Indice
Date
(messaggio)LatLng
(messaggio)Money
(messaggio)PostalAddress
(messaggio)TimeOfDay
(messaggio)
Data
Rappresenta una data di calendario intera o parziale, ad esempio un compleanno. L'ora del giorno e il fuso orario sono specificati altrove o non sono significativi. La data è relativa al calendario gregoriano. Può rappresentare uno dei seguenti elementi:
- Una data completa, con valori di anno, mese e giorno diversi da zero
- Un valore di mese e giorno, con un anno pari a zero, ad esempio un anniversario
- Un anno a sé, con valori zero per mese e giorno
- Un valore relativo all'anno e al mese con un giorno zero, ad esempio la data di scadenza di una carta di credito
I tipi correlati sono google.type.TimeOfDay
e google.protobuf.Timestamp
.
Campi | |
---|---|
year |
Anno della data. Il valore deve essere compreso tra 1 e 9999 oppure 0 per specificare una data senza anno. |
month |
Mese di un anno. Il valore deve essere compreso tra 1 e 12 oppure 0 per specificare un anno senza giorno e mese. |
day |
Giorno di un mese. Il valore deve essere compreso tra 1 e 31 ed essere valido per l'anno e il mese oppure 0 per specificare un anno e un mese in cui il giorno non sia significativo. |
LatLng
Un oggetto che rappresenta una coppia latitudine/longitudine. Questo valore è espresso come una coppia di doppi per rappresentare i gradi di latitudine e i gradi di longitudine. Se non diversamente specificato, deve essere conforme allo standard WGS84. I valori devono essere compresi negli intervalli normalizzati.
Campi | |
---|---|
latitude |
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]. |
Money
Rappresenta una quantità di denaro con il suo tipo di valuta.
Campi | |
---|---|
currency_code |
Il codice valuta di tre lettere definito nello standard ISO 4217. |
units |
Le unità intere dell'importo. Ad esempio, se |
nanos |
Numero di nano (10^-9) unità della quantità. Il valore deve essere compreso tra -999.999.999 e +999.999.999 inclusi. Se |
PostalAddress
Rappresenta un indirizzo postale, ad esempio per la consegna postale o gli indirizzi per i pagamenti. Dato un indirizzo postale, un servizio postale può consegnare gli articoli a un locale, a una casella postale o simili. Non è destinata a modellare località geografiche (strade, città, montagne).
Nell'uso tipico, un indirizzo viene creato tramite l'input utente'utente o dall'importazione di dati esistenti, a seconda del tipo di processo.
Consigli sull'inserimento / modifica dell'indirizzo: - Usa un widget per indirizzi pronti per i18n come https://github.com/google/libaddressinput). Gli utenti non devono visualizzare elementi UI per l'inserimento o la modifica di campi al di fuori dei paesi in cui viene utilizzato questo campo.
Per ulteriori indicazioni su come utilizzare questo schema, consulta la pagina: https://support.google.com/business/answer/6397478
Campi | |
---|---|
revision |
La revisione dello schema di Tutte le nuove revisioni devono essere compatibili con le versioni precedenti. |
region_code |
Obbligatorio. Codice regione CLDR del paese o della regione dell'indirizzo. Questo non viene mai dedotto e spetta all'utente verificare che il valore sia corretto. Per maggiori dettagli, visita le pagine http://cldr.unicode.org/ e http://www.unicode.org/cldr/charts/30/supplemental/territory_information.html. Esempio: "CH" per la Svizzera. |
language_code |
Facoltativo. Codice lingua BCP-47 dei contenuti dell'indirizzo (se noto). Spesso si tratta della lingua dell'interfaccia utente del modulo di input o dovrebbe corrispondere a una delle lingue usate nel paese/nella regione dell'indirizzo o ai relativi equivalenti traslitterati. Questo può influenzare la formattazione in alcuni paesi, ma non è fondamentale per la correttezza dei dati e non influirà mai su convalida o altre operazioni correlate alla formattazione. Se questo valore non è noto, deve essere omesso (anziché specificare un valore predefinito potenzialmente errato). Esempi: "zh-Hant", "ja", "ja-Latn", "en". |
postal_code |
Facoltativo. Codice postale dell'indirizzo. Non tutti i paesi utilizzano o richiedono la presenza di codici postali; tuttavia, nel caso in cui vengano utilizzati, potrebbero attivare un'ulteriore convalida con altre parti dell'indirizzo (ad es. convalida stato/CAP negli Stati Uniti). |
sorting_code |
Facoltativo. Codice di ordinamento aggiuntivo specifico per il paese. Non è utilizzata nella maggior parte delle regioni. Quando 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 dell'area di consegna" (Malawi) o "indicatore dell'ufficio postale" (ad es. Costa d'Avorio). |
administrative_area |
Facoltativo. Suddivisione amministrativa massima 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 questa è la provincia e non la comunità autonoma (ad es. "Barcellona" e non "Catalogna"). Molti paesi non utilizzano un'area amministrativa negli indirizzi postali. Ad esempio, in Svizzera il campo deve essere lasciato vuoto. |
locality |
Facoltativo. In genere si riferisce alla porzione di 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 delle località vuote e utilizza address_lines. |
sublocality |
Facoltativo. Circoscrizione dell'indirizzo. ad esempio quartieri, distretti e distretti. |
address_lines[] |
Righe dell'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 o la regione dell'indirizzo. Nei luoghi in cui può variare (ad es. il Giappone), viene utilizzato address_language per renderlo esplicito (ad es. "ja" per l'ordinamento grande-piccolo e "ja-Latn" o "en" per ordine piccolo-grandi). In questo modo è possibile selezionare la riga più specifica di un indirizzo in base alla lingua. La rappresentazione strutturale minima consentita di un indirizzo è composta da un codice regione con tutte le informazioni rimanenti inserite nelle righe_indirizzo. Sarebbe possibile formattare un indirizzo di questo tipo all'incirca senza geocodifica, ma non è possibile fare alcun ragionamento semantico sui componenti dell'indirizzo fino a quando non fosse stato risolto almeno parzialmente. Creare un indirizzo contenente solo regione_code e address_lines, dopodiché 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[] |
Facoltativo. Il destinatario all'indirizzo. In determinate circostanze, questo campo potrebbe contenere informazioni su più righe. Ad esempio, potrebbe contenere informazioni sulla "cura di". |
organization |
Facoltativo. Il nome dell'organizzazione all'indirizzo. |
TimeOfDay
Rappresenta un'ora del giorno. La data e il fuso orario non sono significativi o sono specificati altrove. Un'API può scegliere di consentire secondi intercalari. I tipi correlati sono google.type.Date
e google.protobuf.Timestamp
.
Campi | |
---|---|
hours |
Ore del giorno nel formato 24 ore. Il valore deve essere compreso tra 0 e 23. Un'API può scegliere di consentire il valore "24:00:00" per scenari come l'orario di chiusura dell'attività. |
minutes |
Minuti di ora del giorno. Il valore deve essere compreso tra 0 e 59. |
seconds |
Secondi di minuti. Normalmente deve essere compreso tra 0 e 59. Un'API potrebbe consentire il valore 60 se consente i secondi intercalari. |
nanos |
Frazioni di secondi in nanosecondi. Il valore deve essere compreso tra 0 e 999.999.999. |