ADRESS-AUTOVERVOLLSTÄNDIGUNG · TYPE-AHEAD-API
Adress-Autovervollständigung für Checkouts, Anmeldeformulare und CRM-Systeme. Jeder Vorschlag kommt als sauber strukturierte Felder mit Punktkoordinaten zurück — die Adresse, die in Ihrer Datenbank landet, ist damit bereits geprüft. Mit unserem Plugin direkt in WordPress und WooCommerce einsetzbar, oder per API.
Land auswählen und tippen — das ist derselbe /suggest-Aufruf, den Ihr Checkout ausführen würde. Britische Adressen stammen aus der offiziellen Royal Mail PAF und lassen sich über die Postcode oder über die Straße suchen. Japan beginnt mit der 7-stelligen Postleitzahl — so, wie japanische Formulare tatsächlich funktionieren.
Anbieter von Autovervollständigung liefern meist eine Anzeigezeichenfolge und berechnen erneut, um daraus Felder zu machen. Bei uns ist jeder Vorschlag bereits in Komponenten zerlegt — mit Koordinaten:
| Feld | Bedeutung |
|---|---|
| street, house_number, city, postcode, country | Strukturierte Komponenten, direkt in Ihre Formularfelder übernehmbar — kein Zerlegen der Anzeigezeichenfolge. |
| formatted_address | Die Adresse in der landesüblichen Reihenfolge zusammengesetzt: eine deutsche Adresse liest sich wie eine deutsche, eine japanische wie eine japanische. |
| lat, lng | Punktkoordinaten direkt am Vorschlag — die Geokodierung fällt bei der Adresserfassung ab und ist kein zweiter berechneter Aufruf. |
| hint | Bleibt die Auswahlliste leer, erscheint ein kurzer Hinweis, was der Kunde als Nächstes tun soll („weiter die Straße tippen") — statt eines toten Feldes. |
Weil der Vorschlag bereits strukturiert und geokodiert ist, wird die Adresse im Moment der Erfassung geprüft — an der günstigsten Stelle, um eine falsche Adresse abzufangen.
Senden Sie ein GET an /suggest mit dem bisher Getippten und dem Land. Britische Adressen werden über paf.acuris-geo.com ausgeliefert, unseren dedizierten Royal-Mail-PAF-Host; alles andere über api.acuris-geo.com. Entprellen Sie auf Ihrer Seite — die Demo oben verwendet rund 200 ms pro Tastenanschlag.
# curl curl 'https://api.acuris-geo.com/suggest?q=hammerstr+1+worms&country=deu&limit=5' \ -H 'X-Acuris-Key: IHR_KEY'
{
"suggestions": [
{
"street": "Hammerstr.",
"house_number": "1",
"city": "Worms",
"postcode": "67549",
"country": "deu",
"lat": 49.63181,
"lng": 8.35916,
"formatted_address": "Hammerstr. 1\n67549 Worms\nDeutschland"
}
]
}
Die Demo oben authentifiziert sich mit einem kurzlebigen Widget-Token statt mit einem API-Key — so gelangt der Key nie in den Browser. Dieses Muster empfehlen wir auch für Ihr Frontend: rufen Sie /suggest serverseitig auf, oder erzeugen Sie pro Sitzung ein Widget-Token.
Wenn Ihr Formular schon in WordPress liegt, brauchen Sie kein JavaScript zu schreiben. Unser Plugin ergänzt die vorhandenen Felder um Autovervollständigung:
| Integration | Was eingebunden wird |
|---|---|
| WooCommerce | Rechnungs- und Lieferadressfelder im Checkout — dort, wo eine falsch getippte Adresse eine fehlgeschlagene Lieferung kostet. |
| Gravity Forms | Das Adressfeld einschließlich seiner Unterfelder. |
| Contact Form 7 | Jedes Adressfeld in Ihrem Formular-Markup. |
| Elementor Forms | Adressfelder im Formular-Widget von Elementor. |
| Alles andere | Ergänzen Sie ein beliebiges Eingabefeld um data-acuris-autocomplete="postcode" — und es vervollständigt. |
API-Key in die Plugin-Einstellungen eintragen, Standardland wählen — fertig. Britische Adressen basieren auf der offiziellen Royal Mail PAF.
Adress-Autovervollständigung wird nicht wie Adressvalidierung abgerechnet, und dieser Unterschied lohnt sich, bevor Sie Preise vergleichen. Branchenübliche Konvention ist Suchen frei, Abruf berechnet: Das Suchen während des Tippens ist kostenfrei, berechnet wird, wenn ein Kunde eine Adresse auswählt und Sie den vollständigen Datensatz abrufen. Ein Kunde, der zwölf Zeichen tippt und einmal auswählt, kostet eine Einheit, nicht zwölf.
Achten Sie beim Anbietervergleich auf zwei Dinge:
| Worauf achten | Warum |
|---|---|
| Was als eine berechenbare Einheit gilt | Manche britischen Anbieter rechnen in Royal-Mail-„Transactions" ab, bei denen eine Abfrage mit bis zu 100 Datensätzen eine Einheit ist. Eine Abrechnung pro Adresse auf denselben Daten kann deutlich anders ausfallen. |
| Ob Koordinaten extra kosten | Bei uns liegen sie am Vorschlag. Mehrere Anbieter behandeln die Geokodierung als separates, separat berechnetes Produkt. |
| Ob strukturierte Felder extra kosten | Eine Anzeigezeichenfolge, die Sie selbst zerlegen müssen, ist nicht dasselbe Produkt wie saubere Komponenten. |
Vollständige Preise, einschließlich der kombinierten Kontingente für Validierung und Geokodierung, unter acuris-geo.com/preise.
Autovervollständigung verhindert, dass falsche Adressen überhaupt entstehen. Für die Adressen, die bereits in Ihrer Datenbank liegen — und für die, die über Kanäle ganz ohne Formular ankommen — nutzen Sie die Validierungsseite derselben API:
| Produkt | Wann einsetzen |
|---|---|
| Adressvalidierung | Sie haben eine Adresse und möchten sie prüfen, korrigieren und geokodieren lassen — einzeln oder im Stapel. |
| UK-Postcode-Abfrage | Sie brauchen alle Zustellpunkte zu einer britischen Postcode, mit UDPRN und UPRN. |
| Excel-Add-in | Die Liste liegt in einer Tabelle und niemand möchte programmieren. |
API-Key in unter einer Minute — ohne Kreditkarte. Beginnen Sie mit dem WordPress-Plugin, wenn Ihr Formular dort liegt, oder rufen Sie /suggest direkt auf.
Tell us what's working or what's missing. Sent anonymously unless you're signed in.
Your feedback went straight to the team.