service definitions
Aeronautical Simple Feature Request Service - Service Definition
Task Status
This page is part of the ongoing SWIM Community of Interest discussions. The content is working material. It should not be treated as final as it is still subject to review, comment and change.
Service Definition Identification
Trace
WORKING
service definition identification | title | Service definition for the Aeronautical Simple Feature Request Service |
---|---|---|
edition | 00.00.05 | |
reference date | 2025-03-28 |
- TBD
- WORKING
- DRAFTED
- AGREED
Service Identification
Trace
SWIM-DEFN-040
WORKING
service identification | service name | Aeronautical Simple Feature Request Service |
---|
Service Abstract
Trace
SWIM-DEFN-050
WORKING
service abstract | The Aeronautical Simple Features Service allows the service consumer to get features that are customised and assembled from aeronautical information for use in Geographical Information System (GIS) systems. The features are designed for direct use in commercial-off-the-shelf GIS tools and libraries without the need for further processing/assembly by the service consumer. The features offered by the service are assembled from the high quality, up-to-date, trusted, regulated aeronautical information that is available in aeronautical information management (AIM) databases. The service can be considered as a specialised aeronautical information service complementing the Aeronautical Information Request Service and the Aeronautical Aerodrome Map Request Service. |
---|
Service Definition Provider
Trace
SWIM-DEFN-085
WORKING
service definition provider | name | EUROCONTROL |
---|---|---|
description | EUROCONTROL is a pan-European, civil-military organisation dedicated to supporting European aviation. | |
point of contact | swim@eurocontrol.int |
Geographical Extent of Information
Trace
SWIM-DEFN-090
WORKING
Explanatory note
This field is left empty.
geographical extent of information |
---|
Service Categories
Trace
WORKING
Service Standard Reference
Trace
WORKING
Explanatory note
This field is left empty.
service standard reference | reference | |
---|---|---|
implemented options | ||
deviations/additions |
Operational Environment
Trace
WORKING
operational environment | operational needs | Some stakeholders with a spatial data infrastructure using GIS technology require interoperable aeronautical information that can be used 'out-of-the-box' without the need for complex processing of geometry and/or temporality. Retrieving features that have already been assembled supports their operations in flight planning, ... tbd A list of operational needs that this service contributes to satisfying is available in Appendix C. | |||||||
---|---|---|---|---|---|---|---|---|---|
capabilities | The service provides features that are customised and assembled from aeronautical information for use direct use in Geographical Information System (GIS) systems. | ||||||||
information exchange requirements | The service takes into account the following information exchange requirements:
|
Service Functions
Trace
WORKING
service functions | function | name | Request aeronautical features |
---|---|---|---|
description | The service consumer shall be able to request features filtered by feature type and/or name. | ||
real-world effect | The aeronautical feature is received and can be used in GIS and other systems. | ||
function | name | Enable advanced filtering of aeronautical features | |
description | The service consumer shall be able to request features filtered according to spatial, temporal and logical operators. | ||
real-world effect | The aeronautical feature is received and can be used in GIS and other systems. |
Service Access and Use Conditions
Trace
WORKING
service access and use conditions | legal constraints | TBD | |
---|---|---|---|
service policies | business policy | TBD | |
operational policy | TBD | ||
technical policy | TBD | ||
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
Trace
WORKING
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 according to 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
Trace
WORKING
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
Trace
WORKING
quality of data | The quality of features offered by the service shall be verified by the service provider. Meet data catalogue? |
---|
Source of Information
Trace
WORKING
source of information | source | The service provider shall ensure that the features offered by the service are based on aeronautical information received from the appropriate authorised originating sources acting as AIS. This includes: |
---|---|---|
modifications | Note: the features offered by the service can be assembled from multiple source information. Note: it is possible to fill an attribute based on calculations from the source information. Note: modifications may change resolution, etc. |
Service Validation Information
Trace
WORKING
Explanatory note
This field is left empty.
service validation information | validation performed | |
---|---|---|
method used | ||
summary of the validation steps performed | ||
results achieved | ||
how the service consumer may obtain the validation evidence |
Application Message Exchange Pattern
Trace
WORKING
application message exchange pattern | REQUEST_REPLY |
---|
Service Behaviour
Trace
WORKING
service behaviour | typical behaviour | The service behaviour shall be in accordance with the patterns detailed in the Message Exchange Patterns: Identification Guidelines. The typical behaviour for SYNCHRONOUS_REQUEST_REPLY (as used in Aeronautical Simple Feature Request Service Request Interface) is as follows:
|
---|
Service Monitoring
Trace
WORKING
service monitoring | A service monitoring mechanism should be made available to service consumers. |
---|
Service Interfaces
Trace
WORKING
service interfaces | interface | name | Aeronautical Simple Feature Request Service Request Interface |
---|---|---|---|
description | The interface is used to group the operations offered by the OGC API - Features standard. | ||
provider/consumer side | Provider side |
SWIM TI Profile and Interface Bindings
Trace
WORKING
Aeronautical Simple Feature 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 | ||
selected network interface binding | The service shall use the network bindings of the SWIM TIYP. | |
description | The interface shall use the OGC API - Features standard. Check if there are different levels e.g. basic, advanced... and which should be supported |
Service Interface Protocols and Data Format
Trace
WORKING
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
Trace
TBD
Explanatory note
The OGC API – Features standard is used to implement the service operations.
It is not the intention to repeat the standardised operations here. However, the table below illustrates how the xxx operation would look in the context of this service.
service operations | operation | operation name | |
---|---|---|---|
description | |||
messages | |||
operation | operation name | ||
description | |||
messages |
Service Messages
Trace
WORKING
Explanatory note
The OGC API – Features standard details the basic messages such as request and response messages.
It is not the intention to repeat the standardised messages here. The table below provides illustrative details.
service messages | message | name | Reply |
---|---|---|---|
description | OpenAPI returns a FeatureCollection | ||
type | Out | ||
data format | GeoJSON (2016) is used to encode features (https://www.rfc-editor.org/rfc/rfc7946.txt). | ||
message | name | Request | |
description | Request message submitted to the service containing query expressions. | ||
type | In | ||
data format | JSON and/or XML |
Information Definition (Minimum) and (Extended)
Trace
SWIM-DEFN-290, SWIM-DEFN-300
WORKING
information definition | The service shall offer feature as per TBD model/schema. Note: The GetCapabilities operation will expose the available layers, styles and coordinate reference systems. Note: The structuring and styling of the layers is a service design decision to be taken when implementing the service. Note: The coordinate reference system and naming of the layers used in the service are subject to the requirements provided in this service definition. |
---|
Filter Encoding
Trace
SWIM-DEFN-310
TBD
filter encoding | Check if used: OGC API - Features - Part 3: Filtering The service shall support the BBOX spatial operator defined in the OGC Filter Encoding 2.0 Encoding Standard. The service shall support the During temporal operator defined in the OGC Filter Encoding 2.0 Encoding Standard. The service should support other filtering based on the operators defined in the OGC Filter Encoding 2.0 Encoding Standard. The service may support other filters on a case by case basis. Example: other filters defined on a case by case basis are PARALLEL_TO and PERPENDICULAR_TO. |
---|
Machine-Readable Service Interface Definition
Trace
SWIM-DEFN-320
WORKING
Explanatory note
This field is left empty. No machine-readable service interface definition is provided.
machine-readable service interface definition |
---|
Model View
Trace
SWIM-DEFN-330
WORKING
Explanatory note
This field is left empty. No model view is provided.
model view |
---|
Abbreviations and Acronyms
Trace
TBD
abbreviations and acronyms | abbreviation | code | API |
---|---|---|---|
term | |||
abbreviation | code | GIS | |
term | |||
abbreviation | code | OGC | |
term |
Appendix A: References
references | 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 | Info definition | |
version | |||
description | |||
url | |||
document type | INFORMATION_DEFINITION | ||
reference | title | semantic correspondence | |
version | |||
description | The report on the information definition and the ATM Information Reference Model (AIRM) | ||
url | |||
document type | SEMANTIC_CORRESPONDENCE_REPORT | ||
reference | title | OGC Filter Encoding 2.0 Encoding Standard or API takes over | |
version | 2.0 | ||
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. Note: This is equivalent to ISO 19143 - Geographic Information - Filter encoding. | ||
url | https://www.ogc.org/docs/is | ||
document type | |||
reference | title | OGC API Features specification | |
version | 1.0.1 \ MIGHT NEED DIFFERENT REFERENCES PER PART | ||
description | A multi-part standard that offers the capability to create, modify, and query spatial data on the Web and specifies requirements and recommendations for APIs that want to follow a standard way of sharing feature data | ||
url | https://ogcapi.ogc.org/features/ | ||
document type | |||
reference | title | GeoJSON - WITH CRS extensions (JSON-FG) https://www.geonovum.nl/uploads/documents/220405-JSON-FG.pdf, https://docs.ogc.org/DRAFTS/21-045.html | |
version | 2016 | ||
description | GeoJSON is a geospatial data interchange format based on JavaScript Object Notation (JSON). | ||
url | https://www.rfc-editor.org/rfc/rfc7946.txt | ||
document type |
Appendix B: Information Definition forAeronautical Simple Feature Request Service
The table below lists the layers and features that are needed to support the scope of the Aeronautical Simple Feature Request Service.
feature |
---|
|
Appendix C: Operational Needs
Transversal
- Collaborative information sharing is essential for decision making involving multiple actors. Automatic taxi with time and path information on the ground, collaborative decision making during emergencies, de-icing operations and infrastructure availability information are examples that involve multiple actors including the aircraft crew.
- Retrieve layered geospatial aeronautical data for 'out-of-the-box' interoperable use within scope of the data domains managed in their spatial data infrastructure using GIS technology.
- Retrieve integrated temporal aeronautical data for 'out-of-the-box' interoperable use within scope of the data domains managed in their spatial data infrastructure using GIS technology.
By service consumer role
Stakeholder/Role | Description of stakeholder/role | Needs for Aeronautical Data | Notes |
---|---|---|---|
CIVIL_AIRSPACE_USER | A generic term designating an organization operating aircraft and its pilots, the flight operations centres (FOC) responsible for the strategic planning of a flight and the entity responsible for the execution of a flight which is traditionally a flight deck. |
| Aircraft covers UAV. |
MILITARY_AIRSPACE_USER | Airspace User under the authority of a military organisation. |
| There is an assumption that these will be working in DMZ under yellow profile. The AISP needs to meet the security needs. In general, they have the same needs as civil airspace users. |
CIVIL_AIR_NAVIGATION_SERVICE_PROVIDER | Any public or private entity providing air navigation services for general air traffic. |
| |
MILITARY_AIR_NAVIGATION_SERVICE_PROVIDER | Any public or private entity providing air navigation services for military air traffic. |
| |
AIR_TRAFFIC_SERVICE_PROVIDER | A generic term meaning variously, flight information service, alerting service, air traffic advisory service, air traffic control service (area control service, approach control service or aerodrome control service). |
| |
REGULATED_METEOROLOGICAL_SERVICE_PROVIDER | An office designated to provide meteorological service for international air navigation. | No needs have been identified. | |
AERONAUTICAL_INFORMATION_SERVICE_PROVIDER | A service established within the defined area of coverage responsible for the provision of aeronautical information/data necessary for the safety, regularity and efficiency of air navigation. |
| |
A provider of CNS services. |
| ||
PROVIDER_OF_DATA_SERVICES | A public or private entity responsible for the management of a Data Service Provision (e.g. to one or several Virtual Centre). |
| |
NETWORK_MANAGER | The organization responsible for enabling the optimum use of airspace and ensure that Airspace Users can operate preferred trajectories while allowing maximum access to airspaces and air navigation services. | ||
AIRPORT_OPERATOR | The civilian or military agency, group or individual which exercises control over the operations of the civil airport or military airfield. |
| |
AIRSIDE_GROUND_HANDLER | A stakeholder involved in the services necessary for an aircraft's arrival at, and departure from, an airport, other than air traffic services. |
| |
MILITARY_DEFENCE_CENTRE | A military defence centre. Note: these centres, e.g., check for diplomatic clearance. |
| |
UAS GEOGRAPHICAL ZONES PROVIDER | A stakeholder making available UAS Geographical Zones on behalf of the State. |
|