Skip to content

Conformance Cases

Small valid cases used to check whether software handles a known part of the format correctly.

This section contains 35 cases. Each item links to the full case page.

Cases

  • appearance_complete: One material and texture with the minimum required properties and one material and texture with all properties. Uniform material assignments use the canonical 'value' form. Geometry with two materials and two textures. Default theme and texture are set.
  • cityjson_extended: CityJSON with extended root members.
  • cityjson_fake_complete: CityJSON that covers the entire spec.
  • cityjson_minimal: CityJSON minimal example from the spec.
  • cityjsonfeature_minimal: Minimal CityJSONFeature with only the required members.
  • cityobject_all_types: CityObjects covering every core type, with the valid Bridge, Building, and Tunnel hierarchies and only type/children/parents members.
  • cityobject_building_address: A BuildingPart with with two addresses, including a point location. Without a geometry member.
  • cityobject_complete: CityObject with all properties and hierarchy. With an empty geometry member.
  • cityobject_extended: CityObject with an 'extended' type, e.g. +ExtendedCityObject, including attributes and hierarchy.
  • coordinates_precision_ecef: ECEF/geocentric CRS with millimeter precision at full Earth radius. Roundtrip drift must stay below 1e-4 m.
  • coordinates_precision_local: Local engineering CRS at the origin with sub-millimeter (0.1 mm) precision. Roundtrip drift must stay below 1e-4 m.
  • coordinates_precision_stateplane: State Plane (survey feet) national grid CRS with millimeter precision and large false origin. Roundtrip drift must stay below 1e-4 m.
  • coordinates_precision_utm: UTM-class projected CRS with millimeter precision and maximum realistic northing. Roundtrip drift must stay below 1e-4 m.
  • coordinates_precision_wgs84: WGS84 geographic CRS at full lon/lat extent with millimeter precision (1e-8 deg scale). Roundtrip drift must stay below 1e-4 m.
  • coordinates_precision_worst: Worst realistic case: national grid with 0.1 mm precision at maximum extent. Roundtrip drift must stay below 1e-4 m.
  • extension: CityJSON with an extension.
  • geometry_instance: Two GeometryInstances with the same template, but different transformation matrices.
  • geometry_material_multisolid: MultiSolid with a single material.
  • geometry_material_multisurface: MultiSurface with a single material.
  • geometry_material_solid: Solid with a single material.
  • geometry_semantics_multilinestring: MultiLineString with semantics. One of the linestrings does not have a semantic assigned ('null').
  • geometry_semantics_multipoint: MultiPoint with semantics. One of the points does not have a semantic assigned ('null').
  • geometry_semantics_multisolid: MultiSolid with semantics. One of the solids does not have a semantic assigned ('null').
  • geometry_semantics_multisurface: MultiSurface with semantics. One of the surfaces has an inner ring, one of the surfaces does not have a semantic assigned ('null').
  • geometry_semantics_solid: Solid with semantics. One of the faces does not have a semantic assigned ('null').
  • geometry_texture_multisolid: MultiSolid with textured and untextured surfaces. One textured surface has an inner ring.
  • geometry_texture_multisurface: MultiSurface with textured surfaces. One textured surface has an inner ring. Last surface is not textured (set to 'null').
  • geometry_texture_solid: Solid with textured surfaces. One textured surface has an inner ring. Last surface is not textured (set to 'null').
  • metadata_complete: Metadata with all properties that are defined in the spec.
  • metadata_extra_properties: Metadata with extra properties that are not in the specs.
  • semantic_all_types: Semantic surfaces with all possible semantic types, including a surface without semantics (last surface).
  • semantic_complete: Two semantic surfaces that together contain all possible semantic properties. These include semantic hierarchy and allowed attribute value types.
  • semantic_extended: Semantic surface with an 'extended' or custom type that start with a '+', e.g. +MySemantic, including attributes and hierarchy.
  • spec_geometry_matrix: Deterministic synthetic case (seed 1001) with 8 Building/Bridge objects covering all seven geometry types, LoDs 0-3, and roof/ground/wall/closure semantics. No materials, textures, or attributes. Baseline for geometry dispatch and boundary handling.
  • vertices: Vertices and transformation properties using coordinates in the Dutch RD New (EPSG:7415) coordinate reference system.