Panoramica dell'API Time Zone

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
  &timestamp=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.

  • ID fuso orario.
  • Nome del fuso orario, facoltativamente localizzato.
  • Differenza rispetto al fuso orario UTC, in secondi.
  • Offset per l'ora legale, in secondi.
  • Consulta Fuso orario per esempi di risposte specifiche.
  • JSON
  • XML

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:

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