Correggi l'indirizzo - esempi

Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta che potrebbero giustificare un comportamento di correzione da parte del sistema. Per un contesto, consulta Flussi di lavoro di esempio 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 l'indirizzo, 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,
  "possibleNextAction": "FIX"
}

possibleNextAction fornisce un'indicazione iniziale che l'indirizzo potrebbe non essere idoneo per la consegna. Anche gli altri componenti evidenziati supportano questa possibilità, quindi puoi eseguire 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",
    "possibleNextAction": "FIX"
}

Ancora una volta, possibleNextAction fornisce un'indicazione iniziale che l'indirizzo potrebbe non essere recapitato. Inoltre, il validationGranularity è ROUTE, il che indica una corrispondenza con la strada, ma non ci sono informazioni sufficienti per raggiungere la sede. Inoltre, la proprietà addressComplete manca nel verdetto, 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 correzione, la conferma o l'accettazione di 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

Verdetto 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,
  "possibleNextAction": "ACCEPT"
}

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

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

Missing subpremise

Questo scenario descrive un indirizzo a cui manca solo un'unità secondaria, ad esempio un numero di appartamento o reparto. In caso contrario, l'API Address Validation può convalidare completamente l'indirizzo. Come nel caso in cui manchi un componente dell'indirizzo, il 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 perito della città di San Francisco, ma non inserisca il numero di stanza.

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

Verdetto per la 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,
  "possibleNextAction": "CONFIRM_ADD_SUBPREMISES"
}

Una query address rivela quanto segue:

"missingComponentTypes": [
        "subpremise"
      ]

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