Task Status

This page is part of the ongoing SWIM communities 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.

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.

-

Status Key

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

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

DRAFT

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

DRAFT

Trace

SWIM-DEFN-040

service identification	service name	Aeronautical Aerodrome Map Request Service

Service Abstract

DRAFT

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

DRAFT

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

DRAFT

Trace

SWIM-DEFN-090

geographical extent of information

Service Categories

DRAFT

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

DRAFT

Trace

SWIM-DEFN-120

service standard reference	reference
	implemented options
	deviations/additions

Operational Environment

DRAFT

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

DRAFT

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

DRAFT

Trace

SWIM-DEFN-150

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

Security Constraints

DRAFT

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

DRAFT

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

DRAFT

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

DRAFT

Trace

SWIM-DEFN-190

source of information	source	AIRPORT_OPERATOR

Service Validation Information

DRAFT

Trace

SWIM-DEFN-200

service validation information	prototyping

Application Message Exchange Pattern

DRAFT

Trace

SWIM-DEFN-210

application message exchange pattern	SYNCHRONOUS_REQUEST_REPLY

Service Behaviour

DRAFT

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

DRAFT

Trace

SWIM-DEFN-230

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

Service Interfaces

DRAFT

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

DRAFT

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

DRAFT

Trace

SWIM-DEFN-260

service interface protocols and data format	transport / messaging protocols	Shall be in accordance with SWIM TIYP: TLS1.2 or later
service interface protocols and data format	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

DRAFT

Trace

SWIM-DEFN-270

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

Service Messages

DRAFT

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)

DRAFT

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

DRAFT

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

DRAFT

Trace

SWIM-DEFN-320

machine-readable service interface definition	reference

Model View

WORKING

Trace

SWIM-DEFN-330

model view	reference

Abbreviations and Acronyms

DRAFT

Trace

SWIM-DEFN-350

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

References

DRAFT

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

Information Definition for Aeronautical Aerodrome Map Request Service

GIS Layer (based on AIXM 5.1.1 features)	Aeronautical Aerodrome Map Request Service 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

Aeronautical Aerodrome Map Request Service - Service Definition

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

References

Information Definition for Aeronautical Aerodrome Map Request Service