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.

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 degli indirizzi non sono ordinati in un modo particolare. Non fare ipotesi sull'ordine dei componenti degli indirizzi nell'elenco.

string

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 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 tipi possibili è disponibile qui.

string

I tipi di componenti che sono presenti in address_components, ma non è stato possibile confermarne l'esattezza. Questo campo viene fornito per praticità: i suoi contenuti corrispondono all'iterazione tramite 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 tipi possibili è disponibile qui.

string

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 ["123235253253"] perché non ha un numero civico valido.

ComponentName

Il nome di questo componente.

string

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.

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 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 "center" in "center". Inoltre, non sempre segnala gli errori ortografici più comuni, ad esempio quando cambi "Anfiteatro Pkwy" in "Amphitheatre Pkwy".

bool

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.

bool

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.

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 viene configurato, indica che il valore è sconosciuto.

bool

Indica che questo è l'indirizzo di una residenza. Se non viene configurato, 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 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 location.

Viewport

I limiti del luogo geocodificato.

float

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.

string

Il PlaceID del luogo in cui viene geocodificato 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 google.maps.addressvalidation.v1.Address in inglese. Per informazioni dettagliate, 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

Obbligatoria. Il risultato della sequenza di tentativi di convalida.

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

string

Obbligatoria. L'ID della risposta a cui fa riferimento questo feedback. Dovrebbe essere il valore [response_id][google.maps.addressvalidation.v1.ConvalidaAddressRequest.response_id] della prima risposta di una serie di tentativi di convalida dell'indirizzo.

string

Prima riga indirizzo.

string

Nome dell'azienda.

string

Seconda riga indirizzo.

string

Nome dell'urbanizzazione portoricana.

string

Città + stato + codice postale.

string

Nome della città.

string

Codice dello stato di 2 lettere.

string

Codice postale, ad es. 10009.

string

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

UspsAddress

Indirizzo standardizzato USPS.

string

Codice punto di consegna a 2 cifre

string

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, delivery_point_check_digit, codice postale e ZIP+4 dovresti ottenere un numero divisibile per 10.

string

I valori possibili per la conferma della data di destinazione. Restituisce un singolo carattere o nessun valore.

• N: impossibile confermare le informazioni sul numero principale e su eventuali numeri secondari.
• D: l'indirizzo è stato confermato solo per il numero principale e le informazioni sul numero secondario erano mancanti.
• S: l'indirizzo è stato confermato 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 di input corrispondente al file ZIP+4
• A1: l'indirizzo di input non corrisponde al file ZIP+4
• BB: abbinato alla data center di servizio (tutti i componenti)
• CC: numero secondario non corrispondente e non obbligatorio
• C1: numero secondario non corrispondente, ma obbligatorio
• N1: indirizzo di un grattacielo senza numero secondario
• M1: numero principale mancante
• M3: numero principale non valido
• P1: numero di casella PO, RR o HC indirizzo di input mancante
• P3: indirizzo inserito PO, RR o numero casella HC non valido
• F1: indirizzo di input corrispondente a un indirizzo militare
• G1: inserisci l'indirizzo corrispondente a un indirizzo di consegna generico
• U1: indirizzo di input corrispondente a un codice postale univoco
• PB: indirizzo di input corrispondente al record PBSA
• RR: indirizzo confermato dal responsabile della protezione dei dati con informazioni sul PMB
• R1: indirizzo confermato dal responsabile della protezione dei dati senza informazioni sul PMB
• R7: record R777 o R779 del vettore
• IA: indirizzo informato identificato
• TA: numero principale trovato dopo aver eliminato un alpha finale

string

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.

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

string

Questo luogo è libero? Restituisce un singolo carattere.

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

string

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

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

int32

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

• 1: IDA (Internal Drop Address) – Indirizzi che non ricevono posta direttamente dall'USPS, ma sono consegnati a un indirizzo di destinazione che li fornisce.
• 2: CDS: indirizzi non ancora idonei alla pubblicazione. Ad esempio, una nuova suddivisione in cui sono stati determinati lotti e i numeri principali, ma non esiste ancora una struttura per il numero di persone.
• 3: collisione - indirizzi che non vengono effettivamente confermati dal data center di destinazione.
• 4: CMZ (College, Military e altri tipi). Il codice ZIP + 4 registra che USPS ha incorporato nei dati.
• 5: Normale: indica gli indirizzi che non ricevono la consegna e che non vengono conteggiati come possibili consegne.
• 6: secondario obbligatorio. L'indirizzo richiede informazioni secondarie.

string

Il flag indica che la posta viene recapitata a un singolo destinatario in un sito. Restituisce un singolo carattere.

• Y: la posta viene recapitata a un unico destinatario in un sito.
• N: la posta non viene recapitata a un singolo destinatario in un sito.

string

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

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

string

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

• Y: la consegna per posta non viene eseguita ogni giorno 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 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

string

