Questo documento riguarda la convalida degli indirizzi specifica per gli Stati Uniti:
- Utilizzare i dati USPS nel flusso di lavoro
- Campi Verifica del punto di consegna USPS (dpv)
- Messaggi di sicurezza
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 dovresti utilizzare questa proprietà come unico mezzo per convalidare gli indirizzi, ma incorporare anche nel tuo sistema i componenti del verdetto e dell'indirizzo.
Verifica del punto di consegna USPS
Nell'ambito della risposta uspsData
, il campo dpvConfirmation
restituisce un singolo carattere per farti sapere se il servizio di spedizione 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
o non
restituisce affatto un valore dpvConfirmation
. La tabella seguente mostra il comportamento consigliato che la logica dovrebbe utilizzare per ciascuno dei cinque possibili risultati. 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 |
L'indirizzo non è stato confermato dal DPV. Ciò significa che USPS non riconosce il numero locale inserito esistente sulla strada (route) specificata e non può consegnare lì. |
D |
Correggi l'indirizzo |
L'indirizzo è stato confermato da DPV solo per il numero principale e mancavano le informazioni sul numero secondario. |
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 secondaria fornita non esiste all'interno dell'edificio, secondo 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 è completamente consegnabile tramite USPS, incluso il numero della sede secondaria, 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
Questo è un indicatore estremamente forte del fatto che il numero della premessa non esiste su questo percorso. Come per altri indirizzi problematici, il sistema dovrebbe richiedere correzioni.
Esempio di DPV D: correggi l'indirizzo
Questo esempio utilizza la sede Google a New York, ma non contiene una premessa secondaria 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 ottenere un DPV di Y, deve essere inclusa una premessa valida nell'input. Ad esempio, potresti includere una premessa secondaria valida di FL 4 (4° piano) per ottenere un 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, USA
- Regione: USA
- Il campo
dpvConfirmation
restituisce:S
Questo indica che, mentre 1600 Amphitheatre Parkway esiste come indirizzo che può accettare posta, la premessa 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 viene utilizzato l'indirizzo Googleplex di Mountain View, CA, come indirizzo di qualità nota.
- 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. Ciò ti consente di avere un'alta probabilità che l'API abbia restituito un indirizzo di buona qualità e puoi 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 negli 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 tramite il rilevamento di 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.