The approved standard OpenAPI description OGC itself publishes for OGC API - Maps. This is the STANDARD'S contract, not any one deployment of it — the servers block is a template, so it describes what a conformant implementation must offer rather than a callable host.
{
"openapi": "3.0.0",
"info": {
"version": "1.0",
"title": "OGC API - Maps",
"description": "Example API Definition for OGC API - Maps - Part 1: Core",
"contact": {
"name": "Open Geospatial Consortium",
"email": "info@ogc.org"
},
"license": {
"name": "OGC License",
"url": "http://www.opengeospatial.org/legal/"
}
},
"servers": [
{
"description": "Example OGC API - Maps server",
"url": "https://maps.gnosis.earth/ogcapi"
}
],
"paths": {
"/": {
"get": {
"tags": [
"Landing Page"
],
"operationId": "getLandingPage",
"summary": "Retrieve the OGC API landing page for this service.",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/LandingPage"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/conformance": {
"get": {
"tags": [
"Conformance"
],
"operationId": "getConformance",
"summary": "Retrieve the set of OGC API conformance classes that are supported by this service.",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Conformance"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/api": {
"get": {
"tags": [
"API"
],
"operationId": "getAPI",
"summary": "Retrieve this API definition.",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/API"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/api/all-collections": {
"get": {
"tags": [
"API"
],
"operationId": "getAPICollections",
"summary": "Retrieve the list of collections available from this API implementation & deployment.",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Enumeration"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/api/tileMatrixSets": {
"get": {
"tags": [
"API"
],
"operationId": "getAPITileMatrixSets",
"summary": "JSON enumeration of the shared TileMatrixSets available from this API implementation & deployment (for inclusion in the API definition).",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Enumeration"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/api/styles": {
"get": {
"tags": [
"API"
],
"operationId": "getAPIStyles",
"summary": "Retrieve the list of dataset styles available from this API implementation & deployment.",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Enumeration"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/collections": {
"get": {
"tags": [
"Data Collections"
],
"operationId": "getCollectionsList",
"summary": "Retrieve the list of geospatial data collections available from this service.",
"parameters": [
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/bbox"
},
{
"name": "limit",
"in": "query",
"description": "The optional limit parameter limits the number of collections that are presented in the response document.\nOnly items are counted that are on the first level of the collection in the response document. Nested objects contained within the explicitly requested items shall not be counted.\n* Minimum = 1 * Maximum = 10000 * Default = 10",
"required": false,
"schema": {
"type": "integer",
"minimum": 1,
"maximum": 10000,
"default": 10
},
"style": "form",
"explode": false
},
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/CollectionsList"
}
}
}
},
"/collections/{collectionId}": {
"get": {
"tags": [
"Data Collections"
],
"operationId": "getCollection",
"summary": "Retrieve the description of a collection available from this service.",
"parameters": [
{
"$ref": "#/components/parameters/collectionId-all"
},
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Collection"
}
}
}
},
"/map": {
"get": {
"tags": [
"Maps"
],
"summary": "Retrieve a default map of the whole dataset",
"operationId": ".dataset.getMap",
"parameters": [
{
"$ref": "#/components/parameters/bbox"
},
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/subset"
},
{
"$ref": "#/components/parameters/crs"
},
{
"$ref": "#/components/parameters/bbox-crs"
},
{
"$ref": "#/components/parameters/subset-crs"
},
{
"$ref": "#/components/parameters/bgcolor"
},
{
"$ref": "#/components/parameters/transparent"
},
{
"$ref": "#/components/parameters/void-color"
},
{
"$ref": "#/components/parameters/void-transparent"
},
{
"$ref": "#/components/parameters/width"
},
{
"$ref": "#/components/parameters/height"
},
{
"$ref": "#/components/parameters/center"
},
{
"$ref": "#/components/parameters/center-crs"
},
{
"$ref": "#/components/parameters/scale-denominator"
},
{
"$ref": "#/components/parameters/mm-per-pixel"
},
{
"$ref": "#/components/parameters/orientation"
},
{
"$ref": "#/components/parameters/crs-proj-method"
},
{
"$ref": "#/components/parameters/crs-proj-center"
},
{
"$ref": "#/components/parameters/crs-proj-params"
},
{
"$ref": "#/components/parameters/crs-datum"
},
{
"$ref": "#/components/parameters/f-map"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Map"
},
"204": {
"$ref": "#/components/responses/EmptyMap"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/styles/{styleId}/map": {
"get": {
"tags": [
"Maps"
],
"summary": "Retrieve a styled map of the whole dataset",
"operationId": ".dataset.style.getMap",
"parameters": [
{
"$ref": "#/components/parameters/bbox"
},
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/subset"
},
{
"$ref": "#/components/parameters/crs"
},
{
"$ref": "#/components/parameters/bbox-crs"
},
{
"$ref": "#/components/parameters/subset-crs"
},
{
"$ref": "#/components/parameters/bgcolor"
},
{
"$ref": "#/components/parameters/transparent"
},
{
"$ref": "#/components/parameters/void-color"
},
{
"$ref": "#/components/parameters/void-transparent"
},
{
"$ref": "#/components/parameters/width"
},
{
"$ref": "#/components/parameters/height"
},
{
"$ref": "#/components/parameters/center"
},
{
"$ref": "#/components/parameters/center-crs"
},
{
"$ref": "#/components/parameters/scale-denominator"
},
{
"$ref": "#/components/parameters/mm-per-pixel"
},
{
"$ref": "#/components/parameters/orientation"
},
{
"$ref": "#/components/parameters/crs-proj-method"
},
{
"$ref": "#/components/parameters/crs-proj-center"
},
{
"$ref": "#/components/parameters/crs-proj-params"
},
{
"$ref": "#/components/parameters/crs-datum"
},
{
"$ref": "#/components/parameters/styleId"
},
{
"$ref": "#/components/parameters/f-map"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Map"
},
"204": {
"$ref": "#/components/responses/EmptyMap"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/collections/{collectionId}/map": {
"get": {
"tags": [
"Maps"
],
"summary": "Retrieve a map for the specified collection",
"operationId": ".collection.getMap",
"parameters": [
{
"$ref": "#/components/parameters/bbox"
},
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/collectionId-all"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/subset"
},
{
"$ref": "#/components/parameters/crs"
},
{
"$ref": "#/components/parameters/bbox-crs"
},
{
"$ref": "#/components/parameters/subset-crs"
},
{
"$ref": "#/components/parameters/bgcolor"
},
{
"$ref": "#/components/parameters/transparent"
},
{
"$ref": "#/components/parameters/void-color"
},
{
"$ref": "#/components/parameters/void-transparent"
},
{
"$ref": "#/components/parameters/width"
},
{
"$ref": "#/components/parameters/height"
},
{
"$ref": "#/components/parameters/center"
},
{
"$ref": "#/components/parameters/center-crs"
},
{
"$ref": "#/components/parameters/scale-denominator"
},
{
"$ref": "#/components/parameters/mm-per-pixel"
},
{
"$ref": "#/components/parameters/orientation"
},
{
"$ref": "#/components/parameters/crs-proj-method"
},
{
"$ref": "#/components/parameters/crs-proj-center"
},
{
"$ref": "#/components/parameters/crs-proj-params"
},
{
"$ref": "#/components/parameters/crs-datum"
},
{
"$ref": "#/components/parameters/f-map"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Map"
},
"204": {
"$ref": "#/components/responses/EmptyMap"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/collections/{collectionId}/styles/{styleId}/map": {
"get": {
"tags": [
"Maps"
],
"summary": "Retrieve a map for a specified collection and style",
"operationId": ".collection.style.getMap",
"parameters": [
{
"$ref": "#/components/parameters/bbox"
},
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/collectionId-all"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/subset"
},
{
"$ref": "#/components/parameters/crs"
},
{
"$ref": "#/components/parameters/bbox-crs"
},
{
"$ref": "#/components/parameters/subset-crs"
},
{
"$ref": "#/components/parameters/bgcolor"
},
{
"$ref": "#/components/parameters/transparent"
},
{
"$ref": "#/components/parameters/void-color"
},
{
"$ref": "#/components/parameters/void-transparent"
},
{
"$ref": "#/components/parameters/width"
},
{
"$ref": "#/components/parameters/height"
},
{
"$ref": "#/components/parameters/center"
},
{
"$ref": "#/components/parameters/center-crs"
},
{
"$ref": "#/components/parameters/scale-denominator"
},
{
"$ref": "#/components/parameters/mm-per-pixel"
},
{
"$ref": "#/components/parameters/orientation"
},
{
"$ref": "#/components/parameters/crs-proj-method"
},
{
"$ref": "#/components/parameters/crs-proj-center"
},
{
"$ref": "#/components/parameters/crs-proj-params"
},
{
"$ref": "#/components/parameters/crs-datum"
},
{
"$ref": "#/components/parameters/styleId-collection"
},
{
"$ref": "#/components/parameters/f-map"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/Map"
},
"204": {
"$ref": "#/components/responses/EmptyMap"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/projectionsAndDatums": {
"get": {
"tags": [
"Custom Projection CRS"
],
"summary": "Retrieve the list of custom CRS projection operation methods (including their associated parameters) and datums supported by this API.",
"operationId": "getCustomCRSProjections",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"description": "The list of custom CRS projection operation methods (including their associated parameters) and datums supported by this API.",
"content": {
"application/json": {
"schema": {
"title": "Custom CRS projections and datums",
"description": "The list of available projection operation methods, parameters and datums for custom CRS definitions",
"type": "object",
"required": [
"methods",
"datums"
],
"properties": {
"methods": {
"type": "object",
"description": "The list of available projection operation methods for the `crs-proj-method` query parameter of the API. The properties in this dictionary object are the available values, and correspond to safe CURIEs if a URI is registered for the method.",
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"description": "A title for this projection operation method",
"type": "string"
},
"description": {
"description": "Brief narrative description of this projection operation method",
"type": "string"
},
"parameters": {
"type": "object",
"description": "The list of available method parmaeters for the `crs-proj-params` query parameter of the API when using this method. The properties in this dictionary object are the available values, and correspond to safe CURIEs if a URI is registered for the method. \"$ref\" may be used to refer to global parameters in the \"parameters\" property of this document.",
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"description": "A title for this method parameter",
"type": "string"
},
"description": {
"description": "Brief narrative description of this method parameter",
"type": "string"
}
}
}
}
}
}
},
"datums": {
"type": "object",
"description": "The list of available datums for the `crs-datum` query parameter of the API. The properties in this dictionary object are the available values, and correspond to safe CURIEs if a URI is registered for the method.",
"additionalProperties": {
"type": "object",
"required": [
"ellipsoid"
],
"properties": {
"title": {
"description": "A title for this datum.",
"type": "string"
},
"description": {
"description": "Brief narrative description of this datum",
"type": "string"
},
"ellipsoid": {
"description": "The identifier (safe CURIE if a URI exists) for the ellipsoid associated with this datum.",
"type": "string"
}
}
}
},
"parameters": {
"type": "object",
"description": "A list of global method parameters that can be referenced from individual methods supporting them using the \"$ref\" JSON Pointer mechanism.",
"additionalProperties": {
"type": "object",
"properties": {
"title": {
"description": "A title for this method parameter",
"type": "string"
},
"description": {
"description": "Brief narrative description of this method parameter",
"type": "string"
}
}
}
}
}
}
},
"text/html": {
"schema": {
"type": "string"
}
}
}
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/tileMatrixSets": {
"get": {
"tags": [
"Tiling Schemes"
],
"summary": "Retrieve the list of available tiling schemes (tile matrix sets)",
"operationId": "getTileMatrixSetsList",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/TileMatrixSetsList"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/tileMatrixSets/{tileMatrixSetId}": {
"get": {
"tags": [
"Tiling Schemes"
],
"summary": "Retrieve the definition of the specified tiling scheme (tile matrix set)",
"operationId": "getTileMatrixSet",
"parameters": [
{
"$ref": "#/components/parameters/tileMatrixSetId"
},
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/TileMatrixSet"
},
"404": {
"description": "The requested tile matrix set id was not found",
"content": {
"application/json": {
"schema": {
"$ref": "#/components/schemas/exception"
}
}
}
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/map/tiles": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve the list of all default map tilesets for the whole dataset",
"operationId": ".dataset.map.getTileSetsList",
"parameters": [
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/TileSetsList"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/map/tiles/{tileMatrixSetId}": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve a default map tileset of the whole dataset for the specified tiling scheme (tile matrix set)",
"operationId": ".dataset.map.getTileSet",
"parameters": [
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/tileMatrixSetId"
},
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/TileSet"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve a default map tile of the whole dataset",
"operationId": ".dataset.map.getTile",
"parameters": [
{
"$ref": "#/components/parameters/tileMatrix"
},
{
"$ref": "#/components/parameters/tileRow"
},
{
"$ref": "#/components/parameters/tileCol"
},
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/subset"
},
{
"$ref": "#/components/parameters/crs"
},
{
"$ref": "#/components/parameters/subset-crs"
},
{
"$ref": "#/components/parameters/bgcolor"
},
{
"$ref": "#/components/parameters/transparent"
},
{
"$ref": "#/components/parameters/void-color"
},
{
"$ref": "#/components/parameters/void-transparent"
},
{
"$ref": "#/components/parameters/tileMatrixSetId"
},
{
"$ref": "#/components/parameters/f-mapTile"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/MapTile"
},
"204": {
"$ref": "#/components/responses/EmptyTile"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/styles/{styleId}/map/tiles": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve the list of styled map tilesets for the whole dataset",
"operationId": ".dataset.style.map.getTileSetsList",
"parameters": [
{
"$ref": "#/components/parameters/styleId"
},
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/TileSetsList"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/styles/{styleId}/map/tiles/{tileMatrixSetId}": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve a styled map tileset of the whole dataset for the specified tiling scheme (tile matrix set)",
"operationId": ".dataset.style.map.getTileSet",
"parameters": [
{
"$ref": "#/components/parameters/styleId"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/tileMatrixSetId"
},
{
"$ref": "#/components/parameters/f-metadata"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/TileSet"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/styles/{styleId}/map/tiles/{tileMatrixSetId}/{tileMatrix}/{tileRow}/{tileCol}": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve a styled map tiles",
"operationId": ".dataset.style.map.getTile",
"parameters": [
{
"$ref": "#/components/parameters/tileMatrix"
},
{
"$ref": "#/components/parameters/tileRow"
},
{
"$ref": "#/components/parameters/tileCol"
},
{
"$ref": "#/components/parameters/datetime"
},
{
"$ref": "#/components/parameters/collections"
},
{
"$ref": "#/components/parameters/subset"
},
{
"$ref": "#/components/parameters/crs"
},
{
"$ref": "#/components/parameters/subset-crs"
},
{
"$ref": "#/components/parameters/bgcolor"
},
{
"$ref": "#/components/parameters/transparent"
},
{
"$ref": "#/components/parameters/void-color"
},
{
"$ref": "#/components/parameters/void-transparent"
},
{
"$ref": "#/components/parameters/styleId"
},
{
"$ref": "#/components/parameters/tileMatrixSetId"
},
{
"$ref": "#/components/parameters/f-mapTile"
}
],
"responses": {
"200": {
"$ref": "#/components/responses/MapTile"
},
"204": {
"$ref": "#/components/responses/EmptyTile"
},
"404": {
"$ref": "#/components/responses/NotFound"
},
"406": {
"$ref": "#/components/responses/NotAcceptable"
},
"500": {
"$ref": "#/components/responses/ServerError"
}
}
}
},
"/collections/{collectionId}/map/tiles": {
"get": {
"tags": [
"Map Tiles"
],
"summary": "Retrieve a list of all map tilesets for specified collection.",
"operationId": ".collection.map.getTileSetsList",
"parameters": [
# --- truncated at 32 KB (139 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ogc/refs/heads/main/openapi/_original/ogc-maps-part1-1-0-openapi-ogcapi-maps-1-bundled.json