In diesem Dokument werden einige reale Szenarien beschrieben, in denen die Die Address Validation API bietet Antwortsignale, die ein Accept-Verhalten rechtfertigen. von Ihrem System. Weitere Informationen finden Sie unter Workflowübersicht in der Verwenden Sie die Validierungsantwort als Kontext.
Gängiges Beispiel: Akzeptieren
Dieses Szenario veranschaulicht eine Adresse, bei der Ihr System eine die vom Kunden eingegebene Adresse verwendet.
Eingegebene Adresse | Region |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ | Vereinigtes Königreich |
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.
<ph type="x-smartling-placeholder">Grenzfallbeispiele: Akzeptieren
Die folgenden Beispiele beziehen sich auf Situationen, in denen verdict
eine Adresse angibt.
die eine weitere Untersuchung rechtfertigen. In diesen Beispielen werden auch
veranschaulichen, wie die Logik vom Ergebnis zu den Adresskomponenten übertragen werden kann
um ein vollständigeres Bild zu erhalten und so Ihre Systemlogik zu verbessern.
Hausnummer (nicht USA)
Dieses Beispiel zeigt den Eintrag einer italienischen Adresse mit allen Adresskomponenten
und keine abgeleiteten oder ersetzten Komponenten. Die
validationGranularity
ist 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 zeigt, dass die Straße
Nummer ist UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Unbestätigte US-Hausnummer
Dieses Beispiel veranschaulicht die Eingabe einer US-Adresse mit allen Adresskomponenten
ohne abgeleitete oder ersetzte Komponenten. Die
validationGranularity
ist 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
Dieses Beispiel veranschaulicht die Eingabe einer US-Adresse mit allen Adresskomponenten
bestätigt (ohne abgeleitete oder ersetzte Komponenten) und
validationGranularity
von PREMISE
. 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 | 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"
}