Um mit einem SOS arbeiten zu können, braucht man erstmal Informationen über den Dienst. Zum Beispiel, welche Sensoren und Messgrößen (Phenomena) zur Verfügung gestellt werden, wo sich die Sensoren befinden, welche Objekte (Features) sie bemessen und welche der für den SOS-Dienst in Frage kommenden Operationen von diesem Dienst angeboten werden.
Mit der GetCapabilities-Anfrage kann ein Client die Selbstbeschreibung des Dienstes mit diesen Metadaten anfordern, in der diese und weitere Informationen enthalten sind.
Der GetCapabilities-Request kann als GET- oder POST-Request an den Dienst übermittelt werden.
Parameter
Die notwendigen Parameter, die mit diesem Request(GET oder POST) übermittelt werden müssen sind:
- request - fest auf "GetCapabilities"
- version - für die hier besprochene, erste Version des SOS fest auf "1.0.0"
- service - fest auf "SOS"
Optionale Parameter für diesen Request sind:
- AcceptVersions - Hier kann der Client angeben, welche SOS-Versionen von ihm unterstützt werden.
- Section - Das Dokument, welches der Dienst auf eine GetCapabilities-Anfrage hin liefert, ist in 5 Sektionen unterteilt (siehe Capabilities ). Um unnötigen Datenverkehr zu vermeiden, kann man hier angeben, welche dieser Sektionen man benötigt und vom Dienst geliefert werden sollen.
- updateSequence
- AcceptFormats - mit diesem Parameter kann man zusätzliche Angaben machen, in welcher Form das Dokument übermittelt werden kann. Default wird es als text/xml-Dokument übermittelt, aber auch komprimierte Dateien wie application/zip sind möglich.
Beispiel für einen GET-Request:
http://www.example.org/sos?SERVICE=SOS&REQUEST=GetCapabilities&VERSION=1...
Beispiele für einen POST-Request:
Kurz
<?xml version="1.0" encoding="UTF-8"?> <GetCapabilities xmlns="http://www.opengis.net/sos/1.0" xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:ogc="http://www.opengis.net/ogc" service="SOS" version="1.0.0"> </GetCapabilities>
oder mit weiteren Attributen
<?xml version="1.0" encoding="UTF-8"?> <GetCapabilities xmlns="http://www.opengis.net/sos/1.0" xmlns:ows="http://www.opengis.net/ows/1.1" xmlns:ogc="http://www.opengis.net/ogc" service="SOS"> <ows:AcceptVersions> <ows:Version>1.0.0</ows:Version> </ows:AcceptVersions> <ows:Sections> <ows:Section>OperationsMetadata</ows:Section> <ows:Section>ServiceIdentification</ows:Section> <ows:Section>Filter_Capabilities</ows:Section> <ows:Section>Contents</ows:Section> </ows:Sections> </GetCapabilities>
Die Antwort auf eine GetCapabilities-Anfrage ist ein Capabilities-Dokument
Add comment