Correggi l'indirizzo - esempi

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

Esempi comuni: correzione

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

Città e codice postale mancanti

Questo esempio mostra una voce con solo la via, senza città o codice postale.

Indirizzo inserito Regione
21 45 40th street USA

Esito 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 recapitabile, 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 Londra Regno Unito

Esito per numero civico mancante

{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

Il valore di validationGranularity è ROUTE, il che indica una corrispondenza con la via, ma non informazioni sufficienti per raggiungere l'edificio. 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 alcune situazioni, la scelta di correggere, confermare o accettare un indirizzo dipende dallo scenario aziendale specifico. Gli esempi riportati di seguito illustrano scenari che potrebbero non rientrare rigorosamente 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, Londra Regno Unito

Esito 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 esaminare la combinazione di una granularità di convalida solo per l'approssimazione a livello di edificio insieme ai componenti non confermati. Una query della proprietà addressComponents mostra i seguenti componentType non confermati:

{
  "componentName": {
    "text": "84",
    "languageCode": "en"
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE"
}

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

Subpremise mancante

Questo scenario descrive un indirizzo a cui manca solo un'unità 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.

Ad esempio, supponiamo che un cliente inserisca un indirizzo valido per l'ufficio del perito della città di San Francisco, ma ometta il numero della stanza nell'input.

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

Esito per subpremise mancante

In questo esempio, l'esito 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"
      ]

In seguito a ulteriori indagini, i dati USPS forniscono un codice dpvConfirmation di D, che indica anche un subpremise mancante.