- Richiesta HTTP
- Corpo della richiesta
- Corpo della risposta
- PostalAddress
- LanguageOptions
- ValidationResult
- Esito
- Granularità
- Indirizzo
- AddressComponent
- ComponentName
- ConfirmationLevel
- Geocodifica
- LatLng
- PlusCode
- Area visibile
- AddressMetadata
- UspsData
- UspsAddress
Convalida un indirizzo.
Richiesta HTTP
POST https://addressvalidation.googleapis.com/v1:validateAddress
L'URL utilizza la sintassi di transcodifica gRPC.
Corpo della richiesta
Il corpo della richiesta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{ "address": { object ( |
Campi | |
---|---|
address |
Obbligatorio. L'indirizzo in fase di convalida. Gli indirizzi non formattati devono essere inviati tramite La lunghezza totale dei campi in questo input non deve superare i 280 caratteri. Le regioni supportate sono disponibili qui. Il valore L'API Address Validation ignora i valori in |
previousResponseId |
Questo campo deve essere vuoto per la prima richiesta di convalida dell'indirizzo. Se sono necessarie più richieste per convalidare completamente un singolo indirizzo (ad esempio, se le modifiche apportate dall'utente dopo la convalida iniziale devono essere riconvalidate), ogni richiesta di follow-up deve completare questo campo con il |
enableUspsCass |
Attiva la modalità compatibile con CASS di USPS. Questo influisce solo sul campo Ti consigliamo di utilizzare un valore compositi del |
languageOptions |
(Facoltativo) Anteprima: questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini di servizio specifici di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. Consente all'API Address Validation di includere informazioni aggiuntive nella risposta. |
sessionToken |
(Facoltativo) Una stringa che identifica una sessione di completamento automatico ai fini della fatturazione. Deve essere una stringa base64 sicura per URL e nomi file con una lunghezza massima di 36 caratteri ASCII. In caso contrario, viene restituito un errore INVALID_ARGUMENT. La sessione inizia quando l'utente esegue una query di completamento automatico e termina quando seleziona un luogo e viene effettuata una chiamata a Place Details o Address Validation. Ogni sessione può avere più query di completamento automatico, seguite da una richiesta Place Details o Address Validation. Le credenziali utilizzate per ogni richiesta all'interno di una sessione devono appartenere allo stesso progetto della console Google Cloud. Una volta terminata la sessione, il token non è più valido. la tua app deve generare un nuovo token per ogni sessione. Se il parametro Nota: Address Validation può essere utilizzato solo nelle sessioni con l'API Autocomplete (nuova) , non con l'API Autocomplete. Per maggiori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/session-pricing. |
Corpo della risposta
La risposta a una richiesta di convalida degli indirizzi.
In caso di esito positivo, il corpo della risposta contiene dati con la seguente struttura:
Rappresentazione JSON |
---|
{
"result": {
object ( |
Campi | |
---|---|
result |
Il risultato della convalida dell'indirizzo. |
responseId |
L'UUID che identifica questa risposta. Se l'indirizzo deve essere riconvalidato, questo UUID deve accompagnare la nuova richiesta. |
PostalAddress
Rappresenta un indirizzo postale, ad esempio per gli indirizzi di consegna postale o di pagamento. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, una P.O. Box o simile. Non è progettato per creare modelli di località geografiche (strade, città, montagne).
Nell'utilizzo tipico, un indirizzo verrebbe creato tramite l'input dell'utente o importando dati esistenti, a seconda del tipo di processo.
Consigli sull'inserimento / modifica di indirizzi: - Usa un widget degli indirizzi pronto per l'internazionalizzazione, come https://github.com/google/libaddressinput. - Agli utenti non dovrebbero essere mostrati elementi di interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato quel campo.
Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina: https://support.google.com/business/answer/6397478
Rappresentazione JSON |
---|
{ "revision": integer, "regionCode": string, "languageCode": string, "postalCode": string, "sortingCode": string, "administrativeArea": string, "locality": string, "sublocality": string, "addressLines": [ string ], "recipients": [ string ], "organization": string } |
Campi | |
---|---|
revision |
La revisione dello schema di |
regionCode |
(Facoltativo) Codice regione CLDR del paese o della regione dell'indirizzo. Per informazioni dettagliate, visita le pagine https://cldr.unicode.org/ e https://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. Se il codice regione non viene fornito, verrà dedotto dall'indirizzo. Per prestazioni ottimali, ti consigliamo di includere il codice regione, se lo conosci. La presenza di regioni incoerenti o ripetute può portare a un rendimento scarso. Ad esempio, se |
languageCode |
Il codice della lingua nell'indirizzo inserito è riservato per utilizzi futuri e oggi viene ignorato. L'API restituisce l'indirizzo nella lingua appropriata in cui si trova l'indirizzo. |
postalCode |
(Facoltativo) Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/codice postale negli Stati Uniti). |
sortingCode |
(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Dove viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice di settore" (Giamaica), "indicatore zona di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrativeArea |
(Facoltativo) Suddivisione amministrativa di livello più elevato utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, può essere uno stato, una provincia, un oblast o una prefettura. In particolare, per la Spagna si tratta della provincia e non della comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad es. in Svizzera, deve essere lasciato vuoto. |
locality |
(Facoltativo) In genere si riferisce alla porzione di città dell'indirizzo. Esempi: città USA, comune in Italia, città postale nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia il campo della località vuoto e utilizza addressLines. |
sublocality |
(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, quartieri e distretti. |
addressLines[] |
Obbligatorio. Righe di indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo. |
recipients[] |
Evita di impostare questo campo. Al momento l'API Address Validation non la utilizza. Anche se in questo momento l'API non rifiuterà le richieste per cui è stato impostato questo campo, le informazioni verranno ignorate e non verranno restituite nella risposta. |
organization |
Evita di impostare questo campo. Al momento l'API Address Validation non la utilizza. Anche se in questo momento l'API non rifiuterà le richieste per cui è stato impostato questo campo, le informazioni verranno ignorate e non verranno restituite nella risposta. |
LanguageOptions
Anteprima: questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini di servizio specifici di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.
Consente all'API Address Validation di includere informazioni aggiuntive nella risposta.
Rappresentazione JSON |
---|
{ "returnEnglishLatinAddress": boolean } |
Campi | |
---|---|
returnEnglishLatinAddress |
Anteprima: restituisci |
ValidationResult
Il risultato della convalida di un indirizzo.
Rappresentazione JSON |
---|
{ "verdict": { object ( |
Campi | |
---|---|
verdict |
Segnalazioni dell'esito complessivo |
address |
Informazioni sull'indirizzo stesso anziché sul geocodice. |
geocode |
Informazioni sulla località e sul luogo in cui è stato geocodificato l'indirizzo. |
metadata |
Altre informazioni pertinenti ai fini della consegna. Non è garantito che il campo |
uspsData |
Flag di consegnabilità extra forniti da USPS. Fornito solo nelle regioni |
englishLatinAddress |
Anteprima: questa funzionalità è in anteprima (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte dai Termini di servizio specifici di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio. L'indirizzo tradotto in inglese. Gli indirizzi tradotti non sono riutilizzabili come input API. Il servizio le fornisce in modo che l'utente possa usare la propria lingua madre per confermare o negare la convalida dell'indirizzo fornito in origine. Se parte dell'indirizzo non ha una traduzione in inglese, il servizio restituisce quella parte in una lingua alternativa che utilizza un alfabeto latino. Leggi qui per una spiegazione di come viene selezionata la lingua alternativa. Se una parte dell'indirizzo non ha traduzioni o traslitterazioni in una lingua che utilizza un alfabeto latino, il servizio restituisce quella parte nella lingua locale associata all'indirizzo. Abilita questo output utilizzando il flag Nota: i campi |
Verdetto
Panoramica generale del risultato della convalida dell'indirizzo e del geocodice.
Rappresentazione JSON |
---|
{ "inputGranularity": enum ( |
Campi | |
---|---|
inputGranularity |
La granularità dell'indirizzo di input. Questo è il risultato dell'analisi dell'indirizzo di input e non fornisce alcun indicatore di convalida. Per gli indicatori di convalida, consulta la sezione Ad esempio, se l'indirizzo inserito include un numero di appartamento specifico, il valore |
validationGranularity |
Il livello di granularità a cui l'API può convalidare completamente l'indirizzo. Ad esempio, un valore Il risultato della convalida dei componenti per indirizzo è disponibile in |
geocodeGranularity |
Informazioni sulla granularità del Questo può occasionalmente differire dalla |
addressComplete |
L'indirizzo è considerato completo se non ci sono token non risolti o componenti dell'indirizzo inaspettati o mancanti. Se non viene configurato, indica che il valore è |
hasUnconfirmedComponents |
Almeno un componente dell'indirizzo non può essere classificato o convalidato. Consulta |
hasInferredComponents |
È stato dedotto (aggiunto) almeno un componente dell'indirizzo che non era nell'input. Vedi |
hasReplacedComponents |
Almeno un componente dell'indirizzo è stato sostituito. Consulta |
Granularità
Le diverse granularità di un indirizzo o di un geocodice. Se utilizzati per indicare il livello di granularità di un indirizzo, questi valori indicano il livello di granularità di un indirizzo che identifica una destinazione postale. Ad esempio, un indirizzo simile a "Via Roma 120, Roma, RM" identifica un PREMISE
, mentre ad esempio "Redwood City, CA, 94061" identifica un LOCALITY
. Se invece non riusciamo a trovare un geocodice per "Via Roma 123" a Redwood City, il codice geografico restituito potrebbe essere di una granularità pari a LOCALITY
, anche se l'indirizzo è più granulare.
Enum | |
---|---|
GRANULARITY_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
SUB_PREMISE |
Risultato al di sotto di un edificio, ad esempio un appartamento. |
PREMISE |
Risultato a livello di edificio. |
PREMISE_PROXIMITY |
Un codice geografico che si avvicina alla posizione dell'indirizzo a livello di edificio. |
BLOCK |
L'indirizzo o il geocodice indica un blocco. Utilizzato solo nelle regioni con indirizzi a livello di blocco, come il Giappone. |
ROUTE |
Il geocodice o indirizzo è granulare per il percorso, ad esempio una strada, una strada o un'autostrada. |
OTHER |
Tutte le altre granularità, che sono raggruppate insieme poiché non sono raggiungibili. |
Indirizzo
Dettagli dell'indirizzo post-elaborato. La post-elaborazione include la correzione delle parti dell'indirizzo con errori ortografici, la sostituzione di parti errate e la deduzione delle parti mancanti.
Rappresentazione JSON |
---|
{ "formattedAddress": string, "postalAddress": { object ( |
Campi | |
---|---|
formattedAddress |
L'indirizzo post-elaborato, formattato come indirizzo di una sola riga che segue le regole di formattazione dell'indirizzo della regione in cui si trova l'indirizzo. |
postalAddress |
L'indirizzo post-elaborato rappresentato come indirizzo postale. |
addressComponents[] |
Elenco non ordinato. I singoli componenti dell'indirizzo formattato e corretto, insieme alle informazioni di convalida. Fornisce informazioni sullo stato di convalida dei singoli componenti. I componenti degli indirizzi non sono ordinati in un modo particolare. Non fare ipotesi sull'ordine dei componenti degli indirizzi nell'elenco. |
missingComponentTypes[] |
I tipi di componenti che si prevedeva fossero presenti in un indirizzo di posta formattato correttamente, ma che non sono stati trovati nell'input E non sono stati dedotti. I componenti di questo tipo non sono presenti in |
unconfirmedComponentTypes[] |
I tipi di componenti che sono presenti in |
unresolvedTokens[] |
Eventuali token nell'input che non è stato possibile risolvere. Potrebbe essere un input che non è stato riconosciuto come parte valida di un indirizzo (ad esempio, in un input come "123235253253 Main St, San Francisco, CA, 94105", i token non risolti potrebbero avere il seguente aspetto |
AddressComponent
Rappresenta un componente dell'indirizzo, come una via, una città o uno stato.
Rappresentazione JSON |
---|
{ "componentName": { object ( |
Campi | |
---|---|
componentName |
Il nome di questo componente. |
componentType |
Il tipo di componente dell'indirizzo. Consulta la Tabella 2: Tipi aggiuntivi restituiti dal servizio Places per un elenco dei tipi possibili. |
confirmationLevel |
Indica il livello di certezza che il componente è corretto. |
inferred |
Indica che il componente non faceva parte dell'input, ma che lo abbiamo dedotto per la posizione dell'indirizzo e riteniamo che debba essere fornito per un indirizzo completo. |
spellCorrected |
Indica una correzione di un errore di ortografia nel nome del componente. L'API non sempre contrassegna le modifiche da una variante ortografica a un'altra, ad esempio quando si cambia la posizione "centrale" al centro. Inoltre, non sempre segnala gli errori ortografici più comuni, come quando cambi "Anfiteatro Pkwy" in "Amphitheatre Pkwy". |
replaced |
Indica che il nome del componente è stato sostituito con uno completamente diverso, ad esempio un codice postale errato viene sostituito con uno corretto per l'indirizzo. Non si tratta di una modifica estetica, bensì del componente di input diverso. |
unexpected |
Indica un componente dell'indirizzo che non dovrebbe essere presente in un indirizzo postale per la regione specificata. L'abbiamo conservato solo perché faceva parte dell'input. |
ComponentName
Un wrapper per il nome del componente.
Rappresentazione JSON |
---|
{ "text": string, "languageCode": string } |
Campi | |
---|---|
text |
Il testo del nome. Ad esempio, "5th Avenue" il nome di una via o "1253" per il numero civico. |
languageCode |
Il codice lingua BCP-47. Non è presente se il nome del componente non è associato a una lingua, come un numero civico. |
ConfirmationLevel
I diversi valori possibili per i livelli di conferma.
Enum | |
---|---|
CONFIRMATION_LEVEL_UNSPECIFIED |
Valore predefinito. Questo valore non è utilizzato. |
CONFIRMED |
Siamo riusciti a verificare che questo componente esista e abbia senso nel contesto del resto dell'indirizzo. |
UNCONFIRMED_BUT_PLAUSIBLE |
Non è stato possibile confermare questo componente, ma è plausibile che esista. Ad esempio, un numero civico all'interno di un intervallo noto e valido di una via in cui non sono noti numeri civici specifici. |
UNCONFIRMED_AND_SUSPICIOUS |
Questo componente non è stato confermato ed è probabile che si tratti di un errore. ad esempio un quartiere che non corrisponde al resto dell'indirizzo. |
Geocodifica
Contiene informazioni sul luogo in cui è stato geocodificato l'input.
Rappresentazione JSON |
---|
{ "location": { object ( |
Campi | |
---|---|
location |
La posizione geocodificata dell'input. È preferibile utilizzare gli ID luogo rispetto all'utilizzo di indirizzi, coordinate di latitudine/longitudine o plus code. Se utilizzi le coordinate durante i percorsi o il calcolo delle indicazioni stradali, il punto viene sempre agganciato alla strada più vicina a tali coordinate. Potrebbe non essere una strada che porterà alla destinazione in modo rapido o sicuro e potrebbe non essere vicina a un punto di accesso alla proprietà. Inoltre, quando una località è geocodificata invertita, non vi è alcuna garanzia che l'indirizzo restituito corrisponda all'indirizzo originale. |
plusCode |
Il Plus Code corrispondente a |
bounds |
I limiti del luogo geocodificato. |
featureSizeMeters |
Le dimensioni del luogo geocodificato, in metri. Questa è un'altra misura della grossa percentuale della posizione geocodificata, ma nelle dimensioni fisiche piuttosto che nel significato semantico. |
placeId |
Il PlaceID del luogo in cui viene geocodificato questo input. Per ulteriori informazioni sugli ID luogo, visita questa pagina. |
placeTypes[] |
I tipi di luogo in cui è stato geocodificato l'input. Ad esempio, |
LatLng
Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è espresso come coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono essere compresi negli intervalli normalizzati.
Rappresentazione JSON |
---|
{ "latitude": number, "longitude": number } |
Campi | |
---|---|
latitude |
La latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0]. |
longitude |
Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0]. |
PlusCode
Il Plus Code (http://plus.codes) è un riferimento di località con due formati: il codice globale che definisce un rettangolo di 14mx14 m o più piccolo e il codice composto, che sostituisce il prefisso con una posizione di riferimento.
Rappresentazione JSON |
---|
{ "globalCode": string, "compoundCode": string } |
Campi | |
---|---|
globalCode |
Il codice globale (completo) di Place, ad esempio "9FWM33GV + HQ", che rappresenta un'area di 1/8000 per 1/8000 gradi (~14 per 14 metri). |
compoundCode |
Il codice composto del luogo, ad esempio "33GV+HQ, Ramberg, Norvegia", contenente il suffisso del codice globale e che sostituisce il prefisso con un nome formattato di un'entità di riferimento. |
Area visibile
Un'area visibile di latitudine e longitudine, rappresentata da due punti diagonalmente opposti a low
e high
. Un'area visibile è considerata un'area chiusa, ovvero include il proprio confine. I limiti di latitudine devono essere compresi tra -90 e 90 gradi inclusi, mentre quelli di longitudine devono essere compresi tra -180 e 180 gradi inclusi. I vari casi includono:
Se
low
=high
, l'area visibile è composta da quel singolo punto.Se
low.longitude
>high.longitude
, l'intervallo di longitudine è invertito (l'area visibile supera la linea di longitudine di 180 gradi).Se
low.longitude
= -180 gradi ehigh.longitude
= 180 gradi, l'area visibile include tutte le longitudini.Se
low.longitude
= 180 gradi ehigh.longitude
= -180 gradi, l'intervallo di longitudine è vuoto.Se
low.latitude
>high.latitude
, l'intervallo di latitudine è vuoto.
È necessario compilare entrambi i campi low
e high
e la casella rappresentata non può essere vuota (come specificato dalle definizioni precedenti). Un'area visibile vuota genererà un errore.
Ad esempio, questa area visibile racchiude completamente New York City:
{ "low": { "latitude": 40.477398, "longitude": -74.259087 }, "high": { "latitude": 40.91618, "longitude": -73.70018 } }
Rappresentazione JSON |
---|
{ "low": { object ( |
Campi | |
---|---|
low |
Obbligatorio. Il punto inferiore dell'area visibile. |
high |
Obbligatorio. Il punto più alto dell'area visibile. |
AddressMetadata
I metadati per l'indirizzo. Non è garantito che il campo metadata
sia completamente compilato per ogni indirizzo inviato all'API Address Validation.
Rappresentazione JSON |
---|
{ "business": boolean, "poBox": boolean, "residential": boolean } |
Campi | |
---|---|
business |
Indica che questo è l'indirizzo di un'attività commerciale. Se non viene configurato, indica che il valore è sconosciuto. |
poBox |
Indica l'indirizzo di una casella postale. Se non viene configurato, indica che il valore è sconosciuto. |
residential |
Indica che questo è l'indirizzo di una residenza. Se non viene configurato, indica che il valore è sconosciuto. |
UspsData
I dati USPS per l'indirizzo. Non è garantito che il campo uspsData
sia completamente compilato per ogni indirizzo USA o PR inviato all'API Address Validation. Ti consigliamo di integrare i campi dell'indirizzo di backup nella risposta se utilizzi uspsData come parte principale della risposta.
Rappresentazione JSON |
---|
{
"standardizedAddress": {
object ( |
Campi | |
---|---|
standardizedAddress |
Indirizzo standardizzato USPS. |
deliveryPointCode |
Codice punto di consegna a 2 cifre |
deliveryPointCheckDigit |
La cifra di controllo del punto di consegna. Questo numero viene aggiunto alla fine del codice a barre delivery_point_barcode per la posta sottoposta a scansione meccanica. Sommando tutte le cifre di delivery_point_barcode, deliveryPointCheckDigit, codice postale e ZIP+4 dovresti ottenere un numero divisibile per 10. |
dpvConfirmation |
I valori possibili per la conferma della data di destinazione. Restituisce un singolo carattere o nessun valore.
|
dpvFootnote |
Le note a piè di pagina della convalida del punto di consegna. Più note a piè di pagina possono essere unite nella stessa stringa.
|
dpvCmra |
Indica se l'indirizzo è un'agenzia per la ricezione di posta commerciale (CMRA), un'azienda privata che riceve posta per i clienti. Restituisce un singolo carattere.
|
dpvVacant |
Questo luogo è libero? Restituisce un singolo carattere.
|
dpvNoStat |
È un indirizzo senza statistiche o un indirizzo attivo? Nessun indirizzo delle statistiche è costituito da indirizzi non occupati in modo continuo o da indirizzi non serviti dall'USPS. Restituisce un singolo carattere.
|
dpvNoStatReasonCode |
Indica il tipo di NoStat. Restituisce un codice motivo come int.
|
dpvDrop |
Il flag indica che la posta viene recapitata a un singolo destinatario in un sito. Restituisce un singolo carattere.
|
dpvThrowback |
Indica che la posta non è stata recapitata all'indirizzo stradale. Restituisce un singolo carattere.
|
dpvNonDeliveryDays |
Il flag indica che la consegna della posta non viene eseguita tutti i giorni della settimana. Restituisce un singolo carattere.
|
dpvNonDeliveryDaysValues |
Numero intero che identifica i giorni di mancata consegna. Può essere interrogato utilizzando flag di bit: 0x40 – Domenica è un giorno di mancato recapito 0x20 – Lunedì è un giorno di mancato recapito 0x10 – Martedì è un giorno di mancato recapito 0x08 – Mercoledì è un giorno di mancato recapito 0x04 – Giovedì è un giorno di mancato recapito 0x02 – Venerdì è un giorno di mancato recapito 0x01 |
dpvNoSecureLocation |
Il flag indica che la porta è accessibile, ma il pacco non verrà lasciato a causa di problemi di sicurezza. Restituisce un singolo carattere.
|
dpvPbsa |
Indica che l'indirizzo è associato al record PBSA. Restituisce un singolo carattere.
|
dpvDoorNotAccessible |
Il flag indica gli indirizzi in cui USPS non può bussare a una porta per consegnare la posta. Restituisce un singolo carattere.
|
dpvEnhancedDeliveryCode |
Indica che più di un codice restituito DPV è valido per l'indirizzo. Restituisce un singolo carattere.
|
carrierRoute |
Il codice di percorso del corriere. Un codice di quattro caratteri composto da un prefisso di una lettera e un indicatore di percorso a tre cifre. Prefissi:
|
carrierRouteIndicator |
Indicatore di ordinamento tariffa itinerario operatore. |
ewsNoMatch |
È possibile trovare una corrispondenza con l'indirizzo di consegna, ma il file EWS indica che a breve sarà disponibile una corrispondenza esatta. |
postOfficeCity |
Città dell'ufficio postale principale. |
postOfficeState |
Stato dell'ufficio postale principale. |
abbreviatedCity |
Città abbreviata. |
fipsCountyCode |
Codice contea FIPS. |
county |
Nome della contea. |
elotNumber |
Numero eLOT (Advanced Line of Travel). |
elotFlag |
Flag crescente/decrescente di eLOT (A/D). |
lacsLinkReturnCode |
Codice restituito LACSLink. |
lacsLinkIndicator |
Indicatore LACSLink. |
poBoxOnlyPostalCode |
Solo casella postale. |
suitelinkFootnote |
Note a piè di pagina dalla corrispondenza di una strada o di un grattacielo con informazioni sulla suite. Se viene trovata una corrispondenza del nome dell'attività, viene restituito il numero secondario.
|
pmbDesignator |
indicatore di unità PMB (Private Mail Box). |
pmbNumber |
numero PMB (Private Mail Box); |
addressRecordType |
Tipo del record dell'indirizzo che corrisponde all'indirizzo di input.
|
defaultAddress |
Indica che è stato trovato un indirizzo predefinito, ma esistono indirizzi più specifici. |
errorMessage |
Messaggio di errore per il recupero dei dati USPS. Il campo viene compilato quando l'elaborazione USPS è sospesa a causa del rilevamento di indirizzi creati artificialmente. I campi dei dati USPS potrebbero non essere compilati se si verifica questo errore. |
cassProcessed |
Indicatore che la richiesta è stata elaborata dal CASS. |
UspsAddress
Rappresentazione USPS di un indirizzo statunitense.
Rappresentazione JSON |
---|
{ "firstAddressLine": string, "firm": string, "secondAddressLine": string, "urbanization": string, "cityStateZipAddressLine": string, "city": string, "state": string, "zipCode": string, "zipCodeExtension": string } |
Campi | |
---|---|
firstAddressLine |
Prima riga indirizzo. |
firm |
Nome dell'azienda. |
secondAddressLine |
Seconda riga indirizzo. |
urbanization |
Nome dell'urbanizzazione portoricana. |
cityStateZipAddressLine |
Città + stato + codice postale. |
city |
Nome della città. |
state |
Codice dello stato di 2 lettere. |
zipCode |
Codice postale, ad es. 10009. |
zipCodeExtension |
Estensione codice postale a 4 cifre, ad es. 5023. |