PROVIDER_SIDE

DescribeFeatureTypeRequest

DescribeFeatureType

Returns a schema description of feature types offered by the WFS instance.

Idempotent

IDEMPOTENT

Operation Message

DescribeFeatureTypeResponse

Binding Method

HTTP-GET/POST

Parameter

GetPropertyValue

Retrieves the value of a feature property (or part of it) for selected features.

Idempotent

IDEMPOTENT

Operation Message

GetPropertyValueRequest

GetPropertyValueResponse

Binding Method

HTTP-GET/POST

Parameter

GetFeature

Returns a selection of features from a data store according to query constraints.

Idempotent

IDEMPOTENT

Operation Message

GetFeatureRequest

GetFeatureResponse

Binding Method

HTTP-GET/POST

Parameter

https://gateway.example.invalid/dds

Endpoints

OGC WFS 2.0 Query Interface endpoint

Base endpoint for the interface.

Url

Service Interface Binding

REST/HTTP Binding

REST architectural style over HTTP(S).

Network Interface Binding

TLS 1.2

Transport Layer Security 1.2 for confidentiality and integrity.

Interface Provision Side

communicationProblemRequest

ArrivalSequenceInformationPublisher

Subscription management interface

Operations

subscribeToArrivalSequence

The "Subscribe" endpoint allows clients to register to receive arrival sequence information.

Idempotent

NON_IDEMPOTENT

Operation Message

SubscriptionRequest

SubscriptionResponse

Binding Method

POST /arrivalSequenceInformation/v1/subscriptions

unsubscribeToArrivalSequence

The "Unsubscribe" endpoint allows clients to remove their current active subscription.

Idempotent

NON_IDEMPOTENT

Operation Message

subscriptionReference

UnsubscriptionResponse

Binding Method

DELETE /arrivalSequenceInformation/v1/subscriptions

Parameter

subscriptionReference

communicateProblem

The "Communicate Problems" endpoint enables clients to report issues in the arrival sequence they have received.

Idempotent

IDEMPOTENT

Operation Message

Binding Method

POST /arrivalSequenceInformation/v1/problems

Endpoints

Endpoint

Operational network address will be provided after signature of the Service Agreement.

Url

https://

Service Interface Binding

SWIM_TI_YP_1_1_WS_LIGHT

The WS Light Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1.

Network Interface Binding

SWIM_TI_YP_1_1_IPV4_UNICAST

The Service implementation conforms with IPV4_UNICAST as part of SWIM Technical Infrastructure Yellow Profile, edition 1.1.

Interface Provision Side

SYNCHRONOUS_REQUEST_RESPONSE

TI Primitive Message Exchange Pattern

Aeronautical Aerodrome Map Request Service Interface

The interface is used to group the operations offered by the OGC Web Map Service 1.3.0 Interface Standard.

Operations

GetCapabilities

The GetCapabilities operation returns metadata about the operations, services, and data (âcapabilitiesâ) that are offered the WMS service.

Idempotent

IDEMPOTENT

Operation Message

Capabilities

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

service

version

request

GetMap

The GetMap operation returns an Aeronautical Aerodrome Map that satisfies the query expressions specified in the GetMap Request message.

Idempotent

IDEMPOTENT

Operation Message

Aeronautical Aerodrome Map

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

GetFeatureInfo

The GetFeatureInfo operation returns the spatial and attribute data for the features at a given location on a map. It is similar to the WFS GetFeature operation, but less flexible in both input and output. The one advantage of GetFeatureInfo is that the request uses an (x,y) pixel value from a returned WMS image. This is easier to use for a client that is not able to perform true geographic referencing.

Idempotent

IDEMPOTENT

Operation Message

FeatureCollection

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

GetLegendGraphic

The GetLegendGraphic operation provides a mechanism for generating legend graphics as images, beyond the LegendURL reference of WMS Capabilities. It generates a legend based on the style defined on the server, or alternatively based on a user-supplied SLD.

Idempotent

IDEMPOTENT

Operation Message

