The Quantitative Volcanic Ash information service provided by the London Volcanic Ash Advisory Centre supplies meteorological gridded data and spatial polygon data in response to tailored API requests submitted by an end user. Data is provided under the remit of the International Civil Aviation Organisation (ICAO) and in accordance with ICAO Annex 3 – Meteorological Service for International Air Navigation and ICAO Doc 10157 PANS-MET – Procedures for Air Navigation Services – Meteorology.
Applications:
Forecast data is available to download per unique volcanic eruption (for significant ash eruptions only) from two API endpoints, and organised in three collections:
1. The VAAC London QVA Gridded Data API provides two collections in netCDF format:
2. The VAAC London QVA Products API provides the ash polygon features in XML format as per the QVA IWXXM schema. Data consists of sets of polygons that represent the ash concentration when it exceeds each of the four following four thresholds in mg/m3: ≥0.2, ≥2.0, ≥5.0 and ≥10.0, where the ash plume is present in the atmospheric layer between FL000 and FL600. This collection has one dataset.
In addition, users can subscribe to receive notifications when new payloads are ready to collect from the APIs. Notifications are filtered based on 'topics’ to which they have subscribed.
Key features:
In the event of operational issues, from December 2025 the VAAC Toulouse Quantitative Volcanic Ash API service operated by Météo-France will provide backup.
The QVA service is available from 28 July 2025 for testing and set up, and for operational use from 27 November 2025.
", "serviceIdentification": { "name": "VAAC London Quantitative Volcanic Ash", "version": "1.0" }, "serviceProvider": { "name": "Met Office", "description": "The Met Office is the sole Air Navigation Service Provider (ANSP) certificated by the UK Civil Aviation Authority to provide and disseminate a range of aviation forecast products and services, in accordance with ICAO Annex 3 to the Chicago Convention, Meteorological Service for international Air Navigation.
ICAO’s Annex 3 provides the main regulatory framework against which the UK is obliged to provide meteorological services, and which the Met Office delivers Met Services against. This ensures that the UK meets its obligations to ICAO to provide safe, efficient and regular air travel.
These services fall into the following main categories:
a) UK services.
b) The World Area Forecast System (WAFS), as provided by World Area Forecast Centre (WAFC) London, in coordination with WAFC Washington.
c) SADIS (Secure Aviation Data Information Service).
d) The Volcanic Ash Advisory Centre (VAAC) London.
In addition to the ICAO Annex 3 determined services, a range of discretionary services that are determined as a requirement in the UK are also provided. Specific services such as Aviation R&D and the provision of information to NATS are examples of this.
", "type": [ "REGULATED_METEOROLOGICAL_SERVICE_PROVIDER" ], "pointOfContact": [ { "name": "Request Access to the Quantitative Volcanic Ash service", "role": "To request access to the Quantitative Volcanic Ash service, please send an e-mail to qva@metoffice.gov.uk", "contactInformation": [ { "type": "EMAIL", "address": "qva@metoffice.gov.uk" }, { "type": "EMAIL", "address": "servicedesk@metoffice.gov.uk" }, { "type": "PHONE", "address": "+44 330 135 0000" } ] }, { "name": "Technical Support", "role": "To report incidents on services in operation, contact the 24/7 Weather Desk.", "contactInformation": [ { "type": "EMAIL", "address": "servicedesk@metoffice.gov.uk" }, { "type": "PHONE", "address": "+44 330 135 0000" } ] } ] }, "serviceCategorisation": { "businessActivityType": [ "AIRSPACE_ORGANISATION_AND_MANAGEMENT" ], "intendedConsumer": [ "AERONAUTICAL_INFORMATION_SERVICE_PROVIDER", "AIR_TRAFFIC_SERVICE_PROVIDER", "CIVIL_AIR_NAVIGATION_SERVICE_PROVIDER", "CIVIL_AIRSPACE_USER", "NETWORK_MANAGER", "PROVIDER_OF_DATA_SERVICES", "REGULATED_METEOROLOGICAL_SERVICE_PROVIDER" ], "informationCategory": [ "AERONAUTICAL_INFORMATION_EXCHANGE", "METEOROLOGICAL_INFORMATION_EXCHANGE" ], "applicationMessageExchangePattern": [ { "name": "SYNCHRONOUS_REQUEST_REPLY" } ], "geospatialCategorisation": { "countryCode": [ "EGRR" ], "region": [ "EUR" ] }, "lifeCycle": [ { "lifeCycleStage": "OPERATIONAL" } ] }, "generalDescription": { "operationalEnvironment": { "operationalNeeds": [ { "name": "Operational needs for the Quantitative Volcanic Ash Service", "description": "As part of its responsibilities as the London Volcanic Ash Advisory Centre (VAAC) the Met Office is required to provide services related to volcanic ash as defined in ICAO Annex 3 Meteorological Service for International Air Navigation, and from 27 November 2025 ICAO Doc 10157 PANS-MET – Procedures for Air Navigation Services – Meteorology
The requirement to provide Quantitative Volcanic Ash Forecasts (QVA) is introduced with Amendment 82 to Annex 3, applicable 27 November 2025.
Responses to API requests are formatted as either:
- JSON. These describe the operation of the EDR API and the 'Collections’ which are available to download from the latest model update (which include a list of available datasets under each 'collection’ for the latest available model update).
- For the VAAC London QVA Gridded Data API, as NetCDF. These files contain the actual forecast data as grid points for the two gridded data collections:
- For the VAAC London QVA Products API, as IWXXM. These files contain the actual forecast data for the “qvaci_iwxxm” collection. It serves payloads in XML format as a set of polygons, each polygon representing the ash concentration when it exceeds set thresholds (≥0.2, ≥2.0, ≥5.0 and ≥10.0 mg/m3) for a specific timestep.
All the data sets will be provided covering the period from T+0 hour to T+24 hours at 3-hourly intervals from the time they are issued and will be updated every 6 hours while a significant ash cloud remains.
", "realWorldEffect": "REAL WORLD EFFECT - Consumers of the Service (Airlines, Air Navigation Service Providers, National Met Services, and companies that supply flight planning software and geospatial data visualisation services for the aviation industry) obtain volcanic ash forecasts to inform their decision-making regarding:- Volcanic ash hazard awareness and avoidance, for eruptions in the VAAC London area of responsibility (primarily Iceland);- Predicting dosages of Volcanic Ash for aircraft engine and airframe service scheduling." } ], "accessAndUseConditions": [ { "name": "OAUTH2 Client Credential/Bearer Token", "type": "SECURITY_CONSTRAINT", "description": "Accessing the service is subject to prior approval by the VAAC London Manager and agreeing to our terms and conditions.
Access is based on OAUTH2 Client Credentials using Client ID and Secret to retrieve a Bearer Token. Login credentials must be set up days in advance of first-time use.
Access to the two VAAC London's Quantitative Volcanic Ash APIs does NOT include reciprocal access to VAAC Toulouse QVA service, operated by Météo France. Should you wish to access VAAC Toulouse QVA service, then you must apply directly with Météo-France.
" }, { "name": "Token valid for 1 hour", "type": "SECURITY_CONSTRAINT", "description": "The access token is valid for one hour, therefore it must be regenerated after expiry.
" }, { "name": "Check Headers", "type": "SERVICE_CONSUMPTION_CONSTRAINT", "description": "The QVA APIs make use of standard HTTP headers, as specified in the SWIM Yellow Profile, WS Light Service Interface Binding.
" }, { "name": "Service Consumption Constraint", "type": "SERVICE_CONSUMPTION_CONSTRAINT", "description": "Usage is limited as per our throttling standard policies:
However, it is possible to download all data published for an individual volcano by making only four requests:
Please read the Terms and Conditions of the VAAC London Quantitative Volcanic Ash service.
" } ], "qualitiesOfService": { "performance": [ { "name": "Capacity of Service", "description": "The Service was load tested without any loss of performance against 400 unique users, 4 simultaneous volcanic events, and over a 10-minute window.
" } ], "reliability": [ { "name": "Service Level Agreement", "description": "The VAAC London Manager reports periodically to the UK Civil Aviation Authority (CAA) and International Civil Aviation Organization (ICAO), who oversee the provision of the Quantitative Volcanic Ash service.
VAAC performance is monitored and reported to the ICAO Met Panel International Airways Volcano Watch operations group (METP-WG-MOG-IAVW).
Forecast data itself is verified by the Met Office regularly.
" }, { "name": "Availability", "description": "The Service has been developed with high availability in mind and is monitored via synthetic canaries. The REST API collection endpoints are monitored against provisioning response payloads advertised as ready for collection.
During a significant volcanic event, qualified end users (duly authorised and authenticated via APIM) must be able to make EDR API requests >99% of the time:
Thereafter, and until the VAAC London forecasters decide that volcanic ash no longer represents a hazard to air traffic, the volcanic ash forecasts are updated at 6 hourly intervals and usually aligned to the main synoptic hours of 00UTC, 06UTC, 12UTC and 18UTC.
" }, { "name": "Recoverability", "description": "Technical support is available 24/7, although on a 'best efforts only' basis outside normal working hours (09:00-17:00 GMT Monday to Friday, except Bank Holidays).
In the event of operational issues, the equivalent VAAC Toulouse Quantitative Volcanic Ash API service is available for backup purposes (from December 2025).
" } ], "security": [ { "name": "Confidentiality", "description": "The Service adheres to SWIM Yellow Profile, WS Light - Infrastructure Capabilities Binding requirements.
The system does not store or manage any personal data. Threat analysis confirmed that loss of confidentiality is deemed Low Risk.
" }, { "name": "Integrity", "description": "The Met Office has robust Cyber Security protocols in place. In the unlikely event of a security breach impacting the integrity of the data, the Service will be suspended, and VAAC London would notify users to fail over to VAAC Toulouse equivalent Quantitative Volcanic Ash service until security has been fully restored.
" } ] }, "dateInOperation": "2025-07-28", "validation": [ { "type": "SELF_VALIDATION", "description": { "validationSteps": "Validation is carried out at least once every 12 months.", "validationResults": "For a report of the achieved results, please email qva@metoffice.gov.uk.", "evidence": "VAAC London's forecasting team validate the volcanic ash outputs every time they use the atmospheric model.\r\n\r\nThe scientists from the Met Office's Atmospheric Dispersion and Air Quality team are responsible for the accuracy of the atmospheric model and test it regularly." } } ], "abbreviations": [ { "name": "API", "description": "Application Programming Interface.
\r\n" }, { "name": "APIM", "description": "API Management - the API management platform used for Authentication and Authorisation that is integrated with the QVA Service. APIM acts as the 'front door' of the QVA APIs for our users.
\r\n" }, { "name": "Collection", "description": "A set of forecast data for one or more related meteorological parameters.
\r\n" }, { "name": "Dataset", "description": "A set of forecast data nested under a 'collection'.
\r\n" }, { "name": "Deterministic collection", "description": "The 'qva_deterministic' forecasts the expected ash concentration as a deterministic gridded forecast for a specific timestep. It includes one dataset. You cannot filter payloads to receive only one threshold.
\r\n\r\nDatasets are provided for twelve vertical slices of the atmosphere between the ground and 60,000ft (Flight level 600), each 5000ft thick.
\r\n\r\nPayloads are in netCDF format.
\r\n" }, { "name": "EDR", "description": "Means the OGC Environmental Data Retrieval standard. To learn more, please visit: https://ogcapi.ogc.org/edr/
\r\n" }, { "name": "FL", "description": "Flight Level.
\r\n" }, { "name": "Gridded data", "description": "Gridded data refers to climate data that has been spatially interpolated onto a regular grid, creating a consistent and complete spatial representation of weather or climate variables across a specific region.
\r\n\r\nVAAC London QVA Gridded Data API's gridded data covers the entirety of an ash plume resulting from a volcanic eruption in Iceland, however wide the plume extends across the globe.
\r\n" }, { "name": "ICAO", "description": "The International Civil Aviation Organisation - It is a specialized agency of the United Nations that coordinates the principles and techniques of international air navigation. ICAO develops standards and recommended practices for international aviation to ensure safe, efficient, and orderly global air transport.
\r\n" }, { "name": "IWXXM", "description": "ICAO Meteorological Information Exchange Model (IWXXM) is a standardized format for exchanging meteorological information used in aviation. It's an XML-based model designed to represent aviation weather information, including reports like METAR/SPECI, TAF, SIGMET, and features/objects like ash concentration forecasts in the forms of polygons. IWXXM is part of the broader SWIM (System Wide Information Management) initiative within ICAO, alongside FIXM and AIXM.
\r\n" }, { "name": "IWXXM Collection", "description": "The 'qvaci_iwxxm' collection consists of sets of polygons that show the expected ash areas for where ash exceeding the four concentration thresholds (0.2mg/m3, 2mg/m3, 5mg/m3 and 10mg/m3) is expected to occur. It includes one dataset, which provides only the vertical levels where the ash plume is present in the atmospheric layer between FL000 and FL600.
\r\n\r\nThe IWXXM objects/polygons represent a subset of the gridded data with each spanning the minimum to maximum height for a given threshold. All the data sets are provided covering the period from T+0 hour to T+24 hours at 3-hourly intervals from the time they are issued. In the case of a significant volcanic eruption in Iceland, the IWXXM data will be updated every 6 hours while a significant ash cloud remains.
\r\n\r\nPayloads are in XML format, as per the IWXXM schema https://schemas.wmo.int/iwxxm/2025-2RC1/WAFSSigWxFC.xsd. Please note this is currently a release candidate, so it may be subject to further adjustment before it comes into effect in November 2025.
\r\n\r\nPlease note that you cannot filter the IWXXM payloads to receive polygons for only one concentration threshold. The API response will return all the data for a particular forecast timestep.
\r\n" }, { "name": "Model run", "description": "A model run is the date and time associated to when an instance of the NAME model is started. London VAAC volcanic ash forecasts are generated by our team of forecasters using an atmospheric transport and dispersion model called NAME. The model represents the expected behaviour of the volcanic ash cloud, the direction and speed of travel as well as processes which act to remove ash from the atmosphere: through precipitation, sedimentation (falling out through gravity) and interaction with the Earth’s surface.
\r\n\r\nAfter the initial model run is used to produce the very first volcanic ash forecasts following a significant volcanic event, our forecasting team will update the forecasts every 6 hours, up until the time ash is no longer discernible.
\r\n" }, { "name": "OGC", "description": "Open Geospatial Consortium. OGC is a consortium of experts committed to improving access to geospatial, or location information.
\r\n" }, { "name": "Probabilistic collection", "description": "The 'qva_probabilistic' collection forecasts the likelihood of ash concentration exceeding four set thresholds in mg/m3: ≥0.2, ≥2.0, ≥5.0 and ≥10.0. It includes four separate datasets (one per threshold).
\r\n\r\nDatasets are provided for twelve vertical slices of the atmosphere between the ground and 60,000ft (Flight level 600), each 5000ft thick.
\r\n\r\nPayloads are in netCDF format.
\r\n" }, { "name": "QVA", "description": "Quantitative Volcanic Ash. QVA forecasts provide higher resolution information on the location of ash in the atmosphere than the traditional volcanic ash advisory (VAA) products and unlike the VAA, also include ash concentration information. QVA also offers operators the opportunity to move away from the traditional ‘discernible ash’- based criteria for avoiding ash and instead use certified engine susceptibility volcanic ash exposure thresholds for flight route planning and inflight replanning. Operators with approval and procedures/practices will be able to use QVA information to fly more efficient routes while maintaining safety in accordance with their safety management program.
\r\n" }, { "name": "Timestep", "description": "Means “forecast period”. A period of time for which forecast data is given, usually expressed as the number of hours after the model run time, e.g. T+6 means 6 hours after the model run time.
\r\n" }, { "name": "VAAC London", "description": "Volcanic Ash Advisory Centre.
\r\n\r\nVAAC London is an ICAO designated centre, responsible for issuing advisories for volcanic eruptions originating in Iceland and the north-eastern corner of the North Atlantic. It is operated by the Met Office.
\r\n\r\nVAAC London is one of 9 Volcanic Ash Advisory Centres worldwide, and has specialist forecasters who produce volcanic ash advisories and guidance products using a combination of volcano data; satellite-based, ground-based and aircraft observations; weather forecast models and dispersion models. The volcanic ash forecasts are provided to the standards and tolerances set by the regulator and ICAO.
\r\n\r\nThe forecasts produced by a VAAC are provided to support the aviation industry.
\r\n\r\nWe provide a reciprocal back-up facility with Toulouse VAAC, operated by Météo-France.
\r\n" }, { "name": "WMO", "description": "The World Meteorological Organization is a specialised agency of the United Nations responsible for promoting international cooperation on atmospheric science, climatology, hydrology and geophysics. The WMO is responsible for the IWXXM schematron used for the provision of the volcanic ash polygon data sets.
\r\n" } ] }, "informationDescription": { "informationDefinition": { "reference": [ { "description": "The QVA APIs are EDR compliant.
\r\n", "url": "https://ogcapi.ogc.org/edr/" } ] } }, "technicalDescription": { "technicalConstraint": [ { "name": "Sign up", "description": "Please contact qva@metoffice.gov.uk for details about signing up to the QVA service.
" }, { "name": "OAuth Authentication", "description": "The authentication mechanism supported is HTTP Bearer Client Authentication.
" }, { "name": "Integration Pattern", "description": "REST API.
" }, { "name": "Security Mechanism", "description": "TLS 1.2
The service uses HTTPS over TLS 1.2 to provide integrity and confidentiality.
" } ], "serviceMonitoring": { "monitoringDescription": "The QVA APIs are monitored and integrate automated alerts that reach 24/7 Met Office support teams. However, no consumer visible monitoring capabilities are provided.
\r\n
\r\nThe generation of forecast data are triggered on the successful ingestion of requisite base components (push).
Appropriate logging, monitoring and alerting are in place 24/7.
\r\n" }, "behaviour": [ { "name": "HTTP Response Codes", "description": "Refer to the API Open API/Swagger documentation for guidance.
| EDR Response code and name | Code Meaning/Possible reasons | Impact and suggested actions |
|---|---|---|
| 200 (OK) | Description: The request is successful. | Expected behaviour, you can access the data. |
| 302 (Found) | Description: Redirect status response code indicating that the resource requested has been temporarily moved to the URL given by the Location header. | Expected behaviour for retrieving location ID ( |
| 400 (Bad Request) | Description: The server cannot or will not process the request due to an apparent client error. For example, a query parameter had an incorrect value Possible Reasons: You may have included an invalid value for the | a) Check the error message returned in the API response, and b) Adjust the parameter reported within the error message as being problematic. e.g. collection ID, location ID ( The API Open API/Swagger documentation should also be consulted if necessary for implementation guidance. |
| 401 (Unauthorized Request) | Description: The request requires user authentication. The response includes a WWW-Authenticate header field containing a challenge applicable to the requested resource. Possible Reasons You may not have included your credentials in the request header or there could be a problem with the user credentials supplied. | You cannot access the data due to invalid authorisation. Please check that your authorisation token is valid and has not expired, and try again. Please ensure you followed the setup instructions communicated to you by the QVA Manager. |
| 403 (Forbidden) | Description: The server understood the request, but is refusing to fulfil it. While status code 401 indicates missing or bad authentication, status code 403 indicates that authentication is not the issue, but the client is not authorized to perform the requested operation on the resource. Possible Reasons: Your request has been rejected as you do not have the rights to access or view the content. This error can be returned by an origin due to an application firewall or other reason at the custom origin. | This error code could be returned if, for example, your token has expired, or if you exceeded the number of requests specified by our Throttling policy limits. Please note that OAuth2 tokens are only valid for one hour. Please refresh your token if it has expired. Additionally, you may need to make a further request to the |
| 404 (Not Found) | Description: The requested resource does not exist on the server. For example, a path parameter had an incorrect value. Possible Reasons: You have entered an invalid URL, invalid collection name or location ID. You may be attempting to access a resource that has not yet been published. | You should first check that your request is valid, in case you may have specified an invalid URL. Please note:
|
| 500 (Internal Server Error) | Description: An internal error occurred in the server. Possible Reasons: This could indicate that a Lambda function in our own systems returned an execution error. | You cannot access the data. Please try again. If the error persists, please contact our Support teams. |
| 502 (Bad Gateway) | Description: This error response means that the server, while working as a gateway to get a response needed to handle the request, got an invalid response. Possible Reasons: It could indicate our server could not return the requested object because it couldn't connect to the origin server. | You cannot access the data. Please try again. If the error persists, please contact our Support teams. |
| 504 (Gateway Timeout) | Description: While the request appears to be valid, the server failed to complete it in a timely manner. | You cannot access the data. Please try again. If the error persists, please contact our Support teams. |
Each operation of the interface can be called independently.
" } ] }, "references": { "serviceDocument": [ { "documentType": "SERVICE_BEHAVIOUR_DESCRIPTION", "title": "User Guide", "version": "1.0", "description": "A full User Guide is published on the Met Office website:
https://www.metoffice.gov.uk/services/transport/aviation/regulated/international-aviation/vaac/qva/qva-api
The guide will be reviewed annually and updated when changes are made to the QVA Service or data provided.
" } ], "implementedStandard": [ { "title": "Environmental Data Retrieval (EDR)", "version": "1.0", "description": "Please see references to EDR website and specifications: https://ogcapi.ogc.org/edr/
", "standardType": "SERVICE_STANDARD", "conformanceStatement": "Adheres to EDR service standard." }, { "title": "EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile", "version": "1.1", "description": "The VAAC London QVA API conforms to the EUROCONTROL SWIM ‘Yellow Profile’ technical specification https://www.eurocontrol.int/publication/eurocontrol-specification-swim-technical-infrastructure-ti-yellow-profile
", "standardType": "EUROCONTROL_SPECIFICATION_FOR_SWIM_TECHNICAL_INFRASTRUCTURE", "conformanceStatement": "The VAAC London QVA API conforms to the EUROCONTROL SWIM ‘Yellow Profile’ technical specification https://www.eurocontrol.int/publication/eurocontrol-specification-swim-technical-infrastructure-ti-yellow-profile" }, { "title": "ICAO Global Air Navigation Plan (GANP) (Doc 9750)", "version": "Doc 9750", "description": "In accordance with the ICAO Global Air Navigation Plan (GANP) (Doc 9750) https://www4.icao.int/ganpportal/, the VAAC London QVA API has been built in accordance with the System Wide Information Management (SWIM) requirements.
", "standardType": "SERVICE_STANDARD", "conformanceStatement": "In accordance with the ICAO Global Air Navigation Plan (GANP) (Doc 9750) https://www4.icao.int/ganpportal/, the VAAC London QVA API has been built in accordance with the System Wide Information Management (SWIM) requirements." }, { "title": "IWXXM Schema", "version": "2025-2R1", "description": "The downloaded IWXXM data (.xml) will return all the information within a single file. This will adhere to the schema IWXXM Schematrons published here: https://schemas.wmo.int/iwxxm/
Note: up until late November 2025 the 2025-2R1 schematron is used, and when the final candidate version published (version 2025-2) the system will be updated to reflect it. If further changes are made to the schematrons by WMO further updates will be made, potentially coordinated with the other VAAC’s and you will be notified in advance that it will be changing.
", "standardType": "SERVICE_STANDARD", "conformanceStatement": "The VAAC London Quantitative Volcanic Ash Products API adheres to the schema IWXXM Schematrons version 2025-2R1.Note: up until late November 2025 the 2025-2R1 schematron is used, and when the final candidate version is published (version 2025-2) the system will be updated to reflect it. If further changes are made to the schematrons by WMO further updates will be made, potentially coordinated with the other VAAC’s and you will be notified in advance that it will be changing" } ] }, "serviceInterface": [ { "name": "VAAC London QVA Gridded Data API", "description": "The VAAC London QVA Gridded Data API supplies meteorological gridded data in response to tailored API requests.
Data is provided under the remit of the International Civil Aviation Organisation (ICAO) and can be used to support activities related to aviation. Specifically, it enables aviation end users operate more effectively in airspaces affected by volcanic eruptions emanating from Iceland.
This API includes two collections in netCDF format as response payloads:
The VAAC London QVA Gridded Data API provides gridded meteorological forecasts in netCDF files in response to tailored API requests.
It 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.
", "messages": [ { "name": "HTTP GET", "direction": "OUT" } ] } ], "endpoints": [ { "name": "GET / EDR root data entrypoint", "description": "This endpoint is the root for the VAAC London QVA Gridded Data API.
Querying this endpoint returns static metadata in JSON format with this information:
Querying this OpenAPI endpoint returns static metadata in JSON format with this information:
Querying this endpoint returns static metadata in JSON format providing information about the OGC conformance classes implemented by the API.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-gridded-data/1.0/conformance" }, { "name": "GET /collections", "description": "This endpoint returns metadata in JSON format about the \"qva_probabilistic\" and \"qva_deterministic\" collections that are available to be queried. Metadata includes:
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-gridded-data/1.0/collections" }, { "name": "GET /collections/{collectionId}/locations", "description": "
This is also the endpoint that you can query to find out the applicable volcano for which forecast data is available. If forecasts are available for multiple volcanic eruptions, then multiple \"volcano_id\" may be listed.
Response is a JSON file.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-gridded-data/1.0/collections" }, { "name": "Get /collections/{collectionId}/locations/{locationId}", "description": "This is the endpoint you query to retrieve the volcanic ash forecast in a specific collection {collectionId} for a specific volcano_id {locationId}.
For example, requesting data in the ‘qva_probabilistic’ collection for volcano_id 372070 (Hekla in Iceland): https://gateway.api-management.metoffice.cloud/vaac-london-qva-gridded-data/1.0/collections/qva_probabilistic/locations/372070
For example, requesting data in the ‘qva_probabilistic’ collection for volcano_id 372070 (Hekla in Iceland): https://gateway.api-management.metoffice.cloud/vaac-london-qva-gridded-data/1.0/collections/qva_deterministic/locations/372070
A successful request for data will return a “302 Found” response code with a redirect link in the Location header of the response, which you can use to download the requested dataset. The link is valid for one hour.
The payload response is in netCDF format. When following the Redirected URL, you will get a 200 response and the requested binary netCDF data, which you can save as an .nc file in your systems.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-gridded-data/1.0/collections/qva_deterministic/locations" } ], "serviceInterfaceBinding": { "name": "SWIM_TI_YP_1_0_WS_LIGHT", "description": "The Service Interface Binding is SWIM Yellow Profile Compliant, using WS Light enabling HTTP GET requests and associated responses.
\r\n\r\nThe Service implementation conforms with IPV4_SECURE_UNICAST as part of SWIM Yellow Profile requirements.
\r\n" }, "messageExchangePattern": "SYNCHRONOUS_REQUEST_RESPONSE" }, { "name": "VAAC London QVA Products API", "description": "The VAAC London QVA Products API supplies spatial polygon data in response to tailored API requests.
Data is provided under the remit of the International Civil Aviation Organisation (ICAO) and can be used to support activities related to aviation. Specifically, it enables aviation end users operate more effectively in airspaces affected by volcanic eruptions emanating from Iceland.
This API includes forecast polygons of volcanic ash, with payloads in XML format as per the IWXXM schema. Data consists of sets of polygons that represent the ash concentration when it exceeds each of the four following four thresholds in mg/m3: ≥0.2, ≥2.0, ≥5.0 and ≥10.0, where the ash plume is present in the atmospheric layer between FL000 and FL600. This collection has one dataset.
", "provisionSide": "PROVIDER_SIDE", "operations": [ { "name": "HTTP GET", "description": "The VAAC London QVA Products API provides meteorological forecasts as XML files.
It 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.
", "messages": [ { "name": "HTTP GET", "direction": "OUT" } ] } ], "endpoints": [ { "name": "GET / EDR root data entrypoint", "description": "This endpoint is the root for the VAAC London QVA Products API.
Querying this endpoint returns static metadata in JSON format with this information:
Querying this OpenAPI endpoint returns static metadata in JSON format with this information:
Querying this endpoint returns static metadata in JSON format providing information about the OGC conformance classes implemented by the API.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-products/1.0/conformance" }, { "name": "GET /collections", "description": "This endpoint returns metadata in JSON format about the \"qvaci_iwxxm\" collections that is available to be queried. Metadata includes:
Get information about the \"qva_iwxxm\" {collectionId}. It is the ‘source of truth’ to check which data has been generated and is ready to download. This is the endpoint that you can query to find out the applicable \"volcano_id\" for which forecast data is available. You can then use \"volcano_id\" to build your API request.
Response is a JSON file.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-products-data/1.0/collections/qvaci_iwxxm" }, { "name": "GET /collections/{collectionId}/locations", "description": "Get information about all the available locations data (displayed as ‘volcano_id’) in the \"qvaci_iwxxm\" {collectionId}.
This is also the endpoint that you can query to find out the applicable volcano for which forecast data is available. If forecasts are available for multiple volcanic eruptions, then multiple \"volcano_id\" may be listed.
Response is a JSON file.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-products-data/1.0/collections/qvaci_iwxxm/locations" }, { "name": "Get /collections/{collectionId}/locations/{locationId}", "description": "This is the endpoint you query to retrieve the volcanic ash forecast in the \"qvaci_iwxxm\" {collectionId} for a specific \"volcano_id\"/{locationId}.
Example URL for requesting data in the \"qvaci_iwxxm\" collection for \"volcano_id\" 372070 (Hekla in Iceland): https://gateway.api-management.metoffice.cloud/vaac-london-qva-products/1.0/collections/qvaci_iwxxm/locations/372070
A successful request for data will return a “302 Found” response code with a redirect link in the Location header of the response, which you can use to download the requested dataset. The link is valid for one hour.
Response is in XML format. When following the Redirected URL, you will get a 200 response and the requested data, which you can save as an .xml file in your systems.
", "url": "https://gateway.api-management.metoffice.cloud/vaac-london-qva-products/1.0/collections/qvaci_iwxxm/locations" } ], "serviceInterfaceBinding": { "name": "SWIM_TI_YP_1_0_WS_LIGHT", "description": "The Service Interface Binding is SWIM Yellow Profile Compliant, using WS Light enabling HTTP GET requests and associated responses.
\r\n\r\nThe Service implementation conforms with IPV4_SECURE_UNICAST as part of SWIM Yellow Profile requirements.
\r\n" }, "messageExchangePattern": "SYNCHRONOUS_REQUEST_RESPONSE" } ] } }