Gestire gli indirizzi degli Stati Uniti

Questo documento descrive 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 del reso.

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

Verifica del punto di consegna (DPV) di USPS

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

Puoi utilizzare questo campo per determinare quanto segue:

  • validità dell'indirizzo.
  • se nell'indirizzo manca un numero di premessa.
  • se il numero della premessa non esiste nel sistema dati USPS.

Il servizio restituisce uno dei quattro valori dpvConfirmation o non restituisce affatto un valore dpvConfirmation. La tabella seguente mostra il comportamento consigliato che la logica dovrebbe utilizzare per ciascuno dei cinque risultati possibili. Per ulteriori dettagli su questa logica, consulta Panoramica del flusso di lavoro in Utilizzare la risposta di convalida.

Valore

Comportamento

Descrizione

N o vuoto

Correggi l'indirizzo

Il DPV non è stato confermato per l'indirizzo.

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

D

Correggi l'indirizzo

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

Significa che il numero locale inserito esiste nella via inserita, ma per raggiungere un indirizzo completamente verificato/consegnabile è necessario fornire anche un numero di premessa valido. In altre parole, la premessa secondaria non era presente nell'input.

S

Conferma l'indirizzo

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

Ciò significa che il numero della premessa inserito esiste sul percorso inserito, ma la premessa fornita non esiste all'interno dell'edificio, secondo USPS.

Sì

Accetta l'indirizzo

L'indirizzo è stato confermato per i numeri primari e secondari.

Ciò significa che l'indirizzo può essere fornito completamente da USPS, incluso il numero della premessa, se applicabile.

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

Esempio di DPV N: correggi l'indirizzo

In questo esempio viene utilizzato un numero civico inesistente per un indirizzo altrimenti valido.

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

Questo è un indicatore estremamente forte che indica che questo numero presupposto non esiste su questa route. Come per altri indirizzi problematici, il sistema deve richiedere all'utente le correzioni.

Esempio di DPV D: correggi l'indirizzo

Questo esempio utilizza la sede Google a New York, ma non contiene una premessa che è una parte obbligatoria dell'indirizzo. Puoi verificarlo utilizzando l'indirizzo nella demo senza informazioni dei presupposti.

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

Questo conferma che la premessa secondaria non era presente nell'input. Per ottenere un DPV di Y, è necessario includere una premessa valida come parte dell'input. Ad esempio, puoi includere una premessa valida di FL 4 (4th Floor) per ottenere un valore dpvConfirmation pari a Y.

Esempio di DPV S: conferma l'indirizzo

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

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

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

Esempio DPV Y: accetta l'indirizzo

In questo esempio viene utilizzato l'indirizzo Googleplex a Mountain View, CA, come indirizzo di qualità noto.

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

L'indirizzo può essere consegnato completamente da USPS. Questo ti offre un'elevata certezza che l'API abbia restituito un indirizzo di buona qualità e che tu possa utilizzarlo 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 degli Stati Uniti

Questa sezione illustra i flag di sicurezza forniti nei dati USPS per gli indirizzi creati artificialmente. Questa misura di sicurezza è concepita 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 verificarsi 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.