Conferma indirizzo. Esempi

Questo documento descrive una serie di scenari reali in cui l'API Address Validation fornisce indicatori di risposta per gli indirizzi che richiedono un comportamento di conferma da parte del sistema. Per informazioni contestuali, consulta la Panoramica del flusso di lavoro in Creare la logica di convalida.

Nota: gli esempi riportati sono solo a scopo illustrativo e non esaustivi.

Esempi comuni: conferma

L'esempio seguente illustra il caso di aree metropolitane con nomi di vie simili. Supponiamo che un utente intenda inserire l'indirizzo del Google Building D a Kirkland, Washington, Stati Uniti. Tuttavia, invece di Kirkland come città, inserisce inavvertitamente Seattle.

Indirizzo inserito	Regione
Edificio D, 451 7th Avenue South, Seattle, WA 98033	US

Giudizio per i dati sostituiti

L'esempio seguente mette in evidenza gli indicatori importanti della risposta.

{
  "inputGranularity": "SUB_PREMISE",
  "validationGranularity": "PREMISE_PROXIMITY",
  "geocodeGranularity": "PREMISE_PROXIMITY",
  "addressComplete": true,
  "hasUnconfirmedComponents": true
  "hasReplacedComponents": true
}

PREMISE_PROXIMITY indica l'approssimazione di un indirizzo a livello di edificio, ma non è dettagliato come SUB_PREMISE, che è la granularità fornita in input. La risposta contiene anche componenti non confermati e sostituiti, quindi la combinazione indica che si tratta della categoria conferma.

Una query sui componenti dell'indirizzo rivela le seguenti aree di preoccupazione:

