Insert excerpt

	SCOI:Task Status
	SCOI:Task Status
nopanel	true

Info

title	Guidance

This template allows for the documentation of service definitions based on the requirements found at: /wiki/spaces/SCOI/pages/59605116

General requirements to remember:

SWIM-DEFN-010

Service definition coverage

A service definition shall define a single service

Note: This concerns the definition of a service that can be implemented by service providers. It is not used to describe a running service - use a service description in that case.

Note: This requirement uses "define" rather than "describe".

SWIM-DEFN-020

Service definition language

The textual descriptions in a service definition shall be written in English using the spelling listed as the primary British spelling when conflicting spellings exist.

-

Table of Contents

maxLevel	2
type	flat

Info

title	Status Key

Status
title TBD
- No work has started
Status
colour Red
title WORKING
- Content is being worked on, comments discussed
Status
colour Yellow
title DRAFT
- Draft is ready, comments resolved
Status
colour Green
title REVIEWED
- Group has reviewed, edited the final draft
Status
colour Blue
title AGREED
- Content is finalised and agreed

Service Definition Identification

Status

title	TBD

Info

title	Trace

SWIM-DEFN-030

service definition identification	title	Service Definition for Aeronautical Aerodrome Maps Service
	edition	00.00.01
	reference date	2022-04-27

Service Identification

Status

colour	Red
title	WORKING

Info

title	Trace

SWIM-DEFN-040

service identification	service name	Aerodrome Map Request Service Aeronautical Aerodrome Maps Service Aeronautical Aerodrome Map Retrieval Service Aeronautical Aerodrome Map Access Service

Service Abstract

Status

colour	Red
title	WORKING

Info

title	Trace

SWIM-DEFN-050

service abstract

PJ15-11: The Aeronautical Digital Map Common Service provides users the capability to retrieve graphical representation of aeronautical data / information. The output is a standardized / harmonised graphic information that can be retrieved by individual requests demanding specific geographical areas.

8.3.10: The AeronauticalInformationMap service provides the CDM for the provision of aeronautical information maps.

The purpose of the service is the provision of digital aeronautical information maps resembling the current aeronautical AIP charts but improving its functionalities and usability.
The service builds on top of ISO "IS 19128:2005 Geographic information - Web map server interface." standard extending it to support the specific aeronautical information mapping needs.
The typical use case for the service is a request with input parameters regarding the map configuration needed and an image output provided by the service.

8.3.10: The main purpose of the AeronauticalInformationMap service is to provide maps as raster images to consumers

AMIS: AccessAMDBMap Aims to fulfil Information Exchange Requirements of accessing pre-styled geo-referenced AMDB layers (bitmap images).

Service Definition Provider

Status

title	TBD

Info

title	Trace

SWIM-DEFN-085

service definition provider	name	EUROCONTROL
	abbreviated name
	description	EUROCONTROL is an intergovernmental organisation with 41 Member and 2 Comprehensive Agreement States.

Geographical Extent of Information

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-090

Info

title	Working notes

SAT 2022-12-13:

Agreed to leave empty as it is not possible to give a precise requirement.

The service is expected to provide information for the area of responsibility (e.g. a specific FIR or worldwide) of the state plus delegations. This may be found in GEN 3.1 of the AIP. Other options are e.g. FABEC.

geographical extent of information

Service Categories

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-095, SWIM-DEFN-100

service categories	category	category name	regulated information exchange
		value	AERONAUTICAL_INFORMATION_EXCHANGE
		scheme	http://reference.swim.aero/information-services/service-categories/CodeRegulatedInformationExchangeType.html
	category	category name	information domain
		value	AERONAUTICAL_INFORMATION
		scheme	https://reference.swim.aero/information-services/service-categories/CodeInformationDomainType.html
	category	category name	business activity
		value	INFORMATION_MANAGEMENT
		scheme	http://reference.swim.aero/information-services/service-categories/CodeBusinessActivityType.html
	category	category name	intended service consumer
		value	CIVIL_AIRSPACE_USER, MILITARY_AIRSPACE_USER, CIVIL_AIR_NAVIGATION_SERVICE_PROVIDER, MILITARY_AIR_NAVIGATION_SERVICE_PROVIDER, AIR_TRAFFIC_SERVICE_PROVIDER, REGULATED_METEOROLOGICAL_SERVICE_PROVIDER, AERONAUTICAL_INFORMATION_SERVICE_PROVIDER, COMMUNICATION_NAVIGATION_AND_SURVEILLANCE_SERVICE_PROVIDER, PROVIDER_OF_DATA_SERVICES, NETWORK_MANAGER, AIRPORT_OPERATOR, AIRSIDE_GROUND_HANDLER, MILITARY_DEFENCE_CENTRE See High level description of the service offer
		scheme	http://reference.swim.aero/information-services/service-categories/CodeStakeholderType.html
	category	category name	intended service provider
		value	AERONAUTICAL_INFORMATION_SERVICE_PROVIDER
		scheme	http://reference.swim.aero/information-services/service-categories/CodeStakeholderType.html
	category	category name	service type
		value	AERONAUTICAL_AERODROME_MAP_ACCESS_SERVICE
		scheme	http://reference.swim.aero/information-services/service-categories/CodeServiceType (for the moment use https://ext.eurocontrol.int/swim_confluence/display/SCOI/Service+Categories+-+Service+Type).

