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

Info

title	Explanation

Some fields in the template are left empty. This means that no requirement is specified for it and it is left to the service provider to decide.

Service Definition Identification

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-030

service definition identification	title	Service definition for the Aeronautical Aerodrome Map Request Service
	edition	00.00.01
	reference date	2023-02-09

Service Identification

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-040

service identification	service name	Aeronautical Aerodrome Map Request Service

Service Abstract

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-050

service abstract

The Aeronautical Aerodrome Map Request Service allows the service consumer to get an aeronautical aerodrome map. The map is generated using up-to-date and accurate aeronautical information for the features at aerodromes.

The content of the map can be in the request e.g. based on GIS layer and the location of the feature.

The map can be used to support various operations such as serving as a baseline map for dynamic data operations.

Service Definition Provider

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-085

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

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-090

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 PROVIDER_OF_DATA_SERVICES AIRPORT_OPERATOR
		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

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".

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.

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.

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.

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

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

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:
The AMD coding guidance shall be applied:
- https://ext.eurocontrol.int/aixm_confluence/display/ACGAMD/%28ICAO%29+Aerodrome+Mapping+Data+Sets+-+Supporting+Material

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

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	Aeronautical Aerodrome Map Request Service 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

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

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 serves a baseline (as per the AIXM 5 temporality model). Due care shall be taken to ensure the layers on the map are visible. For example, this may mean that GIS layers with a polygon geometry are below those with a a line geometry. It may be styled and/or labelled according to a service layer description (SLD) and should ensure an uncluttered map. It shall use EPSG:3857 (https://en.wikipedia.org/wiki/Web_Mercator_projection) as a minimum for its projection. The service consumer may specify another projection that is made available. Note that the projection does not alter the data. It still uses WGS-84 according Annex 15.
		type	Out
		data format	It is in raster graphical format e.g. GIF, JPEG, PNG, TIFF, 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. The resulting information shall be based on the AIXM 5.1.1 exchange language.
	message	name	Request
		description	The request to the service.
		type	In
		data format	Defined by the implementation standard.

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 aerodrome mapping data set defined by ICAO, driven by AMDB industry requirements..

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 GIS layers.

The service offers a filter based on the ICAO location indicator of an aerodrome allowing all the GIS 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 service supports a filter based on the AIRAC cycle allowing the service consumer to select a map for the current AIRAC cycle and the next AIRAC cycle.

Machine-Readable Service Interface Definition

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-320

machine-readable service interface definition	reference

Model View

Status

colour	Red
title	WORKING

Info

title	Trace

SWIM-DEFN-330

model view	reference

Abbreviations and Acronyms

Status

colour	Yellow
title	DRAFT

Info

title	Trace

SWIM-DEFN-350

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

Appendix A: References

Status

colour	Yellow
title	DRAFT

Info

title	Trace

This is not traced to a requirement.

references	reference	title	CP1
		version
		description
		url
		document type
	reference	title	Commission Implementing Regulation (EU) 2017/37
		version
		description
		url
		document type
	reference	title	AIXM 5.1.1 coding guidance https://ext.eurocontrol.int/aixm_confluence/display/ACG/Common+coding+guidelines
		version
		description
		url
		document type
	reference	title	https://aixm.aero/page/data-coding-guidelines
		version
		description
		url
		document type
	reference	title	Use of Geography Markup Language (GML) for Aviation Data
		version
		description
		url
		document type
	reference	title	AMD coding guidance https://ext.eurocontrol.int/aixm_confluence/display/ACGAMD/%28ICAO%29+Aerodrome+Mapping+Data+Sets+-+Supporting+Material
		version
		description
		url
		document type
	reference	title	Message Exchange Patterns: Identification Guidelines.
		version
		description
		url
		document type
	reference	title	ISO 19128:2005 Geographic information - Web map server interface / OGC Web Map Service 1.3.0 Interface Standard
		version
		description
		url
		document type
	reference	title	AIXM 5 temporality model
		version
		description
		url
		document type
	reference	title	Aeronautical Information Exchange Model (AIXM 5.1.1)
		version
		description
		url
		document type
	reference	title	aerodrome mapping data set defined by ICAO
		version
		description
		url
		document type
	reference	title	AMDB industry requirements.
		version
		description
		url
		document type
	reference	title	OGC Filter Encoding 2.0 Encoding Standard (equivalent to ISO 19143 - Geographic Information - Filter encoding).
		version
		description
		url
document type
reference	title	ses
	version
	description
	url
	document type

Appendix B: Information Definition for Aeronautical Aerodrome Map Request Service

Status

colour	Yellow
title	DRAFT

GIS Layer (based on AIXM 5.1.1 features)

Aeronautical Aerodrome Map Request Service

Info
The service generates maps based on AIXM features.

AerialRefuelling

AeronauticalGroundLight

AircraftGroundService

AircraftStand

y

AirportClearanceService

AirportHeliportCollocation

AirportHeliport

y

AirportHotSpot

y

AirportProtectionAreaMarking

AirportSuppliesService

y

AirspaceBorderCrossing

Airspace

AirTrafficControlService

AirTrafficManagementService

AltimeterSource

AngleIndication

ApproachLightingSystem

y

ApronElement

y

ApronLightSystem

y

ApronMarking

Apron

y

ArrestingGear

y

ArrivalFeederLeg

ArrivalLeg

AuthorityForAirspace

Azimuth

ChangeOverPoint

CheckpointINS

CheckpointVOR

CirclingArea

DeicingAreaMarking

DeicingArea

y

DepartureLeg

DesignatedPoint

DirectionFinder

DistanceIndication

DME

Elevation

FinalLeg

FireFightingService

FlightRestriction

FloatingDockSite

GeoBorder

Glidepath

GroundTrafficControlService

y

GuidanceLineLightSystem

y

GuidanceLineMarking

y

GuidanceLine

y

HoldingAssessment

HoldingPattern

InformationService

InitialLeg

InstrumentApproachProcedure

IntermediateLeg

Localizer

MarkerBeacon

MarkingBuoy

MissedApproachLeg

Navaid

NavigationAreaRestriction

NavigationArea

NDB

NonMovementArea

ObstacleArea

OrganisationAuthority

PassengerLoadingBridge

PassengerService

PilotControlledLighting

PrecisionApproachRadar

PrimarySurveillanceRadar

ProcedureDME

RadarSystem

RadioCommunicationChannel

y

RadioFrequencyArea

Road

y

RouteDME

RouteSegment

Route

RulesProcedures

RunwayBlastPad

y

RunwayCentrelinePoint

y

RunwayDirectionLightSystem

y

RunwayDirection

y

RunwayElement

y

RunwayMarking

y

RunwayProtectAreaLightSystem

RunwayProtectArea

y

Runway

y

RunwayVisualRange

SafeAltitudeArea

SDF

SeaplaneLandingArea

SeaplaneRampSite

SearchRescueService

SecondarySurveillanceRadar

SignificantPointInAirspace

SpecialDate

SpecialNavigationStation

SpecialNavigationSystem

StandardInstrumentArrival

StandardInstrumentDeparture

StandardLevelColumn

StandardLevelSector

StandardLevelTable

StandMarking

SurveyControlPoint

y

TACAN

TaxiHoldingPositionLightSystem

y

TaxiHoldingPositionMarking

y

TaxiHoldingPosition

y

TaxiwayElement

y

TaxiwayLightSystem

y

TaxiwayMarking

y

Taxiway

y

TerminalArrivalArea

TouchDownLiftOffLightSystem

y

TouchDownLiftOffMarking

TouchDownLiftOffSafeArea

TouchDownLiftOff

y

Unit

UnplannedHolding

VerticalStructure

y

VisualGlideSlopeIndicator

y

VOR

WorkArea

y

Appendix C: Operational Needs

Status

colour	Yellow
title	DRAFT

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.

By service consumer role

Stakeholder/Role	Description of stakeholder/role	Needs for Aerodrome Maps	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.	Generate graphical representations needed to support digital briefing concepts. Have an up-to-date backdrop for dynamic layers (see SDP).	Aircraft covers UAV.
MILITARY_AIRSPACE_USER	Airspace User under the authority of a military organisation.	Generate digital representation of ground operations Generate graphical representations needed to support digital briefing concepts. Have an up-to-date backdrop for dynamic layers (see SDP).	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.	Remote tower systems use different layers of visualization to highlight movement areas, buildings, etc. for air traffic controllers. AMD data can be used to create more accurate restricted zones for geofencing around aerodromes.
MILITARY_AIR_NAVIGATION_SERVICE_PROVIDER	Any public or private entity providing air navigation services for military air traffic.	Remote tower systems use different layers of visualization to highlight movement areas, buildings, etc. for air traffic controllers. AMD data can be used to create more accurate restricted zones for geofencing around aerodromes.
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).	Generate digital representation of ground operations
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.		No needs have been identified.
COMMUNICATION_NAVIGATION_AND_ SURVEILLANCE_SERVICE_PROVIDER	A provider of CNS services.		No needs have been identified.
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).	Update EFB - electronic flight bags
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.		No needs have been identified.
AIRPORT_OPERATOR	The civilian or military agency, group or individual which exercises control over the operations of the civil airport or military airfield.	Improved common situational awareness Ensure same digital representation of reality e.g. in low visibility operations (LVO) Local flight briefing/preparation tools (eg in ARO context) Airport capacity management
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.		No needs have been identified.
MILITARY_DEFENCE_CENTRE	A military defence centre. Note: these centres, e.g., check for diplomatic clearance.		No needs have been identified.

Version	Old Version 54	New Version 55
Changes made by	WILSON Scott	WILSON Scott
Saved on	2023 Mar 06	2023 Mar 06

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

Appendix A: References

Appendix B: Information Definition for Aeronautical Aerodrome Map Request Service

Appendix C: Operational Needs

Transversal

By service consumer role