Skip to content

Latest commit

 

History

History
88 lines (55 loc) · 4.85 KB

index.md

File metadata and controls

88 lines (55 loc) · 4.85 KB
Raw
layout title nav_exclude description permalink
default
Home
true
CityJSON homepage
/

A JSON-based encoding for 3D city models {: .fs-6 .fw-300 }

[Specs latest version: v{{ site.lastversion}}]({{ '/specs/' | append: site.lastversion | prepend: site.baseurl }}){: .btn .btn-purple .fs-5 .mb-4 .mb-md-0 .mr-2 } [Upgrading to v2.0 🚀]({{ '/tutorials/upgrade20/' | prepend: site.baseurl }}){: .btn .btn-purple .fs-5 .mb-4 .mb-md-0 .mr-2 }

[Getting started]({{ '/tutorials/getting-started/' | prepend: site.baseurl }}){: .btn .fs-5 .mb-4 .mb-md-0 .mr-2 } Web-viewer{: .btn .fs-5 .mb-4 .mb-md-0 .mr-2} Validator{: .btn .fs-5 .mb-4 .mb-md-0 .mr-2} cjio{: .btn .fs-5 .mb-4 .mb-md-0 .mr-2}

Latest news

{% for post in site.posts limit:3 %} {{ post.date | date_to_string }} {{ post.title }} {% endfor %}

[All the news]({{ site.baseurl }}/news/)

What is CityJSON?

CityJSON is a JSON-based encoding for storing 3D city models, also called digital maquettes or digital twins ([longer explanation]({{ site.baseurl }}/about/)).

The aim of CityJSON is to offer a compact and developer-friendly format, so that files can be easily visualised, manipulated, and edited. It was designed with programmers in mind, so that tools and APIs supporting it can be quickly built, and [several]({{ "/software/" | prepend: site.baseurl }}) are available (most as open-source).

We believe that you should use CityJSON because:

  1. its simplicity means adding CityJSON support to your software is easy, [many software already support it]({{ "/software/" | prepend: site.baseurl }})
  2. you can in one-click convert CityGML-XML files to CityJSON files, and vice versa, with the open-source tool citygml-tools; we even have a [tutorial]({{ "/tutorials/conversion/" | prepend: site.baseurl }})
  3. files are on average [7X more compact]({{ '/filesize/' | prepend: site.baseurl }}) than their CityGML-XML equivalent
  4. you can automatically convert to/from CityGML-XML v3.0 files with the excellent citygml-tools
  5. there is a web-viewer where you can drag-and-drop a file
  6. you can easily manipulate files with cjio, you can for instance merge files, remove/filter objects, change the CRS, manage the textures, etc.
  7. you can easily define [Extensions]({{ "/extensions/" | prepend: site.baseurl }}) to the core model
  8. its development is open on GitHub, it is supported by a vibrant community, and everyone is welcome to contribute

Is it an international standard?

Yes, CityJSON v2.0 is an official standard of the Open Geospatial Consortium (OGC).

document 20-072r5

What's its relationship to CityGML?

CityJSON is an encoding for a subset of the OGC CityGML data model (version 3.0.0), which is an open standardised data model and exchange format (in GML) to store digital 3D models of cities and landscapes. The few features that are not currently supported are either because they are seldom used, or because they would overcomplicate the JSON encoding; see the [CityGML v3.0 implementation page]({{ "/citygml/v30/" | prepend: site.baseurl }}).

And because we offer [bidirectional conversion]({{ "/tutorials/conversion/" | prepend: site.baseurl }}) between CityJSON and CityGML-XML, using CityJSON means that you are using the CityGML data model.

Contributing to the project

We invite anyone to contribute to the development and improvement of CityJSON, all discussions, issues, and developments are open to everyone on the GitHub repository of CityJSON.

If you use CityJSON in an academic context, please cite this article

{: .highlight } Ledoux H, Arroyo Ohori K, Kumar K, Dukai B, Labetski A, Vitalis S (2019). CityJSON: A compact and easy-to-use encoding of the CityGML data model. Open Geospatial Data, Software and Standards, 4:4