Gestire gli indirizzi degli Stati Uniti

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

Dati USPS nel flusso di lavoro

Durante la convalida degli indirizzi negli Stati Uniti, il servizio API Address Validation può anche completare la parte uspsData della restituzione.

Poiché questo oggetto non viene sempre compilato, non devi fare affidamento come unico mezzo per convalidare gli indirizzi, ma incorporare invece la proprietà l'esito e l'indirizzamento dei componenti nel sistema.

Verifica del punto di consegna USPS

Come parte della risposta uspsData, il campo dpvConfirmation restituisce una singola per farti sapere se 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 della premessa secondaria 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 ulteriori informazioni su questa logica, vedi 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 dal DPV.

Ciò significa che USPS non riconosce il numero locale inserito esistenti per la strada (percorso) specificata e non possono consegnare lì.

D

Correggi l'indirizzo

L'indirizzo è stato confermato dalla data di destinazione solo per il numero principale e informazioni sul numero secondario mancanti.

Ciò significa che la premessa numero inserito esiste sulla strada specificata, ma per raggiungere un numero valido/rilasciabile, deve essere fornito anche un numero di fornito. In altre parole, la premessa secondaria mancava nell'input.

S

Conferma l'indirizzo

L'indirizzo è stato confermato dalla data di destinazione solo per il numero principale e erano presenti informazioni su un numero secondario, 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 da DPV per il numero primario 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 gli scenari reali che utilizzano i codici per la protezione dei dati.

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, USA
  • Regione: USA
  • Il campo dpvConfirmation restituisce: N

È un indicatore estremamente forte del fatto che questo numero di premessa non esiste su questa strada. 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 la sede di Google a New York, ma non contiene un 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: USA
  • Il campo dpvConfirmation restituisce: D

Ciò conferma che l'input non ha la premessa secondaria. 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

In questo esempio viene utilizzato un numero di presupposto secondario che non esiste all'interno dell'edificio:

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

Questo indica che, mentre 1600 Amphitheatre Parkway esiste come indirizzo che può accettare posta, il presupposto secondario Ste 101 non è una parte valida dell'indirizzo. Il sistema deve confermare queste informazioni all'utente e fornire una l'opportunità di una 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, USA
  • Regione: USA
  • Il campo dpvConfirmation restituisce: Y

L'indirizzo deve essere completamente recapitabile tramite 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 negli Stati Uniti

Questa sezione illustra i flag di sicurezza forniti nei dati USPS per di indirizzi creati artificialmente. Questa misura di sicurezza è stata concepita per evitare Creazione artificiale di un elenco di indirizzi, mediante il rilevamento del momento in cui un indirizzo viene inviato sembrano essere stati costruiti artificialmente e non ottenuti in modo legittimo. Si tratta di un caso molto raro.

Quando l'USPS identifica un indirizzo creato artificialmente, errorMessage della proprietà uspsData della risposta contiene un 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.