Adresse korrigieren – Beispiele

In diesem Dokument werden einige reale Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein fix-Verhalten Ihres Systems rechtfertigen. Die hier aufgeführten Beispiele dienen nur zur Veranschaulichung und sind nicht vollständig. Weitere Informationen finden Sie unter Workflowübersicht im Abschnitt 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.

Stadt und Postleitzahl fehlen

In diesem Beispiel ist nur die Straßenadresse angegeben, nicht aber der Ort oder die Postleitzahl.

Entscheidung bei fehlender 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 Adresse hin, an die nicht zugestellt werden kann. Weitere Informationen erhalten Sie durch Abfragen von addressComponents:

{
  "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. Dabei werden einige wichtige Daten wie Ort und Postleitzahl ausgelassen.

Hausnummer fehlt

In diesem Beispiel fehlt eine Hausnummer.

Entscheidung bei fehlender Hausnummer

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

Die validationGranularity ist ROUTE. Das bedeutet, dass die Straße übereinstimmt, aber nicht genügend Informationen vorhanden sind, um das Gebäude zu finden. Außerdem fehlt im Urteil das Attribut addressComplete, weshalb es false ist. Eine weitere Abfrage des address-Objekts ergibt einen fehlenden Komponententyp:

"missingComponentTypes": [
        "street_number"
      ]

Beispiele für Grenzfälle: Korrektur

Ob Sie eine Adresse korrigieren, bestätigen oder akzeptieren, hängt von Ihrem jeweiligen Unternehmen ab. Die folgenden Beispiele veranschaulichen Szenarien, die nicht unbedingt in eine bestimmte Kategorie fallen.

Nicht bestätigte Hausnummer

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

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 Validierungsgranularität nur für die Schätzungen auf Standortebene und nicht bestätigten Komponenten zu untersuchen. Bei einer Abfrage der Property addressComponents werden die folgenden nicht bestätigten componentType angezeigt:

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

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

Untergeordnete Prämisse fehlt

In diesem Szenario fehlt bei einer Adresse nur eine untergeordnete Einheit, z. B. eine Apartment- oder Abteilungsnummer. Andernfalls kann die Address Validation API die Adresse vollständig validieren. Wie bei fehlenden Adresskomponenten ist die addressComplete false und daher bei der manuellen Überprüfung des Urteils nicht vorhanden.

Angenommen, ein Kunde gibt eine gültige Adresse für das Büro des Stadtassessors von San Francisco ein, lässt aber die Zimmernummer aus.

Urteil für fehlende untergeordnete Prämisse

In diesem Beispiel wird das Attribut addressComplete im Ergebnis nicht angezeigt. Es ist also 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-Anfrage ergibt Folgendes:

"missingComponentTypes": [
        "subpremise"
      ]

Bei weiterer Nachfrage liefert die USPS-Datenbank den dpvConfirmation-Code D, der ebenfalls auf eine fehlende untergeordnete Adresseinheit hinweist.