service definitions for meteorological information services
Quantitative Volcanic Ash Information Subscription and Request Service - Service Definition
Service Definition Identification
service definition identification | title | Service definition for the Quantitative Volcanic Ash Information Subscription and Request Service |
---|---|---|
edition | 00.00.05 | |
reference date | 2024-07-01 |
Service Identification
service identification | service name | Quantitative Volcanic Ash Information Subscription and Request Service |
---|
Service Abstract
service abstract | The Quantitative Volcanic Ash Information Subscription and Request Service allows the service consumer to get quantitative volcanic ash information in accordance with ICAO Annex 3 Amdt 82 and PANS-MET. The service consumer can subscribe to the service to receive notification when a new significant ash cloud occurs. It is also possible to send a direct request, using a request-reply mechanism, to the service to get the relevant quantitative volcanic ash information. The meteorological information is issued by the designated Volcanic Ash Advisory Centre (VAAC). The meteorological information is only intended to be used by service consumers within the aviation domain. |
---|
Service Definition Provider
service definition provider | name | EUROCONTROL |
---|---|---|
description | EUROCONTROL is an intergovernmental organisation with 41 Member and 2 Comprehensive Agreement States. | |
point of contact | swim@eurocontrol.int |
Geographical Extent of Information
geographical extent of information | The service shall offer quantitative volcanic ash information resulting from volcanic eruptions occurring in the service provider's area of responsibility, except when the responsibility of publishing this information has been transferred to another VAAC due to the ash cloud moving into the area of responsibility of this VAAC. The service shall offer the equivalent quantitative volcanic ash information for the areas of responsibility for which the service provider acts as back-up during outages. The service shall offer quantitative volcanic ash information resulting from volcanic eruptions occurring outside the service provider's area of responsibility, when the responsibility of publishing this information has been transferred by another VAAC due to an interruption of the operation. Note: the back-up arrangements are based on mutual agreements between Volcanic Ash Advisory Centre service providers. Note: the ash cloud may extend beyond the area of responsibility. |
---|
Service Categories
service categories | category | category name | regulated information exchange |
---|---|---|---|
value | |||
scheme | |||
category | category name | information domain | |
value | METEOROLOGICAL_INFORMATION | ||
scheme | https://reference.swim.aero/information-services/service-categories/CodeInformationDomainType.html | ||
category | category name | business activity | |
value | |||
scheme | http://reference.swim.aero/information-services/service-categories/CodeBusinessActivityType.html | ||
category | category name | intended service consumer | |
value | |||
scheme | https://reference.swim.aero/information-services/service-categories/CodeStakeholderType.html | ||
category | category name | intended service provider | |
value | |||
scheme | http://reference.swim.aero/information-services/service-categories/CodeStakeholderType.html | ||
category | category name | service type | |
value |
| ||
scheme | http://reference.swim.aero/information-services/service-categories/CodeServiceType.html |
Service Standard Reference
Explanatory note
This field is left empty. It is expected that the service definition developed in Europe by MET3SG will reference any ICAO-level information service definition.
service standard reference | reference | |
---|---|---|
implemented options | ||
deviations/additions |
Operational Environment
operational environment | operational needs | ICAO Annex 3 Amdt 82 and PANS-MET requires that quantitative volcanic ash (QVA) concentration information is provided by designated Volcanic Ash Advisory Centres (VAAC) as part of the International Airways Volcano Watch (IAVW) framework overseen by the International Civil Aviation Organization (ICAO). The quantitative volcanic ash (QVA) concentration information is provided per volcano in the form of a high-resolution four-dimensional representation of a volcanic ash cloud based on 3-hourly timesteps. New information is provided when there is a significant change in the erupting characteristics or at 6 hourly intervals until the ash is no longer present. The information is intended for use in operator’s flight planning and decision support systems allowing, e.g., more efficient routes in accordance with their safety management programme during significant volcanic ash cloud events. | |
---|---|---|---|
capabilities | The service provides high quality, up-to-date, trusted, regulated meteorological information in digital form for use by service consumers within the aviation domain. | ||
information exchange requirements | The service takes into account the following information exchange requirements:
|
Service Functions
service functions | function | name | Request list of volcanoes |
---|---|---|---|
description | The service consumer may be able to request a list of volcanoes for which there is information. | ||
real-world effect | The service consumer receives the list of volcanoes to use in further functions. | ||
function | name | Request quantitative volcanic ash information | |
description | The service consumer shall be able to request the latest quantitative volcanic ash information filtered by erupting volcano number, forecast timesteps and logical (e.g. severity threshold) operators. | ||
real-world effect | The meteorological information is received and can be used in ATM and other systems. | ||
function | name | Request the information in a specific format | |
description | The service consumer shall be able to request that the quantitative volcanic ash information be returned as polygons (IWXXM) and/or deterministic gridded data (NetCDF) and/or probabilistic gridded data (NetCDF). | ||
real-world effect | The meteorological information is received in the specified format and can be used in ATM and other systems. | ||
function | name | Subscribe to quantitative volcanic ash information | |
description | The service consumer shall be able to subscribe in order to receive notifications when a significant volcanic ash cloud occurs and unsubscribe when needed. | ||
real-world effect | The service consumer subscribes to the service and will receive notifications as per the subscription or unsubscribes from the service. | ||
function | name | Distribute notification | |
description | The service shall distribute a notification detailing how to access the quantitative volcanic ash information when a significant volcanic ash cloud occurs. | ||
real-world effect | The service consumer receives notifications with details on how to access the relevant QVA information. |
Service Access and Use Conditions
service access and use conditions | legal constraints | ||
---|---|---|---|
service policies | business policy | It shall be made clear to new service consumers that they must also enter an agreement with the back-up VAACs in case they need to revert to the back-up. | |
operational policy | There shall be a service policy to ensure that only service consumers within the aviation domain can use the service. The service policy shall include a requirement that service consumers cannot pass the information obtained from the service to non-aviation users without prior authorisation from the service provider. | ||
technical policy | |||
service consumption constraints | There shall be a service consumption constraint to ensure that a service consumer does not impose undue loads on computer and network resources, for example, by polling it at a higher frequency than the status is normally provided. |
Security Constraints
security constraints | authentication | The service shall ensure consumer authentication in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0042. The service shall ensure provider authentication in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0042. |
---|---|---|
authorisation | The service shall ensure that satisfactory authorisation is put in place in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile requirement SWIM-TIYP-0070. | |
confidentiality | The service shall ensure point-to-point confidentiality in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of Transport Layer Security (TLS) 1.2 or above. | |
integrity | The service shall ensure point-to-point integrity in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of Transport Layer Security (TLS) 1.2 or above. |
Quality of Service
quality of service | performance | capacity | The service shall achieve a quality that is sufficient to ensure the service is fit for purpose. The service should ensure that a single user is unable to monopolise a service or to degrade it below agreed service levels for others users. |
---|---|---|---|
response time | The service shall achieve a quality that is sufficient to ensure the service is fit for purpose. | ||
reliability | availability | The service shall achieve a quality that is sufficient to ensure the service is fit for purpose. Note: the following factors must be used in deciding the fitness for purpose:
| |
recoverability | The service shall achieve a quality that is sufficient to ensure the service is fit for purpose. | ||
security | confidentiality | The service shall ensure confidentiality by using SWIM Technical Infrastructure (TI) Yellow Profile bindings. | |
integrity | The service shall ensure integrity by using SWIM Technical Infrastructure (TI) Yellow Profile bindings. |
Quality of Data
quality of data | The quality of quantitative volcanic ash information offered by the service shall be verified by the service provider. Information on the quality of the QVA information offered by the service shall be reported annually to the ICAO Met Panel Met Operations working group relating to the IAVW who provide oversight of QVA data provision |
---|
Source of Information
source of information | source | The service provider shall ensure that the quantitative volcanic ash information offered by the service is based on data received from the appropriate authorised originating sources. This includes:
Note: EUMETSAT may be used to make sure the ash plume corresponds to where it is already being detected by the satellites. |
---|---|---|
modifications | Note: atmospheric modelling techniques are used to generate the output. |
Service Validation Information
Explanatory note
This field is left empty.
service validation information | description |
---|
Application Message Exchange Pattern
application message exchange pattern |
---|
Service Behaviour
service behaviour | typical behaviour | The service behaviour shall be in accordance with the patterns detailed in the Message Exchange Patterns: Identification Guidelines. The typical service behaviour, is:
The interfaces that support the service have different behaviour. A combination of an AMQP 1.0 implementation and an OGC implementation shall be used for the basic behaviour. The typical behaviour for PUBLISH_SUBSCRIBE means that:
The typical behaviour for SYNCHRONOUS_REQUEST_REPLY (as used in Quantitative Volcanic Ash Information Subscription and Request Service Request Interface) is as follows:
|
---|
Service Monitoring
service monitoring | A service monitoring mechanism should be made available to service consumers and alert them when the service is unavailable so that they can switch to the back-up service. |
---|
Service Interfaces
service interfaces | interface | name | Quantitative Volcanic Ash Information Subscription and Request Service Request Interface |
---|---|---|---|
description | Allows the service consumer to request filtered quantitative volcanic ash information. Note: this interface is used to group the operations offered by the chosen OGC standard. | ||
provider/consumer side | Provider side | ||
interface | name | Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface | |
description | Allows the service consumer to subscribe to the service. It allows the service consumer to manage the subscriptions e.g. to unsubscribe. Note: this can be handled by a separate dedicated subscription service. Note: some service providers will prefer to receive subscription requests by email. | ||
provider/consumer side | Provider side | ||
interface | name | Quantitative Volcanic Ash Information Subscription and Request Service Distribution Interface | |
description | Allows the service provider to distribute notifications when a new significant ash cloud occurs meeting the need of the service consumer that has subscribed for updates. | ||
provider/consumer side | Consumer side |
SWIM TI Profile and Interface Bindings
Quantitative Volcanic Ash Information Subscription and Request Service Request Interface
SWIM TI profile and interface bindings | profile name | EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile |
---|---|---|
profile version | 1.1 | |
selected service interface binding | WS_LIGHT | |
selected network interface binding | The service shall use the network bindings of the SWIM TIYP. | |
description | The interface shall use at least one of the following OGC standards:
Note: it is expected that the service will implement the OGC API – Environmental Data Retrieval Standard by November 2026. |
Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface
SWIM TI profile and interface bindings | profile name | EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile |
---|---|---|
profile version | 1.1 | |
selected service interface binding | ||
selected network interface binding | The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile. | |
description |
Quantitative Volcanic Ash Information Subscription and Request Service Distribution Interface
SWIM TI profile and interface bindings | profile name | EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile |
---|---|---|
profile version | 1.1 | |
selected service interface binding | SWIM_TI_YP_1_1_AMQP_MESSAGING | |
selected network interface binding | The service shall use the network bindings of the SWIM TIYP. | |
description | AMQP 1.0 shall be used to distribute messages as explained in the Publish/Subscribe Push MEP: Implementation Guidance. |
Service Interface Protocols and Data Format
service interface protocols and data format | transport / messaging protocols | The service shall use TLS1.2 or later in accordance with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile. |
---|---|---|
data format | This is captured at Service Message level (see below). WS_LIGHT does not mandate a data format. The header expresses what is used. |
Service Operations
Quantitative Volcanic Ash Information Subscription and Request Service Request Interface
Explanatory note
The OGC Web Feature Service Interface Standard, Web Coverage Service (WCS) Interface Standard and OGC API – Environmental Data Retrieval Standard are used to implement the service operations.
It is not the intention to repeat the standardised operations here. However, the table below illustrates how the WFS GetFeature operation would look in the context of this service.
Service operations | operation | operation name | GetFeature |
---|---|---|---|
description | The WFS GetFeature operation returns a selection of features from a data store. It responds to a GetFeature Request message with a Quantitative Volcanic Ash Information Message that satisfies the query expressions specified in the request. | ||
messages | Request, Quantitative Volcanic Ash Information Message |
Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface
Service operations | reference | url | Meteorological SWIM Services Subscription Interface Standard |
---|---|---|---|
description | The standard operations for subscription and subscription management. The following operations shall be implement at a minimum:
|
Quantitative Volcanic Ash Information Subscription and Request Service Distribution Interface
Service operations | operation | operation name | publish |
---|---|---|---|
description | This operation allows the service provider to publish Quantitative Volcanic Ash Information Notifications to service consumers based on their subscriptions. | ||
messages | Quantitative Volcanic Ash Information Notification |
Service Messages
Explanatory note
The OGC Web Feature Service Interface Standard, Web Coverage Service (WCS) Interface Standard and OGC API – Environmental Data Retrieval Standard detail the basic messages such as request and response messages.
It is not the intention to repeat the standardised messages here. The table below provides extra details for the Quantitative Volcanic Ash Information Message.
service messages | message | name | Quantitative Volcanic Ash Information Message |
---|---|---|---|
description | The output message containing the quantitative volcanic ash information. | ||
direction | Out | ||
data format | QVA information shall be provided in two file formats:
Note: the file may be compressed. | ||
message | name | Request | |
description | Request message submitted to the service containing query expressions for the WFS GetFeature operation, WCS GetCoverage operation or the EDR HTTP GET operation and the required data format for the Quantitative Volcanic Ash Information Message. | ||
direction | In | ||
data format | JSON and/or XML | ||
message | name | Quantitative Volcanic Ash Information Notification | |
description | The notification and way to retrieve the Quantitative Volcanic Ash Information Message e.g. the URL, or the volcano number. The message will include:
The message can include:
Note: an example of the structure of the URL that is used to retrieve the QVA in IWXXM format using an EDR implementation: https://{organizaton URL}/QVACI_Iwxxm/Locations/{VolcanoNumber} Note: the URL, if provided, could be a request formatted for the Quantitative Volcanic Ash Information Subscription and Request Service Request Interface. | ||
direction | Out | ||
data format | JSON and/or XML | ||
reference | url | Meteorological SWIM Services Subscription Interface Standard | |
description | The standard messages for subscription and subscription management. |
Information Definition (Minimum) and (Extended)
information definition | The IWXXM QVA information shall include feature information for four ash concentration thresholds (≥0.2mg/m3, ≥2.0mg/m3, ≥5.0mg/m3, ≥10mg/m3) in accordance with the QVA IWXXM schema. The probabilistic QVA information shall include the probability of exceeding four ash concentration thresholds (≥0.2mg/m3, ≥2.0mg/m3, ≥5.0mg/m3, ≥10mg/m3) at a 0.25 degree horizontal resolution and for 12 vertical levels in accordance with the NetCDF4 specification for gridded data. The deterministic QVA information shall include an expected ash concentration for each grid point at a 0.25 degree horizontal resolution and for 12 vertical levels in accordance with the NetCDF4 specification for gridded data. All information types shall be provided for the period 0-hours to 24-hours at 3-hourly intervals. Note: the QVA IWXXM schema is expected to be included in the 2025-2 IWXXM release. |
---|
Filter Encoding
filter encoding | The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface shall support filtering by volcano number (i.e., the IAVCIE number) and forecast timestep (dateTime). The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface should support filtering of probabilistic information based on the ash concentration threshold (≥0.2mg/m3, ≥2.0mg/m3, ≥5.0mg/m3, ≥10mg/m3). The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface may support filtering based on geographic bounding box defined in the OGC Filter Encoding 2.0 Encoding Standard. The Quantitative Volcanic Ash Information Subscription and Request Service Request Interface shall support the selection of one or more of the supported data set types. If the service implements the OGC API – Environmental Data Retrieval Standard, the Quantitative Volcanic Ash Information Subscription and Request Service Subscription Interface shall allow for the selection of subscription based on clearly defined criteria. Note: for example, subscriptions can be for all QVA messages or by volcano number or by data format type (deterministic, probabilistic or in IWXXM format). |
---|
Machine-Readable Service Interface Definition
Explanatory note
This field is left empty. No machine-readable service interface definition is provided.
machine-readable service interface definition | reference |
---|
Model View
Explanatory note
This field is left empty. No model view is provided.
model view | reference |
---|
Abbreviations and Acronyms
abbreviations and acronyms | abbreviation | code | AMQP |
---|---|---|---|
term | Advanced Message Queuing Protocol | ||
abbreviation | code | API | |
term | Application Programming Interface | ||
abbreviation | code | ATM | |
term | AIr Traffic Management | ||
abbreviation | code | IAVW | |
term | International Airways Volcano Watch | ||
abbreviation | code | ICAO | |
term | International Civil Aviation Organization | ||
abbreviation | code | IWXXM | |
term | ICAO Meteorological Information Exchange Model | ||
abbreviation | code | JSON | |
term | JavaScript Object Notation | ||
abbreviation | code | MEP | |
term | Message Exchange Pattern | ||
abbreviation | code | NetCDF | |
term | network Common Data Form | ||
abbreviation | code | OGC | |
term | Open Geospatial Consortium | ||
abbreviation | code | PANS-MET | |
term | ICAO Procedures for Air Navigation Services – Meteorology | ||
abbreviation | code | QVA | |
term | Quantitative Volcanic Ash | ||
abbreviation | code | SWIM | |
term | System wide information management | ||
abbreviation | code | TI | |
term | Technical Infrastructure | ||
abbreviation | code | TIYP | |
term | Technical Infrastructure Yellow Profile | ||
abbreviation | code | TLS | |
term | Transport Layer Security | ||
abbreviation | code | URL | |
term | Uniform Resource Locator | ||
abbreviation | code | VAAC | |
term | Volcanic Ash Advisory Centre | ||
abbreviation | code | WCS | |
term | Web Coverage Service | ||
abbreviation | code | WFS | |
term | Web Feature Service | ||
abbreviation | code | XML | |
term | Extensible Markup Language |
Appendix A: References
references | reference | title | IWXXM |
---|---|---|---|
version | ICAO Meteorological Information Exchange Model | ||
description | The ICAO Meteorological Information Exchange Model (IWXXM) is an exchange model capturing Meteorological information. It was introduced to support the exchange of meteorological information in accordance with ICAO Annex 3. | ||
url | https://github.com/wmo-im/iwxxm | ||
document type | INFORMATION_DEFINITION | ||
reference | title | OGC API – Environmental Data Retrieval Standard | |
version | 1.1 | ||
description | OGC API standards define modular API building blocks to spatially enable Web APIs in a consistent way. The OpenAPI specification is used to define the API building blocks. | ||
url | |||
document type | SERVICE_SPECIFICATION | ||
reference | title | OGC Web Coverage Service (WCS) Interface Standard | |
version | version 2.0 | ||
description | A Web Coverage Service (WCS) offers multi-dimensional coverage data for access over the Internet. WCS Core specifies a core set of requirements that a WCS implementation must fulfill. | ||
url | https://www.ogc.org/standard/wcs/ | ||
document type | SERVICE_SPECIFICATION | ||
reference | title | OGC Web Feature Service 2.0 Interface Standard | |
version | |||
description | WFS offers direct fine-grained access to geographic information at the feature and feature property level. Note: This is equivalent to ISO 19142 - Geographic Information - Web Feature Service. | ||
url | https://www.ogc.org/standard/wfs/ | ||
document type | SERVICE_SPECIFICATION | ||
reference | title | OGC Filter Encoding 2.0 Encoding Standard | |
version | |||
description | This jointly developed OGC and ISO TC/211 International Standard describes an XML and KVP encoding of a system neutral syntax for expressing projections, selection and sorting clauses collectively called a query expression. These components are modular and intended to be used together or individually by other standards which reference this International Standard. Note: This is equivalent to ISO 19143 - Geographic Information - Filter encoding. | ||
url | https://www.ogc.org/docs/is | ||
document type | SERVICE_SPECIFICATION | ||
reference | title | Message Exchange Patterns: Identification Guidelines | |
version | JULY 2nd, 2019 | ||
description | Document intended to facilitate the understanding of message exchange patterns from an application and Technical Infrastructure perspective. | ||
url | https://reference.swim.aero/technical-infrastructure/message-exchange-patterns-identification-guidelines.html | ||
document type | SERVICE_BEHAVIOUR_DESCRIPTION | ||
reference | title | Publish/Subscribe Push MEP: Implementation Guidance | |
version | JULY 2nd, 2019 | ||
description | This document intends to serve as implementation guidance of the Publish/Subscribe Push Message Exchange Pattern using SWIM-TI Yellow Profile Service Bindings. | ||
url | https://reference.swim.aero/technical-infrastructure/guidance-for-pub-sub-push-implementation.html | ||
document type | SERVICE_SPECIFICATION |