Panoramica dell'API Time Zone

L'API Time Zone è un servizio che accetta una richiesta HTTP di coordinate di latitudine/longitudine e della data e dell'ora desiderate. Restituisce i dati sul fuso orario della località, inclusi gli offset per UTC e 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 di luoghi specifici su una mappa. Ad esempio, puoi mostrare i seguenti dati relativi al fuso orario:

  • Nomi localizzati del fuso orario per le posizioni sulla mappa da Google Maps Platform.
  • Differenza di fuso orario rispetto a UTC e all'ora legale.

I dati sui fusi orari possono essere particolarmente utili quando vuoi che il tuo sito web o la tua app mostrino dati basati sul tempo pertinenti per gli utenti.

Cosa puoi fare con l'API Time Zone

Con l'API Time Zone, puoi richiedere il fuso orario per le località sulla superficie terrestre, con la differenza di fuso orario da 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/longitudine, la data e l'ora desiderate come timestamp e, facoltativamente, un codice lingua. Restituisce i dati nel formato specificato dalla richiesta. L'esempio seguente mostra una richiesta per Nevada, USA, con un output richiesto in JSON.

 https://maps.googleapis.com/maps/api/timezone/json
    ?location=39.6034810%2C-119.6822510
    &timestamp=1331161200
    &key=YOUR_API_KEY
  

Risorse

La seguente tabella riassume le risorse disponibili tramite l'API Time Zone insieme ai dati che restituisce.

Risorse di dati Dati restituiti Formato del reso
Fuso orario

Fornisci la tua richiesta insieme alla località e al timestamp. Vedi i parametri obbligatori.

  • ID fuso orario.
  • Nome del fuso orario, eventualmente localizzato
  • Differenza rispetto a UTC, in secondi
  • Offset per l'ora legale, in secondi
  • Per esempi specifici di risposta, vedi Fuso orario.
  • JSON
  • XML

Come utilizzare l'API Time Zone

1 Configurazione Inizia con Configura il tuo progetto Google Cloud e completa le istruzioni di configurazione che seguono.
2 Prova una richiesta di fuso orario Dopo aver ottenuto una chiave API, puoi iniziare a testare l'API Time Zone direttamente dal tuo browser. Per maggiori dettagli, vedi gli esempi di fuso orario nella guida relativa a richieste e risposte relative al fuso orario.
3 Informazioni di base sulle risposte Scopri come utilizzare i dati relativi al fuso orario nella tua app o nel tuo sito web. Consulta Risposte relative al fuso orario per i dettagli.
5 Incorpora i dati relativi al fuso orario nella tua app. Puoi utilizzare i dati relativi al fuso orario per migliorare app e siti web per gli utenti di diverse impostazioni internazionali basate sul tempo.

Librerie client disponibili

Chiama questa API nel linguaggio di tua scelta 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 e open source previste dalla licenza Apache 2.0. Scaricali da GitHub, dove puoi anche trovare istruzioni per l'installazione e codice di esempio.

Passaggi successivi