Legend

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

Endpoints

wms

Endpoint for Aeronautical Aerodrome Map Request Service is RESTful Request-Reply interface WMS.

Url

URL:/swim/wms

Reference

Service Interface Binding

SWIM_TI_YP_1_1_WS_LIGHT

The web service is bound to the REST architectural style.

Network Interface Binding

IPV4_UNICAST

SWIM TI Yellow Profile specification

Messages

Aeronautical Aerodrome Map

Description

This is the map that is generated on the server as a result of the GetMap query to the service.

Interface Provision Side

GetFeatureRequest - REST POST

Digital NOTAM Subscription and Request Service Request Interface

Allows the service consumer to request an AIXM Basic Message based on filters which are linked to the event feature.

Operations

wfs.getFeature

The GetFeature operation returns a selection of features from a data store.

Idempotent

IDEMPOTENT

Operation Message

GetFeatureResponse - REST POST

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Endpoints

wfs/5.1.1/

Endpoint for Digital NOTAM Subscription and Request Service Request Interface is RESTful Request-Reply interface WFS.

Url

URL:/swim/wfs/5.1.1/

Reference

Service Interface Binding

WS_LIGHT

EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile

Network Interface Binding

IPV4_UNICAST

SWIM TI Yellow Profile specification

Messages

wfs-resp:ServiceExceptionReport

Description

ServiceExceptionReport container for error messages. Exception reporting.

Interface Provision Side

Digital NOTAM Subscription and Request Service Distribution Interface

Allows the service provider to distributes Digital NOTAM Messages based on the event scenario that has triggered the need for the service consumer to be updated.

Operations

publish

This operation allows the service provider to publish Digital NOTAM messages to service consumers based on their subscriptions. Implementation is handled through AMQP 1.0 protocol and the published message is distributed to service consumers through AMQP Queues.

Idempotent

IDEMPOTENT

Binding Method

SWIM_TI_YP_1_1_AMQP_MESSAGING

Endpoints

AMQP 1.0 Queue

Endpoint is AMQP 1.0 Queue in AMQP Message Broker. Each subscription is linked to one queue, and queue name is returned in subscription response. Queue enables guaranteed messaging, that means message is kept in the queue until message consumer sends acknowledgment. Only then message is removed from the queue.
Service consumer shall be able to connect to AMQP Message Broker.

Resource Type

URL

Url

url:withheld

Reference

Service Interface Binding

SWIM_TI_YP_1_1_AMQP_MESSAGING

The web service is bound to the AMQP 1.0 messaging protocol.

Network Interface Binding

IPV4_UNICAST

SWIM TI Yellow Profile specification

Interface Provision Side

SubscriptionsRequest - REST POST

Digital NOTAM Subscription and Request Service Subscription Interface

Allows the service consumer to select and subscribe to event scenarios of interest. It allows the service consumer to manage the subscriptions e.g. to pause a subscription, or to unsubscribe.

Operations

subscribe

This operation allows a service consumer to subscribe to event scenarios of interest.

Idempotent

IDEMPOTENT

Operation Message

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

unsubscribe

This operation allows a service consumer to unsubscribe from event scenarios of interest.

Idempotent

IDEMPOTENT

Operation Message

SubscriptionsRequest - REST DELETE

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

SubscriptionsRequest - REST PUT

pause

This operation allows a service consumer to pause the subscription for a particular topic subscription.

Idempotent

IDEMPOTENT

Operation Message

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

SubscriptionsRequest - REST PUT

subscriptionStatus

comment

resume

This operation allows a service consumer to resume a subscription that had been paused.

Idempotent

IDEMPOTENT

Operation Message

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

SubscriptionsRequest - REST GET

subscriptionStatus

comment

getSubscriptions

This operation allows a service consumer to obtain the list of subscriptions.

Idempotent

IDEMPOTENT

Operation Message

SubscriptionsRequest - REST POST

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

queueName

subscriptionStatus

getSubscriptionDetails

This operation allows a service consumer to obtain information on a specific subscription.

