3DCityDB Web Feature Service Interface

The OGC Web Feature Service (WFS) interface for the 3D City Database enables web-based access to the city objects stored in the database. WFS clients can directly connect to this standardized and open interface for requesting 3D content across the web using platform-independent calls. Users of the 3D City Database are therefore no longer limited to using the Importer/Exporter tool for data retrieval. The Web feature services allows clients to only retrieve the city objects they are seeking, rather than retrieving a file that contains the data they are seeking and possibly much more.

The 3D City Database WFS interface is implemented against the latest version 2.0 of the OGC Web Feature Service standard and hence is compliant with ISO 19142:2010. Previous versions of the WFS standard are not supported. The implementation currently satisfies the Simple WFS conformance class. The development of the WFS is led by the company virtualcitySYSTEMS which offers an extended version of the WFS with additional functionalities that go beyond the Simple WFS class (e.g., thematic and spatial filter capabilities and transaction support). This additional functionality may be fed back to the open source project in future releases.

License

The 3D City Database Web Feature Service is licensed under the Apache License, Version 2.0. See the LICENSE file for more details.

Note that releases of the software before version 3.3.0 continue to be licensed under GNU LGPL 3.0. To request a previous release of the 3D City Database Importer/Exporter under Apache License 2.0 create a GitHub issue.

Latest release

The latest stable release of the 3D City Database WFS interface is 4.2.

Download a ZIP file of the WFS here. Previous releases are available from the releases section.

System requirements

The 3D City Database WFS is implemented as Java web application based on the Java Servlet technology. It therefore must be run in a Java servlet container on a web server. The following minimum software requirements have to be met:

The WFS implementation has been successfully deployed and tested on Apache Tomcat versions 9, 8 and 7.

Documentation

A complete and comprehensive documentation on the Web Feature Service is contained in the ZIP file from the releases section and is available online.

The documentation contains a step-by-step guide for deploying the WFS on a servlet container.

Contributing

Building

The project uses Gradle as build system. To build the WFS from source, clone the repository to your local machine and run the following command from the root of the repository.

> gradlew installDist

The build process will produce the WFS software package under build/install.

Developers

The 3D City Database Web Feature Service has been developed by: