{ 
  "informationService":{
    "descriptionInformation":{
      "descriptionIdentification":{
        "title":"EANS Aeronautical Information Feature Request Service", 
        "edition":"0.1.0",
        "referenceDate":"2026-01-01"
      }, 
      "abbreviations": [ 
	{
		"name":"AIP",
		"description":"Aeronautical Information Publication"
	},
	{
		"name":"AIM",
		"description":"Aeronautical Information Management"
	},
	{
		"name":"AIRM",
		"description":"Aeronautical Information Reference Model"
	},
	{
		"name":"AIXM",
		"description":"Aeronautical Information Exchange Model"
	},
	{
		"name":"ATM",
		"description":"Air Traffic Management"
	},
	{
		"name":"ATS",
		"description":"Air Traffic Services"
	},
	{
		"name":"EANS",
		"description":"Estonian Air Navigation Services"
	},
	{
		"name":"EU",
		"description":"European Union"
	},
	{
		"name":"GAT",
		"description":"General Air Traffic"
	},
	{
		"name":"HTTP",
		"description":"Hypertext Transfer Protocol"
	},
	{
		"name":"ICAO",
		"description":"International Civil Aviation Organization"
	},
	{
		"name":"IER",
		"description":"Information Exchange Requirement"
	},
	{
		"name":"OAT",
		"description":"Operational Air Traffic"
	},
	{
		"name":"OGC",
		"description":"Open Geospatial Consortium"
	},
	{
		"name":"SASL",
		"description":"Simple Authentication Security Layer"
	},
	{
		"name":"SESAR",
		"description":"Single European Sky ATM Research"
	},
	{
		"name":"SWIM",
		"description":"System Wide Information Management"
	},
	{
		"name":"TI",
		"description":"Technical Infrastructure"
	},
	{
		"name":"TLS",
		"description":"Transport Layer Security "
	},
	{
		"name":"WFS",
		"description":"Web Feature Service"
	},
	{
		"name":"WFS-TE",
		"description":"Web Feature Service - Temporality Extension"
	},
	{
		"name":"WMS",
		"description":"Web Map Service"
	},
	{
		"name":"WS",
		"description":"Web Service"
	},
	{
		"name": "XML",
		"description": "Extensible Markup Language"
	},
	{
		"name":"YP",
		"description":"Yellow Profile"
	}
    ] 
	},
    "serviceIdentification":{ 
      "name":"EANS Aeronautical Information Feature Request Service", 
      "version":"0.1.0" 
    }, 
    "serviceAbstract":"<p> The EANS Aeronautical Information Feature Request Service enables the service consumer to request actual and future aeronautical feature data - such as aerodromes, airspaces, navigation aids, obstacles and ATS routes – through a standardized SOAP-based request/response interface. The exact information needed by the service consumer can be specified in the information request based on feature name, location and/or time parameters. The information returned is in the form of an AIXM 5.1.1 message ensuring compliance with aeronautical information exchange standards. </p>",
	"serviceProvider": { 
		"abbreviation":"EANS",
		"providerType": [ 
        "AERONAUTICAL_INFORMATION_SERVICE_PROVIDER" 
		],
		"pointOfContact": [ 
        { 
          "name":"AIM Services", 
          "contactInformation": [ 
            { 
              "type":"URL", 
              "address":"https://aim.eans.ee " 
            } 
          ],
			"role":"To request information and access to the service."
        },
		{
			"name":"Registration form",
			"contactInformation":[
			{
				"type":"URL",
				"address":"-"
			}	
		  ],
		  "role":"Customer registration form."
		}	
      ], 
		"provider":"Estonian Air Navigation Services", 
		"providerDescription":"<p>EANS is the organisation that offers air traffic management, aeronautical information management, communication, navigation and surveillance services in Tallinn FIR.</p>"
	}, 
    "serviceCategorisation": { 
      "serviceType":"SWIM_COMPLIANT", 
      "businessActivityType": [ 
        "INFORMATION_MANAGEMENT" 
      ], 
      "intendedConsumer":[ 
        "AIR_TRAFFIC_SERVICE_PROVIDER", 
        "AIRPORT_OPERATOR", 
        "CIVIL_AIR_NAVIGATION_SERVICE_PROVIDER", 
        "CIVIL_AIRSPACE_USER", 
        "MILITARY_AIR_NAVIGATION_SERVICE_PROVIDER", 
        "MILITARY_AIRSPACE_USER", 
        "MILITARY_DEFENCE_CENTRE",
        "PROVIDER_OF_DATA_SERVICES"
      ], 
      "informationCategory":[ 
        "AERONAUTICAL_INFORMATION_EXCHANGE" 
      ], 
      "applicationMessageExchangePattern": [ 
        { 
			"name": "SYNCHRONOUS_REQUEST_REPLY" 
        } 
      ], 
	  "geospatialCategorisation": { 
			"region": [ 
			"EETT" 
			], 
			"description":"Estonian FIR" 
		},
	  "lifeCycle": [ 
		{ 
			"lifeCycleStage": "PROSPECTIVE", 
			"from": "2026-01-01" 
        } 
      ]  
    }, 
    "generalDescription": { 
      "operationalEnvironment": { 
        "operationalNeeds": [ 
        { 
            "name":"Operational needs", 
            "description":"EANS Aeronautical Information Feature Request Service provides access to aeronautical data in EANS AIM database. Data consists of actual and future infrastructure in Tallinn FIR such as aerodromes, airspaces, navigation aids and ATS routes to be used by air traffic (civil and military airspace users, Air traffic Control, Civil and Military ANSP-s, Aeronautical Information management and Military Defence centre) and surface management (Airport operators). This service satisfies the need for high quality data by offering aeronautical data in accordance with EU Comission Implementing Regulation 373/2017, EU Comission Implementing Regulation 2021/116 - Common Project One, ICAO Annex 15, ICAO Doc 10066 and SESAR Deployment Program." 
        }, 
        { 
			"name":"Information Exchange Requirements", 
            "description":"A3SG-IER-01 AIP Data Exchange, as follows: Allow civil and military Airspace users, ATS, Airport operators, civil and military ANSP-s, AIM and military defence centre to subscribe to aeronautical information feature service. Users can choose the data, they would like to have access to and receive baseline data and any updates to it."
		} 
        ], 
        "capabilities": [ 
        { 
            "name":"Aeronautical Features", 
            "description":"Service offers high-quality, latest, trusted and regulated aeronautical AIXM 5.1 formatted data retrieval. Service offers following capabilities: Authentication to use the service; Retrieving baseline+tempdelta data; Retrieving AIXM features; Filtering – using filters such as time, feature identifier, feature type, feature properties (active/not active/ready for activation), airspaces, airports etc." 
		} 
       ] 
      }, 
		"functionality": [ 
        { 
			"name":"Request aeronautical data", 
			"description":"User retrieves features with data necessary only for your flight using filtering.", 
			"realWorldEffect":"Unnecessary data for flight planning is filtered out and dataset has been shared." 
        }, 
        { 
			"name":"Check connection status ", 
			"description":"User can request service status and service provides status code.", 
			"realWorldEffect":"Statuscode is received " 
        }, 
		{ 
			"name":"Check latest data update ", 
			"description":"User can request latest update date and time.", 
			"realWorldEffect":"Temporal information about database is received " 
        } 
		], 
		"qualitiesOfService": {  
			"performance": [  
        {  
			"name":"Capacity",  
			"description": "The service shall achieve a quality of processing 25 200 requests per hour."  
        },  
        {  
			"name":"Response time",  
			"description": "The service shall achieve a quality 0.955 second delay for 95% of messages."  
        }  
       ],  
        "reliability": [  
        {  
            "name":"Availability",  
			"description": "High Availability – 95%: Service disruption is minimal, support for cluster or multiple instances. Autoscaling: Ability to scale according to load. If one instance goes down, traffic is automatically redirected to another."  
        },  
        {  
            "name":"Recoverability",  
            "description": "Recovery is performed automatically or in a managed manner according to policy. Loss of configuration and authentication data is not allowed. Configuration and queue metadata are backed up regularly. API Gateway configuration is backed up automatically. In case of system failure, the service must be restored the next business day. In case of force major this may not be guaranteed."  
        }  
       ],  
        "security": [  
        {  
            "name":"Confidentiality",  
            "description": "Data confidentiality is ensured by the implemented security mechanisms: mTLS ensures mutual authentication between client and server (client and server certificates) and all connections are secured with TLS 1.2/1.3 encryption."  
        },  
        {  
            "name":"Integrity", 
			"description": "Data integrity is maintained, no messages or critical queries are lost."  
        }  
       ]  
    },  
	"accessAndUseConditions": [  
		{  
			"name":"Authentication and Authorisation",  
			"type":"SECURITY_CONSTRAINT",  
			"description": "Only authenticated users are authorised to use the service. The service shall ensure consumer authentication in accordance with the EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile through the use of a X.509 certificate over mTLS and the use of a username/password (SASL). In order to use the service and have access to appropriate service functions and operations, the client must have user roles granted in service provider authentication system. "  
		},  
		{
			"name":"Access",  
            "type":"LEGAL_CONSTRAINT",  
            "description":"In order to be able to access and use the EANS Aeronautical Information Feature Request service, users need to become certified clients. The authentication to the service is performed as basic authentication: 1. Register as a service user via web-form (registration form will soon be accessible from our aim webpage), you will be provided with username and password 2.Authenticate with x.509 via mTLS. 3. Username and password will later be used for authentication and authorization for using the service. 4. By sending us a request for signing up as a client, you agree with our terms and conditions. ",					
            "reference": {  
				"description":"Terms and Conditions - soon to be published",
				"url":"https://aim.eans.ee/"
            }  
        },  
		{  
            "name":"Policy",  
            "type":"SERVICE_POLICY",  
      		"description":"When signing up as a service user, we ask for your personal information: full name, organization name, organizational e-mail address, organizational mobile phone number. When you fill the contact form, you do so voluntarily. We only use the information provided by you for our own business purposes, such as providing access to the service.",  
            "reference": {  
                "description":"Terms and Conditions - soon to be published",
				"url":"https://aim.eans.ee/"
            }  
		},  
		{  
			"name":"Fair Use",  
			"type":"SERVICE_CONSUMPTION_CONSTRAINT",  
			"description":"soon to be published" 
		} 
	   ],   
	"validation": [  
		{  
			"type":"SELF_VALIDATION",  
			"description":{  
				"validationSteps":"Before allowed access to live API, the client must test that their API endpoint is compliant with service configurations. The verification process is performed in service provider test environment. Client must run validation checks to ensure proper functionality, security and data format compliance. Once the clients endpoint is confirmed as compliant, the live service full access is activated enabling seamless system integration.",
				"validationResults":"For information about the achieved results, please approach the designated point of contact." 
			}
		}
	],
	"serviceSupport":[ 
        { 
          "name":"AIM Service Desk", 
          "role":"To report incidents about services in operation.",
		  "contactInformation":[ 
            { 
              "type":"EMAIL", 
              "address":"swim@eans.ee" 
            } 
          ]
		} 
    ],
	"dateInOperation":"2026-01-31"	  
    }, 
    "informationDescription": { 
		"informationDefinition":[ 
        { 
            "name":"Aeronautical Information Features", 
            "definition":"The service implements parts of the WFS-TE standard, specified explicitly for querying and retrieving geospatial data with temporal extensions like AIXM 5.1. In subject to the query type different output formats will be supported. The output format can be specified for each query (see below the description of the different query types). To define a specific output format will have an impact on the query response. In general, following output formats are supported 1. text/xml; subtype=aixm. A well-formed and valid AIXM will be returned as text content of an XML element. 2. xml/aixm: The response contains the queried AIXM as XML content.", 
			"datatype":"The default feature version of the query responses is AIXM 5.1. The service supports AIXM 5.1.1 features described in Aeronautical Information Request Service Information Definition Appendix B.", 
			"airmCorrespondence":"True"
        } 
      ],  
		"filtering": { 
          "capability": [ 
		{ 
			"name":"OGC Filter Encoding 2.0 Encoding Standard", 
			"description":"The service implements OGC Filter Encoding 2.0 Encoding Standard. Service supports following logical operators: AND, OR, NOT. The service supports following spatial operators: Within, DWithin, BBox. Service supports following Comparison Operators: PropertyIsEqualTo-Operator, PropertyIsNotEqualTo-Operator, PropertyIsLessThan-Operator, PropertyIsGreaterThan-Operator, PropertyIsLessThanOrEqualTo-Operator, PropertyIsGreaterThanOrEqualTo-Operator, PropertyIsNull-Operator, PropertyIsNil-Operator, ContainsProperty-Operator. Service supports following Reference Operators: References, ReferencedBy.", 
			"reference":{ 
				"description":"OGC Filter Encoding 2.0 Encoding Standard", 
				"url":"https://www.ogc.org/standards/filter/" 
			} 
		},  
		{ 
			"name":"OGC Filter Encoding 2.0 Encoding Standard- Temporal Extension", 
            "description":"The service supports the retrieval of AIXM 5.1 features. All temporal operators described in OGC Web Feature Service (WFS) Temporality Extension (Doc nr OGC 12-027r3) are supported. Restriction: the interpretation cannot be SNAPSHOT if temporal filters are used.",
			"reference": { 
				"description":"OGC Web Feature Service (WFS) Temporality Extension", 
				"url": "https://portal.opengeospatial.org/files/?artifact_id=58922" 
			}
		}
       ] 
      }, 
      "sourceOfInformation":"The service will receive information from the data originators that have signed service level agreement with EANS. This includes: - AIRPORT_OPERATOR - CIVIL_AIR_NAVIGATION_SERVICE_PROVIDER - MILITARY_AIR_NAVIGATION_SERVICE_PROVIDER - COMMUNICATION_NAVIGATION_AND_SURVEILLANCE_SERVICE_PROVIDER - MILITARY_DEFENCE_CENTER - CIVIL AVIATION ADMINISTRATION - Government Agencies. EANS aims at achieving the level of minimal to no modifications made when receiving information from data originators." 
    }, 
    "technicalDescription":{ 
			"serviceMonitoring":{ 
			"monitoringDescription":"When you sign up to use the service, your IP-address will be logged for analytics and behavioural purposes." 
		}, 
		"technicalConstraint":[
		{
		"name":"Comparison operators",
		"description":"The attributes matchCase and matchAction are not supported and ignored."
		},
		{
		"name":"Conformance with WFS-TE",
		"description":"Temporal filters on the valid time are supported but the interpretation cannot be SNAPSHOT if temporal filters are used."
		}
		],
		"behaviour": [ 
        { 
			"name":"Normal Behaviour", 
			"description":"Users can request baseline data through OGC Web Feature Service 2.0. There is no automatic dataset publication, all data is available in the database and users can request desired data. Client sends a SOAP request to the server (request message) and it processes the respective response. To do this the actual request has to be embedded into the standard SOAP envelope and sent via HTTP to the server. Then the AIXM Basic Message (the reply message) is sent from the service to the consumer. The response is embedded into a SOAP envelope and body just like the request. The service behaviour is in accordance with the synchronous request-reply message exchange patterns detailed in the Message Exchange Patterns: Identification Guidelines. " 
        }, 
		{         
			"name":"Error Handling", 
			"description":"Incase of erroneous or invalid request an XML FaultMessage on the SOAP-level shall be generated indicating that an error has occurred."  
		} 
      ] 
    }, 
    "serviceInterface": [  
	{ 
			"name":"Aeronautical Information Feature Request Service Interface", 
			"description":"The interface is used to group the operations offered by the OGC Web Feature Service 2.0 Interface Standard.", 
			"provisionSide":"PROVIDER_SIDE",  
			"messageExchangePattern":"SYNCHRONOUS_REQUEST_REPLY", 
			"operations": [ 
			{  
				"name":"GetCapabilities",  
				"description":"Returns XML metadata with information describing a WFS service provided by a server. ",  
				"idempotency":"IDEMPOTENT",
				"messages": [  
				{  
					"name":"Request",  
					"direction": "IN"  
				}, 
				{  
					"name":"Capabilities", 
					"direction": "OUT"  
				} 
				] 
			},	 
			{ 
				"name":"GetFeature", 
				"description":"The GetFeature operation allows the retrieval of time slices. The GetFeature request will result in a GetFeatureResponse answer containing a queryResult in the form of an XML file for every query defined in the request. The default feature version of the query responses is AIXM 5.1. ", 
				"idempotency":"NON_IDEMPOTENT", 
				"messages":[ 
				{ 
					"name":"GetFeature", 
					"direction":"IN" 
				}, 
				{ 
					"name":"GetFeatureResponse ", 
					"direction":"OUT" 
				} 
				]
			}  
		],
			"endpoints":[
			{
				"name":"AIM API endpoint",
				"url":"https://aimapi.eans.ee/cadas-aimdb/wfs"
			}
		], 
			"serviceInterfaceBinding":{
				"name":"SWIM_TI_YP_1_1_WS_SOAP_WITH_BASIC_MESSAGE_SECURITY",
				"description":"The service Interface binding is compliant with EUROCONTROL Specification for SWIM Technical Infrastructure (TI) Yellow Profile."
			},
			"networkInterfaceBinding": { 
				"name":"IPV4_Secure Unicast", 
				"description":"The service shall use the network bindings of the SWIM TIYP IPv4 Secure Unicast." 
			}, 
			"messages": [ 
			{ 
				"name":"Error status code", 
				"description":"The service uses A Common Fault Message Schema. Any errors and fault messages that can occur are categorized into different fault-message-groups. To communicate such a message an object called FaultMessage is used on the SOAP-level and made up of the properties type, the errorMessageCode, maybe one or more errorMessageParameters and defaultErrorMessage.", 
				"schema": {
					"description":"Hypertext Transfer Protocol (HTTP) Status Code Registry",
					"url":"https://www.iana.org/assignments/http-status-codes/http-status-codes.xhtml",
				"isError":true
				}
			} 
		] 
	}         
   ],
	"references": {  
			"serviceDocument": [  
			{  
				"documentType":"MACHINE_READABLE_SERVICE_DESCRIPTION",  
				"title":"Interface WSDL",
				"version":"21.6.1",
				"description": "Machine processable description of the service interface",
				"reference":{  
					"url":"https://schemas.xmlsoap.org/wsdl/"
				}
			},
			{  
				"documentType":"SERVICE_DESCRIPTION",  
				"title":"Interface Control Document",  
				"version":"21.6.1",  
				"description":"The CADAS-AIMDB Interface Control Document (ICD) contains a description of all interfaces provided by CADAS-AIMDB for the exchange of information with external systems"
			},
			{  
				"documentType":"SERVICE_DESCRIPTION",  
				"title":"Service Categories",
				"version":"-",
				"description":"A set of service categorisation schemes for use in artefacts that describe services.",
				"reference":{  
					"url":"https://reference.swim.aero/information-services/service-categories.html"  
				}  
			},  
			{ 
				"documentType":"SERVICE_SPECIFICATION",
				"title":"Appendix A: References",
				"version":"-",
				"description":"Aeronautical Information Request Service - Service Definition - Aeronautical SWIM Services - SWIM Confluence atlassian.net", 
				"reference": {
					"url":"https://swim-eurocontrol.atlassian.net/wiki/x/RQGUAw"
				}
			},
			{
				"documentType":"SERVICE_SPECIFICATION", 
				"title":"Appendix B: Information Definition for Aeronautical Information Request Service", 
				"version": "-", 
				"description":" Aeronautical Information Request Service - Service Definition - Aeronautical SWIM Services - SWIM Confluence (atlassian.net)", 
				"reference": {
					"url":"https://swim-eurocontrol.atlassian.net/wiki/x/RQGUAw"
					
				}
			}
		],
			"implementedStandard":[
			{
				"title":"OGC Web Feature Service",
				"standardType":"SERVICE_STANDARD",
				"conformanceStatement":"The service conforms with the standard as per Technical Constraints section of the current service description.",
				"version":"2.0/1.1.0/1.0.0",
				"description":"This standard defines direct fine-grained access to geographic information at the feature and feature property level by specifying discovery, query, locking and transaction operations and operations to manage stored, parameterized query expressions. This standard covers 11 operations e.g. GetCapabilities (discovery operation). This Standard continues to be a reliable means to provide geospatial data to the web. However, the functional capabilities are now available in a more modern web API, OGC API – Features, and implementers are encouraged to use the newer Standard.",
				"reference":{
					"description":"OGC Web Feature Service",
					"url":"https://www.ogc.org/standards/wfs/"
				}
			},
			{
				"title": "OGC Filter Encoding", 
				"standardType": "SERVICE_STANDARD",
				"conformanceStatement": "The service conforms with the standard as per Technical Constraints section of the current service description.", 
				"version": "2.0",
				"description":"This standard is a jointly developed OGC and ISO TC/211 International Standard that describes an XML and Key Value Pairs (KVP ) encoding of a system neutral syntax for expressing projections, selection and sorting clauses collectively called a query expression.", 
				"reference":{
					"description":"OGC Filter Encoding 2.0 Encoding Standard",
					"url":"https://www.ogc.org/standards/filter/"
                }
			},
			{
				"title": "Eurocontrol Specification for SWIM Service Description",
				"standardType": "SERVICE_STANDARD",
				"conformanceStatement": "The service conforms with the standard.",
				"version": "2.0",
				"description":"This specification contains requirements for service descriptions, describing information services, in the context of System Wide Information Management (SWIM). ", 
				"reference":{
					"description":" Eurocontrol Specification for SWIM Service Description ",
					"url":"https://www.eurocontrol.int/sites/default/files/2022-03/eurocontrol-swim-service-description-specification-v2-0.pdf"
				} 
			}, 
			{ 
                "title": "Eurocontrol Specification for SWIM Technical Infrastucture (TI)Yellow Profile",
                "standardType": "SERVICE_STANDARD",
                "conformanceStatement": "The service conforms with the standard as per Technical Constraints section of the current service description.",
                "version": "2.0",
                "description":"This specification contains requirements for the implementation of technical infrastructure supporting information exchanges in System Wide Information Management (SWIM). It enables technical interoperability by specifying standardised technical interfaces (e.g. protocols) and the capabilities required to enable a reliable, secure and efficient exchange of information.",
				"reference":{ 
					"description":"Eurocontrol Specification for SWIM Technical Infrastucture (TI)Yellow Profile ", 
					"url":"https://www.eurocontrol.int/sites/default/files/2025-07/eurocontrol-spec-swim-tiyp-ed-2-0.pdf" 
                }
			}
		]
    }
  }
 }