Idempotent

IDEMPOTENT

Operation Message

SubcriptionDetailsRequest - REST GET

SubcriptionDetailsReply - REST GET

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

GetTopicRequest - REST GET

getTopics

This operation allows a service consumer to request the list of topics (which represent type of data, i.e. SWIM services) available for subscription

Idempotent

IDEMPOTENT

Operation Message

TopicsRequest - REST GET

TopicsReply - REST GET

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

getTopicDetails

This operation allows a service consumer to obtain information on a specific topic (filter criteria).

Idempotent

IDEMPOTENT

Operation Message

GetTopicReply - REST GET

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

topicId

Endpoints

subscriptions

Endpoint subscriptions is used for subscription management:
- creation of new subscription
- pause existing subscription
- resume existing subscription
- unsubscription/deletion of existing subscription
- get subscriptions
- get subscription details

Url

URL:/swim/v1/subscriptions/

Reference

topics

In SWIM compliant implementation of Publish-Subscribe message exchange pattern using AMQP 1.0 protocol, the term topic is used to define service (i.e. type of data) that the future service consumer is allowed to subscribe to.

Endpoint topics is used to get:
- list of all topics
- topic details

Url

URL:/swim/v1/topics/

Reference

Service Interface Binding

SWIM_TI_YP_1_1_WS_LIGHT

The web service is bound to the REST architectural style.

Network Interface Binding

IPV4_UNICAST

SWIM TI Yellow Profile specification

Messages

SubscriptionRequest

Description

Request message to subscribe to an event scenario of interest.

SubscriptionReply

Description

Reply message to a subscription request.

UnsubscriptionRequest

Description

Request message to unsubscribe to an event scenario of interest.

UnsubscriptionReply

Description

Reply message to an unsubscription request.

PauseRequest

Description

Request message to pause a subscription.

PauseReply

Description

Reply message to an pause request.

ResumeRequest

Description

Request message to resume a subscription.

ResumeReply

Description

Reply message to a resume request.

GetSubscriptionsRequest

Description

Request message to get a list of subscriptions.

GetSubscriptionsReply

Description

Reply message to a get subscriptions request.

GetSubcriptionDetailsRequest

Description

Request message to get the details on a specific subscription.

GetSubcriptionDetailsReply

Description

Reply message to a get subscription details request.

GetTopicsRequest

Description

Request message to get a list of business topics (type of data, i.e. services) that are available for subscription.

GetTopicsReply

Description

Reply message to a get topics request.

GetTopicRequest

Description

Request message to get the details on a specific topic.

GetTopicReply

Description

Reply message to a get topic request.

Interface Provision Side

SDD Download Web Service

This request fetches exported AIXM 5.1.1 files, based on the defined parameter set.

Operations

downloadAixmMessageFile

Retrieves a specific download AIXM 5.1.1 XML file using a notifications process.
The steps of the above-mentioned process are as follows:
1. User creates a new Extraction rule and Subscription.
2. System automatically creates a "topic" within AIMSL per user who is specified as "Subscriber" for the download.
3. The specified user may subscribe to the appropriate topic and recurrently consume messages published to his queue. To subscribe, user shall use an existing AMQP queue, which was created prior the subscription request.
4. The appropriate topic expression should be set as "adm:<user_id>".
5. Once the system starts dataset generation job, every status change of the active generation process is notified to the topic. Possible values are QUEUED, PROCESSING, FINISHED, FAILED and CANCELLED.
6. When the status changes to FINISHED, the id of the created file is provided with the notification as the <downloadFileId>.
It is needed to request the download result via WS operation downloadAixmMessageFile - see ADM XML Primer, section 2.3.2.4 "Download Operations".

Idempotent

IDEMPOTENT

Operation Message

GetDownload

DownloadResponse

Binding Method

SWIM_TI_YP_1_1_WS_LIGHT

Parameter

downloadFileId

Endpoints

SDDDownloadWebService

For security reasons, the addresses will be communicated only to customers.

Resource Type

URL

