Migration

Migration von OpenStreetMap Nominatim

Nominatim nimmt unter den Geokodierungsoptionen eine ungewöhnliche Stellung ein, denn es ist sowohl Open-Source-Software, die Sie selbst betreiben können, als auch eine öffentliche Demo-Instanz, die jeder direkt abfragen kann. Diese unterliegt einer Nutzungsrichtlinie, die einen aussagekräftigen User-Agent-Header und ein vernünftiges Anfragetempo statt eines formellen API-Schlüssels erwartet. Die JSON-Antwort enthält einen display_name-String, ein lat- und lon-Paar als Strings statt als Zahlen sowie ein address-Objekt mit den eigenen Tagging-Konventionen von OpenStreetMap wie road, suburb und postcode.

Teams stoßen bei der öffentlichen Instanz meist an eine Grenze, sobald ihr Traffic über das hinauswächst, was eine gemeinsam genutzte Community-Ressource auffangen soll. Nominatim selbst zu hosten ist eine echte, aber aufwendige Option: Man muss einen großen Planet- oder regionalen OpenStreetMap-Datenextrakt herunterladen und importieren, diese Daten aktuell halten und die Serverinfrastruktur auf unbestimmte Zeit selbst betreiben. Diesen Kompromiss, Infrastruktur- und Wartungsarbeit im Tausch gegen Kontrolle, sollte man ehrlich abwägen, bevor man sich für einen der beiden Wege entscheidet.

Der Nominatim-Kompatibilitäts-Host von My Geocode bildet die Feldstruktur von display_name, lat, lon und der Adresse exakt nach. Nur die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz unterscheiden sich von der Ausgabe von Nominatim selbst. Details finden Sie unter /compatibility/nominatim/. Code, der für die öffentliche Nominatim-Instanz geschrieben wurde, einschließlich der als Strings typisierten Koordinatenfelder, sollte Antworten des Kompatibilitäts-Hosts ohne Änderungen verarbeiten.

Was sich bei dieser konkreten Migration tatsächlich ändert:

  • Keine an eine gemeinsame Nutzungsrichtlinie gebundene Pflicht zum User-Agent-Header mehr; die Authentifizierung erfolgt stattdessen über einen Schlüssel, der als X-API-Key-Header, Authorization: Bearer-Header, per HTTP Basic Auth oder als Query-Parameter gesendet wird
  • Ein vorhersehbares tägliches Kontingent statt eines nicht näher festgelegten Ratenlimits für eine gemeinsam genutzte Ressource: 2.500 Anfragen pro Tag kostenlos ohne Schlüssel und weitere 2.500 kostenlos pro Schlüssel und Tag, gezählt pro Netzwerk
  • Keine Infrastruktur zu betreiben und kein OpenStreetMap-Datenextrakt zu pflegen, da der gehostete Dienst das übernimmt

Jenseits des kostenlosen Kontingents gibt es Prepaid-Guthaben zu 0,0001 € pro Anfrage oder einen Unlimited-Schlüssel zu 50 € pro Monat, und jeder Endpunkt, einschließlich dieses Kompatibilitäts-Hosts, kostet genauso viel wie jeder andere auf der Plattform.

Für Teams, die gerade die Grundlage von Nominatim in offenen Geodaten geschätzt haben, ist gut zu wissen, dass die an OpenStreetMap-Konventionen angelehnten Feldnamen wie suburb und postcode statt allgemeinerer Begriffe in der Struktur dieses Kompatibilitäts-Hosts erhalten bleiben. Das Adressvokabular, das Ihr Code bereits erwartet, sollte also auch nach der Migration noch passen.