Panoramica dell'API Time Zone

L'API Time Zone è un servizio che accetta una richiesta HTTP di coordinate di latitudine/longitudine e una data e un'ora selezionate. Restituisce i dati sul fuso orario della località, incluse le differenze 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 quanto segue: Dati relativi al fuso orario:

  • Nomi di fusi orari localizzati per le posizioni sulla mappa in Google Maps Platform.
  • Differenze di fuso orario rispetto a UTC e per l'ora legale.

I dati sui fusi orari possono essere particolarmente utili se vuoi che il tuo sito web o la tua app mostri dati basati sul tempo pertinenti per i tuoi 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 l'offset di tempo rispetto a UTC e per l'ora legale per ciascuna di queste località.

Come funziona l'API Time Zone

L'API Fuso orario 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 di 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 tabella seguente riassume le risorse disponibili tramite l'API fuso orario, nonché i dati restituiti.

Risorse di dati Dati restituiti Formato di reso
Fuso orario

Devi fornire la richiesta insieme alla località e al timestamp. Consulta obbligatorio parametri.

  • ID fuso orario.
  • Nome del fuso orario, eventualmente localizzato
  • Offset da UTC, in secondi
  • Differenza per l'ora legale, in secondi
  • Per esempi di risposte specifici, consulta Fuso orario.
  • JSON
  • XML

Come utilizzare l'API Time Zone

1 Configurazione Per iniziare, consulta la sezione Configurare il progetto Google Cloud e completa le istruzioni di configurazione riportate di seguito.
2 Prova una richiesta relativa al fuso orario Una volta ottenuta una chiave API, puoi iniziare a testare l'API Time Zone direttamente da nel browser. Per maggiori dettagli, consulta Esempi di fusi orari nella guida Richieste e risposte relative ai fusi orari.
3 Informazioni di base sulle risposte Scopri come utilizzare i dati sui fusi orari nella tua app o nel tuo sito web. Vedi le risposte relative al fuso orario per maggiori dettagli.
5 Incorpora i dati relativi ai fusi orari nella tua app. Puoi utilizzare i dati sul fuso orario per migliorare app e siti web per gli utenti su diverse impostazioni internazionali basate sul tempo.

Librerie client disponibili

Chiama questa API nella lingua di la tua scelta tramite una delle seguenti librerie client:

Client Java, client Python, client Go e client Node.js per Google Maps I servizi sono librerie client supportate dalla community, open source secondo Licenza Apache 2.0. Scaricale da GitHub, dove puoi trovare anche le istruzioni per l'installazione e il codice di esempio.

Passaggi successivi