Provides tiles of meteorological gridded data in response to tailored API requests submitted by an end user. This data is provided under the remit of the International Civil Aviation Organisation (ICAO) and can be used to support activities related to aviation.
Operations
The Service provides meteorological forecasts as GRIB2 response payloads. Within each request, consumers can specify a single 'item' (parameter) either for one global 'tile' (the forecast for the selected parameter for the whole globe per timestep group), or for one of 8 pre-set regional 'tiles'.
The Service also provides end users the ability to request metadata about the meteorological forecast included in the forecasts, returning a response in .json format.
Synchronous: Transactions are synchronous.
TI Protocol Method: HTTP GET
Precondition: Consumers must be authenticated and authorised via the Met Office API Management (APIM) Developer portal.
Processing consideration: The service shall provide only the latest available data.
Endpoints
This endpoint is the root for the Gridded Data API service.
Querying this endpoint returns static metadata in JSON format with this information:
- Service description and keywords
- Provider name and contact details
- List of endpoints accessible via the Service
Querying this OpenAPI endpoint returns static metadata in JSON format with this information:
- API definition
- EDR specifications
Querying this endpoint returns static metadata in JSON format providing information about the OGC conformance classes implemented by the Service.
This endpoint returns metadata in JSON format about each 'collection' (data set) available to be queried:
- Collection ID
- Parameters and relevant measurement unit
- Forecast timesteps available
URL: https://gateway.api-management.metoffice.cloud/sadis-wafs-gridded-data/…/{collectionId}
Querying this end point returns metadata information in JSON format about one of these specific collections {collectionId}:
- egrr_wafs_windtempgeo_0p25
- egrr_wafs_humidity_0p25
- egrr_wafs_tropjet_0p25
- egrr_wafs_windtempgeo_1p25
- egrr_wafs_humidity_1p25
- egrr_wafs_tropjet_1p25
- egrr_wafshzds_blended_ice_0p25
- egrr_wafshzds_blended_turb_0p25
- egrr_wafshzds_blended_cb_0p25
- kwbc_wafs_windtempgeo_0p25
- kwbc_wafs_humidity_0p25
- kwbc_wafs_tropjet_0p25
- kwbc_wafs_windtempgeo_1p25
- kwbc_wafs_humidity_1p25
- kwbc_wafs_tropjet_1p25
- kwbc_wafshzds_blended_ice_0p25
- kwbc_wafshzds_blended_turb_0p25
- kwbc_wafshzds_blended_cb_0p25
URL: https://gateway.api-management.metoffice.cloud/sadis-wafs-gridded-data/…{collectionId}/items
Querying this end point returns metadata information in JSON format listing the available items, each with an 'itemId' and its associated metadata, that can be requested from a specified collection {collectionId}.
The 'itemId' naming standard is described in section 4.1 of the SADIS API - User Guide.
URL: https://gateway.api-management.metoffice.cloud/sadis-wafs-gridded-data/…{collectionId}/items/{itemId}
Querying this end point with the 'itemId' within a specified collection {collectionId} returns forecast data and associated metadata for this parameter e.g. Temperature, Geopotential Height, Relative Humidity, etc.
The success response is a 302 redirect, which directs you to the GRIB2 file payload of the requested item. The item payload contains the forecast data for all pressure levels for the relevant forecast timesteps and parameter(s), as specified by the 'itemId'.
The 'itemId' naming standard is described in section 4.1 of the SADIS API - User Guide.
Service Interface Binding
The Service Interface Binding is SWIM Yellow Profile Compliant, using WS Light enabling HTTP GET requests and associated responses.
- The Service shall return a .json response for metadata requests:
- OpenAPI:
- / gets the EDR root data entrypoint
- /api gets the EDR spec for exposed endpoints
- /conformance gets the conformance data for the API
- Collections data:
- /collections gets the end point that contains information about all the collections available
- /collections/{collectionId} gets the end point that contains information about an individual collection {collectionId}
- Item data: /collections/{collectionId}/items gets the end point that contains information about items available in an individual collection {collectionId}
- OpenAPI:
- Request for meteorological forecast data shall return a response as a 302 URL redirect to the GRIB2 payload:
- Item data: /collections/{collectionId}/items/{itemsId} gets the end point for forecast data contained in the {itemId} item from an individual collection {collectionId}
Network Interface Binding
The Service implementation conforms with IPV4_SECURE_UNICAST as part of SWIM Yellow Profile requirements.