OLCA

Was ist OLCA?

OLCA ist eine Programmierschnittstelle (API) zur Konvertierung von Koordinaten in Plus codes des Open Location Codes und umgekehrt. Sie kann zum Beispiel in Online-Portale eingebunden werden, um diese mit einer entsprechenden Suche auszustatten.
Im „Kartenmodus“ dient OLCA zudem auch der massenhaften Erzeugung von Plus codes innerhalb definierter Gebiete („Bounding-Boxen“). Somit lässt sich beispielsweise die Datengrundlage für OGC-Dienste dynamisch erzeugen.
Für die Konvertierung an sich nutzt OLCA, die vollständig in Python entwickelt ist, die entsprechende Bibliothek von Google, die unter der unter der Freien-Software-Lizenz Apache License 2.0 auf GitHub veröffentlicht ist.

Wo kann man OLCA ausprobieren?

OLCA ist zum Beispiel in Geoport.HRO eingebunden, dem Portal für Geodaten der Hanse- und Universitätsstadt Rostock und Umgebung: Wenn man dort im linken Seitenbereich auf Suche nach Open Location Codes (Plus codes) klickt und eine Suchanfrage startet, nutzt man OLCA.
Auch in der Anschau-/Druckanwendung der Offenen Regionalkarte Mecklenburg-Vorpommern (ORKa.MV) ist OLCA eingebunden – nutzen Sie dort einfach das Sucheingabefeld in der Seitenmitte.

Wie kann man OLCA selbst nutzen?

OLCA ist eine Open-Source-Software und unter der Freien-Software-Lizenz Apache License 2.0 auf GitHub veröffentlicht: Somit ist sie für jedermann frei nutzbar!
Alles rund um Installation, Konfiguration und Arbeit mit OLCA kann man in den entsprechenden Erläuterungen nachlesen.

Wie kann man OLCA direkt bei der Hanse- und Universitätsstadt Rostock nutzen?

Bei der Hanse- und Universitätsstadt Rostock ist OLCA unter den API-Endpunkten https://geo.sv.rostock.de/olca/ (für die Such-/Konvertierungsfunktionen) und https://geo.sv.rostock.de/olca/map (für den „Kartenmodus“) zu erreichen. Unterstützt werden die HTTP-Methoden GET und POST, letztere kann entweder mit Formulardaten (also Content-Type: application/x-www-form-urlencoded) oder mit JSON-Body (also Content-Type: application/json) genutzt werden.

Beispiel-URL für einen (GET-)Aufruf, ganz normal via Webbrowser – Suche nach einem Koordinatenpaar:
https://geo.sv.rostock.de/olca/?query=12.097875,54.092875

Beispiel-URL für einen (GET-)Aufruf, ganz normal via Webbrowser – Suche nach einem regionalen Plus code:
https://geo.sv.rostock.de/olca/?query=33VX+55 rostock&epsg_out=25833

Beispiel-URL für einen (GET-)Aufruf, ganz normal via Webbrowser – Erzeugung aller Plus codes innerhalb einer „Bounding-Box“:
https://geo.sv.rostock.de/olca/map?bbox=12.51,54.22,12.513,54.222&epsg_out=2398

Beispiel-URL für einen (GET-)Aufruf, ganz normal via Webbrowser – Suche nach einem vollen Plus code:
https://geo.sv.rostock.de/olca/?query=9F6J33VX+55&epsg_out=25833

Dasselbe Beispiel als GET-Aufruf mittels cURL:
curl 'https://geo.sv.rostock.de/olca/?query=9F6J33VX+55&epsg_out=25833'

Dasselbe Beispiel als POST-Aufruf mit Formulardaten, ebenfalls mittels cURL:
curl -X POST --data 'query=9F6J33VX+55&epsg_out=25833' \
https://geo.sv.rostock.de/olca/

Dasselbe Beispiel als POST-Aufruf mit JSON-Body, abermals via cURL:
curl -X POST -H 'Content-Type: application/json' \
--data '{ "query": "9F6J33VX+55", "epsg_out": 25833}' \
https://geo.sv.rostock.de/olca/

Und wie sieht es aus mit OGC-Diensten zu den Plus codes?

Angeboten wird ein WMS mit den Plus codes des Open Location Codes weltweit, der zum Beispiel in Geoport.HRO eingebunden ist.

Gibt es die Plus codes auch als Daten zum Herunterladen für die lokale Nutzung?

Im Open-Data-Portal der Hanse- und Universitätsstadt Rostock stehen die Plus codes des Open Location Codes zum Download bereit.

Ansprechpartner

Hanse- und Universitätsstadt Rostock
Kataster-, Vermessungs- und Liegenschaftsamt
Holbeinplatz 14
18069 Rostock
Telefon: +49 381 381-6281
Telefax: +49 381 381-6902
E-Mail: geodienste@rostock.de