Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta che garantiscono un comportamento accettato da parte del tuo sistema. Per il contesto, consulta la Panoramica del flusso di lavoro in Utilizzare la risposta di convalida.
Esempio comune: accetto
Questo scenario illustra un indirizzo in cui il sistema accetterà un indirizzo inserito da un cliente.
Indirizzo inserito | Regione |
---|---|
76 Buckingham Palace Road, Londra SW1W 9TQ | Regno Unito |
Verdetto per un indirizzo accettabile
L'esempio seguente evidenzia gli indicatori importanti.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"addressComplete": true
}
Oltre a questo, la risposta indica quanto segue:
- Tempo rimanente:
hasUnconfirmedComponents
:false
- Tempo rimanente:
hasInferredComponents
:false
- Tempo rimanente:
hasReplacedComponents
:false
Se combinati, questi indicatori indicano un indirizzo di alta qualità.
Esempi di casi limite: accetta
Gli esempi seguenti riguardano situazioni in cui verdict
indica problemi di qualità che richiedono ulteriori indagini. Questi esempi illustrano inoltre come la logica può spostarsi dall'esito ai componenti dell'indirizzo per ottenere un quadro più completo e migliorare la logica del sistema.
Numero civico non confermato non negli Stati Uniti
Questo esempio illustra la voce di un indirizzo italiano con tutti i componenti dell'indirizzo presenti, senza componenti dedotti o sostituiti. 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
}
Un'ulteriore indagine sui componenti dell'indirizzo rivela che il numero civico è UNCONFIRMED_BUT_PLAUSIBLE
.
{
"text": "14",
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Numero civico USA non confermato
Questo esempio illustra la voce 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 confermati, senza componenti dedotti o sostituiti e un valore validationGranularity
di PREMISE
. Tuttavia, uspsData
non è completamente
compilato 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"
}