Gestire gli indirizzi degli Stati Uniti

Questo documento riguarda la convalida degli indirizzi specifica per gli Stati Uniti:

Dati USPS nel flusso di lavoro

Quando convalidi gli indirizzi negli Stati Uniti, il servizio dell'API Address Validation può anche compilare la parte uspsData del reso.

Poiché questo oggetto non è sempre compilato, non devi fare affidamento su questa proprietà come unico mezzo per convalidare gli indirizzi, ma devi incorporare anche i componenti di giudizio e indirizzo nel tuo sistema.

Verifica del punto di consegna USPS

Nell'ambito della risposta uspsData, il campo dpvConfirmation restituisce un singolo carattere per indicare se l'USPS può effettuare la consegna all'indirizzo fornito.

Puoi utilizzare questo campo per determinare quanto segue:

  • valido.
  • se nell'indirizzo manca un numero del presupposto secondario.
  • se il numero del locale secondario non esiste nel sistema dati USPS.

Il servizio restituisce uno dei quattro valori dpvConfirmation oppure non restituisce restituisce un valore dpvConfirmation. La tabella seguente mostra le comportamento che la tua logica dovrebbe usare per ciascuno dei 5 risultati possibili. Per maggiori dettagli su questa logica, consulta la Panoramica del flusso di lavoro in Utilizzare la risposta di convalida.

Valore

Comportamento

Descrizione

N o vuoto

Correggi l'indirizzo

L'indirizzo non è stato confermato tramite DPV.

Ciò significa che l'USPS non riconosce il numero civico inserito presente nella via (percorso) inserita e non può effettuare consegne.

D

Correggi l'indirizzo

L'indirizzo è stato confermato tramite DPV solo per il numero principale e mancavano le informazioni sul numero secondario.

Ciò significa che il numero di proprietà inserito esiste nella via inserita, ma per raggiungere un indirizzo completamente verificato/corrispondente a una sede fisica, è necessario fornire anche un numero di proprietà secondaria valido. In altre parole, l'elemento secondario mancava nell'input.

S

Conferma l'indirizzo

L'indirizzo è stato confermato tramite DPV solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non confermate.

Ciò significa che il numero della sede inserito esiste sul percorso inserito, ma la premessa secondaria fornita non esiste all'interno di tale edificio, a USPS.

Y

Accetta l'indirizzo

L'indirizzo è stato confermato dalla data di destinazione per il numero principale e per eventuali numeri secondari.

Ciò significa che l'indirizzo può essere recapitato completamente tramite USPS, incluso il numero del sub-premise, se applicabile.

Il resto di questa sezione illustra scenari reali che utilizzano i codici DPV.

Esempio di DPV N: correggi l'indirizzo

Questo esempio utilizza un numero civico inesistente su un indirizzo altrimenti valido.

  • Indirizzo inserito: 12 Amphitheatre Parkway, Mountain View, CA, 94043
  • Regione: USA
  • Il campo dpvConfirmation restituisce: N

Si tratta di un indicatore estremamente forte che questo numero di indirizzi non esiste su questo percorso. Come per altri indirizzi problematici, il sistema dovrebbe richiedere le correzioni da parte dell'utente.

Esempio di DPV D: correggi l'indirizzo

Questo esempio utilizza l'ufficio di Google a New York, ma non contiene un'area sottoposta a restrizioni, che è una parte obbligatoria dell'indirizzo. Puoi verificarlo utilizzando l'indirizzo nella demo senza informazioni secondarie.

  • Indirizzo inserito: 111 8th Avenue, New York, NY, 10011
  • Regione: Stati Uniti
  • Il campo dpvConfirmation restituisce: D

Ciò conferma che la proprietà secondaria non era presente nell'input. Per arrivare a un DPV su Y, è necessario includere nell'input una premessa secondaria valida. Ad esempio: potresti includere una premessa secondaria valida di FL 4 (4° piano) per ottenere una Valore dpvConfirmation di Y.

Esempio di DPV S: conferma l'indirizzo

Questo esempio utilizza un numero di proprietà secondaria che non esiste all'interno dell'edificio:

  • Indirizzo inserito: 1600 Amphitheatre Parkway, Suite 101, Mountain View, CA, USA, 94043
  • Regione: Stati Uniti
  • Il campo dpvConfirmation restituisce: S

Ciò indica che, sebbene 1600 Amphitheatre Parkway esista come indirizzo che può accettare posta, la proprietà secondaria Ste 101 non è una parte valida dell'indirizzo. Il sistema deve confermare queste informazioni con l'utente e offrire un'opportunità di correzione.

Esempio di DPV Y - Accetta l'indirizzo

In questo esempio, l'indirizzo Googleplex di Mountain View, in California, viene utilizzato come un indirizzo di qualità noto.

  • Indirizzo inserito: 1600 Amphitheatre Parkway, Mountain View, CA, 94043
  • Regione: USA
  • Il campo dpvConfirmation restituisce: Y

L'indirizzo è completamente idoneo per la consegna da parte di USPS. Questo offre un altissimo livello la certezza che l'API ha restituito un indirizzo di buona qualità e puoi utilizzarlo come previsto.

Nota: il DPV non indica se l'API Address Validation ha effettuato qualche modifiche all'input, ad esempio una correzione ortografica.

Messaggi di sicurezza per gli indirizzi statunitensi

Questa sezione illustra i flag di sicurezza forniti nei dati USPS per di indirizzi creati artificialmente. Questa misura di sicurezza è progettata per impedire la creazione artificiale di un elenco di indirizzi rilevando quando un indirizzo inviato sembra essere stato creato artificialmente e non ottenuto in modo legittimo. Si tratta di un caso molto raro.

Quando USPS identifica un indirizzo creato artificialmente, il campo errorMessage della proprietà uspsData della risposta contiene un messaggio di errore che descrive il problema. Ad esempio:

AMS API processing was terminated due to the detection of what is determined to
be an artificially created address. No address beyond this point has been
validated and/or processed. If you believe this address was identified in error,
please contact your Vendor.