Package google.maps.addressvalidation.v1

string

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.

Nota: il formato di questo indirizzo potrebbe non corrispondere a quello dell'indirizzo nel campo postal_address. Ad esempio, postal_address rappresenta sempre il paese come region_code di due lettere, ad esempio "US" o "NZ". Al contrario, questo campo utilizza una forma più lunga del nome del paese, ad esempio "USA" o "Nuova Zelanda".

PostalAddress

L'indirizzo post-elaborato rappresentato come indirizzo postale.

AddressComponent

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 dell'indirizzo non sono ordinati in un determinato modo. Non fare supposizioni sull'ordine dei componenti dell'indirizzo nell'elenco.

string

I tipi di componenti che si prevedeva fossero presenti in un indirizzo postale formattato correttamente, ma che non sono stati trovati nell'input E che non è stato possibile dedurre. I componenti di questo tipo non sono presenti in formatted_address, postal_address o address_components. Un esempio potrebbe essere ['street_number', 'route'] per un input come "Boulder, Colorado, 80301, USA". L'elenco dei possibili tipi è disponibile qui.

string

I tipi di componenti presenti in address_components, ma di cui non è stato possibile confermare la correttezza. Questo campo viene fornito per praticità: i relativi contenuti sono equivalenti all'iterazione di address_components per trovare i tipi di tutti i componenti in cui confirmation_level non è CONFIRMED o il flag inferred non è impostato su true. L'elenco dei possibili tipi è disponibile qui.

string

Eventuali token nell'input che non è stato possibile risolvere. Potrebbe trattarsi di un input che non è stato riconosciuto come parte valida di un indirizzo. Ad esempio, per un input come "Parcel 0000123123 & 0000456456 Str # Guthrie Center IA 50115 US", i token non risolti potrebbero essere ["Parcel", "0000123123", "&", "0000456456"].

ComponentName

Il nome di questo componente.

string

Il tipo di componente dell'indirizzo. Consulta la Tabella 2: tipi aggiuntivi restituiti dal servizio Luoghi per un elenco dei possibili tipi.

ConfirmationLevel

Indica il livello di certezza che abbiamo sulla correttezza del componente.

bool

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.

bool

Indica la correzione di un errore ortografico nel nome del componente. L'API non segnala sempre le modifiche da una variante ortografica all'altra, ad esempio quando si passa da "centre" a "center". Inoltre, non segnala sempre gli errori ortografici comuni, ad esempio quando si modifica "Amphitheater Pkwy" in "Amphitheatre Pkwy".

bool

Indica che il nome del componente è stato sostituito con uno completamente diverso, ad esempio un codice postale errato sostituito con uno corretto per l'indirizzo. Non si tratta di una modifica estetica, ma il componente di input è stato modificato.

bool

Indica un componente dell'indirizzo che non dovrebbe essere presente in un indirizzo postale per la regione specificata. L'abbiamo mantenuto solo perché faceva parte dell'input.

bool

Indica che questo è l'indirizzo di un'attività commerciale. Se non viene configurato, indica che il valore è sconosciuto.

bool

Indica l'indirizzo di una casella postale. Se non è impostato, indica che il valore è sconosciuto.

bool

Indica che si tratta dell'indirizzo di una residenza. Se non è impostato, indica che il valore è sconosciuto.

string

Il testo del nome. Ad esempio, "5th Avenue" per il nome di una via o "1253" per il numero civico.

string

Il codice lingua BCP-47. Non è presente se il nome del componente non è associato a una lingua, come un numero civico.

LatLng

La posizione geocodificata dell'input.

È preferibile utilizzare gli ID luogo rispetto agli indirizzi, alle coordinate di latitudine/longitudine o ai plus code. L'utilizzo delle coordinate durante la definizione del percorso o il calcolo delle indicazioni stradali comporterà sempre l'aggancio del punto alla strada più vicina a queste coordinate. Potrebbe non essere una strada che porta alla destinazione in modo rapido o sicuro e potrebbe non essere vicino a un punto di accesso alla proprietà. Inoltre, quando una posizione viene geocodificata in modo inverso, non è garantito che l'indirizzo restituito corrisponda all'originale.

PlusCode

Il Plus Code corrispondente a location.

Viewport

I limiti del luogo geocodificato.

