MapQuest Geocoding ist Teil vieler langlebiger Anwendungen, von denen manche ihren Code für Standortabfragen seit Jahren nicht angefasst haben, weil er einfach weiter funktioniert. Unser Kompatibilitäts-Host ist genau für diese Situation gebaut: Code, der gut funktioniert und den niemand neu schreiben will, den ein Team aber trotzdem ohne Neuaufbau von einer alternden Integration wegbewegen möchte.
Der Host bildet die Anfrageparameter und den Antwortinhalt von MapQuest exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von uns stammen statt vom ursprünglichen Anbieter. Eine Anfrage, die derzeit für die Geokodierungs-Endpunkte von MapQuest aufgebaut ist, kann unverändert an unseren Host gesendet werden, und die zurückgegebene Antwort lässt sich genauso auswerten, wie bestehender Code es bereits erwartet.
Nötig sind nur ein neuer Hostname und ein neuer Schlüssel. Dieser Schlüssel authentifiziert sich mit derjenigen unserer vier Standardmethoden, die zu Ihrer aktuellen Integration passt: ein X-API-Key-Header, ein Authorization: Bearer-Header, HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder ein Query-Parameter.
Um diesen Schlüssel zu erhalten, müssen Sie die Kontoverifizierung nicht zuerst abschließen. Die Schlüssel eines neu registrierten Kontos funktionieren während einer Übergangsfrist, bevor My Geocode die Bestätigung der bei der Registrierung angegebenen E-Mail-Adresse verlangt; danach werden nicht verifizierte Schlüssel pausiert, statt einfach zu scheitern. Das ist genau bei dieser Art von Migrationstest wichtig, wenn jemand an einem Freitagnachmittag eine Altintegration auf einen neuen Host umstellen möchte, ohne auf den Austausch per E-Mail zu warten.
Die Preise folgen derselben Struktur wie überall sonst bei My Geocode. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt eigene, separate 2.500 kostenlose Anfragen pro Tag hinzu. Jenseits dieser Kontingente kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt die Nutzung für 50 € im Monat ab, ohne Preisunterschied zwischen diesem Host und jedem anderen.
Jede Antwort enthält dieselben Kontingent-Header wie der Rest der Plattform: 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. Zwei davon, X-Key-IPs-Used und X-Key-IPs-Limit, erfassen etwas, das sich auf Schlüssel statt auf Netze bezieht: Jeder Schlüssel darf von einer kleinen, rollierenden Anzahl von IP-Adressen aus aufgerufen werden. Das verhindert, dass ein Schlüssel über eine fremde Flotte von Servern geteilt wird, toleriert aber weiterhin ein normales Deployment, das die ausgehende Adresse einer Anwendung ändert.
Für Projekte, die mehr möchten, als die kompatible Antwort liefert, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale Felder zur Standardstruktur hinzu, rein optional.
Die Dokumentation zum Host finden Sie unter /compatibility/mapquest/, einen umfassenderen Überblick über die Kompatibilität auf der gesamten Plattform unter /docs/compatibility/. Wenn MapQuest Geocoding noch unauffällig in Ihrem Stack steckt, sehen Sie so mit geringem Aufwand, wie eine moderne Kontingentstruktur unter derselben vertrauten Struktur aussieht.