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.

6 Min. Lesezeit Aktualisiert am 21-10-2026

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.

Testen Sie es mit Ihren eigenen Kunden

Der kostenlose Tarif bietet Ihnen jeden Monat 20 vollständige Unternehmensdossiers, ohne Karte. Wechseln Sie zu einem kostenpflichtigen Tarif, wenn Sie mehr brauchen, und kündigen Sie, wann Sie möchten.

Zuerst eine Frage? Kontaktieren Sie uns