Service Standard Reference

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-120

service standard reference	reference
	implemented options
	deviations/additions

Operational Environment

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-130

Info

title	Working notes

SAT 2022-11-11:

The service will focus on what the AISP makes available to the next intended user. Therefore, it will not cover A3SG-IER-02 Aerodrome Mapping Data Exchange. This will be looked at later and as a different service.

operational environment

operational needs

Air traffic management is defined as the "dynamic, integrated management of air traffic and airspace including air traffic services, airspace management and air traffic flow management - safely, economically and efficiently - through the provision of facilities and seamless services in collaboration with all parties and involving airborne and ground-based functions". It is provided by the air traffic management system that, amongst other things, relies on the collaborative integration of information and services.

Stakeholders operating in the global air traffic management system have the need for graphical representations of aeronautical data (i.e., maps). This facilitates the safe, economical and efficient execution of their duties both in planning and during operations. There is a need for aeronautical aerodrome maps in support of integrated digital briefings. The maps can be used to ensure a common situation awareness on which to notify changes e.g. in the availability of the aerodrome infrastructure.

This service satisfies this need by offering aeronautical aerodrome maps as regulated by ICAO Annex 15 - Aeronautical Information Services. The scope satisfies the EU Implementing Regulation 2021/116 - Common Project One.

The aeronautical aerodrome maps may also used in other systems such as those used for surface management at aerodrome. A complete list of these is available as a High level description of the service offer. However, the service is not intended for in-cockpit use.

capabilities

The service provides aeronautical aerodrome maps based on service consumer requests (for example, for a specified geographical area or based on a specific data layer).

information exchange requirements

IER 1

Aerodrome Maps Exchange (A3SG-IER-03)

Service Functions

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-140

service functions	function	name	discover the layers that are available
		description	A mechanism by which the consumer will know which data is available for the map; which layers.
		real-world effect	Service consumer knows the content offered by the service.
	function	name	get map
		description	A mechanism to specify which layers to include in the map based on their location and/or attributes and how to style them.
		real-world effect	Service consumer receives the requested map.
	function	name	get map based on filters
		description	A mechanism to specify conditions (queries) on the layers to include in the map.
		real-world effect	Service consumer receives the requested map.
	function	name	get map based on temporal filter
		description	A mechanism to specify the temporality conditions for the map. (Valid for a certain time, etc.)
		real-world effect	Service consumer receives the requested map.

Service Access and Use Conditions

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-150

Info

title	Working notes

SAT 2023-01-30:

Agreed to leave empty as it is not possible to give a precise requirement.

service access and use conditions	legal constraints
	service policies	business policy
		operational policy
		technical policy
	service consumption constraints

Security Constraints

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-160

security constraints	authentication	The service may offer unauthenticated/public use. It shall ensure provider authentication in accordance with SWIM TIYP through X.509 certificate. It shall ensure consumer authentication in accordance with SWIM TIYP through X.509 certificate or the use of a username/password.
	authorisation	The service shall ensure that satisfactory authorisation is put in place according to SWIM-TIYP-0070.
	confidentiality	The service ensures point-to-point confidentiality in accordance with SWIM TIYP through Transport Layer Security (TLS) 1.2 or above.
	integrity	The service ensures point-to-point integrity in accordance with SWIM TIYP through Transport Layer Security (TLS) 1.2 or above.

Quality of Service

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-180

Info

title	Working notes

SAT 2023-01-30:

Agreed to leave empty (except the need for confidentiality and integrity) as it is not possible to give a precise requirement.

quality of service	performance	capacity
		response time
		Time for Transmission
	reliability	availability
	reliability	recoverability
	security	confidentiality	Confidentiality shall be shall be ensured using SWIM TIYP bindings.
	security	integrity	Integrity shall be shall be ensured using SWIM TIYP bindings.

Quality of Data

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-185

quality of data	The data must satisfy the applicable sections of Commission Implementing Regulation (EU) 2017/373 of 1 March 2017 The AIXM 5.1.1 coding guidance is applied to the data. See: https://ext.eurocontrol.int/aixm_confluence/display/ACG/Common+coding+guidelines https://aixm.aero/page/data-coding-guidelines Use of Geography Markup Language (GML) for Aviation Data

Source of Information

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-190

source of information	source	AIRPORT_OPERATOR

Service Validation Information

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-200

Info

title	Working notes

SAT 2023-01-30:

Agreed to leave empty (except the need for confidentiality and integrity) as it is not possible to give a precise answer.

service validation information	prototyping

Application Message Exchange Pattern

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-210

