Questo documento descrive una serie di scenari reali in cui L'API Address Validation fornisce indicatori di risposta che garantiscono un comportamento di accettazione dal tuo sistema. Consulta Panoramica del flusso di lavoro in Utilizza la risposta di convalida per contesto.
Esempio comune: accettazione
Questo scenario illustra un indirizzo in cui il sistema accetta un inserito da un cliente.
Indirizzo inserito | Regione |
---|---|
76 Buckingham Palace Road, London SW1W 9TQ, Regno Unito | Regno Unito |
Verdetto per un indirizzo accettabile
L'esempio seguente mette in evidenza gli indicatori importanti.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Inoltre, la risposta indica quanto segue:
hasUnconfirmedComponents
rimanefalse
hasInferredComponents
rimanefalse
hasReplacedComponents
rimanefalse
Se combinati insieme, questi indicatori indicano un indirizzo di alta qualità.
Esempi di casi limite: accettazione
I seguenti esempi riguardano situazioni in cui verdict
indica un indirizzo
problemi di qualità che meritano ulteriori accertamenti. Anche questi esempi
illustra come la logica può spostarsi dall'esito ai componenti dell'indirizzo
per ottenere un quadro più completo al fine di migliorare la logica di sistema.
Numero civico non statunitense non confermato
Questo esempio illustra l'inserimento di un indirizzo italiano con tutte le relative componenti.
presenti, insieme a nessun componente dedotto o sostituito. Tuttavia,
validationGranularity
è ROUTE
.
Indirizzo inserito | Regione |
---|---|
Via Fonte Grugnale, 14 unit 2, 66054 Vasto CH, Italia | IT |
Verdetto per un numero civico non confermato
{
"inputGranularity": "SUB_PREMISE",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE",
"addressComplete": true,
"hasUnconfirmedComponents": true
}
Ulteriori indagini sui componenti dell'indirizzo rivelano che la strada
è UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Numero civico Stati Uniti non confermato
Questo esempio illustra l'inserimento di un indirizzo statunitense con tutti i componenti dell'indirizzo.
presenti, senza componenti dedotti o sostituiti. Tuttavia,
validationGranularity
è PREMISE_PROXIMITY
.
Indirizzo inserito | Regione |
---|---|
975 Carson Dr, Sunnyvale, CA 94086, USA | US |
Dati USPS per un numero civico non confermato
{
"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",
}
Dati USPS incompleti per un indirizzo confermato
Questo esempio illustra l'inserimento di un indirizzo statunitense con tutti i componenti dell'indirizzo.
confermato, senza componenti dedotti o sostituiti e un
validationGranularity
di PREMISE
. Tuttavia, uspsData
non è del tutto
e non contiene un valore dpvConfirmation
.
Indirizzo inserito | Regione |
---|---|
155 Via Condado Way, Palm Beach Gardens, FL 33418-1703 | US |
Verdetto per un indirizzo confermato con dati USPS incompleti
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true,
}
Dati USPS per un indirizzo confermato con dati USPS incompleti
{
"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"
}