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.

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.

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.

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/

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

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