Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce segnali di risposta che giustificano un comportamento di aggiunta di un sottolocale da parte del sistema. Questi indicatori sono disponibili solo per gli indirizzi statunitensi. Per il contesto, consulta Flussi di lavoro di esempio in Crea la logica di convalida.
Esempio comune: aggiunta di locali secondari
Questo scenario illustra un indirizzo in cui il sistema potrebbe chiedere a un cliente di aggiungere un numero di unità all'indirizzo.
| Indirizzo inserito | Regione |
|---|---|
| 1450 Brickell Avenue, Miami, FL 33131-4065 | US |
Verdetto per un indirizzo a cui manca un'unità secondaria
L'esempio seguente evidenzia l'indicatore importante.
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Esempio di caso limite: aggiunta di locali secondari
Il seguente esempio riguarda una situazione in cui verdict indica
problemi di qualità dell'indirizzo che richiedono ulteriori indagini. Questi esempi illustrano anche come la logica può passare dal verdetto ai componenti dell'indirizzo per ottenere un quadro più completo al fine di migliorare la logica del sistema.
Componenti secondari mancanti e componenti dedotti e sostituiti
Questo esempio illustra l'inserimento di un indirizzo statunitense con una località mancante e un codice postale errato.
| Indirizzo inserito | Regione |
|---|---|
| 1450 Brickell Avenue, FL 33132-4065 | US |
Verdetto per un componente secondario mancante e per i componenti dedotti e sostituiti
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true,
"hasReplacedComponents": true,
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Ulteriori indagini sui componenti dell'indirizzo rivelano che la località è stata dedotta e il codice postale è stato sostituito.
{
"componentName": {
"text": "33131",
}
"componentType": "postal_code",
"confirmationLevel": "CONFIRMED",
"replaced": true
},
{
"componentName": {
"text": "Miami",
"languageCode": "en"
}
"componentType": "locality",
"confirmationLevel": "CONFIRMED",
"inferred": true
}