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.