Adresse korrigieren – Beispiele

In diesem Dokument werden einige reale Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die eine Korrektur durch Ihr System erfordern. Die Beispiele hier sind nicht vollständig. Weitere Informationen finden Sie unter Workflowübersicht im Abschnitt Validierungslogik erstellen.

Typische Beispiele: fix

In diesem Abschnitt werden gängige Beispiele beschrieben, bei denen die Address Validation API Antwortsignale liefert, die auf Adressinformationen von geringerer Qualität hinweisen.

Stadt und Postleitzahl fehlen

In diesem Beispiel wird ein Eintrag gezeigt, der nur die Adresse, aber keine Stadt oder Postleitzahl enthält.

Eingegebene Adresse Region
21 45 40th street USA

Urteil 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 Adresse hin, an die nicht zugestellt werden kann. Sie können die 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 Daten wie Ort und Postleitzahl weggelassen werden.

Hausnummer fehlt

In diesem Beispiel fehlt die Hausnummer.

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

Der validationGranularity ist ROUTE, was auf eine Übereinstimmung mit der Straße hinweist, aber nicht genügend Informationen, um zum Gebäude zu gelangen. Außerdem fehlt das Attribut addressComplete im Urteil und ist daher false. Eine weitere Abfrage des address-Objekts zeigt einen fehlenden Komponententyp:

"missingComponentTypes": [
        "street_number"
      ]

Beispiele für Grenzfälle: Korrektur

In manchen Situationen hängt es von Ihrem speziellen Geschäftsszenario ab, ob Sie eine Adresse korrigieren, bestätigen oder akzeptieren. Die folgenden Beispiele veranschaulichen Szenarien, die möglicherweise nicht genau in eine Fehlerbehebungskategorie 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

Urteil für unbestä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 auf Standortebene und unbestätigten Komponenten zu untersuchen. Eine Abfrage des Attributs addressComponents zeigt die folgenden unbestätigten componentType:

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

Hier ist der confirmation_level des street_number auf UNCONFIRMED_BUT_PLAUSIBLE festgelegt. Unbestä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 Hausnummer/Wohnungsnummer

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

Angenommen, ein Kunde gibt eine gültige Adresse für das San Francisco City Assessor's Office ein, vergisst aber die Zimmernummer.

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

Urteil für fehlende Untereinheit

In diesem Beispiel wird das Attribut addressComplete im Urteil nicht angezeigt, daher ist es false. Daher wissen Sie, dass mindestens ein Adresselement unerwartet, nicht aufgelöst oder fehlend ist.

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

}

Eine address-Abfrage ergibt Folgendes:

"missingComponentTypes": [
        "subpremise"
      ]

Bei weiterer Prüfung liefern die USPS-Daten einen dpvConfirmation-Code von D, was ebenfalls auf eine fehlende Untereinheit hinweist.