Working towards the next version of the SWIM Supporting Material

Page tree

Working towards the next version of the SWIM Supporting Material

Skip to end of metadata
Go to start of metadata
Page Table of Content

Version

This page concerns v2.0 of the Specification. Supporting material on v1.0 is SWIM-SERV-009 Service categories

Requirement

Title

Service categories

Identifier

SWIM-SERV-100

Requirement

A service description shall include the service categories to which the service belongs and, if applicable, reference the service categorisation schemes used.

Rationale

Service category information allows discovering services by a series of classification criteria.


This requirement supports decision making in terms of service suitability in relation to a particular usage context.

Verification

Completeness: Verify that a service category is present.

Consistency: Not applicable.

Correctness: Not Applicable. 

Examples/Notes

Note: The service category can be a keyword, a key phrase or a URI. It is best practice to use a URI taken from a published service categorisation scheme.

Note: An ICAO Information Service Overview expects one or more of the following categories to be used:
a)    Flight information; and/or
b)    Aeronautical information; and/or
c)    Meteorological information; and/or
d)    Environment information; and/or
e)    Capacity, demand & flow information; and/or
f)    Surveillance information; and/or
g)    Other information

Note: A set of service categorisation schemes is available at: https://reference.swim.aero/information-services/service-categories.html [RD 13]. However, it is acceptable to use other schemes.

Level of Implementation

Mandatory

Guidance

More information on service categories can be found on the Using Service Categories page. It is especially useful when listing "additional category information" as mentioned in the best practice in the requirement.

Verification Support

Completeness

Check that:

[  ] The service description includes the service categories to which the service belongs.

[  ] The service description includes, if applicable, the reference the service categorisation schemes used.

Examples

The following example shows the content as a table.

service categories





category category name

Regulated Information Exchange

value

FLIGHT_INFORMATION_EXCHANGE

scheme

http://reference.swim.aero/information-services/service-categories/CodeRegulatedInformationExchangeType

category category name

Business Activity

value

AERODROME_OPERATION

scheme

http://reference.swim.aero/information-services/service-categories/CodeBusinessActivityType

category category name

intended service consumer

value

CIVIL_AIRSPACE_USER

scheme

http://reference.swim.aero/information-services/service-categories/CodeStakeholderType

category category nameintended service consumer
value

AIRSIDE_GROUND_HANDLER

schemehttp://reference.swim.aero/information-services/service-categories/CodeStakeholderType
categorycategory nameintended service consumer
value

MILITARY_AIRSPACE_USER

schemehttp://reference.swim.aero/information-services/service-categories/CodeStakeholderType

The following example shows an extract of the content of a JSON file that conforms to the Service Metadata Schema

The Service Metadata Schema expects the use of some classification schemes such as http://reference.swim.aero/information-services/service-categories/CodeStakeholderType. This allows the json to be shorter.

Example of SWIM-SERV-100 using Service Metadata Schema
"serviceCategorisation": {
 "businessActivityType": ["AERODROME_OPERATION"],
 "intendedConsumer": ["CIVIL_AIRSPACE_USER", "AIRSIDE_GROUND_HANDLER", "MILITARY_AIRSPACE_USER"],
 "informationCategory": ["FLIGHT_INFORMATION_EXCHANGE"],
 "other": [{
  "name": "SERVICE_TYPE",
  "value": "FEATURE_ACCESS_SERVICE",
  "categorisationScheme": {
   "url": "http://reference.swim.aero/information-services/service-categories/CodeServiceType"
  }
 }]
}

Complete examples are available at Example service description.

  • No labels