{"id":23116410,"url":"https://github.com/3dcitydb/web-feature-service","last_synced_at":"2025-08-16T21:32:42.037Z","repository":{"id":15776852,"uuid":"18515903","full_name":"3dcitydb/web-feature-service","owner":"3dcitydb","description":"OGC Web Feature Service 2.0 interface for the 3D City Database","archived":false,"fork":false,"pushed_at":"2024-09-14T13:03:51.000Z","size":126045,"stargazers_count":30,"open_issues_count":0,"forks_count":13,"subscribers_count":14,"default_branch":"master","last_synced_at":"2024-09-15T01:34:33.974Z","etag":null,"topics":["citygml","database","ogc","web-feature-service","wfs"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/3dcitydb.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGES.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2014-04-07T12:19:05.000Z","updated_at":"2024-09-14T13:03:54.000Z","dependencies_parsed_at":"2024-04-19T12:28:06.101Z","dependency_job_id":"40546917-19da-4c8f-9db5-b39193498f8e","html_url":"https://github.com/3dcitydb/web-feature-service","commit_stats":null,"previous_names":[],"tags_count":17,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fweb-feature-service","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fweb-feature-service/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fweb-feature-service/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/3dcitydb%2Fweb-feature-service/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/3dcitydb","download_url":"https://codeload.github.com/3dcitydb/web-feature-service/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":230061427,"owners_count":18166705,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["citygml","database","ogc","web-feature-service","wfs"],"created_at":"2024-12-17T04:16:09.138Z","updated_at":"2025-08-16T21:32:42.029Z","avatar_url":"https://github.com/3dcitydb.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"3DCityDB Web Feature Service Interface\n======================================\n\n\u003e [!NOTE]\n\u003e This repository hosts the 3DCityDB v4 Web Feature Service. Although 3DCityDB v5 is now available, 3DCityDB v4\n\u003e remains stable and operational. However, it is in **maintenance mode**, meaning no significant new features are\n\u003e planned, though existing bugs will continue to be addressed. Development is now focused on 3DCityDB v5, and we recommend\n\u003e upgrading to benefit from new features and improvements. Please refer to the [3DCityDB v5 user manual](https://3dcitydb.github.io/3dcitydb-mkdocs/)\n\u003e for more information.\n\nThe OGC Web Feature Service (WFS) interface for the 3D City Database enables web-based access to the city objects stored\nin the database. WFS clients can directly connect to this standardized and open interface for requesting 3D content\nacross the web using platform-independent calls. Users of the 3D City Database are therefore no longer limited to using\nthe [Importer/Exporter](https://github.com/3dcitydb/importer-exporter) tool for data retrieval. The Web Feature Service\nallows clients to only retrieve the city objects they are seeking, rather than retrieving a file that contains the data\nthey are seeking and possibly much more.\n\nThe 3D City Database WFS interface is implemented against the latest version 2.0 of the [OGC Web Feature Service standard](http://www.opengeospatial.org/standards/wfs)\nand hence is compliant with ISO 19142:2010. Previous versions of the WFS standard are not supported.\nThe development of the WFS is led by the company [Virtual City Systems](https://vc.systems/)\nthat offers an extended version of the WFS with additional capabilities such as, for instance,\ntransaction support through insert, update, replace and delete operations. This additional functionality may\nbe fed back to the open source project in future releases.\n\nLicense\n-------\nThe 3D City Database Web Feature Service is licensed under the [Apache License, Version 2.0](http://www.apache.org/licenses/LICENSE-2.0).\nSee the `LICENSE` file for more details.\n\nNote that releases of the software before version 3.3.0 continue to be licensed under GNU LGPL 3.0. To request a\nprevious release of the 3D City Database Importer/Exporter under Apache License 2.0 create a GitHub issue.\n\nLatest release\n--------------\nThe latest stable release of the 3D City Database WFS interface is 5.4.1.\n\nDownload a ZIP file of the WFS [here](https://github.com/3dcitydb/web-feature-service/releases/download/v5.4.1/3DCityDB-Web-Feature-Service-5.4.1.zip).\nPrevious releases are available from the [releases section](https://github.com/3dcitydb/web-feature-service/releases).\n\nSystem requirements\n-------------------\nThe 3D City Database WFS is implemented as Java web application based on the Java Servlet technology. It therefore must\nbe run in a Java servlet container on a web server. The following minimum software requirements have to be met:\n\n* Java servlet container supporting the Java Servlet 3.1/3.0 specification\n* Java 11 Runtime Environment (or higher)\n\nThe WFS implementation has been successfully deployed and tested on [Apache Tomcat](http://tomcat.apache.org/)\nversions 9 and 8. All previous versions of the Apache Tomcat server have reached end of life and are not supported\nanymore.\n\nDocumentation\n-------------\nA complete and comprehensive user manual on the Web Feature Service is available\n[online](https://3dcitydb-docs.readthedocs.io/en/latest/wfs/).\n\nThe documentation contains a step-by-step guide for deploying the WFS on a servlet container.\n\nContributing\n------------\n* To file bugs found in the software create a GitHub issue.\n* To contribute code for fixing filed issues create a pull request with the issue id.\n* To propose a new feature create a GitHub issue and open a discussion.\n\nBuilding\n--------\nThe project uses [Gradle](https://gradle.org/) as build system. To build the WFS from source, clone the repository to\nyour local machine and run the following command from the root of the repository.\n\n    \u003e gradlew installDist\n    \nThe build process will produce the WFS software package under `build/install`.\n\nUsing with Docker\n-----------------\n\nThe 3D City Database Web Feature Service is also available as Docker image. You can either build the image\nyourself using one of the provided Docker files or use a pre-built image from Docker Hub at\nhttps://hub.docker.com/r/3dcitydb/wfs.\n\nTo build the image, clone the repository to your local machine and run the following command from the root of the\nrepository:\n\n    \u003e docker build -t 3dcitydb/wfs .\n\nUsing the Docker image of the 3D City Database WFS is simple:\n\n```\n\u003e docker run --name wfs [-d] -p 8080:8080 \\\n    [-e CITYDB_TYPE=postgresql|oracle] \\\n    [-e CITYDB_HOST=the.host.de] \\\n    [-e CITYDB_PORT=thePort] \\\n    [-e CITYDB_NAME=theDBName] \\\n    [-e CITYDB_SCHEMA=theCityDBSchemaName] \\\n    [-e CITYDB_USERNAME=theUsername] \\\n    [-e CITYDB_PASSWORD=theSecretPass] \\\n    [-e WFS_CONTEXT_PATH=wfs-context-path] \\\n    [-e WFS_ADE_EXTENSIONS_PATH=/path/to/ade-extensions/] \\\n    [-e WFS_CONFIG_FILE=/path/to/config.xml] \\\n    [-v /my/data/config.xml:/path/to/config.xml] \\\n  3dcitydb/wfs\n```\n\nWhen running a Docker container with default settings, the WFS will listen at the following URL.\n\n    http[s]://[host][:port]/wfs\n\nMore details on how to use the 3D City Database WFS with Docker can be found in the\n[online documentation](https://3dcitydb-docs.readthedocs.io/en/version-2024.0/wfs/).\n\nDevelopers\n----------\n\nThe 3D City Database Web Feature Service has been developed by: \n\n* [Virtual City Systems, Berlin](https://vc.systems/)","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3dcitydb%2Fweb-feature-service","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F3dcitydb%2Fweb-feature-service","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F3dcitydb%2Fweb-feature-service/lists"}