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. Consulta la panoramica del flusso di lavoro in Creare la logica di convalida per il contesto.

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 contenente solo il nome della via, senza città o codice postale.

Indirizzo inserito Regione
21 45 40th street USA

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 ai dati, come la località e il 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"
}

Il validationGranularity è ROUTE, che indica una corrispondenza con la strada, ma non abbastanza informazioni per arrivare alla premessa. Inoltre, nell'esito non è presente la proprietà addressComplete, 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 riportato di seguito 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 locale 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ò convalidare completamente l'indirizzo. Come accade quando manca un elemento dell'indirizzo, il valore addressComplete è false e quindi non è presente durante l'ispezione manuale del verdetto.

Per spiegarci meglio, supponiamo che un cliente inserisca un indirizzo valido per l'ufficio di valutatore della città di San Francisco, ma non abbia inserito il numero della camera.

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. 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 ulteriori accertamenti, i dati USPS forniscono un codice dpvConfirmation di D, che indica anche una proprietà secondaria mancante.