float

La dimensione del luogo geocodificato, in metri. Si tratta di un'altra misura della approssimazione della posizione geocodificata, ma in termini di dimensioni fisiche anziché di significato semantico.

string

Il PlaceID del luogo a cui viene eseguito il geocodifica di questo input.

Per ulteriori informazioni sugli ID luogo, visita questa pagina.

string

I tipi di luogo in cui è stato geocodificato l'input. Ad esempio, ['locality', 'political']. L'elenco completo dei tipi è disponibile qui.

bool

Anteprima: restituisci un google.maps.addressvalidation.v1.Address in inglese. Per maggiori dettagli, visita la pagina google.maps.addressvalidation.v1.ValidationResult.english_latin_address.

string

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

string

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.

ValidationConclusion

Obbligatorio. Il risultato della sequenza di tentativi di convalida.

Se questo campo è impostato su VALIDATION_CONCLUSION_UNSPECIFIED, verrà restituito un errore INVALID_ARGUMENT.

string

Obbligatorio. L'ID della risposta a cui si riferisce questo feedback. Deve essere [response_id][google.maps.addressvalidation.v1.ValidateAddressRequest.response_id] della prima risposta in una serie di tentativi di convalida dell'indirizzo.

string

Prima riga dell'indirizzo.

string

Ragione sociale.

string

Seconda riga dell'indirizzo.

string

Nome dell'urbanizzazione di Portorico.

string

Città + stato + codice postale.

string

Nome della città.

string

Codice stato di 2 lettere.

string

Codice postale, ad esempio 10009.

string

Estensione codice postale a 4 cifre, ad es. 5023.

UspsAddress

Indirizzo standardizzato USPS.

string

Codice del punto di consegna di 2 cifre

string

La cifra di controllo del punto di consegna. Questo numero viene aggiunto alla fine del codice a barre delivery_point per la posta sottoposta a scansione meccanica. L'aggiunta di tutte le cifre di delivery_point_barcode, delivery_point_check_digit, codice postale e ZIP+4 deve produrre un numero divisibile per 10.

string

I valori possibili per la conferma del DPV. Restituisce un singolo carattere o nessun valore.

• N: non è stato possibile confermare il numero principale e eventuali numeri secondari tramite DPV.
• D: l'indirizzo è stato confermato dal DPV solo per il numero principale e mancano le informazioni sul numero secondario.
• S: l'indirizzo è stato confermato tramite DPV solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non confermate.
• Y: l'indirizzo è stato confermato dalla data di destinazione per il numero principale e per eventuali numeri secondari.
• Vuoto: se la risposta non contiene un valore dpv_confirmation, l'indirizzo non è stato inviato per la conferma DPV.

string

Le note a piè di pagina della convalida del punto di consegna. Più note a piè di pagina possono essere unite nella stessa stringa.

• AA: indirizzo inserito corrispondente al file ZIP+4
• A1: l'indirizzo inserito non corrisponde al file ZIP+4
• BB: corrispondenza con il DPV (tutti i componenti)
• CC: numero secondario non corrispondente e non obbligatorio
• C1: numero secondario non corrispondente, ma obbligatorio
• N1: nell'indirizzo di un grattacielo manca il numero secondario
• M1: numero principale mancante
• M3: numero principale non valido
• P1: numero della casella postale PO, RR o HC mancante nell'indirizzo inserito
• P3: numero di casella postale PO, RR o HC dell'indirizzo di input non valido
• F1: indirizzo inserito corrispondente a un indirizzo militare
• G1: indirizzo inserito corrispondente a un indirizzo di consegna generale
• U1: inserisci l'indirizzo corrispondente a un codice postale univoco
• PB: indirizzo inserito corrispondente al record PBSA
• RR: indirizzo confermato dal DPV con informazioni PMB
• R1: indirizzo confermato dal responsabile della protezione dei dati senza informazioni sul PMB
• R7: record Percorso corriere R777 o R779
• IA: indirizzo informato identificato
• TA: numero principale trovato eliminando una lettera finale

string

Indica se l'indirizzo è una CMRA (Commercial Mail Receiving Agency), ovvero un'azienda privata che riceve posta per i clienti. Restituisce un singolo carattere.

