Adresse korrigieren – Beispiele

In diesem Dokument werden eine Reihe von Beispielen aus der Praxis beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein Korrekturverhalten Ihres Systems erfordern. Die Beispiele hier dienen zur Veranschaulichung, sind aber nicht vollständig. Weitere Informationen finden Sie unter Workflow-Übersicht in Validierungslogik erstellen.

Häufige Beispiele: Korrektur

In diesem Abschnitt werden häufige Beispiele beschrieben, in denen die Address Validation API Antwortsignale liefert, die auf Adressinformationen von geringerer Qualität hinweisen.

Fehlende Stadt und Postleitzahl

In diesem Beispiel enthält ein Eintrag nur die Straßenadresse, aber keine Stadt oder Postleitzahl.

Eingegebene Adresse Region
21 45 40th street USA

Ergebnis für fehlende Stadt und Postleitzahl

Im folgenden Beispiel werden die wichtigen Signale aus der Antwort hervorgehoben.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Diese Signale weisen auf eine nicht zustellbare Adresse hin. Sie können daher addressComponents abfragen, um weitere Informationen zu erhalten:

{
  "componentName": {
    "text": "21",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "45 40th street",
    "languageCode": "en"
  },
  "componentType": "route",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
  "componentName": {
    "text": "United States",
    "languageCode": "en"
  },
  "componentType": "country",
  "confirmationLevel": "CONFIRMED"
}

Die Address Validation API gibt nur das Land (USA) als CONFIRMED zurück. Alle anderen Adresskomponenten werden als UNCONFIRMED_BUT_PLAUSIBLE zurückgegeben, wobei einige wichtige Auslassungen in den Daten vorhanden sind, z. B. Ort und Postleitzahl.

Fehlende Hausnummer

In diesem Beispiel fehlt eine Hausnummer.

Eingegebene Adresse Region
Buckingham Palace Road, SW1W 9TQ London Vereinigtes Königreich
Ergebnis für fehlende Hausnummer
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

Die validationGranularity ist ROUTE. Das bedeutet, dass die Straße gefunden wurde, aber nicht genügend Informationen vorhanden sind, um zum Gebäude zu gelangen. Außerdem fehlt die Eigenschaft addressComplete im Ergebnis und ist daher false. Eine weitere Abfrage des Objekts address ergibt einen fehlenden Komponententyp:

"missingComponentTypes": [
        "street_number"
      ]

Beispiele für Grenzfälle: Korrektur

In einigen Situationen hängt es von Ihrem jeweiligen Geschäftsszenario ab, ob Sie eine Adresse korrigieren, bestätigen oder akzeptieren. Die folgenden Beispiele veranschaulichen Szenarien, die möglicherweise nicht streng in eine Korrekturkategorie fallen.

Nicht bestätigte Hausnummer

In diesem Szenario kann die Address Validation API die angegebene Hausnummer nicht bestätigen, gibt aber an, dass die Adresse vollständig ist.

Eingegebene Adresse Region
84 Buckingham Palace Road, SW1W 9TQ, London Vereinigtes Königreich

Ergebnis für nicht bestätigte Hausnummer

Im folgenden Beispiel werden die wichtigen Signale hervorgehoben.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true
}

Es lohnt sich, die Kombination aus einer Validierungsgenauigkeit nur bis zur Gebäudeebene und nicht bestätigten Komponenten zu untersuchen. Eine Abfrage der Eigenschaft addressComponents zeigt den folgenden nicht bestätigten componentType:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

Hier ist confirmation_level von street_number auf UNCONFIRMED_BUT_PLAUSIBLE gesetzt. Nicht bestätigt bedeutet, dass der Dienst die Hausnummer 84 in seinem Dataset nicht finden kann. Plausibel bedeutet, dass die Komponentendaten trotzdem gültig sein könnten.

Fehlende Unteradresse

In diesem Szenario fehlt in einer Adresse nur eine Unteradresse, z. B. eine Wohnungs- oder Abteilungsnummer. Andernfalls kann die Address Validation API die Adresse vollständig validieren. Wie bei jeder fehlenden Adresskomponente ist addressComplete false und daher bei der manuellen Überprüfung des Ergebnisses nicht vorhanden.

Angenommen, ein Kunde gibt eine gültige Adresse für das Büro des Steuerassessors von San Francisco ein, lässt aber die Raumnummer in der Eingabe aus.

Eingegebene Adresse Region
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 USA

Ergebnis für fehlende Unteradresse

In diesem Beispiel wird die Eigenschaft addressComplete im Ergebnis nicht angezeigt. Sie ist daher false. Daher wissen Sie, dass mindestens ein Adressenelement unerwartet, nicht aufgelöst oder nicht vorhanden ist.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

Eine address-Abfrage ergibt Folgendes:

"missingComponentTypes": [
        "subpremise"
      ]

Bei weiterer Nachfrage liefern die USPS-Daten einen dpvConfirmation-Code von D, der ebenfalls auf eine fehlende Unteradresse hinweist.