application message exchange pattern	SYNCHRONOUS_REQUEST_REPLY

Service Behaviour

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-220

service behaviour	typical behaviour	The service behaviour is in accordance with the Synchronous Request/Reply pattern detailed in Message Exchange Patterns: Identification Guidelines. The ISO 19128:2005 Geographic information - Web map server interface defines the basic behaviour. Synchronous Request/Reply The request message is sent from the service consumer to the service The service consumer remains blocked while awaiting the reply The service remains blocked while processing the reply The aeronautical aerodrome map, the reply message, is sent from the service to the service consumer.

Service Monitoring

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-230

service monitoring	A service monitoring mechanism shall be made available to service consumers.

Service Interfaces

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-240

service interfaces	interface	name	nameofservice + Interface
		description	The interface is used to group the operations offered by the Web Map Service.
		provider/consumer side	Provider side

SWIM TI Profile and Interface Bindings

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-250, SWIM-DEFN-255

SWIM TI profile and interface bindings	profile name	EUROCONTROL Specification for SWIM Technical Infrastructure Yellow Profile
	profile version	1.1
	selected service interface binding	WS_LIGHT
	selected network interface binding	Shall use the network bindings of the SWIM TIYP. See 3.1.2 for the options: IPV4, etc.
	supported optional requirements	The OGC Web Map Service 1.3.0 Interface Standard is used in the service implementation All standardised operations for Basic WMS shall be implemented All standardised operations for Queryable WMS should be implemented Other operations such as getLegend may be implemented

Service Interface Protocols and Data Format

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-260

service interface protocols and data format

transport / messaging protocols

Shall be in accordance with SWIM TIYP: TLS1.2 or later

data format

Info

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

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-270

Info

title	Working notes

SAT 2023-01-30:

Using WMS standard names so no need to document further.

Service operations	operation	operation name
		description
		messages
	operation	operation name
		description
		messages

Service Messages

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-280

Info

title	Working notes

SAT 2022-12-13:

There is no need to consider the data as this is covered by the feature access service.

There is a need to look at how the content of the map is styled:

SEAG-10 looked at symbology
Annex 4 symbology not enough
Make it look like Annex 14?

.. we can also say that the symbology language uses a standard e.g. SLD.

service messages	message	name	Aerodrome Map
		description	This is the map that is generated on the server as a result of the query to the service. It is in graphical format e.g. raster or vector. It may be styled according to a service layer description (SLD).
		type	Out
		data format	This may be GIF, JPEG, etc. The desired output format may be included in the query to the service. A queryable WMS allows access to the information on the map. It shall be in AIXM 5.1.1. format. Other formats such as simple GML features, SHAPE files, GeoJSON may be supported.
	message	name
		description
		type
		data format

Information Definition (Minimum) and (Extended)

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-290, SWIM-DEFN-300

information definition

The service offers GIS layers:

based on features that have a geographical footprint and
are defined in the Aeronautical Information Exchange Model (AIXM 5.1.1) and
are included in the AMD data set defined by ICAO.

See the AMD data set column in Information aspects of the service.

Filter Encoding

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-310

filter encoding

The service sorts the data based on layers. The layers are based on the AMD features as given in the AMD data set column of Information aspects of the service. The layers are based on features that have a geographical footprint.

The service offers a filter based on the ICAO location indicator of an aerodrome allowing all layers to be returned for that aerodrome.

The service supports spatial, temporal and logical filtering based on (subset of the) the operators defined in the OGC Filter Encoding 2.0 Encoding Standard (equivalent to ISO 19143 - Geographic Information - Filter encoding).

The temporal extension (WFS-TE) is used to support advanced temporal filtering.

Machine-Readable Service Interface Definition

Status

title	TBD

Info

title	Trace

SWIM-DEFN-320

machine-readable service interface definition	reference

Model View

Status

title	TBD

Info

title	Trace

SWIM-DEFN-330

model view	reference

Abbreviations and Acronyms

Status

title	TBD

Info

title	Trace

SWIM-DEFN-350

abbreviations and acronyms	abbreviation	code	SWIM
		term	System Wide Information Management
	abbreviation	code
		term

Version	Old Version 34	New Version 35
Changes made by	WILSON Scott	WILSON Scott
Saved on	2023 Feb 02	2023 Feb 02

Page Comparison

Versions Compared

Key

Service Definition Identification

Service Identification

Service Abstract

Service Definition Provider

Geographical Extent of Information

Service Categories

Service Standard Reference

Operational Environment

Service Functions

Service Access and Use Conditions

Security Constraints

Quality of Service

Quality of Data

Source of Information

Service Validation Information

Application Message Exchange Pattern

Service Behaviour

Synchronous Request/Reply

Service Monitoring

Service Interfaces

SWIM TI Profile and Interface Bindings

Service Interface Protocols and Data Format

Service Operations

Service Messages

Information Definition (Minimum) and (Extended)

Filter Encoding

Machine-Readable Service Interface Definition

Model View

Abbreviations and Acronyms