Nominatim basiert auf OpenStreetMap-Daten und ist seit Langem die Standardwahl für Teams, die eine Geokodierungsoption ohne kommerzielle Lizenz wollten. Nutzungsrichtlinien für eine gemeinsam genutzte öffentliche Instanz können es mit wachsendem Traffic schwerer machen, sich auf diese Lösung zu verlassen, und genau hier wird ein kompatibler, kontingentbewusster Host nützlich.
Unser Nominatim-Kompatibilitäts-Host bildet die Anfrageparameter und den Antwortinhalt des Originaldienstes exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von My Geocode stammen. Anfragen im Nominatim-Format können unverändert an unseren Host gesendet werden, und die Antwort kommt in derselben Struktur zurück, die bestehender Parsing-Code bereits erwartet.
Auch hier folgt die Authentifizierung unseren üblichen vier Methoden: ein X-API-Key-Header, ein Authorization: Bearer-Header, HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder ein Query-Parameter. Da die öffentliche Nominatim-Instanz normalerweise gar keinen Schlüssel verlangt, bedeutet ein Schlüssel hier zugleich ein eigenes, nachvollziehbares Kontingent, statt eine unverwaltete öffentliche Ressource zu teilen.
Die Preise entsprechen denen jedes anderen Hosts und Endpunkts, den wir betreiben. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt darüber hinaus eigene 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits beider Kontingente kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt alles für 50 € im Monat ab.
Eine gemeinsam genutzte öffentliche Instanz muss sich mit Nutzungsrichtlinien schützen, die notgedrungen vorsichtig sind, da sie den Traffic eines Aufrufers nicht vorab von dem eines anderen unterscheiden kann. Ein Schlüssel ändert das: Die Nutzung eines Kontos wird gegen sein eigenes Kontingent verrechnet, unabhängig davon, was an diesem Tag sonst auf dem Dienst passiert. Das ist eine andere Garantie, als eine gemeinsam genutzte Ressource bieten kann, ganz gleich, wie großzügig ihre angegebene Richtlinie ist.
Auf diesem Host werden jeder Antwort Kontingent-Header beigefügt, was eine deutliche Veränderung gegenüber einer gemeinsam genutzten öffentlichen Instanz ohne Einblick pro Aufrufer ist: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used und X-Credits-Remaining sind alle enthalten, sodass Sie immer genau wissen, wo Sie stehen, statt eine unveröffentlichte Nutzungsrichtlinie erraten zu müssen.
Für Projekte, die mehr möchten, als die kompatible Antwort standardmäßig liefert, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale zusätzliche Felder hinzu, ohne die Grundstruktur zu verändern, sofern Sie das nicht verlangen.
Wer unsicher ist, wie sich ein Wechsel in einem bestimmten Land oder einer bestimmten Region verhält, findet auf der Abdeckungsseite unter /coverage/ detailliert dokumentiert, wo Geokodierungsdaten verfügbar sind. Das ist eine sinnvolle erste Anlaufstelle, bevor Sie Produktions-Traffic auf einen neuen Host lenken, ob im Nominatim-Format oder nicht.
Der Host ist unter /compatibility/nominatim/ dokumentiert, allgemeine Hinweise zum Anbieterwechsel finden Sie unter /docs/compatibility/. Wer sich heute auf eine öffentliche Nominatim-Instanz verlässt, erhält hier dieselbe Anfragestruktur mit eigenem Kontingent und klaren Kontingent-Headern.