Correggi l'indirizzo - esempi

Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta che giustificano un comportamento di correzione del sistema. Per informazioni contestuali, 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 indicatori di risposta che indicano informazioni sull'indirizzo di qualità inferiore.

Mancano città e codice postale

Questo esempio mostra una voce contenente solo il nome della via, senza città o codice postale.

Indirizzo inserito Regione
21 45 40th street USA

Giudizio 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 omissioni importanti nei 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
Giudizio per numero civico mancante
{
    "inputGranularity": "PREMISE_PROXIMITY",
    "validationGranularity": "ROUTE",
    "geocodeGranularity": "ROUTE"
}

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

"missingComponentTypes": [
        "street_number"
      ]

Esempi di casi limite: correzione

In alcuni casi, la scelta di correggere, confermare o accettare un indirizzo dipende dal tuo specifico scenario aziendale. 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, Londra Regno Unito

Giudizio 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 proprietà insieme ai 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, il confirmation_level del street_number è impostato su UNCONFIRMED_BUT_PLAUSIBLE. Non confermato indica che il servizio non riesce a trovare una corrispondenza per il numero civico 84 nel proprio set di dati, mentre Plausibile indica che i dati del componente potrebbero essere ancora validi.

Struttura secondaria 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ò verificare completamente l'indirizzo. Come accade quando manca un componente dell'indirizzo, il valore addressComplete è false e quindi non è presente durante l'ispezione manuale del verdetto.

Per fare un esempio, supponiamo che un cliente inserisca un indirizzo valido per l'ufficio del perito 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

Giudizio per la proprietà secondaria mancante

In questo esempio, il verdetto non mostra la proprietà addressComplete, pertanto è false. Di conseguenza, sai che almeno un elemento address è imprevisto, irrisolto o mancante.

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

}

Una query address rivela quanto segue:

"missingComponentTypes": [
        "subpremise"
      ]

A seguito di ulteriori accertamenti, i dati USPS forniscono un codice dpvConfirmation di D, che indica anche la presenza di una proprietà secondaria mancante.