CityJSON-Specific Export Options¶
The CityJSON exporter in the 3DCityDB Tool provides additional options unique to the CityJSON format. These options allow precise control over JSON formatting, geometry precision, and transformations.
CityJSON-Specific Options¶
| Option | Description | Default Value |
|---|---|---|
-v, --cityjson-version=<version> |
Specify the CityJSON version to use: 2.0, 1.1, or 1.0. |
2.0 |
--[no-]json-lines |
Export data as CityJSON Sequence in JSON Lines format (each line is a separate JSON object). Requires CityJSON 1.1+. |
true |
--vertex-precision=<digits> |
Set the number of decimal places for geometry coordinates to reduce file size (e.g., 3 for 0.001). |
|
--template-precision=<digits> |
Set the precision (decimal places) for template vertices, reducing file size while retaining accuracy. | |
--texture-vertex-precision=<digits> |
Define the precision for texture coordinates used in geometries (e.g., 7 for high precision). |
|
--[no-]transform-coordinates |
Transform geometry coordinates into integers when using CityJSON 1.0 to optimize file size. |
true |
--replace-templates |
Replace template geometries with explicit vertex coordinates, increasing file size but simplifying output. | |
--[no-]material-defaults |
Apply default material values (e.g., colors and textures) as defined in the CityGML standard. | true |
--html-safe |
Escape problematic characters to ensure the JSON can be safely embedded into HTML documents. |
Examples for CityJSON Export Options¶
Below are practical examples demonstrating how to use CityJSON-specific options in the 3DCityDB Tool.
Export with Custom Precision for Geometry Vertices¶
To set the vertex precision to 5 decimal places to reduce file size:
Export with CityJSON Lines Format¶
To export data as a CityJSON Sequence in JSON Lines format (requires CityJSON version 1.1+):
Each line in the output file will contain a separate JSON object.Transform Coordinates into Integers¶
To transform geometry coordinates into integers for optimized file size (CityJSON version 1.0):
Replace Templates with Explicit Coordinates¶
To replace template geometries with explicit vertex coordinates for simplified output:
Export with Default Material Values¶
To export CityJSON with default material values (e.g., colors and textures) defined in the CityGML standard:
To disable default material values:
Export CityJSON for HTML Embedding¶
To escape problematic characters in the JSON output for safe embedding into HTML documents: