api

OSS4gEO API Wiki Documentation

In addition to the OSS4gEO web application, the project exposes a REST API that serves information, collected and stored in the OSS4gEO databases, about several open-source geospatial software projects.

Currently hosted at API_URL, the API exposes data using JSONLD format.

Pagination

Because at the moment there are more than 200 projects listed, the API serves paginated results (50 items per page, by default) controlled by the page query parameter. Thus, to retrieve the n-th set of 50 items, one must suffix ?page=n to API_URL where n is defined as a positive integer.

Example for accessing page no. 3:

https://www.oss4geo.org/api/projects?page=3

Filters

In order to the retrieval of projects more efficient, users can retrieve a subset of projects that meet certain criteria.

The following filters are available:

Filter	Value examples
license	Other BSD 2-Clause Apache License 2.0
category	Desktop Server-Side Web Tools Mobile GNU General Public License v2.0
main_organisation	community privately
governance_model	Foundation-backed
enterprise_version	no yes
functionalities	Data management Cartography and visualisation Spatial analysis Geocoding and georeferencing Remote sensing analysis 3D modeling Mobile data collection
standards_category_compliance	encoding access processing visualisation metadata and catalogue services
data_encoding_standards	GeoPackage Geographic Markup Language GML GeoPackage
data_access_standards	OGC API - Features Web Features Service Web Coverage Service
processing_standards	Web Processing WPS Service
visualisation_standards	Web Map Service WMS Web Map Tile Service WMTS KML Styled Layer Descriptor SLD KML

Examples:

http://www.oss4geo.org/api/projects?page=1&license=apache

http://www.oss4geo.org/api/projects?page=1&license=GNU

http://www.oss4geo.org/api/projects?page=1&license=GNU%20General%20Public%20License%20v2.0

https://www.oss4geo.org/api/projects?page=1&functionalities=Data%20management&functionalities=Cartography%20and%20visualisation&functionalities=Remote%20sensing

https://www.oss4geo.org/api/projects?functionalities=Data%20management&functionalities=Remote%20sensing&standards_category_compliance=processing

https://www.oss4geo.org/api/projects?data_encoding_standards=Geographic%20Markup%20Language%20GML&data_encoding_standards=geopackage

https://www.oss4geo.org/api/projects?data_access_standards=Web%20Features%20Service

https://www.oss4geo.org/api/projects?visualisation_standards=Styled%20Layer%20Descriptor%20SLD&visualisation_standards=KML