A light and compact CityJSON management tool.
This tool is built as a high-level MERN application. It therefore allows developing with a single language in both server and client side. It does not rely on an operating system layer.
3D city models are structured following the CityJSON encoding, a JSON-based encoding for storing 3D city models, also called digital maquettes or digital twins. Thanks to MongooseJS, inserted models are validated in regard of CityJSON 1.0.1 specifications. These specifications define the city model schema used to structure the database (several modifications were however made to suit to document-oriented databases).
A MongoDB server is mandatory. The choice between MongoDB Atlas, Community or Enterprise Server is left open.
Everything else is packaged in this repository and installed thanks to npm.
These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.
Setup the project :
npm install
Compiles and minifies for production :
npm run build
Run a local host :
npm start
By default, the application is deployed on localhost:3000 .
Documentations of the Measur3D API and the OGCAPIF can be found in the API-DOCS file (Open API 3.0).
- MongoDB - A cross-platform document-oriented database
- ExpressJS - A fast, unopinionated, minimalist web framework for Node.js
- ReactJS - A JavaScript library for building user interfaces
- Node.js - An open-source, cross-platform, JavaScript runtime environment
- Three.js - A cross-browser JavaScript library to display 3D objects in web browser
- Mongoose - An elegant mongodb object modeling for node.js
The v0.3.0 of Measur3D came with several improvements :
- Delete Object/Model from database and client
- Visualisation: improved UI, highlight of selected object and support of holes in geometries
- OGC API - Features compliant-ish (Thank to Hugo Ledoux for its insight and the CityJSONFeature object - cityjson_ogcapi)
- GeometryInstance and GeometryTemplates support
- Security layers: rateLimiter, cache, DDOS, ...
- Swagger documentation (OpenAPI 3.0)
Public release
The management of the 3D meshes is based on the Ninja viewer and its features. This tool is developed under the supervision of Hugo Ledoux by the GeoInformation research Group from TUDelft.
- Gilles-Antoine Nys - Idea and development - Twitter
This project is part of the PhD Thesis of GANys under the supervision of Prof. Roland Billen - Geomatics Unit, University of Liège, Belgium. It is also part of the SIG3.0 project funded by the National Fund for Scientific Research, Belgium.
This project is licensed under the Apache License - see the LICENSE.md file for details.
If you use Measur3D or the simplified database schema in a scientific context, please cite this article:
Nys G.-A. and Billen R. (2021). From consistency to flexibility: A simplified database schema for the management of CityJSON 3D city models. Transactions in GIS.
@article{nys_consistency_2021,
title = {From consistency to flexibility: {A} simplified database schema for the management of {CityJSON} {3D} city models},
doi = {10.1111/tgis.12807},
urldate = {2021-08-16},
journal = {Transactions in GIS},
author = {Nys, Gilles-Antoine and Billen, Roland},
month = jul,
year = {2021},
}