In Navigations- und Logistiksoftware ist TomTom Search oft recht tief verankert, da Standortabfragen dort meist neben Routing- und Kartenaufrufen stehen, die vom selben Team im selben Stil gebaut wurden. Einen Teil zu verschieben, ohne den Rest anzufassen, ist genau das, was unser Kompatibilitäts-Host möglich machen soll.
Er bildet die Anfrageparameter und den Antwortinhalt von TomTom Search exakt nach, der einzige Unterschied sind die Texte zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die sich auf My Geocode statt auf den ursprünglichen Anbieter beziehen. Wo immer Ihr Code heute eine Geokodierungsanfrage im TomTom-Format sendet, kann er dieselbe Anfrage an unseren Host senden, und die Antwort lässt sich genauso auswerten, ohne Änderungen an Ihrer bestehenden Logik.
Routing- und Kartenaufrufe, die vom selben Team gebaut wurden, teilen meist Konventionen: dieselbe Wiederholungslogik, dieselbe Fehlerbehandlung, dieselben Erwartungen an das Timing. Wenn wir die Anfrage- und Antwortstruktur von TomTom Search exakt nachbilden, statt eine ähnliche, aber andere Geokodierungs-API anzubieten, muss diese umgebende Logik nicht neu getestet werden, nur weil ein Aufruf in der Mitte jetzt woandershin zeigt.
Für die Authentifizierung gibt es unsere üblichen vier Optionen: einen X-API-Key-Header, einen Authorization: Bearer-Header, HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder einen Query-Parameter. Die Variante, auf die sich Ihre aktuelle TomTom-Integration bereits stützt, wird auch hier ohne Änderung akzeptiert.
Die Preise sind identisch mit denen jedes anderen Hosts und Endpunkts der Plattform. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt weitere eigene 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.
Teams, die Navigations- oder Logistiksoftware betreiben, verteilen ihren Traffic oft auf mehrere Schlüssel, einen pro Umgebung oder einen pro internem Dienst, damit ein Problem in der Staging-Umgebung nie das Kontingent der Produktion aufzehrt. Auf der Schlüsselseite im Dashboard unter /dashboard/keys können Sie für eine Integration im TomTom-Format genauso zusätzliche Schlüssel erzeugen und benennen wie für jede andere.
Auch auf diesem Host werden jeder Antwort Kontingent-Header beigefügt: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used und X-Credits-Remaining sind alle vorhanden und bieten einen Einblick in die Nutzung, den eine direkte TomTom-Integration sonst nicht liefern würde.
Wenn ein Projekt mehr als die kompatible Standardantwort möchte, fügt mg_extras=1 in der Anfrage oder ein gesendeter X-MG-Extras-Header optionale zusätzliche Felder hinzu, ganz nach Ihrer Wahl, und lässt die Grundstruktur der Antwort unberührt, solange Sie nicht ausdrücklich mehr anfordern.
Der Host ist unter /compatibility/tomtom/ dokumentiert, und allgemeine Migrationshinweise für die Kompatibilitäts-Hosts der Plattform finden Sie unter /docs/compatibility/. Um eine bestehende Integration im TomTom-Format hierher umzuleiten, brauchen Sie einen geänderten Hostnamen und einen neuen Schlüssel, sonst nichts.