Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta che giustificano un comportamento di aggiunta di sotto-unità da parte del tuo sistema. Questi indicatori sono disponibili solo per gli indirizzi negli Stati Uniti. Per il contesto, consulta Esempi di flussi di lavoro in Crea la logica di convalida.
Esempio comune: aggiunta di sotto-unità
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 |
Esito per un indirizzo senza 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 sotto-unità
L'esempio seguente riguarda una situazione in cui verdict indica problemi di qualità dell'indirizzo che richiedono ulteriori indagini. Questo esempio illustra anche come la logica può passare dall'esito ai componenti dell'indirizzo per ottenere un quadro più completo e 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 |
Esito per un subpremise mancante e componenti dedotti e sostituiti
{
"inputGranularity": "PREMISE",
"validationGranularity": "PREMISE",
"geocodeGranularity": "PREMISE",
"hasInferredComponents": true,
"hasReplacedComponents": true,
"possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}
Un'ulteriore indagine sui componenti dell'indirizzo rivela 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
}