• Y: l'indirizzo è un CMRA
• N: l'indirizzo non è un CMRA

string

Questo posto è libero? Restituisce un singolo carattere.

• Y: l'indirizzo è vuoto
• N: l'indirizzo non è vuoto

string

Si tratta di un indirizzo senza statistiche o di 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.

• Y: l'indirizzo non è attivo
• N: l'indirizzo è attivo

int32

Indica il tipo NoStat. Restituisce un codice motivo come int.

• 1: IDA (Internal Drop Address, indirizzo di consegna interno): indirizzi che non ricevono posta direttamente dall'USPS, ma vengono consegnati a un indirizzo di consegna che li serve.
• 2: CDS - Addresses that have not yet become deliverable (Indirizzi che non sono ancora stati recapitati). Ad esempio, una nuova suddivisione in cui sono stati determinati lotti e numeri principali, ma non esiste ancora una struttura per l'occupazione.
• 3: collisione - indirizzi che non vengono effettivamente confermati dal data center di destinazione.
• 4: CMZ (College, Military and Other Types) - ZIP + 4 records USPS has incorporated into the data.
• 5: normale: indica gli indirizzi che non ricevono il recapito e che non vengono conteggiati come possibili recapiti.
• 6: Secondario obbligatorio. L'indirizzo richiede informazioni secondarie.

string

L'indicatore indica che la posta viene recapitata in un unico contenitore in un sito. Restituisce un singolo carattere.

• Y: la posta viene consegnata in un unico contenitore in un sito.
• N: la posta non viene consegnata in un unico contenitore in un sito.

string

Indica che la posta non è stata recapitata all'indirizzo civico. Restituisce un singolo carattere.

• Y: la posta non viene consegnata all'indirizzo.
• N: la posta viene consegnata all'indirizzo.

string

Indica che la consegna della posta non viene eseguita tutti i giorni della settimana. Restituisce un singolo carattere.

• Y: la consegna della posta non viene effettuata tutti i giorni della settimana.
• N: nessuna indicazione che la consegna della posta non viene eseguita ogni giorno della settimana.

int32

Numero intero che identifica i giorni di mancata consegna. Può essere interrogato utilizzando bit flag: 0x40 - Domenica è un giorno di mancata consegna 0x20 - Lunedì è un giorno di mancata consegna 0x10 - Martedì è un giorno di mancata consegna 0x08 - Mercoledì è un giorno di mancata consegna 0x04 - Giovedì è un giorno di mancata consegna 0x02 - Venerdì è un giorno di mancata consegna 0x01 - Sabato è un giorno di mancata consegna

string

L'indicatore indica che la porta è accessibile, ma il pacco non verrà lasciato per motivi di sicurezza. Restituisce un singolo carattere.

• Y: il pacco non verrà lasciato per motivi di sicurezza.
• N: nessuna indicazione che il pacco non verrà lasciato per motivi di sicurezza.

string

Indica che l'indirizzo è stato associato al record PBSA. Restituisce un singolo carattere.

• Y: l'indirizzo è stato associato al record PBSA.
• N: l'indirizzo non è stato abbinato al record PBSA.

string

Indica gli indirizzi in cui l'USPS non può bussare alla porta per consegnare la posta. Restituisce un singolo carattere.

• Y: la porta non è accessibile.
• N: nessuna indicazione che la porta non è accessibile.

string

Indica che per l'indirizzo è valido più di un codice di reso DPV. Restituisce un singolo carattere.

• Y: l'indirizzo è stato confermato dal DPV per il numero principale e per eventuali numeri secondari.
• N: non è stato possibile confermare il numero principale e eventuali numeri secondari tramite la verifica della proprietà.
• S: l'indirizzo è stato confermato tramite DPV solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non confermate oppure è stato omesso un singolo carattere alfa finale in un numero principale per ottenere una corrispondenza DPV e sono necessarie informazioni secondarie.
• D: l'indirizzo è stato confermato dal DPV solo per il numero principale e mancano le informazioni sul numero secondario.
• R: indirizzo confermato, ma assegnato al percorso fantasma R777 e R779 e la consegna tramite USPS non è prevista.

string

Il codice percorso dell'operatore. Un codice di quattro caratteri composto da un prefisso di una lettera e un indicatore di percorso a tre cifre.

