Adress-Autovervollständigung in ein Webformular einbauen
Amtliche Adressen schon beim Tippen vorzuschlagen, beseitigt die meisten Lieferfehler und verkürzt das Formular. So gelingt es.
Warum die Adresse automatisch vervollständigen
Eine von Hand getippte Adresse ist der Ursprung der meisten Lieferfehler: ein vergessener Briefkasten, eine Straße in zwei Schreibweisen, die Postleitzahl des Nachbarorts. Amtliche Adressen beim Tippen vorzuschlagen, beseitigt den Fehler, bevor er gespeichert wird.
Auch das Formular wird kürzer: ein Feld statt fünf, mit wenigen Tastenanschlägen gefüllt.
Wann die Suche gesendet wird
- Warten Sie auf zwei oder drei Zeichen: Kürzere Eingaben passen auf zu viel, um zu helfen.
- Warten Sie etwa 200 Millisekunden nach dem letzten Tastenanschlag, damit jemand, der schnell tippt, eine Suche sendet und nicht zehn.
- Brechen Sie die vorige Anfrage ab, wenn eine neue startet, damit eine alte Antwort nie eine neuere überschreibt.
- Zeigen Sie höchstens fünf bis acht Vorschläge.
Was mit dem gewählten Vorschlag geschieht
Füllen Sie die strukturierten Felder (Straße, Nummer, Briefkasten, Postleitzahl, Ort) aus dem Vorschlag, nicht aus dem getippten Text, und lassen Sie sie bearbeitbar.
Speichern Sie die Koordinaten und die amtliche Kennung mit der Adresse: So vergleichen Sie später zwei Adressen, ohne Schreibweisen zu vergleichen.
Hat das Gebäude Briefkästen und der Vorschlag keinen, fragen Sie den Briefkasten in einem eigenen Feld ab, statt ihn hinter die Straße tippen zu lassen.
Tastatur und Screenreader
- Die Pfeiltasten wandern durch die Vorschläge, Enter wählt einen aus, Escape schließt die Liste.
- Folgen Sie dem ARIA-Combobox-Muster: Das Feld hat die Rolle combobox, die Liste die Rolle listbox, und aria-activedescendant folgt dem hervorgehobenen Vorschlag.
- Kündigen Sie die Zahl der Vorschläge in einer Live-Region an.
- Blockieren Sie nie die freie Eingabe: Ein ganz neues Gebäude steht vielleicht noch nicht in der Referenz.
Den API-Schlüssel auf dem Server lassen
Der Schlüssel, der die API authentifiziert, darf nie in den Browser gelangen, wo ihn jeder lesen kann. Senden Sie die Suche an Ihr eigenes Backend, das den Schlüssel hinzufügt und den Aufruf weiterleitet.
Dasselbe Backend kann die häufigsten Suchanfänge zwischenspeichern und Ihre eigenen Grenzen pro Besucher durchsetzen.
Eine Abrechnung, die dem Tippen folgt
Viele Adressdienste rechnen jeden Aufruf oder jede gewählte Adresse ab. Addrly rechnet seine Autovervollständigung pro Tippsitzung ab: Die Tastenanschläge einer Suche zählen als eine Anfrage, das Warten oben spart also Latenz, nicht Geld.
Das Wichtigste in Kürze
- Suchen Sie nach zwei oder drei Zeichen und 200 Millisekunden Ruhe.
- Füllen Sie strukturierte Felder aus dem Vorschlag, und lassen Sie sie bearbeitbar.
- Lassen Sie den API-Schlüssel auf Ihrem Server, und blockieren Sie nie die freie Eingabe.
Häufig gestellte Fragen
Wie viele Zeichen vor der Suche?
Zwei oder drei. Mit weniger sind die Vorschläge zu breit, um zu helfen, und jede Suche kostet trotzdem einen Hin- und Rückweg.
Muss der Kunde einen Vorschlag wählen?
Nein. Vorschlagen, nicht erzwingen: Ein neues Gebäude kann einige Wochen in der Referenz fehlen, und der Kunde muss es trotzdem eintippen können.
Kann ich die API direkt mit JavaScript aus der Seite aufrufen?
Nur über Ihr eigenes Backend. Ein Schlüssel im Browser kann von jedem kopiert und benutzt werden.