Conventions

To ease writing and reading data, the GeoDB API uses a series of format and structure conventions.

📄️ HTTP verbs and codes

Following common REST practices, we use a subset of HTTP of verbs and status codes to denote how to interact with the GeoDB API.

The main means to detect a request error is its HTTP status code (in the range 4XX–5XX).

Formats

For geospatial attributes of resources (e.g., location, boundaries), we use GeoJSON simple features, as defined in IETF RFC 7946.