Page Table of Content

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 name	intended service consumer
		value	AIRSIDE_GROUND_HANDLER
		scheme	http://reference.swim.aero/information-services/service-categories/CodeStakeholderType
	category	category name	intended service consumer
		value	MILITARY_AIRSPACE_USER
		scheme	http://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.

SWIM Supporting Material

SWIM-SERV-100 Service categories

Requirement

Guidance

Verification Support

Examples