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.
Ein „Meinten Sie“-Vorschlagsfeld mit Autovervollständigung bauen
Ein „Meinten Sie“-Feld funktioniert am besten, wenn es dezent erscheint, eine kurze Liste anbietet und aus dem Weg geht, wenn keiner der Vorschläge passt. Der Autovervollständigungs-Endpunkt ist genau für dieses Muster gebaut.
Die Anfrage
GET /v1/autocomplete?q=Baker Stret&limit=4{
"status": "ok",
"query": "Baker Stret",
"suggestions": [
{"text": "Baker Street, London, UK", "place_id": "abc123"},
{"text": "Baker Street, York, UK", "place_id": "abc789"}
]
}Beachten Sie, dass ein Tippfehler wie „Stret“ in der Anfrage nicht verhindert, dass sinnvolle Vorschläge zurückkommen, da der Endpunkt für unvollkommene Eingaben gebaut ist, und genau darum geht es bei einem Vorschlagsfeld überhaupt.
Ein zweites Beispiel: überhaupt keine Vorschläge
Nicht jede Anfrage, ob mit Tippfehler oder ohne, liefert einen brauchbaren Treffer.
GET /v1/autocomplete?q=Zzqxlm Nonexistent Rd&limit=4{
"status": "ok",
"query": "Zzqxlm Nonexistent Rd",
"suggestions": []
}Ein leeres Array suggestions ist hier eine korrekte Antwort und kein Zeichen dafür, dass bei der Anfrage etwas schiefgelaufen ist. Gestalten Sie das Feld so, dass es in diesem Fall dezent verschwindet, statt ein leeres Dropdown oder einen sichtbaren Fehlerzustand für eine Eingabe anzuzeigen, zu der es einfach keinen guten Treffer gibt.
Die Liste anzeigen
Zeigen Sie das Feld text jedes Vorschlags als sichtbare Bezeichnung an und behalten Sie die place_id des angeklickten Vorschlags bei, denn diese Kennung geben Sie anschließend weiter, um die vollständige Adresse aufzulösen, statt den angezeigten Text erneut zu parsen.
Optional bleiben
Der wichtigste Teil dieses Musters, besonders auf einer Website ohne clientseitiges JavaScript für die Interaktion, ist, dass das Feld beim Absenden des Formulars weiterhin eine direkt eingetippte Adresse akzeptiert, unabhängig davon, ob ein Vorschlag angeklickt wurde. Ein Vorschlagsfeld, das das Absenden blockiert, bis eine seiner Optionen ausgewählt ist, macht aus einem hilfreichen Hinweis eine harte Pflicht, und jede Adresse, die berechtigterweise nicht in der Vorschlagsliste steht, lässt sich dann gar nicht mehr absenden.
Ein Sonderfall, den Sie testen sollten
Adressen in einer anderen Schrift als der, mit der Ihr Vorschlagsfeld hauptsächlich getestet wurde, oder transliterierte Ortsnamen sind fester Bestandteil der meisten Adressdatenbanken und verdienen dieselbe Behandlung mit Rückfall auf einfachen Text wie jede andere Anfrage ohne Treffer. Gehen Sie nicht davon aus, dass fehlende Vorschläge bei ungewöhnlichen Eingaben bedeuten, dass die Eingabe selbst ungültig ist, denn die richtige Reaktion ist oft einfach, den Kunden genau das absenden zu lassen, was er eingetippt hat.
Anfragen begrenzen
Setzen Sie limit auf eine kleine Zahl, drei bis fünf reichen für ein Vorschlagsfeld meist aus, da eine längere Liste den Zweck eines schnellen Überfliegens verfehlt. Verzögern Sie die Aufrufe per Debounce, sodass eine Anfrage erst nach einer kurzen Tipppause ausgelöst wird, damit die Gesamtzahl der Anfragen pro Sitzung niedrig bleibt.
Kosten pro Sitzung
Ein typisches Adressfeld löst pro Besucher vielleicht eine Handvoll Autovervollständigungsaufrufe aus, während er tippt und sich korrigiert, jeder davon eine Anfrage. Das ist selbst bei einem Formular mit nennenswertem Traffic ein kleiner Bruchteil der 2.500 kostenlosen Anfragen pro Tag, die in jedem Schlüssel enthalten oder ohne Schlüssel von einer einzelnen Adresse aus verfügbar sind.
Ein gut gebautes Vorschlagsfeld fängt Tippfehler dezent ab und tritt bei allem zurück, was es nicht erkennt. Die vollständigen Felddefinitionen finden Sie in der Dokumentation zur Adress-Autovervollständigung.