In diesem Dokument werden verschiedene reale Szenarien beschrieben, in denen die Address Validation API Antwortsignale bereitstellt, die ein Accept-Verhalten von deinem System erfordern. Weitere Informationen finden Sie unter Workflowübersicht im Abschnitt Validierungsantwort verwenden.
Gängiges Beispiel: Akzeptieren
Dieses Szenario veranschaulicht eine Adresse, bei der Ihr System eine von einem Kunden eingegebene Adresse akzeptiert.
Eingegebene Adresse | Region |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | UK |
Ergebnis für eine zulässige Adresse
Im Beispiel unten sehen Sie die wichtigsten Signale.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Darüber hinaus enthält die Antwort Folgendes:
hasUnconfirmedComponents
bleibtfalse
hasInferredComponents
bleibtfalse
hasReplacedComponents
bleibtfalse
In Kombination weisen diese Signale auf eine qualitativ hochwertige Adresse hin.
Grenzfallbeispiele: Akzeptieren
Die folgenden Beispiele beziehen sich auf Situationen, in denen verdict
Qualitätsprobleme behandelt, die eine weitere Untersuchung rechtfertigen. Diese Beispiele veranschaulichen auch, wie die Logik vom Ergebnis zu den Adresskomponenten übertragen kann, um ein vollständigeres Bild zu erhalten und die Systemlogik zu verbessern.
Hausnummer (nicht USA)
In diesem Beispiel wird der Eintrag einer italienischen Adresse mit allen vorhandenen Adresskomponenten und ohne abgeleitete oder ersetzte Komponenten veranschaulicht. validationGranularity
ist jedoch ROUTE
.
Eingegebene Adresse | Region |
---|---|
Via Fonte Grugnale, 14 Unit 2, 66054 VASTo CH, Italia | IT |
Ergebnis einer nicht bestätigten Hausnummer
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Eine weitere Untersuchung der Adresskomponenten hat ergeben, dass die Hausnummer UNCONFIRMED_BUT_PLAUSIBLE
lautet.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Unbestätigte US-Hausnummer
In diesem Beispiel wird die Eingabe einer US-Adresse mit allen vorhandenen Adresskomponenten und ohne abgeleitete oder ersetzte Komponenten veranschaulicht. validationGranularity
ist jedoch PREMISE_PROXIMITY
.
Eingegebene Adresse | Region |
---|---|
975 Carson Dr, Sunnyvale, CA 94086, USA | 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 der validationGranularity
PREMISE
veranschaulicht. uspsData
wird 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 | 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"
}