Il flag indica che la porta è accessibile, ma il pacco non verrà lasciato a causa di problemi di sicurezza. Restituisce un singolo carattere.

• Y: il pacco non verrà lasciato a causa di problemi di sicurezza.
• N: nessuna indicazione che il pacco non verrà lasciato a causa di problemi di sicurezza.

string

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

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

string

Il flag indica gli indirizzi in cui USPS non può bussare a una 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 più di un codice restituito DPV è valido per l'indirizzo. Restituisce un singolo carattere.

• Y: l'indirizzo è stato confermato dalla data di destinazione per il numero principale e per eventuali numeri secondari.
• N: impossibile confermare le informazioni sul numero principale e su eventuali numeri secondari.
• S: l'indirizzo è stato confermato solo per il numero principale e le informazioni sul numero secondario erano presenti, ma non confermate oppure è stato eliminato un singolo alpha finale su un numero principale per creare una corrispondenza con il data warehouse secondario e sono state richieste informazioni secondarie.
• D: l'indirizzo è stato confermato solo per il numero principale e le informazioni sul numero secondario erano mancanti.
• R: l'indirizzo è stato confermato, ma assegnato ai percorsi fantasma R777 e R779 e la consegna con USPS non è stata fornita.

string

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:

• C: percorso dell'operatore (o rotta urbana)
• R: strada rurale
• H: percorso contrattuale autostradale
• B: sezione casella postale
• G: unità di consegna generale

string

Indicatore di ordinamento tariffa itinerario operatore.

bool

È possibile trovare una corrispondenza con l'indirizzo di consegna, 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 contea FIPS.

string

Nome della contea.

string

Numero eLOT (Advanced Line of Travel).

string

Flag crescente/decrescente di eLOT (A/D).

string

Codice restituito LACSLink.

string

Indicatore LACSLink.

bool

Solo casella postale.

string

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.

• A: corrispondenza record SuiteLink, indirizzo dell'attività migliorato.
• 00: nessuna corrispondenza, l'indirizzo dell'attività non è stato 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. Si tratta di una corrispondenza con un record di consegna generale.
• H: COSTRUIRE / APPARTAMENTO. Corrisponde a un record di edificio o appartamento.
• P: Casella postale. Questa è una corrispondenza con una casella postale.
• R: PERCORSO RURALE o CONTRATTO AUTOMATICO: si tratta di una corrispondenza con il record di una strada rurale o di un contratto autostradale, entrambi i quali possono avere intervalli di numeri di riquadri associati.
• S: STREET RECORD: corrisponde a un record di una strada 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. 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.

bool

Indicatore che la richiesta è stata elaborata dal CASS.

PostalAddress

Obbligatoria. 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 viene ignorato oggi. 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. Tutti i valori in questi campi verranno ignorati e non verranno restituiti. Non impostarli.

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 riconvalidate), ogni richiesta di follow-up deve completare questo campo con il response_id dalla prima risposta nella sequenza di convalida.

bool

Attiva la modalità compatibile con CASS di USPS. Questo influisce solo sul campo google.maps.addressvalidation.v1.ValidationResult.usps_data di google.maps.addressvalidation.v1.ValidationResult. Nota: per le richieste USPS CASS abilitate 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 deve essere fornito come "Portorico" (senza distinzione tra maiuscole e minuscole) o "PR".

Ti consigliamo di utilizzare un valore compositi del address o, in alternativa, di specificare almeno due google.type.PostalAddress.address_lines dove la prima riga contiene il numero civico e il nome e la seconda la città, lo stato e il codice postale.

LanguageOptions

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

string

Campo 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. 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 maggiori 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 riconvalidato, questo UUID deve accompagnare la nuova richiesta.

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.

AddressMetadata

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

UspsData

Flag di consegnabilità extra 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 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 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 di input 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, il valore input_granularity qui sarà SUB_PREMISE. Se non riusciamo a trovare il numero dell'appartamento nei database o se il numero non è valido, il valore validation_granularity probabilmente sarà PREMISE o inferiore.

Granularity

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

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

Granularity

Informazioni sulla granularità del geocode. Può essere inteso come il significato semantico di quanto è approssimativa o precisa la 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 indicare una posizione precisa dell'appartamento all'interno di un grande complesso residenziale. In questo caso, il valore di validation_granularity sarà SUB_PREMISE, mentre il valore di geocode_granularity sarà di PREMISE.

bool

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 è false. Vedi i campi missing_component_types, unresolved_tokens o unexpected per ulteriori dettagli.

bool

Almeno un componente dell'indirizzo non può essere classificato o convalidato. Consulta google.maps.addressvalidation.v1.Address.address_components per i dettagli.

bool

È stato dedotto (aggiunto) almeno un componente dell'indirizzo che non era nell'input. Vedi google.maps.addressvalidation.v1.Address.address_components per i dettagli.

bool

Almeno un componente dell'indirizzo è stato sostituito. Consulta google.maps.addressvalidation.v1.Address.address_components per i dettagli.