Geocodio hat sich mit unkomplizierter Batch-Geokodierung einen Namen gemacht, und eine ganze Reihe darauf aufbauender Integrationen stützt sich stark auf dieses Batch-Verhalten. Unser Kompatibilitäts-Host bildet sowohl die Anfragestruktur für Einzelabfragen als auch die für Batches exakt nach, damit diese Abhängigkeit einem Wechsel nicht im Weg steht.
Der Host bildet die Anfrageparameter und den Antwortinhalt von Geocodio präzise nach, abgesehen von den Texten zu Urheberrecht, Nutzungsbedingungen und Datenschutz, die von My Geocode stammen. Anfragen, die derzeit für die Endpunkte von Geocodio aufgebaut sind, ob einzeln oder als Batch, können unverändert an unseren Host gesendet werden, und die Antworten lassen sich genau so auswerten, wie bestehender Code es bereits erwartet.
Batch-Anfragen werden hier genauso gezählt wie überall auf der Plattform: Jede Adresse in einem Batch-Aufruf zählt als eine Anfrage, nicht der Aufruf als Ganzes. So bleibt die Kontingenterfassung genau, egal ob ein Aufruf eine Adresse oder viele enthält.
Ein Batch mit fünfhundert Adressen, der in einem Aufruf übermittelt wird, wird als fünfhundert Anfragen auf das Kontingent angerechnet, und auf das Prepaid-Guthaben, falls die kostenlosen Kontingente bereits aufgebraucht sind, genau wie fünfhundert einzelne Aufrufe. Diese Granularität sorgt dafür, dass X-Quota-Used und X-Credits-Remaining in dem Moment genau sind, in dem ein großer Batch fertig ist, statt sich erst ein paar Minuten später einzupendeln, wenn irgendein Hintergrundjob aufgeholt hat.
Für die Authentifizierung gibt es unsere vier Standardoptionen: einen X-API-Key-Header, einen Authorization: Bearer-Header, HTTP Basic Auth mit dem Schlüssel als Benutzernamen oder einen Query-Parameter, passend zu dem, was Ihre aktuelle Geocodio-Integration bereits verwendet.
Die Preise sind auf der gesamten Plattform gleich. Jede Adresse erhält 2.500 kostenlose Anfragen pro Tag ohne Schlüssel, gezählt pro Netz. Ein Schlüssel fügt eigene 2.500 kostenlose Anfragen pro Tag hinzu. Darüber hinaus kostet Prepaid-Guthaben 0,0001 € pro Anfrage, oder ein Unlimited-Paket deckt alles für 50 € im Monat ab, wobei derselbe Preis für Einzelabfragen und Batch-Einträge gleichermaßen gilt.
Gutscheincodes im Dashboard sind ein gängiger Weg, eine Batch-lastige Migration wie diese zu testen, ohne zuerst echtes Budget zu binden: Sie schreiben einem Konto Guthaben gut, bevor Sie entscheiden, ob Sie es regulär über Prepaid-Guthaben oder ein Unlimited-Paket finanzieren.
Kontingent-Header begleiten jede Antwort, ob Batch oder Einzelabfrage: X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining, X-Quota-Network-Used und X-Credits-Remaining zeigen genau, wie viele Einträge ein Batch verbraucht hat, mit einer Präzision, mit der sich gut planen lässt.
Wenn ein Projekt mehr als die kompatible Standardantwort möchte, fügt mg_extras=1 in der Anfrage oder ein X-MG-Extras-Header optionale zusätzliche Felder hinzu, ohne die Grundstruktur anzutasten, sofern dies nicht ausdrücklich angefordert wird.
Der Host ist unter /compatibility/geocodio/ dokumentiert, und allgemeine Hinweise zur Umstellung einer bestehenden Integration finden Sie unter /docs/compatibility/. Ein Test-Batch gegen den neuen Host ist ein schneller Weg, um zu bestätigen, dass die Kontingentzählung genau wie erwartet funktioniert, bevor Sie sich bei echtem Volumen darauf verlassen.