Die DQE-Adressdienste validieren, normalisieren und reichern Postadressen in Echtzeit an. Dieser Artikel beschreibt jeden Adressdienst und was er zurückgibt.
DQE bietet zwei Gruppen von Adress-API-Endpunkten mit gleichwertiger Funktionalität:
- Legacy WS — die ursprünglichen WS-Endpunkte, weiterhin vollständig unterstützt.
- RESTful — die neueren REST-Endpunkte, empfohlen für neue Integrationen.
Adressvalidierung
Die Adressvalidierung prüft, ob eine übermittelte Adresse erkannt, standardisiert und anhand der verfügbaren Referenzdaten für das jeweilige Land bewertet werden kann. DQE bietet mehrere Validierungsendpunkte:
-
CheckAddress — validiert eine vollständige Adresse und liefert ein normalisiertes Postformat mit einem Zustellbarkeitsindikator zurück. Für französische Adressen stützt sich DQE auf Referenzdaten von La Poste (RNVP — Rectification et Normalisation des adresses en Vue de la Poste).
Legacy WS:/RNVP/— RESTful:/{VERSION}/checkaddress/
Bei internationalen Adressen variiert der Genauigkeitsgrad je nach Land und verfügbarer Abdeckung.
Adress-Autovervollständigung
Die Adress-Autovervollständigung schlägt Adressen vor und vervollständigt sie, während der Nutzer tippt, wodurch Eingabefehler an der Quelle reduziert werden. Sie ist für die Verwendung in Echtzeit-Formularfeldern konzipiert.
-
Funnel-Modus — führt den Nutzer Schritt für Schritt: Postleitzahl → Straße → Zusatz.
Legacy WS:/CP/→/ADR/→/COMPL/— RESTful:/{VERSION}/funnelpostcode/→/{VERSION}/funneladdress/→/{VERSION}/funnelcompl/ -
Single-Modus — liefert Vorschläge aus einer Volltexteingabe, gefolgt von einem Zusatzschritt für Gebäude- oder Wohnungsdetails.
Legacy WS:/SINGLEV2/→/COMPLV2/— RESTful:/{VERSION}/single/→/{VERSION}/compl/
Geokodierung
Die Geokodierung liefert geografische Koordinaten (Breiten- und Längengrad) für eine angegebene Adresse zurück. Der Genauigkeitsgrad hängt von den verfügbaren Referenzdaten ab:
- Genauigkeit auf Straßenebene, wenn die vollständige Adresse erkannt wird
- Genauigkeit auf Stadtebene, wenn die Straße nicht zugeordnet werden kann
- Keine Koordinaten zurückgegeben, wenn die Adresse nicht geolokalisiert werden kann
Legacy WS: /LATLG/
Reverse-Geokodierung
Die Reverse-Geokodierung liefert Adressinformationen aus einem Satz geografischer Koordinaten zurück. Sie eignet sich zur Anreicherung von Standortdaten, wenn Koordinaten, aber keine Postadresse vorliegen.
Legacy WS: /SINGLE/ (mit Lat/Lng-Parametern)
Antwortformat
Alle Adressdienste liefern Antworten im JSON-Format, einschließlich der normalisierten Adresskomponenten und Qualitätsindikatoren, die den erreichten Validierungsgrad beschreiben.
Verwandte Artikel
- Wie validiert DQE Postadressen?
- Warum normalisiert DQE eine Adresse anders als erwartet?
- Warum wird eine Adresse nicht von DQE zurückgegeben?
Verknüpfung mit