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.
Einen Konfidenzwert richtig lesen, bevor Sie ihm vertrauen
Ein Konfidenzwert zwischen 0.0 und 1.0 bei einem Geokodierungsergebnis sieht aus wie ein einfaches Signal für bestanden oder nicht bestanden, doch wer ihn so behandelt, verkennt, was er tatsächlich misst.
Was die Konfidenz misst
Die Konfidenz gibt an, wie sicher der Abgleich angesichts des Eingabetexts ist, dass genau dieses Ergebnis dasjenige ist, auf das sich die Eingabe bezog. Ein hoher Konfidenzwert bei einer mehrdeutigen oder ungewöhnlich formatierten Eingabe bedeutet immer noch, dass das System von seiner besten Schätzung überzeugt ist, nicht, dass die Eingabe definitiv korrekt war oder dass der Ort definitiv so existiert wie beschrieben.
GET /v1/forward?q=Main Street, Springfield&limit=1{
"status": "ok",
"query": "Main Street, Springfield",
"results": [
{"formatted": "Main Street, Springfield, IL", "lat": 39.7817, "lon": -89.6501, "type": "address", "precision": "street", "confidence": 0.62, "place_id": "sp901", "components": {}}
]
}Eine Konfidenz von 0.62 spiegelt hier wider, dass viele Orte den Namen Springfield tragen, sodass selbst ein korrekter Treffer für ein bestimmtes Springfield eine gewisse inhärente Unsicherheit darüber enthält, ob es das Springfield ist, das die Eingabe meinte.
Konfidenz und Präzision
Das sind zwei verschiedene Felder, die zwei verschiedene Dinge messen. Die Präzision beschreibt, wie spezifisch der Treffer ist: Haus, Straße oder eine gröbere Ebene. Die Konfidenz beschreibt, wie sicher sich das System bei dem gefundenen Treffer ist. Ein Ergebnis mit der Präzision „house“ kann trotzdem einen mittleren Konfidenzwert haben, wenn die Eingabe mehrdeutig war, welches Haus in welcher Straße gemeint ist, und ein Ergebnis mit der Präzision „street“ kann einen hohen Konfidenzwert haben, wenn der Treffer zwar grob, aber eindeutig war.
Einen Schwellenwert festlegen
Wählen Sie einen Konfidenz-Schwellenwert danach, was Sie ein falsches Ergebnis kosten würde. Ein Schwellenwert von 0.8 oder höher ist sinnvoll für etwas Automatisiertes mit Folgen, etwa das automatische Ausfüllen eines Versandetiketts ohne menschliche Prüfung. Ein niedrigerer Schwellenwert ist vertretbar, wenn anschließend ein Mensch das Ergebnis prüft, etwa bei einem Vorschlag, den ein Kunde bestätigen soll.
Kombination mit dem Parameter countries
Mehrdeutige Treffer wie das Springfield-Beispiel oben lassen sich oft auflösen, indem Sie die Suche mit dem Parameter countries eingrenzen, wenn Sie bereits wissen, in welchem Land die Adresse liegen sollte. Das erhöht die Chance auf einen Treffer mit hoher Konfidenz beim ersten Versuch, statt eine zweite Abfrage zu benötigen.
Die Kosten bleiben gleich
Die Konfidenz richtig zu lesen ändert nichts an den Kosten einer Abfrage, es bleibt so oder so eine Anfrage. Es ändert aber, ob Sie mit dem richtigen Maß an Vertrauen auf das Ergebnis reagieren.
Die Konfidenz ist ein spezifisches, eng umrissenes Signal und keine allgemeine Garantie für Richtigkeit, und wer sie so liest, vermeidet es, zu schnell auf einen wackeligen Treffer zu reagieren. Die vollständigen Felddefinitionen finden Sie in der Dokumentation zur Geokodierung.