Gestire gli indirizzi degli Stati Uniti

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

Dati USPS nel tuo workflow

Durante la convalida degli indirizzi negli Stati Uniti, l'API Address Validation può anche compilare la parte uspsData del risultato.

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

USPS Delivery Point Verification (DPV)

Come parte della risposta uspsData, il campo dpvConfirmation restituisce un singolo carattere per farti sapere se USPS può consegnare all'indirizzo fornito.

Puoi utilizzare questo campo per determinare quanto segue:

  • validità dell'indirizzo.
  • Se nell'indirizzo manca il numero dell'unità secondaria.
  • se il numero della sotto-unità non esiste nel sistema di dati USPS.

Il servizio restituisce uno dei quattro valori dpvConfirmation o non restituisce alcun valore dpvConfirmation. La tabella seguente mostra il comportamento consigliato che la tua logica deve utilizzare per ciascuno dei 5 possibili risultati. Per maggiori dettagli su questa logica, consulta Panoramica del workflow in Crea la logica di convalida.

Valore

Comportamento

Descrizione

No

o vuoto

Correggi l'indirizzo

L'indirizzo non è stato confermato dal DPV.

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

D

Correggi l'indirizzo

L'indirizzo è stato confermato dal DPV solo per il numero principale e le informazioni sul numero secondario erano mancanti.

Ciò significa che il numero civico inserito esiste nella via specificata, ma per raggiungere un indirizzo completamente verificato e consegnabile, è necessario fornire anche un numero civico secondario valido. In altre parole, l'interno non era presente nell'input.

S

Conferma l'indirizzo

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

Ciò significa che il numero civico inserito esiste nel percorso inserito, ma il numero di interno fornito non esiste all'interno di quell'edificio, secondo USPS.

Y

Accetta l'indirizzo

L'indirizzo è stato confermato dal DPV per i numeri principali e secondari.

Ciò significa che l'indirizzo è completamente consegnabile da USPS, incluso il numero della proprietà secondaria, 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

Questo è un indicatore estremamente forte del fatto che questo numero civico non esiste su questo percorso. Come per altri indirizzi problematici, il sistema deve chiedere all'utente di apportare correzioni.

Esempio DPV D: correggi l'indirizzo

Questo esempio utilizza l'ufficio di Google a New York, ma non contiene un'unità secondaria, che è una parte obbligatoria dell'indirizzo. Puoi vederlo utilizzando l'indirizzo nella demo senza informazioni sulla sotto-unità.

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

Ciò conferma che l'unità secondaria non era presente nell'input. Per ottenere un DPV di Y, è necessario includere un sotto-edificio valido come parte dell'input. Ad esempio, puoi includere un'unità secondaria valida di FL 4 (4° piano) per ottenere un valore dpvConfirmation di Y.

Esempio di DPV S: conferma l'indirizzo

Questo esempio utilizza un numero di unità secondaria 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

Ciò indica che, sebbene 1600 Amphitheatre Parkway esista come indirizzo che può accettare posta, la sotto-unità Ste 101 non è una parte valida dell'indirizzo. Il tuo sistema deve confermare queste informazioni con l'utente e offrire la possibilità di apportare correzioni.

Esempio di DPV Y: accetta l'indirizzo

Questo esempio utilizza l'indirizzo di Googleplex a Mountain View, in California, come indirizzo di qualità noto.

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

L'indirizzo è completamente recapitabile da USPS. Questo ti dà un livello di certezza molto elevato che l'API ha restituito un indirizzo di buona qualità e che puoi utilizzarlo così come fornito.

Nota: il DPV non indica se l'API Address Validation ha apportato 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 gli 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 legittimamente. Questo dovrebbe essere un evento 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.