Discovery is "the act of locating a machine-processable description of a Web service-related resource that may have been previously unknown and that meets certain functional criteria. It involves matching a set of functional and other criteria with a set of resource descriptions. The goal is to find an appropriate Web service-related resource." [Web Services Glossary]

This document defines the namespace http://discovery.swim.aero. It also serves as an open repository for artifacts that support the implementation of SWIM discovery services in the Global context.

Developer Resources

Service Description Conceptual Model (SDCM) 3.0 SDCM 3.0.0 is a graphical and lexical representation of the properties, structure, and interrelationships of all service metadata elements, collectively known as a service description.It lays out the conceptual basis for the US FAA registry, service description standards, and exchange model for SWIM Discovery Services (SDS). SDS Implementation Specification currently uses SDCM 2.0.0, found at swim.aero/sdcm.
SWIM Discovery Service (SDS) Implementation Specification, Version 1.0.0; FAA SWIM; July 2020 A document that specifies a standard interface, key interaction patterns, schemas, and message exchange formats required to develop SWIM Discovery Services (SDS).
SDS JSON Schema, Version 1.0.1 The collection of JSON schemas that together represent the information consumed or produced by a SWIM discovery service.
Service Description Model for JSON (SDM-J), Version 1.0.1 The collection of JSON schemas based on Service Description Conceptual Model(SDCM)
SWIM Discovery Service (SDS) OpenAPI schema The API offered by SDS that is compliant with OpenAPI Specification version 3.0.

Publications and Related Works

SWIM Discovery Service (SDS) Implementation Specification; OGC Technical Review Workshop; September 9, 2020 A presentation about SDS given at the OGC Technical Review Workshop
SWIM Discovery Service (SDS): Introduction; Federal Aviation Administration Fourth Meeting of APAC SWIM Task Force (TF-4); (FAA), USA, and Korea Airports Corporation (KAC), Republic of Korea (ROK); November 2020 A Working Paper that describes the enabling technologies and practices for instituting a SWIM Discovery Service.
Security and Trust in the Context of SWIM Service Discovery; Fourth Meeting of APAC SWIM Task Force (TF-4); FAA USA, KAC ROK; November 2020 A Working Paper that discusses options for securing SDS, and how the SDS effort can contribute to the establishment of a general SWIM security and trust framework for the APAC SWIM.
Implementation Status of SWIM Discovery Service (SDS); Fourth Meeting of APAC SWIM Task Force (TF-4); FAA USA, KAC ROK; November 2020 An Information Paper that describes the motivations, essential milestones, and status of work items for the SDS collaborative effort.
SWIM Discovery Service (SDS) Demonstration and Lessons Learned; Fifth Meeting of APAC SWIM Task Force (TF-5); FAA USA, KAC ROK; August 2021 A working Paper that provides a brief summary of the SDS concept, describes the SDS demonstration conducted at SWIM TF/5, and shares lessons learned from the SDS effort.
SWIM Discovery Service (SDS) Update and Next Steps, Sixth Meeting of APAC SWIM Task Force (TF-6); FAA USA, KAC ROK; Civil Aviation Administration of China Air Traffic Management Bureau (ATMB), PRC; Electronic Navigation Research Institute (ENRI), Japan; May 2022 A working Paper that describes the status and plans of a growing collaborative effort to deploy a network of SWIM Discovery Services (SDS) in the Asia Pacific Region (APAC). The effort aims to support federated service discovery among independently developed and autonomously managed SWIM domains.
SWIM Discovery Service Demonstration, Seventh Meeting of APAC SWIM Task Force (TF-7); FAA USA, KAC ROK; Civil Aviation Administration of China Air Traffic Management Bureau (ATMB), PRC; Electronic Navigation Research Institute (ENRI), Japan; May 2023 This paper describes SWIM Discovery Service (SDS) demonstration between ROK, USA, and Japan. It specifically provides capabilities to be used, topologies between SDS instances, and test-case for the demonstration.

Implementations

FAA SWIM Metadata Exchange Service (SMXS) A service that allows consumers to find and retrieve information about SWIM services maintained by the FAA. For more information, please visit FAA SWIM Registry.
KAC SWIM Metadata Exchange Service (SMXS) A service that allows consumers to discover metadata of SWIM services maintained by the KAC.

For questions regarding the content of this page contact Mark Kaplun (mark.kaplun@faa.gov)