Url

url:withheld

Reference

Service Interface Binding

SWIM_TI_YP_1_1_WS_LIGHT

The web service is bound to the REST architectural style.

Network Interface Binding

IPV4_UNICAST

SWIM TI Yellow Profile specification

Messages

DownloadResponse

Description

Errors are provided with DownloadResponse or Fault Error Messages.

Interface Provision Side

GetCapabilitiesRequest - REST Post

TI Primitive Message Exchange Pattern

REQUEST_REPLY

SDD Query Service (sdd-wfs)

The Query Service for AIXM 5.1.1 is based on the Open Geospatial Consortium Web Feature Service Interface Standard (WFS).

Operations

wfs.getCapabilities

The GetCapabilities operation generates a service metadata document describing a WFS service provided by a server.

Idempotent

IDEMPOTENT

Operation Message

GetCapabilitiesResponse - REST Response

Binding Method

SWIM_TI_YP_1_0_WS_LIGHT

wfs.describeFeatureType

The DescribeFeatureType operation returns a schema description of feature types offered by a WFS instance.

Idempotent

IDEMPOTENT

Operation Message

DescribeFeatureTypeRequest - REST Post

DescribeFeatureTypeResponse - REST Response

Binding Method

SWIM_TI_YP_1_0_WS_LIGHT

wfs.getPropertyValue

The GetPropertyValue operation allows the value of a feature property or part of the value of a complex feature property to be retrieved from the data store for a set of features identified using a query expression.

Idempotent

NON_IDEMPOTENT

Operation Message

GetPropertyValueRequest - REST Post

GetPropertyValueResponse - REST Response

Binding Method

SWIM_TI_YP_1_0_WS_LIGHT

wfs.getFeature

The GetFeature operation returns a selection of features from a data store. Ref WSDL & OGC

Idempotent

NON_IDEMPOTENT

Operation Message

GetFeatureRequest - REST Post

GetFeatureResponse - REST Response

Binding Method

SWIM_TI_YP_1_0_WS_LIGHT

wfs.listStoredQueries

The ListStoredQueries operation lists the stored queries available at a server.

Idempotent

IDEMPOTENT

Operation Message

ListStoredQueriesRequest - REST Post

ListStoredQueriesResponse - REST Response

Binding Method

SWIM_TI_YP_1_0_WS_LIGHT

wfs.describeStoredQueries

The DescribeStoredQueries operation provides detailed metadata about each stored query expression that a server offers.

Idempotent

IDEMPOTENT

Operation Message

DescribeStoredQueriesRequest - REST Post

DescribeStoredQueriesResponse - REST Response

Binding Method

SWIM_TI_YP_1_0_WS_LIGHT

Endpoints

sdd-wfs

The REST service points to a URL /swim/wfs/5.1.1 (AIXM5.1.1) which is routed by AIMSL to the WFS implementation.

Url

url:/swim/wfs/5.1.1

Reference

Service Interface Binding

SWIM_TI_YP_1_1_WS_LIGHT

A WFS-2.0 is bound for the REST architectural style.

Network Interface Binding

IPV4_UNICAST

SWIM TI Yellow Profile specification

Messages

wfs-resp:ServiceExceptionReport

Description

ServiceExceptionReport container for error messages. Exception reporting.

Schema

The DescribeFeatureType operation returns a schema description of feature types offered by a WFS instance.

url:withheld

Interface Provision Side

/<address> dynamic endpoint, AMQP node

TI Primitive Message Exchange Pattern

REQUEST_REPLY

Data Publication Interface

The Data Publication Interface allows a consumer to obtain updates of the ADS-C exchanges of the flights he is interested in. It provides two ways of doing so: By creating an endpoint from which a consumer can listen to updates of flights matching certain filtering criteria defined in a subscription created through the Subscription Management Interface. In which case he will receive in its subscription response the endpoint address created specifically for his subscription. The dynamic endpoint created for a specific subscription is labelled by /<address> in this document, the specific value taken by the <address> placeholder is resolved in runtime and provided in the subscription response. By defining a number of preconfigured static endpoints where predefined filters are already applied. These preconfigured static endpoints do not require the creation of a specific subscription by the consumer, they are created in design-time by the service provider and are readily available for any consumer, subject to authorization verification. These static endpoints are labelled by /<predefinedSubscription> in this document, the specific values taken by these endpoints is defined by the service provider during design-time.

