Skip to content

Commit 9760902

Browse files
committed
Add 2 notes with suggested conventions for the file extensions
1 parent 9dfc283 commit 9760902

1 file changed

Lines changed: 11 additions & 1 deletion

File tree

‎specs/specs.bs‎

Lines changed: 11 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -71,6 +71,11 @@ A CityJSON object:
7171
- **may** have one member with the name `"geometry-templates"`, the value is a JSON object containing the templates that can be reused by different City Objects (usually for trees). This is equivalent to the concept of "implicit geometries" in CityGML. See [[#geometry-templates]] for details.
7272
- **may** have other members, and their value is not prescribed. Because these are not standard in CityJSON, they might be ignored by parsers.
7373

74+
75+
<div class="note">
76+
**Suggested convention:** A file containing one CityJSON object may have the extension `'.city.json'`
77+
</div>
78+
7479
The minimal valid CityJSON object is thus:
7580

7681
```json
@@ -1491,10 +1496,15 @@ Below is an example of a CityJSONFeature stream (or a JSON Lines text file), wit
14911496
{"type":"CityJSONFeature","id":"b","CityObjects":{...},"vertices":[...]}
14921497
{"type":"CityJSONFeature","id":"c","CityObjects":{...},"vertices":[...]}
14931498
```
1499+
1500+
<div class="note">
1501+
**Suggested convention:** `"CityJSON"` and `"CityJSONFeature"` objects may be stored in a file with the extension `'.city.jsonl'`
1502+
</div>
14941503
<div class="note">
1495-
CityJSON does not prescribe the format or standard that should be used to store several JSON objects in a given file, it only defines how `"CityJSON"` and `"CityJSONFeature"` objects should be defined.
1504+
Observe that CityJSON does not prescribe the format or standard that should be used to store several JSON objects in a given file, it only defines how `"CityJSON"` and `"CityJSONFeature"` objects should be defined.
14961505
</div>
14971506

1507+
14981508
# Extensions
14991509

15001510
CityJSON uses [JSON Schemas](http://json-schema.org/) to document and validate its data model, including its Extensions. Schemas offer a way to validate the syntax of a JSON document.

0 commit comments

Comments
 (0)