HERE Geocoding and Search steckt hinter einem guten Teil der Logistik-, Automobil- und Standortsoftware, oft als ein Baustein unter vielen und nicht als das ganze System. Wenn ein Anbieter so tief eingebettet ist, bedeutet die Prüfung einer Alternative meist, Entwicklungskosten gegen einen ungewissen Nutzen abzuwägen. Unser HERE-Kompatibilitäts-Host ist dafür gebaut, die Entwicklungskosten vollständig aus dieser Rechnung zu nehmen.
Der Host bildet die Anfrageparameter und den Antwortinhalt von HERE exakt nach, die einzigen Unterschiede sind die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von uns stammen statt vom ursprünglichen Anbieter. Client-Code, der bereits Anfragen im HERE-Format erstellt und Antworten im HERE-Format liest, muss nicht angefasst werden. Er braucht nur einen anderen Hostnamen und einen Schlüssel von My Geocode.
Dieser Schlüssel funktioniert auf jedem Host, den wir betreiben, auf dieselbe flexible Weise, auch auf diesem: als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als Query-Parameter. Verwenden Sie einfach die Variante, die Ihr bestehender Client bereits sendet, denn alle vier werden ausnahmslos auf jedem Endpunkt und jedem Kompatibilitäts-Host erkannt.
Unter der kompatiblen Oberfläche gelten unsere Preise, und die sind überall auf der Plattform gleich. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel, gezählt pro Netz, sodass das kostenlose Kontingent eher einem einzelnen Standort oder Büro entspricht als jedem einzelnen Gerät, das darüber läuft. Ein Schlüssel fügt eigene, separate 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits beider Kontingente kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt die Nutzung für 50 € im Monat ab, ohne Aufpreis für die Nutzung eines Kompatibilitäts-Hosts statt eines nativen Endpunkts.
Jede Antwort, ob kompatibel oder nicht, enthält unseren vollständigen Satz an Kontingent-Headern: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used, X-Credits-Remaining, X-Key-IPs-Used, X-Key-IPs-Limit und X-Quota-Reset. Das bietet eine Transparenz bei der Nutzung, die die Original-API nicht mitbringt, ohne den Inhalt der Antwort selbst zu verändern.
Wenn ein Projekt mehr benötigt, als die kompatible Struktur liefert, fügt mg_extras=1 in der Anfrage oder ein gesendeter X-MG-Extras-Header optionale Felder wie die Geländehöhe hinzu, rein optional. Lassen Sie es weg, entspricht die Antwort exakt dem Format von HERE.
Der Kompatibilitäts-Host ist unter /compatibility/here/ dokumentiert, und einen umfassenderen Überblick darüber, wie der Wechsel bei allen siebzehn Hosts funktioniert, finden Sie unter /docs/compatibility/. Ein einzelner Testaufruf reicht meist, um zu sehen, ob es passt.