{
  "componentName": {
    "text": "451",
  },
  "componentType": "street_number",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
...
{
  "componentName": {
    "text": "98104",
  },
  "componentType": "postal_code",
  "confirmationLevel": "CONFIRMED",
  "replaced": true
}
...
{
  "componentName": {
    "text": "Building D",
    "language_code": "en"
  },
  "componentType": "subpremise",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
}
.......

    "unconfirmedComponentTypes": [
      "street_number",
      "subpremise"
    ]

In questo caso, l'API di convalida dell'indirizzo ha trovato un'approssimazione ravvicinata all'indirizzo fornito a Seattle e ha sostituito il codice postale, un componente di livello superiore, per risolvere in un indirizzo di Seattle. Questa potrebbe essere una sostituzione valida, ma, oltre al fatto che i componenti non sono stati confermati, ha senso assicurarsi che l'utente intenda inserire un indirizzo di Seattle e non qualcos'altro, come Kirkland.

Suggerimento: controlla l'indirizzo corretto nella demo, utilizzando 451 7th Avenue South, Kirkland, WA 98033 per vedere la risposta per l'indirizzo previsto inizialmente.

Azione: conferma l'inserimento dell'indirizzo con il cliente.

Esempi di casi limite: conferma

Gli esempi seguenti illustrano i seguenti tipi di casi limite:

• Deduzione minori che SONO confermate. L'API Address Validation deducono il paese, il codice postale o lo stato, ma tutto il resto viene fornito e confermato. La combinazione della granularità e del livello di conferma consente un'inferenza minore che non richiede necessariamente un'azione di conferma.
• Componente dell'indirizzo imprevisto NON confermato. I componenti dell'indirizzo non confermati aumentano il livello di rischio dell'indirizzo. Questa situazione potrebbe richiedere una conferma.
• Componente dell'indirizzo imprevisto che È confermato. Il componente non è strettamente necessario per un indirizzo corretto e l'API Address Validation lo rimuove dall'output. I problemi di formattazione generalmente non richiedono una conferma.

Inferenze minori che SONO confermate

Se combinata con dati confermati di un livello più granulare, l'API può comunque fare un'inferenza corretta se all'input manca solo un componente dei seguenti tipi:

• Città
• Stato
• Codice postale
• Paese

Ad esempio, un cliente fornisce un indirizzo stradale valido per un ristorante McDonald's a Springfield, nel Massachusetts, ma dimentica di inserire la città e fornisce un codice postale senza l'estensione di 4 cifre.

Indirizzo inserito	Regione
1402 Allen St, MA 01118	US

Giudizio per la città mancante

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

Nelle situazioni in cui l'API di convalida dell'indirizzo deducono componenti di livello superiore per produrre un indirizzo recapitabile, puoi avere un livello più elevato di certezza che i dati del sistema siano corretti. Questo perché i componenti dedotti che rappresentano un'ampia regione geografica corrispondono più facilmente ai componenti dell'indirizzo confermati, che sono più granulari. Anche nei paesi in cui i nomi delle città si ripetono, come Springfield negli Stati Uniti, gli altri componenti combinati possono fornire un indirizzo univoco.

Utilizzando l'esempio riportato sopra, una scansione di tutti i componenti dell'indirizzo mostra che ogni componente è confermato, il che significa che corrisponde ai dati memorizzati dall'API Address Validation e che il servizio deducono anche due componenti di livello superiore.

{
  "componentName": {
    "text": "Springfield",
    "languageCode": "en"
  },
  "componentType": "locality",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
},
{
  "componentName": {
    "text": "1806"
  },
  "componentType": "postal_code_suffix",
  "confirmationLevel": "CONFIRMED",
  "inferred": true
}

Azione: accetta. Indirizzi come questi forniscono una granularità confermata sufficiente, insieme alla conferma dei componenti dedotti, in modo che la tua logica possa accettarli come validi senza dover chiedere conferma al cliente.

Componente dell'indirizzo imprevisto NON confermato

Questo scenario illustra l'importanza di verificare quando i componenti non sono confermati. Se un componente dell'indirizzo non è previsto, l'API Address Validation lo rimuove dall'output. In questi casi, puoi accettare l'indirizzo o confermarlo con il cliente, a seconda del tuo livello di rischio e del tuo livello di confidenza.

Ad esempio, un indirizzo potrebbe provenire da una regione in cui i clienti inseriscono spesso informazioni innocue ignorate dall'autorità postale, nel qual caso dovresti accettare l'indirizzo. Tuttavia, in alcuni casi un componente non confermato potrebbe non essere ciò che il cliente vuole.

Indirizzo inserito	Regione
1 Rue Grenache, la caritat 2, 34630 Saint-Thibéry	Francia

Giudizio per componente dell'indirizzo imprevisto non confermato

{
  "inputGranularity": "PREMISE",
  "validationGranularity": "PREMISE",
  "geocodeGranularity": "PREMISE",
  "unconfirmedComponents": true
}

Oltre a un verdetto con componenti non confermati, l'API Address Validation restituisce il seguente indirizzo formattato:

"formattedAddress": "1 Rue Grenache, 34630 Saint-Thibéry, France",

Una ricerca di componenti non confermati mostra che l'API ha rimosso la caritat 2 dall'indirizzo restituito:

{
  "componentName": {
    "text": "la caritat 2",
    "languageCode": "fr"
  },
  "componentType": "sublocality_level_1",
  "confirmationLevel": "UNCONFIRMED_BUT_PLAUSIBLE",
  "unexpected": true
}

Azione: conferma. In questo caso, la località, che può indicare un insediamento abitativo o un quartiere, potrebbe essere corretta, ma essere comunque ignorata dall'autorità postale. Tuttavia, dato che queste informazioni non sono confermate dall'API Address Validation, ha senso confermarle con il cliente. A questo punto, puoi ignorare la rimozione o confermarla.

Componente dell'indirizzo imprevisto che È stato confermato

Questo esempio illustra l'inclusione di una contea del Regno Unito nell'indirizzo fornito, che è una pratica comune. Tuttavia, non si tratta di un requisito dell'autorità postale del Regno Unito e viene sostanzialmente ignorato. Visita la pagina postoffice.co.uk e consulta Come indirizzare la posta nel Regno Unito e all'estero.

Di conseguenza, quando un cliente fornisce una contea in un indirizzo del Regno Unito, il servizio lo valuta come input imprevisto.

Indirizzo inserito	Regione
33 Dunalley St, Cheltenham, Gloucestershire, GL50 4AP	Regno Unito

Giudizio per componente dell'indirizzo imprevisto che È confermato

{
   "inputGranularity": "PREMISE",
   "validationGranularity": "PREMISE",
   "geocodeGranularity": "PREMISE"
}

In questo caso, address_complete restituisce false e un'analisi del componente dell'indirizzo rivela un flag imprevisto.

{
  "componentName": {
    "text": "Gloucestershire",
    "languageCode": "en"
  },
  "componentType": "administrative_area_level_2",
  "confirmationLevel": "CONFIRMED",
  "unexpected": true
}

Questo componente è imprevisto e confermato, il che significa quanto segue:

• Dati confermati come corretti. Ciò indica che il componente è la contea corretta che contiene l'indirizzo.
• Imprevisto come input. Indica un componente non obbligatorio per la formattazione corretta dell'indirizzo.

Anche se il Gloucestershire è la contea corretta per l'indirizzo inserito, l'indirizzo stesso non è formattato correttamente. Ricorda che l'API Address Validation valuta anche la formattazione corretta delle informazioni.

Azione: per questo scenario, l'azione consigliata è ignorare questo indicatore e accettare l'indirizzo.