Adresse korrigieren – Beispiele

In diesem Dokument wird eine Reihe von realen Szenarien beschrieben, in denen die Address Validation API Antwortsignale bereitstellt, die eine fix Ihres Systems erfordern. Weitere Informationen finden Sie unter Workflowübersicht im Artikel Validierungslogik erstellen.

Gängige Beispiele: Korrektur

In diesem Abschnitt werden allgemeine Beispiele beschrieben, in denen die Address Validation API Antwortsignale bereitstellt, die Adressinformationen von geringerer Qualität anzeigen.

Stadt und Postleitzahl fehlen

Dieses Beispiel zeigt einen Eintrag, der nur die Adresse ohne Stadt oder Postleitzahl enthält.

Eingegebene Adresse Region
Hauptstraße 123 USA

Ergebnis aufgrund fehlender Stadt oder Postleitzahl

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

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

Diese Signale geben eine Adresse an, die nicht zustellbar ist. Sie können also 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 Datenauslassungen wie Ort und Postleitzahl fehlen.

Hausnummer fehlt

In diesem Beispiel fehlt die 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"
}

validationGranularity ist ROUTE, was eine Übereinstimmung mit der Straße anzeigt, aber nicht genügend Informationen, um zum Gebäudepunkt zu gelangen. Außerdem fehlt das Attribut addressComplete im Ergebnis und lautet daher false. Bei einer weiteren Abfrage des address-Objekts wird ein fehlender Komponententyp angezeigt:

"missingComponentTypes": [
        "street_number"
      ]

Edge-Case-Beispiele: Korrektur

Ob Sie eine Adresse korrigieren, bestätigen oder akzeptieren, hängt in einigen Situationen von Ihrem individuellen Geschäftsszenario ab. Die folgenden Beispiele zeigen Szenarien, die möglicherweise nicht unbedingt in eine Korrekturkategorie fallen.

Nicht bestätigte Hausnummer

In diesem Szenario kann die Address Validation API die angegebene Hausnummer nicht bestätigen, aber sie zeigt 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 Beispiel unten werden die wichtigen Signale hervorgehoben.

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

Es lohnt sich, die Kombination aus Validierungsgranularität nur mit Näherung auf Standortebene und nicht bestätigten Komponenten zu untersuchen. Eine Abfrage des Attributs addressComponents zeigt die folgende unbestätigte componentType:

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

Hier ist confirmation_level von street_number auf UNCONFIRMED_BUT_PLAUSIBLE festgelegt. Nicht bestätigt bedeutet, dass der Dienst nicht mit der Hausnummer 84 in seinem Dataset übereinstimmen kann. plausibel bedeutet, dass die Komponentendaten noch gültig sein könnten.

Fehlender Raum

Dieses Szenario beschreibt eine Adresse, bei der nur ein Teilgebäude fehlt, z. B. eine Wohnungs- oder Abteilungsnummer. Andernfalls kann die Address Validation API die Adresse vollständig validieren. Wenn eine Adresskomponente fehlt, hat addressComplete den Wert false und ist daher bei einer manuellen Prüfung des Ergebnisses nicht vorhanden.

Zur Veranschaulichung: Angenommen, ein Kunde gibt eine gültige Adresse des Büros des Stadtprüfers in San Francisco ein, vermisst jedoch die Zimmernummer in der Eingabe.

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

Urteil aufgrund fehlender Teilfläche

In diesem Beispiel wird das Attribut addressComplete im Ergebnis nicht angezeigt. Daher lautet es false. Aus diesem Grund wissen Sie, dass mindestens ein Adresselement unerwartet, nicht aufgelöst oder fehlt.

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

}

Eine address-Abfrage zeigt Folgendes an:

"missingComponentTypes": [
        "subpremise"
      ]

Nach weiterer Anfrage liefern die USPS-Daten den dpvConfirmation-Code D, was ebenfalls auf eine fehlende Unterprämisse hinweist.