Prefissi:

• C: percorso del corriere (o percorso cittadino)
• R: strada rurale
• H: percorso contrattuale autostradale
• B: sezione cassetta postale
• G: unità di consegna generale

string

Indicatore di ordinamento della tariffa del percorso del corriere.

bool

L'indirizzo di consegna è associabile, ma il file EWS indica che a breve sarà disponibile una corrispondenza esatta.

string

Città dell'ufficio postale principale.

string

Stato dell'ufficio postale principale.

string

Città abbreviata.

string

Codice FIPS della contea.

string

Nome della contea.

string

Numero della linea di viaggio avanzata (eLOT).

string

Flag A/D (crescente/decrescente) per gli elenchi di offerte.

string

Codice restituito LACSLink.

string

Indicatore LACSLink.

bool

Solo codice postale per caselle postali.

string

Note a piè di pagina derivanti dalla corrispondenza di un record di una strada o di un grattacielo con le informazioni sulla suite. Se viene trovata una corrispondenza del nome dell'attività, viene restituito il numero secondario.

• A: corrispondenza del record SuiteLink, indirizzo dell'attività migliorato.
• 00: nessuna corrispondenza, l'indirizzo dell'attività non è migliorato.

string

indicatore di unità PMB (Private Mail Box).

string

Numero PMB (Private Mail Box);

string

Tipo del record dell'indirizzo che corrisponde all'indirizzo di input.

• F: FIRM. Si tratta di una corrispondenza con un record dell'azienda, ovvero il miglior livello di corrispondenza disponibile per un indirizzo.
• G: CONSEGNA GENERALE. Corrispondenza a un record di recapito generale.
• H: COSTRUZIONE / APPARTAMENTO. Corrisponde a un record di un edificio o di un appartamento.
• P: CASELLA POSTALE. Corrisponde a una cassetta postale.
• R: RURAL ROUTE o HIGHWAY CONTRACT: corrisponde a un record di Rural Route o Highway Contract, entrambi con intervalli di numeri civici associati.
• S: RECORD DI VIA: corrisponde a un record di via contenente un intervallo di numeri principali valido.

bool

Indica che è stato trovato un indirizzo predefinito, ma esistono indirizzi più specifici.

string

Messaggio di errore per il recupero dei dati USPS. Viene compilato quando l'elaborazione USPS è sospesa a causa del rilevamento di indirizzi creati artificialmente.

I campi dei dati USPS potrebbero non essere compilati quando si verifica questo errore.

bool

Indica che la richiesta è stata elaborata in base al sistema CASS.

PostalAddress

Obbligatorio. L'indirizzo in fase di convalida. Gli indirizzi non formattati devono essere inviati tramite address_lines.

La lunghezza totale dei campi in questo input non deve superare i 280 caratteri.

Le regioni supportate sono disponibili qui.

Il valore language_code nell'indirizzo di input è riservato per utilizzi futuri e al momento viene ignorato. Il risultato dell'indirizzo convalidato verrà compilato in base alla lingua preferita per l'indirizzo specificato, come identificato dal sistema.

L'API Address Validation ignora i valori in recipients e organization. Eventuali valori in questi campi verranno ignorati e non restituiti. Non impostarle.

string

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 convalidate di nuovo), ogni richiesta di follow-up deve compilare questo campo con il valore response_id della prima risposta nella sequenza di convalida.

bool

Attiva la modalità compatibile con CASS USPS. Questo influisce solo sul campo google.maps.addressvalidation.v1.ValidationResult.usps_data di google.maps.addressvalidation.v1.ValidationResult. Nota: per le richieste con attivazione CASS USPS per gli indirizzi a Portorico, è necessario fornire un google.type.PostalAddress.region_code del address come "PR" oppure un google.type.PostalAddress.administrative_area del address come "Puerto Rico" (senza distinzione tra maiuscole e minuscole) o "PR".

Ti consigliamo di utilizzare un address componentizzato oppure, in alternativa, di specificare almeno due address in cui la prima riga contenga il numero civico e il nome della via e la seconda riga contenga la città, lo stato e il codice postale.

LanguageOptions

(Facoltativo) Anteprima: questa funzionalità è in anteprima (pre-release). 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 specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Consente all'API di convalida degli indirizzi di includere ulteriori informazioni nella risposta.