Operations

publish

This operation allows the service provider to publish flight status updates to service consumers based on their subscriptions. By creating an endpoint from which a consumer can listen to updates of flights matching certain filtering criteria defined in a subscription created through the Flight Status Subscription Management Interface. In which case he will receive in its subscription response the endpoint address created specifically for his subscription. The dynamic endpoint created for a specific subscription is labelled by /<address> in this document, the specific value taken by the <address> placeholder is resolved in runtime and provided in the subscription response.

Operation Message

publish

By defining a number of preconfigured static endpoints where predefined filters are already applied. These preconfigured static endpoints do not require the creation of a specific subscription by the consumer, they are created in design-time by the service provider and are readily available for any consumer, subject to authorization verification. These static endpoints are labelled by /<predefinedSubscription> in this document, the specific values taken by these endpoints is defined by the service provider during design-time.

Operation Message

/<predefinedSubscription> predefined static endpoint, AMQP node

Service Interface Binding

SWIM_TI_YP_1_1_AMQP_MESSAGING

The AMQP_MESSAGING Interface Binding as detailed in the EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile, edition 1.1

Network Interface Binding

selected network interface binding

The service shall use the network bindings of the SWIM TIYP. AMQP 1.0 shall be used to distribute messages as explained in the Publish/Subscribe Push MEP: Implementation Guidance: https://reference.swim.aero/technical-infrastructure/guidance-for-pub-s…

Interface Provision Side

subscriptionDetailsRequest

Subscription Management Interface

The Subscription Management Interface allows a consumer of the SWIM ADS-C Ground Distribution Service to select the set of datalink messages he is interested to receive via the Data Publication Interface.

Operations

subscribe

This operation allows a consumer of the SWIM ADS-C Ground Distribution Service to select the set of datalink messages he is interested to receive via the Data Publication Interface.

Operation Message

subscriptionRequest

subscriptionReply

unsubscribe

This operation allows a service consumer to unsubscribe from the set of datalink messages changes he is subscribed to.

Operation Message

unsubscriptionRequest

unsubscriptionReply

list subscriptions

This operation allows a service consumer to obtain the list of subscriptions.

Operation Message

getsubscriptionsRequest

getsubscriptionsReply

subscription details

This operation allows a service consumer to obtain information on a specific subscriptions.

Operation Message

subscriptionDetailsReply

Endpoints

/subscriptions/

Url

https://localhost/subscriptions/

/subscriptions/<subscriptionId>

Url

https://localhost/subscriptions/subscriptionId/

Service Interface Binding

WS_LIGHT

Network Interface Binding

selected network interface binding

The service shall use the network bindings of the SWIM Technical Infrastructure (TI) Yellow Profile.

Messages

subscriptionRequest

Description

This message allows a consumer of the service to subscribe to a set of datalink messages he is interested in.

subscriptionReply

Description

The reply message of the subscription request indicating the subscription is confirmed.

unsubscriptionRequest

Description

This message allows a consumer of the service to unsubscribe to a subscription he previously made.

unsubscriptionReply

Description

The reply message of the flight status unsubscription request confirming the unsubscription was successful.

getSubscriptionRequest

Description

This message allows a consumer of the service to list the subscriptions he is currently subscribed to.

getSubscriptionReply

Description

The reply message of the list subscriptions request which is confirmed and detailing the list of subscriptions he has.

subscriptionDetailsRequest

Description

This message allows a consumer of the service to get the details of his subscriptions.

subscriptionDetailsReply

Description

The reply message of the subscriptions details request which is confirmed and giving the details of the subscriptions the service consumer.

Interface Provision Side