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 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. |
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.