OGC-API-Standards definieren modulare API-Bausteine, um Web-APIs räumlich und einheitlich zu ermöglichen. Die OpenAPI-Spezifikation wird zum Definieren der API-Bausteine verwendet.
Die OGC API-Standardfamilie ist nach Ressourcentyp organisiert. Dieser Standard spezifiziert die grundlegenden API-Bausteine für die Interaktion mit Features. Die Geodaten-Community verwendet den Begriff „Feature“ für Dinge in der realen Welt, die von Interesse sind.
Für diejenigen, die mit dem Begriff „Feature“ nicht vertraut sind, bieten die Erläuterungen zu räumlichen Dingen, Features und Geometrie im Best Practice-Dokument „Spatial Data on the Web“ von W3C/OGC ausführlichere Informationen.
OGC API Features stellt API-Bausteine zum Erstellen, Ändern und Abfragen von Features im Web bereit. OGC API Features besteht aus mehreren Teilen, die jeweils einen separaten Standard darstellen. Teil 1, der „Kern“, spezifiziert die Kernfunktionen und ist auf das Abrufen von Features beschränkt, deren Geometrien im Koordinatenreferenzsystem WGS 84 mit der Achsenreihenfolge Längengrad/Breitengrad dargestellt sind. Teil 2 spezifiziert die Funktionen zum Abrufen von Features, deren Geometrien in allen anderen Koordinatenreferenzsystemen dargestellt sind. Zusätzliche Funktionen für fortgeschrittenere Anforderungen werden in weiteren Teilen spezifiziert. Beispiele hierfür sind die Unterstützung für das Erstellen und Ändern von Features, komplexere Datenmodelle, umfangreichere Abfragen, mehrere Datensätze und Sammlungshierarchien.
Teil 1 dieser Norm ist kostenlos auf dieser OGC-Website verfügbar. Das Dokument wurde auch von der Internationalen Organisation für Normung (ISO) veröffentlicht als ISO 19168-1: 2020.
Standardmäßig bietet jede API, die diesen Standard implementiert, Zugriff auf einen einzelnen Datensatz. Anstatt die Daten als vollständigen Datensatz freizugeben, bieten die OGC API Features-Standards direkten, feinkörnigen Zugriff auf die Daten auf Feature- (Objekt-)Ebene.
Die in diesem Standard festgelegten API-Bausteine entsprechen der Architektur des Webs. Insbesondere orientiert sich das API-Design an den IETF HTTP/HTTPS RFCs, den W3C Data on the Web Best Practices, den W3C/OGC Spatial Data on the Web Best Practices und den neuen OGC Web API Guidelines. Ein besonderes Beispiel ist die Verwendung der Konzepte von Datensätzen und Datensatzverteilungen, wie sie in DCAT definiert und in schema.org verwendet werden.
Dieser Standard spezifiziert Erkennungs- und Abfragevorgänge, die mit der HTTP-GET-Methode implementiert werden. Die Unterstützung für zusätzliche Methoden (insbesondere POST, PUT, DELETE, PATCH) wird in zusätzlichen Teilen spezifiziert.
Mithilfe von Erkennungsvorgängen können Clients die API abfragen, um ihre Fähigkeiten zu ermitteln und Informationen zu dieser Verteilung des Datensatzes abzurufen, einschließlich der API-Definition und Metadaten zu den von der API bereitgestellten Feature-Sammlungen.
Abfragevorgänge ermöglichen es Clients, Funktionen aus dem zugrunde liegenden Datenspeicher basierend auf einfachen, vom Client definierten Auswahlkriterien abzurufen.
