Open Geospatial Consortium (OGC) Collection data queries API
Data queries available.
Work with this as data
Every API here is available over the APIs.io API and to AI agents over MCP.
MCP server
One button, every client — Claude, Cursor, VS Code and the rest.
https://apis.io/mcp
Tools for apis
7 MCP tools reach this
find_apisBrowse and filter every API in the catalog.get_api_artifactsOne API's artifacts, grouped by type.get_openapiThe primary OpenAPI for this API.find_similar_apisAPIs that look like this one.apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.resolveTurn a domain, URL or GitHub org into the provider it belongs to.find_cohortsEvery scored population of providers in the catalog.
Call it yourself
curl for this page
This API
curl "https://apis.io/api/v1/apis/ogc-collection-data-queries-api"
All apis
curl "https://apis.io/api/v1/apis?limit=25"Discovery needs no key. Ratings and market analysis are Pro.
Get an API key
Free tier, no form to fill in. Signing in shares your email address with us — we store it to create your key and to recognise you if you sign in with another provider. See our Privacy Policy and Terms.
A second provider on the same verified email joins the account you already have.
OpenAPI Specification
openapi: 3.2.0
info:
title: Ogc Collection data queries API
license:
name: OGC License
url: https://www.ogc.org/legal
version: '1.0'
description: 'Operations tagged Collection data queries across 2 of this provider''s published API definitions: ogc-edr-1-0-openapi-ogcapi-environmental-data-retrieval-1-bundled.json, ogc-edr-1-1-openapi-ogcapi-environmental-data-retrieval-1-bundled.json. Each path carries the servers of the definition it was published in.'
servers:
- url: https://www.example.org/edr
description: Example OGC API - Environmental Data Retrieval server
- url: https://example.org/edr
description: Example OGC API - Environmental Data Retrieval server
tags:
- name: Collection data queries
description: Data queries available.
paths:
/collections/{collectionId}/position:
get:
tags:
- Collection data queries
summary: Query end point for position queries of collection {collectionId}
description: Query end point for position queries
operationId: getDataForPoint
parameters:
- name: collectionId
in: path
description: Identifier (id) of a specific collection
required: true
schema:
type: string
- name: coords
in: query
description: "location(s) to return data for, the coordinates are defined by a Well Known Text\n(wkt) string. to retrieve a single location :\n\nPOINT(x y) i.e. POINT(0 51.48) for Greenwich, London\n\nAnd for a list of locations\n\nMULTIPOINT((x y),(x1 y1),(x2 y2),(x3 y3))\n\ni.e.\nMULTIPOINT((38.9 -77),(48.85 2.35),(39.92 116.38),(-35.29 149.1),(51.5 -0.1))\n\nsee http://portal.opengeospatial.org/files/?artifact_id=25355 and \nhttps://en.wikipedia.org/wiki/Well-known_text_representation_of_geometry\n\nthe coordinate values will depend on the CRS parameter, if this is not defined\nthe values will be assumed to WGS84 values (i.e x=longitude and y=latitude)\n"
required: true
schema:
type: string
- name: z
in: query
description: "Define the vertical level to return data from \ni.e. z=level\n\nfor instance if the 850hPa pressure level is being queried\n\nz=850\n\nor a range to return data for all levels between and including 2 defined levels\ni.e. z=minimum value/maximum value\n\nfor instance if all values between and including 10m and 100m\n\nz=10/100\n\nfinally a list of height values can be specified\ni.e. z=value1,value2,value3\n\nfor instance if values at 2m, 10m and 80m are required\n\nz=2,10,80\n\nAn Arithmetic sequence using Recurring height intervals, the difference is the number of recurrences is defined at the start \nand the amount to increment the height by is defined at the end\n\ni.e. z=Rn/min height/height interval\n\nso if the request was for 20 height levels 50m apart starting at 100m:\n\nz=R20/100/50\n\nWhen not specified data from all available heights SHOULD be returned\n"
required: false
schema:
type: string
style: form
explode: false
- name: datetime
in: query
description: 'Either a date-time or an interval. Date and time expressions adhere to RFC 3339. Intervals may be bounded or half-bounded (double-dots at start or end).
Examples:
* A date-time: "2018-02-12T23:20:50Z" * A bounded interval: "2018-02-12T00:00:00Z/2018-03-18T12:31:12Z" * Half-bounded intervals: "2018-02-12T00:00:00Z/.." or "../2018-03-18T12:31:12Z"
Only resources that have a temporal property that intersects the value of `datetime` are selected.
If a feature has multiple temporal properties, it is the decision of the server whether only a single temporal property is used to determine the extent or all relevant temporal properties.'
required: false
schema:
type: string
style: form
explode: false
- name: parameter-name
in: query
description: comma delimited list of parameters to retrieve data for. Valid parameters are listed in the collections metadata
schema:
type: string
style: form
explode: false
required: false
- name: crs
in: query
description: identifier (id) of the coordinate system to return data in list of valid crs identifiers for the chosen collection are defined in the metadata responses. If not supplied the coordinate reference system will default to WGS84.
required: false
example: native
schema:
type: string
- name: f
in: query
description: format to return the data response in
required: false
schema:
type: string
responses:
'200':
description: Data ranges required to construct valid queries for the choosen data collection
content:
application/prs.coverage+json:
schema:
type: object
title: CoverageJSON
description: A geospatial coverage interchange format based on JavaScript Object Notation (JSON)
required:
- type
properties:
type:
description: Coverage domain type
enum:
- Coverage
- CoverageCollection
- Domain
domainType:
type: string
coverages:
type: array
items:
type: object
required:
- type
- domain
- ranges
properties:
type:
description: Coverage domain type
enum:
- Coverage
domain:
description: A Domain, which defines a set of positions and their extent in one or more referencing systems
type: object
properties:
type:
enum:
- Domain
domainType:
type: string
axes:
type: object
oneOf:
- description: 'Grid domain: x and y are required, z and t optional'
properties:
x:
description: Simple axis with numeric values
oneOf:
- description: Axis defined by list of numeric axis values and optional bounds
allOf:
- description: Base schema for values-based axis schemas
properties:
dataType:
type: string
not:
enum:
- primitive
values:
type: array
minItems: 1
uniqueItems: true
coordinates:
type: array
items:
type: string
minItems: 2
bounds:
description: Optional axis bounds. Must be twice as long (and same data type) as "values"
type: array
minItems: 2
required:
- values
- properties:
values:
items:
type: number
bounds:
items:
type: number
additionalProperties: false
- description: A regularly-spaced numeric axis
properties:
start:
type: number
stop:
type: number
num:
type: integer
minimum: 1
required:
- start
- stop
- num
additionalProperties: false
y:
description: Simple axis with numeric values
oneOf:
- description: Axis defined by list of numeric axis values and optional bounds
allOf:
- description: Base schema for values-based axis schemas
properties:
dataType:
type: string
not:
enum:
- primitive
values:
type: array
minItems: 1
uniqueItems: true
coordinates:
type: array
items:
type: string
minItems: 2
bounds:
description: Optional axis bounds. Must be twice as long (and same data type) as "values"
type: array
minItems: 2
required:
- values
- properties:
values:
items:
type: number
bounds:
items:
type: number
additionalProperties: false
- description: A regularly-spaced numeric axis
properties:
start:
type: number
stop:
type: number
num:
type: integer
minimum: 1
required:
- start
- stop
- num
additionalProperties: false
z:
description: Simple axis with numeric values
oneOf:
- description: Axis defined by list of numeric axis values and optional bounds
allOf:
- description: Base schema for values-based axis schemas
properties:
dataType:
type: string
not:
enum:
- primitive
values:
type: array
minItems: 1
uniqueItems: true
coordinates:
type: array
items:
type: string
minItems: 2
bounds:
description: Optional axis bounds. Must be twice as long (and same data type) as "values"
type: array
minItems: 2
required:
- values
- properties:
values:
items:
type: number
bounds:
items:
type: number
additionalProperties: false
- description: A regularly-spaced numeric axis
properties:
start:
type: number
stop:
type: number
num:
type: integer
minimum: 1
required:
- start
- stop
- num
additionalProperties: false
t:
description: Simple axis with string values (e.g. time strings)
allOf:
- description: Base schema for values-based axis schemas
properties:
dataType:
type: string
not:
enum:
- primitive
values:
type: array
minItems: 1
uniqueItems: true
coordinates:
type: array
items:
type: string
minItems: 2
bounds:
description: Optional axis bounds. Must be twice as long (and same data type) as "values"
type: array
minItems: 2
required:
- values
- properties:
values:
items:
type: string
bounds:
items:
type: string
additionalProperties: false
required:
- x
- y
- description: 'Trajectory domain: mandatory composite axis and optional z axis'
properties:
axes:
properties:
composite:
description: Tuple-based axis
allOf:
- description: Base schema for values-based axis schemas
properties:
dataType:
type: string
not:
enum:
- primitive
values:
type: array
minItems: 1
uniqueItems: true
coordinates:
type: array
items:
type: string
minItems: 2
bounds:
description: Optional axis bounds. Must be twice as long (and same data type) as "values"
type: array
minItems: 2
required:
- values
- properties:
dataType:
enum:
- tuple
values:
items:
description: A tuple of axis values (numbers or strings)
type: array
items:
anyOf:
- type: number
- type: string
minItems: 2
coordinates: {}
required:
- dataType
- values
- coordinates
additionalProperties: false
z:
description: Simple axis with numeric values
oneOf:
- description: Axis defined by list of numeric axis values and optional bounds
allOf:
- description: Base schema for values-based axis schemas
properties:
dataType:
type: string
not:
enum:
- primitive
values:
type: array
minItems: 1
uniqueItems: true
coordinates:
type: array
items:
type: string
minItems: 2
bounds:
description: Optional axis bounds. Must be twice as long (and same data type) as "values"
type: array
minItems: 2
required:
- values
- properties:
values:
items:
type: number
bounds:
items:
type: number
additionalProperties: false
- description: A regularly-spaced numeric axis
properties:
start:
type: number
stop:
type: number
num:
type: integer
minimum: 1
required:
- start
- stop
- num
additionalProperties: false
required:
- composite
referencing:
type: array
items:
description: 'Reference System Connection object: connects coordinates to reference systems'
type: object
properties:
coordinates:
type: array
items:
type: string
minItems: 1
system:
type: object
properties:
type:
type: string
required:
- type
oneOf:
- description: Temporal reference system
properties:
calendar:
type: string
timeScale:
type: string
required:
- calendar
- description: An identifier-based reference system
properties:
id:
type: string
label:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
description:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
targetConcept:
type: object
properties:
id:
type: string
label:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
description:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
required:
- label
identifiers:
type: object
additionalProperties:
type: object
properties:
id:
type: string
label:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
description:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
required:
- label
required:
- targetConcept
required:
- coordinates
- system
required:
- type
- axes
ranges:
additionalProperties:
type: object
description: Object representing a multidimensional (>= 0D) array with named axes, encoded as a flat one-dimensional array in row-major order
properties:
type:
enum:
- NdArray
dataType:
enum:
- float
- integer
- string
shape:
type: array
items:
type: number
axisNames:
type: array
items:
type: string
uniqueItems: true
values:
type: array
items:
type:
- number
- 'null'
minItems: 1
oneOf:
- properties:
values:
items:
type: number
- properties:
values:
items:
type: integer
- properties:
values:
items:
type: string
- properties:
shape:
minItems: 1
axisNames:
minItems: 1
required:
- shape
- axisNames
required:
- type
- dataType
- values
parameters:
additionalProperties:
type: object
description: Represents metadata about the values of the coverage
properties:
id:
type: string
type:
description: Type of the parameter object, must be "Parameter"
enum:
- Parameter
description:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
observedProperty:
type: object
description: A definition of the quantity being measured.
properties:
id:
type: string
label:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
description:
type: object
description: Object representing an internationalised string. TODO test that the keys are valid language identifiers
additionalProperties:
type: string
categories:
type: array
items:
type: object
properties:
id:
type: string
label:
type: object
description: Object representing an interna
# --- truncated at 32 KB (1153 KB total) ---
# Full source: https://raw.githubusercontent.com/api-evangelist/ogc/refs/heads/main/openapi/ogc-collection-data-queries-api-openapi.yml