string

(Facoltativo) Una stringa che identifica una sessione Autocomplete a fini di 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 effettua 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 di dettagli sui luoghi o di convalida dell'indirizzo. 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. L'app deve generare un nuovo token per ogni sessione. Se il parametro sessionToken viene omesso o se riutilizzi un token di sessione, la sessione viene addebitata come se non fosse stato fornito alcun token di sessione (ogni richiesta viene fatturata separatamente).

Nota: Address Validation può essere utilizzato solo nelle sessioni con l'API Autocomplete (nuova) , non con l'API Autocomplete. Per ulteriori dettagli, visita la pagina https://developers.google.com/maps/documentation/places/web-service/session-pricing.

ValidationResult

Il risultato della convalida dell'indirizzo.

string

L'UUID che identifica questa risposta. Se l'indirizzo deve essere convalidato di nuovo, questo UUID deve accompagnare la nuova richiesta.

Verdict

Flag relativi all'esito complessivo

Address

Informazioni sull'indirizzo stesso, al contrario del codice geografico.

Geocode

Informazioni sulla posizione e sul luogo a cui è stato geocodificato l'indirizzo.

AddressMetadata

Altre informazioni pertinenti ai fini della consegna. Non è garantito che metadata sia completamente compilato per ogni indirizzo inviato all'API Address Validation.

UspsData

Flag di recapito aggiuntivi forniti da USPS. Fornito solo nelle regioni US e PR.

Address

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 dell'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 parte dell'indirizzo non ha traduzioni o traslitterazioni in una lingua che utilizza caratteri latini, il servizio restituisce quella parte nella lingua locale associata all'indirizzo.

Abilita questo output utilizzando il flag google.maps.addressvalidation.v1.LanguageOptions.return_english_latin_address.

Nota: i campi google.maps.addressvalidation.v1.Address.unconfirmed_component_types in english_latin_address e google.maps.addressvalidation.v1.AddressComponent.confirmation_level in english_latin_address.address_components non sono compilati.

Granularity

La granularità dell'indirizzo di input. Questo è il risultato dell'analisi dell'indirizzo inserito e non fornisce alcun indicatore di convalida. Per gli indicatori di convalida, consulta la sezione validation_granularity di seguito.

Ad esempio, se l'indirizzo inserito include un numero di appartamento specifico, input_granularity qui sarà SUB_PREMISE. Se non riusciamo a trovare una corrispondenza per il numero dell'appartamento nei database o se il numero non è valido, è probabile che validation_granularity sia pari o inferiore a PREMISE.

Granularity

Il livello di granularità a cui l'API può convalidare completamente l'indirizzo. Ad esempio, un valore validation_granularity pari a PREMISE indica che tutti i componenti dell'indirizzo a livello di PREMISE o più approssimativo possono essere convalidati.

Il risultato della convalida dei componenti dell'indirizzo è disponibile in google.maps.addressvalidation.v1.Address.address_components.

Granularity

Informazioni sulla granularità del geocode. Questo può essere inteso come il significato semantico della granularità della posizione geocodificata.

Questo può occasionalmente differire dalla validation_granularity indicata sopra. Ad esempio, il nostro database potrebbe registrare l'esistenza di un numero di appartamento, ma non avere una posizione precisa dell'appartamento all'interno di un grande complesso residenziale. In questo caso, validation_granularity sarà SUB_PREMISE, ma geocode_granularity sarà PREMISE.

bool

L'indirizzo è considerato completo se non sono presenti token non risolti e non sono presenti componenti dell'indirizzo inaspettati o mancanti. Se non impostato, indica che il valore è false. Per ulteriori dettagli, consulta i campi missing_component_types, unresolved_tokens o unexpected.

bool

Almeno un componente dell'indirizzo non può essere classificato o convalidato. Per maggiori dettagli, consulta google.maps.addressvalidation.v1.Address.address_components.

bool

È stato dedotto (aggiunto) almeno un componente dell'indirizzo che non era presente nell'input. Per maggiori dettagli, consulta google.maps.addressvalidation.v1.Address.address_components.

bool

È stato sostituito almeno un componente dell'indirizzo. Per maggiori dettagli, vedi google.maps.addressvalidation.v1.Address.address_components.