Adress-Autovervollständigung ist eine andere Art von Anfrage als eine reine Geokodierungsabfrage: Sie muss auf unvollständige, sich ändernde Eingaben reagieren statt auf eine einzelne fertige Adresse, meist während jemand in ein Formular tippt. Wir haben unsere Kompatibilitäts-Hosts erweitert, sodass sie auch dieses Muster unterstützen, passend zur Anfragestruktur der Autovervollständigung bei den Anbietern, die sie anbieten.
Das ergänzt unseren nativen Endpunkt /v1/autocomplete, dokumentiert unter /docs/address-autocomplete/, der dieselbe Art von Anfrage mit Teiladressen direkt verarbeitet. Überall dort, wo der ursprüngliche Anbieter eines Kompatibilitäts-Hosts ebenfalls Autovervollständigung anbietet, wird dieselbe Anfragestruktur jetzt auf unserem entsprechenden Host unterstützt, abgesehen von Copyright-, Nutzungs- und Datenschutztexten, die von uns stammen.
Authentifizierung und Preise für Autovervollständigungsanfragen folgen genau denselben Regeln wie jede andere Anfrageart auf der Plattform. Ein Schlüssel authentifiziert sich als Header X-API-Key, als Header Authorization: Bearer, per HTTP Basic Auth oder als Abfrageparameter, und die Nutzung wird auf dasselbe kostenlose Tageskontingent angerechnet, egal ob dieses Kontingent aus dem aufrufenden Netzwerk oder aus dem Schlüssel selbst stammt. Über das kostenlose Kontingent hinaus werden Autovervollständigungsanfragen mit 0,0001 € pro Anfrage vom Prepaid-Guthaben abgebucht oder durch ein Unlimited-Paket abgedeckt, genau wie bei jedem anderen Endpunkt.
Autovervollständigungs-Traffic läuft meist in einem anderen Takt als eine typische Geokodierungsabfrage und wird oft bei jedem Tastendruck ausgelöst, während jemand eine Adresse in ein Formular tippt, statt einmal pro fertiger Übermittlung. Deshalb ist die Sichtbarkeit des Kontingents hier besonders nützlich: Dieselben Kontingent-Header, die jeder Antwort beiliegen, X-Quota-Limit, X-Quota-Used, X-Quota-Free-Remaining und die übrigen, ermöglichen es einer Integration, den Verbrauch in Echtzeit zu beobachten und das Verhalten anzupassen, etwa Anfragen stärker per Debounce zu verzögern, wenn die Nutzung höher ausfällt als erwartet.
Für Teams, die bereits einen Kompatibilitäts-Host für die Geokodierung nutzen und die Autovervollständigung getrennt über einen anderen Anbieter oder eine zweite Integration abwickeln, bedeutet dieses Update, dass die Autovervollständigung jetzt möglicherweise auf denselben Host und denselben Schlüssel umziehen kann. So lassen sich beide Anfragearten unter einem Konto bündeln, statt sie auf zwei aufzuteilen.
Welche Kompatibilitäts-Hosts Autovervollständigung unterstützen, hängt davon ab, ob ihr ursprünglicher Anbieter sie unterstützt. Die Details dazu sind auf der eigenen Seite des jeweiligen Hosts dokumentiert, die Sie über die vollständige Liste unter /compatibility/ erreichen. Die Autovervollständigung mit einem kompatiblen Host auszuprobieren, kostet nichts, da jedem neuen Schlüssel ein kostenloses Kontingent zur Verfügung steht.