In diesem Dokument werden eine Reihe von realen Szenarien beschrieben, in denen die Address Validation API Antwortsignale liefert, die ein accept-Verhalten Ihres Systems rechtfertigen. Weitere Informationen finden Sie unter Workflow-Übersicht in Validierungsantwort verwenden.
Häufiges Beispiel: „Annehmen“
In diesem Szenario wird eine Adresse veranschaulicht, die von Ihrem System akzeptiert würde, wenn sie von einem Kunden eingegeben wird.
Eingegebene Adresse | Region |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | UK |
Entscheidung für eine akzeptable Adresse
Im folgenden Beispiel werden die wichtigen Signale hervorgehoben.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Außerdem gibt die verdict
Folgendes an:
hasUnconfirmedComponents
bleibtfalse
hasInferredComponents
bleibtfalse
hasReplacedComponents
bleibtfalse
In Kombination weisen diese Signale auf eine Adresse von hoher Qualität hin.
Beispiele für Grenzfälle: Akzeptieren
Die folgenden Beispiele beschreiben Situationen, in denen verdict
auf Probleme mit der Adressqualität hinweist, die weitere Untersuchungen erfordern. Diese Beispiele veranschaulichen auch, wie Ihre Logik vom Ergebnis zu den Adresskomponenten übergehen kann, um ein vollständigeres Bild zu erhalten und die Systemlogik zu verbessern.
Nicht bestätigte Hausnummer außerhalb der USA
In diesem Beispiel wird die Eingabe einer italienischen Adresse mit allen Adresskomponenten veranschaulicht. Es werden keine Komponenten abgeleitet oder ersetzt. Die validationGranularity
ist jedoch ROUTE
.
Eingegebene Adresse | Region |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italien | IT |
Ergebnis für eine nicht bestätigte Hausnummer
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Eine weitere Untersuchung der Adresskomponenten ergibt, dass die Bestätigungsstufe für die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE
ist.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Nicht bestätigte US-Hausnummer
In diesem Beispiel wird die Eingabe einer US-Adresse mit allen Adresskomponenten veranschaulicht, ohne dass Komponenten abgeleitet oder ersetzt werden. Die validationGranularity
ist jedoch PREMISE_PROXIMITY
.
Eingegebene Adresse | Region |
---|---|
975 Carson Dr, Sunnyvale, CA 94086 | USA |
USPS-Daten für eine nicht bestätigte Hausnummer
{
"firstAddressLine": "975 CARSON DR",
"cityStateZipAddressLine": "SUNNYVALE CA 94086",
"city": "SUNNYVALE",
"state": "CA",
"zipCode": "94086"
"dpvConfirmation": "N",
"dpvFootnote": "AAM3",
"carrierRoute": "C031",
"carrierRouteIndicator": "D",
"postOfficeCity": "SUNNYVALE",
"postOfficeState": "CA",
"fipsCountyCode": "085",
"county": "SANTA CLARA",
}
Unvollständige USPS-Daten für eine bestätigte Adresse
In diesem Beispiel wird die Eingabe einer US-Adresse mit allen bestätigten Adresskomponenten ohne abgeleitete oder ersetzte Komponenten und einem validationGranularity
von PREMISE
veranschaulicht. Der uspsData
ist jedoch nicht vollständig ausgefüllt und enthält keinen dpvConfirmation
-Wert.
Eingegebene Adresse | Region |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | USA |
Ergebnis für eine bestätigte Adresse mit unvollständigen USPS-Daten
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
USPS-Daten für eine bestätigte Adresse mit unvollständigen USPS-Daten
{
"standardizedAddress": {
"firstAddressLine": "155 VIA CONDADO WAY",
"cityStateZipAddressLine": "PALM BEACH GARDENS",
"city": "PALM BEACH GARDENS",
"state": "FL",
"zipCode": "33418"
},
"carrierRoute": "H018",
"postOfficeCity": "PALM BEACH GARDENS",
"postOfficeState": "FL"
}