Package google.type

Indice

LatLng

Un oggetto che rappresenta una coppia di latitudine/longitudine. Questo valore è espresso come una coppia di numeri doppi per rappresentare i gradi di latitudine e di longitudine. Se non diversamente specificato, questo oggetto deve essere conforme allo standard WGS84. I valori devono rientrare in intervalli normalizzati.

Campi
latitude

double

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

double

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

PostalAddress

Rappresenta un indirizzo postale, ad esempio per la consegna della posta o gli indirizzi di pagamento. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a un'abitazione, a una cassetta postale o a un indirizzo simile. Non è progettato per modellare località geografiche (strade, città, montagne).

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

Consigli per l'inserimento/la modifica dell'indirizzo: - Utilizza un widget di indirizzo pronto per l'internazionalizzazione, ad esempio https://github.com/google/libaddressinput. - Agli utenti non devono essere mostrati elementi dell'interfaccia utente per l'inserimento o la modifica di campi al di fuori dei paesi in cui vengono utilizzati.

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 causerà l'errore INVALID_ARGUMENT dell'API.
region_code

string

(Facoltativo) Codice regione CLDR del paese/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 il massimo rendimento, ti consigliamo di includere il codice regione, se lo conosci. La presenza di regioni incoerenti o ripetute può comportare un rendimento scadente. Ad esempio, se address_lines include già la regione, non fornire di nuovo il codice regione in questo campo. Le regioni supportate sono riportate nelle Domande frequenti.
language_code

string

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

string

(Facoltativo) Il codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali, ma, dove vengono utilizzati, possono attivare una convalida aggiuntiva con altre parti dell'indirizzo (ad es. la convalida dello stato/del codice postale negli Stati Uniti).
sorting_code

string

(Facoltativo) Codice di ordinamento aggiuntivo specifico per il paese. Questo formato non viene utilizzato nella maggior parte delle regioni. Se viene utilizzato, il valore è una stringa come "CEDEX", eventualmente seguita da un numero (ad es. "CEDEX 7") o solo un numero, che rappresenta il "codice settore" (Giamaica), l'"indicatore zona di consegna" (Malawi) o l'"indicatore ufficio postale" (ad es. Costa d'Avorio).
administrative_area

string

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

(Facoltativo) Solitamente si riferisce alla porzione di città dell'indirizzo. Esempi: "city" per gli Stati Uniti, "comune" in Italia, "post town" nel Regno Unito. Nelle regioni del mondo in cui le località non sono ben definite o non si adattano bene a questa struttura, lascia la località vuota e utilizza le righe dell'indirizzo.
sublocality

string

(Facoltativo) Quartiere dell'indirizzo. Ad esempio, possono essere quartieri, rioni, distretti.
address_lines[]

string

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

Poiché i valori in address_lines non hanno 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 dell'indirizzo deve essere "ordine busta" per il paese o la regione dell'indirizzo.

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

La creazione di un indirizzo contenente solo address_lines e il relativo geocodificamento sono il modo consigliato per gestire gli indirizzi completamente non strutturati (anziché indovinare quali parti dell'indirizzo devono essere località o aree amministrative).
recipients[]

string

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

string

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.