Skip to content

GeoJSON Profile

GeoJSON is useful for site interchange. It is not the internal ArchAI coordinate or geometry model.

Use GeoJSON for:

  • Parcels.
  • Zoning overlays.
  • Neighboring plots.
  • Roads and paths.
  • Site context.
  • Web map overlays.

Do not use GeoJSON for:

  • Building-local coordinates.
  • Millimeter-precise element geometry.
  • Solids.
  • Terrain TINs.
  • Hosted openings.
  • Parametric BIM relationships.
  • Export RFC 7946 GeoJSON using WGS84 longitude/latitude unless a non-RFC profile is explicitly requested.
  • Put ArchAI path, ID, and kind in feature properties.
  • Preserve source coordinate-space metadata as properties.
  • Do not assume GeoJSON can round-trip all ArchAI semantics.
{
"type": "Feature",
"properties": {
"archai:path": "site.main.parcels.pcl_001",
"archai:id": "Parcel.PCL-001",
"archai:kind": "parcel",
"archai:sourceFrame": "site.main.frames.local"
},
"geometry": {
"type": "Polygon",
"coordinates": [
[
[8.5401, 47.3701],
[8.5407, 47.3701],
[8.5406, 47.3705],
[8.5402, 47.3706],
[8.5401, 47.3701]
]
]
}
}

On import:

  • Create or update site context layers, parcels, or zoning overlays.
  • Store the original source artifact.
  • Record source CRS assumptions.
  • Convert coordinates into an ArchAI coordinate space.
  • Preserve feature properties as metadata where useful.
  • Emit warnings for ambiguous CRS, invalid polygons, or unsupported geometry.
WarningMeaning
geojson.crs_assumed_wgs84Input had no explicit CRS and was treated as RFC 7946 WGS84
geojson.unsupported_geometryGeometry type cannot map cleanly
geojson.invalid_polygonPolygon is not closed or self-intersects
geojson.semantic_lossSome ArchAI semantics cannot be represented
geojson.reprojectedCoordinates were transformed to or from WGS84