Die Nutzung Ihres Schlüssels überwachen, bevor Sie an ein Limit stoßen
Wenn Sie Ihre Kontingent-Header laufend beobachten, wissen Sie, wann ein Limit näher rückt, lange bevor eine Anfrage tatsächlich abgelehnt wird.
Unordentliche Adresseingaben vor dem Geokodieren normalisieren
In Freitext-Adressfeldern sammeln sich die unterschiedlichsten Formatierungsgewohnheiten: überflüssige Leerzeichen, uneinheitliche Groß- und Kleinschreibung, uneinheitlich ausgeschriebene Abkürzungen und gelegentlich ein verirrtes Zeichen, das von irgendwoher eingefügt wurde. Nichts davon macht eine Geokodierungsanfrage zwangsläufig kaputt, aber eine vorherige Bereinigung verbessert meist die Trefferqualität.
Was Sie vor dem Senden bereinigen sollten
Entfernen Sie führende und nachgestellte Leerzeichen und fassen Sie mehrfache Leerzeichen zu einem zusammen. Entfernen Sie Steuerzeichen und verirrte Satzzeichen, die eindeutig nicht in eine Adresse gehören. Lassen Sie den eigentlichen Adressinhalt unverändert, denn der Endpunkt für die Geokodierung ist darauf ausgelegt, Freitext zu parsen, und Sie müssen ihn nicht selbst in getrennte Felder für Straße, Stadt und Postleitzahl aufteilen.
GET /v1/forward?q=221b baker st, london&limit=1Der Endpunkt löst solche locker formatierten Eingaben in der Regel trotzdem auf, da er für echten Adresstext statt für eine starre Vorlage gebaut ist. Eine sauberere Eingabezeichenkette verringert aber bei wirklich unordentlichen Daten die Wahrscheinlichkeit eines mehrdeutigen Treffers oder eines Treffers mit geringer Konfidenz.
Ein zweites Beispiel: Abkürzungen unverändert lassen
Eine Anfrage mit gängigen Abkürzungen wie „St“ für „Street“ oder „Ave“ für „Avenue“ muss vor dem Senden nicht ausgeschrieben werden.
GET /v1/forward?q=500 5th Ave, New York&limit=1Jede Abkürzung vor dem Senden der Anfrage selbst auszuschreiben, ist zusätzliche Arbeit, die das Ergebnis selten ändert, denn der Endpunkt verarbeitet Standardabkürzungen bereits beim Parsen gewöhnlicher Adresstexte. Konzentrieren Sie Ihre Bereinigung auf wirklich fehlerhafte Eingaben, etwa eingefügte Zeilenumbrüche oder Kodierungsartefakte, statt Abkürzungen umzuschreiben, die nie ein Problem waren.
Ergebnisse mit dem Parameter countries eingrenzen
Wenn Sie bereits wissen, in welchem Land eine Adresse liegen sollte, etwa aus einer hinterlegten Rechnungsadresse oder dem regionalen Schwerpunkt einer Website, übergeben Sie es mit dem Parameter countries, um mehrdeutige Treffer bei ähnlich benannten Orten anderswo auf der Welt zu reduzieren.
GET /v1/forward?q=Springfield Main Street&countries=US&limit=3Ein Fehler, den Sie vermeiden sollten
Wenn Sie eine Adresse übermäßig bereinigen und alles entfernen, was ungewöhnlich aussieht, können Informationen verloren gehen, die der Geocoder tatsächlich brauchte. Eine Wohnungs- oder Einheitsnummer, eine Etagenangabe oder ein Gebäudename an einer Straßenadresse ist bedeutsamer Inhalt und kein Rauschen, auch wenn er anders aussieht als der Rest der Adresse. Beschränken Sie Ihre Bereinigung auf Leerzeichen, Kodierung und eindeutig verirrte Zeichen, und lassen Sie alles unverändert, was plausibel zur Adresse gehören könnte.
Die Konfidenz im Nachhinein prüfen
Normalisierung verringert schlechte Treffer, beseitigt sie aber nicht vollständig. Prüfen Sie immer das Konfidenzfeld im Ergebnis, statt anzunehmen, dass ein geliefertes Ergebnis automatisch korrekt ist, nur weil die Anfrage erfolgreich war.
Die Kosten pro Anfrage bleiben gleich
Die Bereinigung der Eingabezeichenkette vor dem Senden ändert nichts daran, wie viele Anfragen die Abfrage kostet: Es bleibt eine Anfrage pro Adresse. Was sich ändert, ist die Wahrscheinlichkeit, dass die eine Anfrage, die Sie senden, etwas Brauchbares liefert, statt einen zweiten, korrigierten Versuch zu erfordern, der eine zweite Anfrage kosten würde.
Wenn Sie die Normalisierung von Anfang an richtig machen, verschwenden Sie weniger Abfragen und erhalten nachgelagert sauberere Daten. In der Dokumentation zur Geokodierung finden Sie alle unterstützten Parameter, einschließlich countries und limit.