Panoramica dell'API Time Zone

L'API Time Zone è un servizio che accetta una richiesta HTTP di coordinate di latitudine/longitudine e la data e l'ora desiderate. Restituisce l'ora i dati di zona per la località, inclusi compensazioni per UTC e ora legale volta.

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 orari 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.
  • Compensazione del fuso orario rispetto all'UTC e all'ora legale.

I dati relativi al fuso orario possono essere particolarmente utili quando vuoi che un sito web o un'app che mostrano 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 di luoghi sulla superficie terrestre, con lo scarto temporale da UTC e per l'ora legale per ciascuno di tali luoghi.

Come funziona l'API Time Zone

L'API Time Zone accetta una richiesta HTTPS di latitudine/longitudine le coordinate, 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 Time Zone e ai dati che restituisce.

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, localizzato facoltativamente
  • Offset da UTC, in secondi
  • Offset per l'ora legale, in secondi
  • Consulta Fuso orario per esempi di risposte specifici.
  • JSON
  • XML

Come utilizzare l'API Time Zone

1 Configurazione Inizia con l'articolo Configura il tuo Progetto Google Cloud e completare la configurazione istruzioni che seguono.
2 Prova con una richiesta relativa al fuso orario Una volta ottenuta una chiave API, puoi iniziare a testare l'API Time Zone direttamente da nel browser. Consulta gli esempi di fusi orari Per maggiori dettagli, consulta la guida Richieste e risposte relative al fuso orario.
3 Nozioni di base sulle risposte Scopri come utilizzare i dati relativi ai 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