REST APIs für Datenzugriff erweitert
Zahlreiche Neuerungen stehen ab sofort zur Verfügung. Sie sind konform zu den aktuellen Entwicklungen in der Standardisierung durch das Open Geospatial Consortium (OGC).
Seit Einführung einer REST API für den Zugriff auf statische Daten in 2021 sind die Datensätze der Urban Data Platform einfacher nutzbar. Diese Schnittstelle wurde jetzt um weitere Funktionalitäten erweitert.
Die über https://api.hamburg.de/datasets/v1 verfügbaren APIs bieten ab sofort diese Neuerungen:
- komplexe Filterausdrücke formulieren (z. B. alle Straßenbäume in Othmarschen und Ottensen mit einem Kronendurchmesser zwischen 20 und 25m außer Eichen, Linden und Buchen)
- Ergebnismengen sortieren (z. B. Baudenkmale absteigend nach Fläche sortiert)
- auszuliefernde Felder steuern (z. B. staatliche Schulen mit ausgewählten Feldern)
- mehrere Textfelder der Daten durchsuchen (z. B. Sportstätten, die in einem Feld Beachvolleyball enthalten)
- das Schema der gelieferten Objekte abfragen (z. B. Schema der Objekte in der Collection club des Datensatzes Club-Kataster).
Bei der Weiterentwicklung wurde einerseits Feedback der Userinnen und User berücksichtigt, das unsere LGV-Fachleute u. a. durch die Teilnahme an Hackathons (Rad-Daten-Hackathon, BMDV DataRun) erhalten haben. Andererseits sind die aktuellen Entwicklungen der Standardisierung auf Seiten des Open Geospatial Consortium (OGC), insbesondere zu OGC API, mit eingeflossen.
Um zügig neue API-Bestandteile zur Verfügung zu stellen werden auch Implementierungen von OGC API-Standards im Entwurfsstadium veröffentlicht. Die API-Bestandteile und deren Reifegrad sind im OpenAPI-Dokument dokumentiert, beispielsweise hier.
API-Bestandteile hingegen, die nicht durch das OGC standardisiert und auch nicht auf dem Entwurf eines OGC-Standards basieren, werden nicht weiter unterstützt. Das betrifft vor allem den gesamten Download einer Collection über den Parameter „bulk“. Stattdessen können die Download-Möglichkeiten in den Formaten CSV oder GeoJSON verwendet werden. Ein Paging lässt sich mit Hilfe der Parameter „limit“ und „offset“ sowie den Eigenschaften „numberMatched“ und „links“ im Antwortdokument umsetzen.