Correggi l'indirizzo - esempi

Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce segnali di risposta che giustificano un comportamento di correzione da parte del tuo sistema. Gli esempi qui riportati sono illustrativi, ma non esaustivi. Per il contesto, consulta la sezione Panoramica del flusso di lavoro in Creare la logica di convalida.

Esempi comuni: correzione

Questa sezione descrive esempi comuni in cui l'API Address Validation fornisce segnali di risposta che indicano informazioni sull'indirizzo di qualità inferiore.

Città e codice postale mancanti

Questo esempio illustra una voce che contiene solo l'indirizzo stradale, senza città o codice postale.

Indirizzo inserito Regione
21 45 40th street USA

Verdetto per città e codice postale mancanti

L'esempio seguente sottolinea i segnali importanti della risposta.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "OTHER",
  "geocodeGranularity": "OTHER",
  "hasUnconfirmedComponents": true
}

Questi segnali 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 omissioni importanti dei dati, come località e codice postale.

Numero civico mancante

Questo esempio mostra un numero civico mancante.

Indirizzo inserito Regione
Buckingham Palace Road, SW1W 9TQ London Regno Unito
Verdetto per numero civico mancante
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

validationGranularity è ROUTE, il che indica una corrispondenza con la via, ma non informazioni sufficienti per raggiungere la sede. Inoltre, la proprietà addressComplete non è presente nel verdetto e pertanto è false. Un'ulteriore query dell'oggetto address rivela un tipo di componente mancante:

"missingComponentTypes": [
        "street_number"
      ]

Esempi di casi limite: correzione

In alcune situazioni, la decisione di correggere, confermare o accettare un indirizzo dipende dal tuo scenario aziendale specifico. Gli esempi riportati di seguito illustrano scenari che potrebbero non rientrare strettamente in una categoria di correzione.

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, London Regno Unito

Verdetto per numero civico non confermato

L'esempio seguente sottolinea i segnali importanti.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete" : true,
  "hasUnconfirmedComponents": true
}

Vale la pena esaminare la combinazione di una granularità di convalida solo per l'approssimazione a livello di sede e i 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"
}

In questo caso, confirmation_level di street_number è impostato su UNCONFIRMED_BUT_PLAUSIBLE. Non confermato significa che il servizio non riesce a trovare una corrispondenza per il numero civico 84 nel suo set di dati, mentre plausibile significa che i dati dei componenti potrebbero comunque essere validi.

Sede secondaria mancante

Questo scenario descrive un indirizzo in cui manca solo una sede secondaria, ad esempio un numero di appartamento o di 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 nell'ispezione manuale del verdetto.

Per illustrare, supponiamo che un cliente inserisca un indirizzo valido per l'ufficio del valutatore della città di San Francisco, ma non inserisca il numero della stanza.

Indirizzo inserito Regione
1 Doctor Carlton B Goodlett Place, San Francisco, CA 94102 USA

Verdetto per sede secondaria mancante

In questo esempio, il verdetto non mostra la proprietà addressComplete, quindi è false. Per questo motivo, sai che almeno un elemento dell'indirizzo è imprevisto, non risolto o mancante.

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "hasInferredComponents": true

}

Una query address rivela quanto segue:

"missingComponentTypes": [
        "subpremise"
      ]

Dopo ulteriori indagini, i dati USPS forniscono un codice dpvConfirmation di D, che indica anche una sede secondaria mancante.