Geocode.Farm betreibt schon lange unauffällig die Geokodierung in einer Reihe kleinerer Anwendungen und interner Tools, oft in einer frühen Entwicklungsphase eingebunden und seitdem nicht mehr angefasst. Unser Kompatibilitäts-Host ist genau für diese Art von Integration gedacht, eine, die problemlos läuft und einen einfachen Weg nach vorn verdient statt eines Neuschreibens.
Der Host bildet die Anfrageparameter und den Antwortinhalt von Geocode.Farm exakt nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von My Geocode stammen. Anfragen, die derzeit für die Endpunkte von Geocode.Farm aufgebaut sind, lassen sich unverändert auf unseren Host umleiten, und die Antwort kommt in derselben Struktur zurück, die bestehender Code bereits erwartet.
Für den Wechsel ändern Sie einen Hostnamen und einen Schlüssel, und nichts an der Logik zum Erstellen der Anfrage oder zum Auswerten der Antwort. Dieser Schlüssel kann sich als X-API-Key-Header, als Authorization: Bearer-Header, per HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder als Query-Parameter authentifizieren, passend zu dem, was Ihre aktuelle Integration bereits sendet.
Ältere Integrationen wie diese wurden oft direkt mit rohen HTTP-Aufrufen geschrieben, bevor es ein SDK für den Anbieter gab oder sich dessen Einsatz lohnte. My Geocode veröffentlicht eigene SDKs, aufgelistet unter /sdks/, für alle, die ganz von rohem HTTP wegkommen möchten, während sie diesen Teil des Codes ohnehin anfassen, auch wenn der Kompatibilitäts-Host das in keiner Weise voraussetzt.
Die Preise folgen denselben Regeln wie auf dem Rest der Plattform. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ganz ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt darüber hinaus eigene 2.500 kostenlose Anfragen pro Tag hinzu. Darüber hinaus kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt die Nutzung für 50 € im Monat ab, wobei derselbe Preis gilt, unabhängig davon, welcher Host den Aufruf verarbeitet hat.
Jede Antwort 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, und damit eine Sicht auf die Nutzung, die eine kleinere, ältere Integration vielleicht nie zuvor hatte.
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 zusätzliche Felder hinzu, rein optional und standardmäßig deaktiviert.
Damit steigt die Zahl unserer veröffentlichten Kompatibilitäts-Hosts auf insgesamt siebzehn, verteilt auf Geokodierung, IP-Geolokalisierung und Höhe. Bei dieser Zahl ging es weniger darum, jeden denkbaren Anbieter abzudecken, als vielmehr die Anbieter, die echte Integrationen tatsächlich nutzen, weshalb sich die Liste über diese drei Kategorien erstreckt, statt sich ganz auf eine davon zu konzentrieren.
Der Host selbst ist unter /compatibility/geocode-farm/ dokumentiert, und die vollständige Liste finden Sie unter /compatibility/. Wenn Geocode.Farm Teil einer älteren Integration in Ihrem Stack ist, sehen Sie so mit wenig Aufwand, wie eine moderne Kontingentstruktur hinter derselben Anfragestruktur aussieht.