Correggi l'indirizzo - esempi

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.