Package google.type

Indice

LatLng

Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore viene espresso come una 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 in intervalli normalizzati.

Campi
latitude

double

Latitudine in gradi. Deve essere compreso nell'intervallo [-90,0, +90,0].
longitude

double

Longitudine in gradi. Deve essere compreso nell'intervallo [-180,0, +180,0].

PostalAddress

Rappresenta un indirizzo postale, ad esempio per la consegna o gli indirizzi per i pagamenti. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a una sede, a una casella postale o simili. Non è stato progettato per modellare le località geografiche (strade, città, montagne).

Nell'uso tipico, un indirizzo viene creato tramite l'input utente o dall'importazione di dati esistenti, a seconda del tipo di processo.

Consigli per l'inserimento / la modifica dell'indirizzo: - Usa un widget degli indirizzi pronto per l'internazionalizzazione, come https://github.com/google/libaddressinput). - Agli utenti non devono essere presentati elementi UI per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato tale campo.

Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina: https://support.google.com/business/answer/6397478

Campi
revision

int32

La revisione dello schema di PostalAddress. Qualsiasi valore diverso da 0 farà sì che l'API restituisca un errore INVALID_ARGUMENT.
region_code

string

Campo 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 ottenere prestazioni ottimali, ti consigliamo di includere il codice regione, se lo conosci. La presenza di regioni incoerenti o ripetute può portare a prestazioni scadenti. Ad esempio, se address_lines include già la regione, non specificare di nuovo il codice regione in questo campo. Le regioni supportate sono disponibili nella sezione Domande frequenti.
language_code

string

Il codice della lingua nell'indirizzo di input è riservato per utilizzi futuri e viene ignorato oggi. L'API restituisce l'indirizzo nella lingua appropriata della località in cui si trova l'indirizzo.
postal_code

string

Campo facoltativo. Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali. Tuttavia, se vengono utilizzati, possono attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. la convalida del codice postale negli Stati Uniti).
sorting_code

string

Campo facoltativo. Codice di ordinamento aggiuntivo specifico per il paese. Questa opzione non è utilizzata nella maggior parte delle regioni. Se viene utilizzato, il valore è una stringa come "CEDEX", facoltativamente seguito da un numero (ad es. "CEDEX 7") o solo un numero che rappresenta il "codice del settore" (Giamaica), "indicatore dell'area di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio).
administrative_area

string

Campo facoltativo. Suddivisione amministrativa di livello più alto utilizzata per gli indirizzi postali di un paese o di una regione. Ad esempio, uno stato, una provincia, un oblast o una prefettura. Nello specifico, 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 esempio, in Svizzera questo campo deve essere lasciato vuoto.
locality

string

Campo facoltativo. Si riferisce generalmente alla parte relativa alla città dell'indirizzo. Esempi: città degli Stati Uniti, comune italiano, città del 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 address_lines.
sublocality

string

Campo facoltativo. Circoscrizione dell'indirizzo. ad esempio quartieri, distretti o distretti.
address_lines[]

string

Obbligatorio. Righe indirizzo non strutturate che descrivono i livelli inferiori di un indirizzo.

Poiché i valori in address_lines non contengono informazioni sul tipo e a volte possono contenere più valori in un singolo campo (ad es. "Austin, TX"), è importante che l'ordine delle righe sia chiaro. L'ordine delle righe indirizzo deve essere "ordine busta" per il paese/la regione dell'indirizzo.

La rappresentazione strutturale minima consentita di un indirizzo consiste in tutte le informazioni inserite nel address_lines. Se non viene fornito un valore region_code, la regione viene dedotta dalle righe dell'indirizzo.

Creare un indirizzo contenente solo address_lines e poi la geocodifica è il modo consigliato per gestire indirizzi completamente non strutturati (invece di indovinare quali parti dell'indirizzo dovrebbero essere località o aree amministrative).
recipients[]

string

Evita di impostare questo campo. Al momento, l'API Address Validation non lo utilizza. Sebbene al momento l'API non rifiuti le richieste con questo set di campi, le informazioni verranno ignorate e non verranno restituite nella risposta.
organization

string

Evita di impostare questo campo. Al momento, l'API Address Validation non lo utilizza. Sebbene al momento l'API non rifiuti le richieste con questo set di campi, le informazioni verranno ignorate e non verranno restituite nella risposta.