CityJSON Reader/Writer (Technology Preview)

Licensing options for this format begin with FME Desktop Professional Edition.

Technology Preview

Note: This format is still under active development, so please expect changes to the current behavior. We do not recommend using this format in production environments.

The CityJSON module enables FME to read and write files in the CityJSON format.

This chapter assumes familiarity with JSON and the CityJSON format.

Overview

CityJSON is a JSON-based encoding for storing 3D city models, also called digital maquettes or digital twins.

The current version of CityJSON (v1.0) is an alternative encoding to XML/GML for the CityGML data model v2.0.0 (The schema of CityGML can be downloaded from the Open Geospatial Consortium (OGC) website).

This schema specifications can be found at the CityJSON website.

Reader Overview

This reader supports CityJSON datasets conforming to the publicly available CityJSON v1.0 schemas.

The CityJSON reader reads all parts of a file – only the Appearance (textures and materials) is ignored. (Appearance support is planned in a future version of this format.)

The reader supports datasets that contain Extensions natively (similar to CityGML ADEs).

Writer Overview

This writer supports writing of CityJSON v1.0 files.

Any of the supported city objects of CityJSON can be written to a CityJSON file, and city objects belonging to an Extension can be written (but their name/type must begin with a plus "+" symbol).

However, there is not yet a way to automatically write the extensions property at the root of the CityJSON file. (This enhancement is planned in a future version of this format.)