Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta che giustificano una fix del comportamento del sistema. Per contesto, consulta Panoramica del flusso di lavoro in Creazione di una logica di convalida.
Esempi comuni: correggi
Questa sezione descrive esempi comuni in cui l'API Address Validation fornisce indicatori di risposta che indicano informazioni sugli indirizzi di qualità inferiore.
Città e codice postale mancanti
Questo esempio illustra una voce con solo l'indirizzo, senza città o codice postale.
Indirizzo inserito | Regione |
---|---|
Via 21 45 40 | Stati Uniti |
Verdetto per città e codice postale mancanti
L'esempio seguente mette in evidenza gli indicatori importanti della risposta.
{
"inputGranularity": "PREMISE",
"validationGranularity": "OTHER",
"geocodeGranularity": "OTHER",
"hasUnconfirmedComponents": true
}
Questi indicatori indicano un indirizzo non valido, quindi puoi eseguire una query su addressComponents
per saperne di più:
{
"componentName": {
"text": "21",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "45 40th street",
"languageCode": "en"
},
"componentType": "route",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
},
{
"componentName": {
"text": "United States",
"languageCode": "en"
},
"componentType": "country",
"confirmationLevel": "CONFIRMED"
}
L'API Address Validation restituisce solo il paese (Stati Uniti) come CONFIRMED
.
Restituisce tutti gli altri componenti dell'indirizzo come UNCONFIRMED_BUT_PLAUSIBLE
, con alcune importanti omissioni nei dati, come la località e il codice postale.
Numero civico mancante
In questo esempio manca un numero civico.
Indirizzo inserito | Regione |
---|---|
Buckingham Palace Road, SW1W 9TQ Londra | Regno Unito |
Verdetto per numero civico mancante
{
"inputGranularity": "PREMISE_PROXIMITY",
"validationGranularity": "ROUTE",
"geocodeGranularity": "ROUTE"
}
validationGranularity
è ROUTE
, che indica una corrispondenza con la strada,
ma non ci sono informazioni sufficienti per raggiungere la sede. Inoltre, la proprietà addressComplete
non è presente nell'esito, pertanto è false
. Un'ulteriore query dell'oggetto address
rivela un tipo di componente mancante:
"missingComponentTypes": [
"street_number"
]
Esempi di casi limite: correzione
In alcuni casi, la possibilità di correggere, confermare o accettare un indirizzo dipende dal tuo scenario aziendale particolare. Gli esempi di seguito illustrano scenari che potrebbero non rientrare rigorosamente in una categoria di correzioni.
Numero civico non confermato
In questo scenario, l'API Address Validation non può confermare il numero civico fornito, ma indica che l'indirizzo è completo.
Indirizzo inserito | Regione |
---|---|
84 Buckingham Palace Road, SW1W 9TQ, Londra | Regno Unito |
Verdetto per numero civico non confermato
L'esempio seguente mette in evidenza gli indicatori importanti.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE_PROXIMITY",
"geocodeGranularity": "PREMISE_PROXIMITY",
"addressComplete" : true,
"hasUnconfirmedComponents": true
}
Vale la pena analizzare la combinazione di una granularità di convalida solo per
approssimazione a livello di premessa insieme a componenti non confermati. Una query della proprietà addressComponents
mostra il seguente componentType
non confermato:
{
"componentName": {
"text": "84",
"languageCode": "en"
},
"componentType": "street_number",
"confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}
Qui, il valore confirmation_level
di street_number
è impostato su UNCONFIRMED_BUT_PLAUSIBLE
. Non confermato significa che il servizio non può corrispondere al numero civico 84 nel suo set di dati, mentre plausibile indica che i dati del componente potrebbero essere comunque validi.
Locale secondario mancante
Questo scenario descrive un indirizzo a cui manca solo una premessa, ad esempio il numero dell'appartamento o del reparto. In caso contrario, l'API Address Validation può convalidare completamente l'indirizzo. Come nel caso in cui manchi un componente dell'indirizzo, addressComplete
è false
e pertanto non è presente all'ispezione manuale dell'esito.
Ad esempio, supponiamo che un cliente inserisca un indirizzo valido per l'ufficio dell'autorità di regolamentazione della città di San Francisco, ma non contenga il numero di camera indicato nell'input.
Indirizzo inserito | Regione |
---|---|
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102, USA | Stati Uniti |
Verdetto per mancanza di premesse
In questo esempio, l'esito non mostra la proprietà addressComplete
, quindi è false
. Per questo motivo, sai che almeno un elemento dell'indirizzo è imprevisto, irrisolto o mancante.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true
}
Una query address
rivela quanto segue:
"missingComponentTypes": [
"subpremise"
]
A seguito di un'ulteriore indagine, i dati di USPS forniscono un codice dpvConfirmation
di D
, che indica anche una premessa mancante.