
La Time Zone API è un servizio che accetta una richiesta HTTP di coordinate di latitudine/longitudine e una data e un'ora scelte. Restituisce i dati sul fuso orario della località, inclusi gli offset per UTC e l'ora legale.
Perché utilizzare l'API Time Zone
Con l'API Time Zone, puoi sviluppare applicazioni che forniscono l'ID e il nome del fuso orario per date e ore in località specifiche su una mappa. Ad esempio, puoi mostrare i seguenti dati relativi ai fusi orari:
- Nomi dei fusi orari localizzati per le località sulla mappa di Google Maps Platform.
- Differenze di fuso orario rispetto all'ora UTC e per l'ora legale.
I dati sul fuso orario sono particolarmente utili quando vuoi che il tuo sito web o la tua app visualizzino dati basati sul tempo pertinenti per le persone che utilizzano la tua applicazione.
Cosa puoi fare con l'API Time Zone
Con l'API Time Zone, puoi richiedere il fuso orario per le località sulla superficie della Terra, con l'offset temporale rispetto all'ora UTC e per l'ora legale per ciascuna di queste località.
Come funziona l'API Time Zone
L'API Time Zone accetta una richiesta HTTPS di coordinate di latitudine e longitudine, la data e l'ora selezionate come timestamp e, facoltativamente, un codice lingua. Restituisce i dati nel formato specificato dalla richiesta. L'esempio seguente mostra una richiesta per il Nevada, USA, con un output richiesto in JSON:
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
Risorse
La tabella seguente riassume le risorse disponibili tramite l'API Time Zone e i dati che restituisce:
| Risorse di dati | Dati restituiti | Formato di reso |
|---|---|---|
| Fuso orario
Fornisci la tua richiesta insieme alla posizione e al timestamp. Consulta i parametri obbligatori. |
|
|
Come utilizzare l'API Time Zone
| 1 | Configurazione | Inizia con Configura il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito. |
| 2 | Prova una richiesta di fuso orario | Una volta ottenuta una chiave API, puoi iniziare a testare l'API Time Zone direttamente dal tuo browser. Per maggiori dettagli, consulta gli esempi di fuso orario nella guida Richieste e risposte relative al fuso orario. |
| 3 | Nozioni di base sulle risposte | Scopri come utilizzare i dati sul fuso orario nella tua app o nel tuo sito web. Per maggiori dettagli, consulta Risposte del fuso orario. |
| 5 | Incorpora i dati sul fuso orario nella tua app. | Puoi utilizzare i dati sul fuso orario per migliorare app e siti web in diverse impostazioni internazionali basate sul tempo. |
Librerie client disponibili
Chiama questa API nel linguaggio che preferisci tramite una delle seguenti librerie client:
- Client Java per i servizi Google Maps
- Client Python per i servizi Google Maps
- Go Client for Google Maps Services
- Client Node.js per i servizi Google Maps
I client Java, Python, Go e Node.js per i servizi Google Maps sono librerie client supportate dalla community, open source con licenza Apache 2.0. Scaricali da GitHub, dove puoi trovare anche le istruzioni di installazione e il codice campione.
Passaggi successivi
- Scopri come effettuare richieste Time Zone: vai a Richieste e risposte Time Zone.
- Segui le best practice: vai a Best practice per i servizi web.