L’API del fuso orario fornisce dati sull’offset orario per le località sulla superficie della terra. Richiedi le informazioni sul fuso orario per una specifica coppia latitudine/longitudine e data. L’API restituisce il nome di quel fuso orario, l’offset dell’ora da UTC e l’offset dell’ora legale.

Campione di richiesta e risposta

Accedi all’API del fuso orario attraverso un’interfaccia HTTPS, con richieste costruite come una stringa URL, usando le coordinate di latitudine/longitudine per specificare il location, un timestamp per specificare la data e la tua chiave API.

L’esempio seguente richiede i dati del fuso orario per Washington, DC, USA, il 15 marzo 2016, in formato JSON:

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Puoi testarlo inserendo l’URL nel tuo browser web (assicurati di sostituire YOUR_API_KEY con la tua attuale chiave API). La risposta include i dati del fuso orario per la località specificata e la data (timestamp).

Vedi la guida dello sviluppatore per maggiori informazioni sulla costruzione degli URL di richiesta e sui parametri disponibili e sulla comprensione della risposta.

Di seguito un esempio di risposta, in JSON:

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Inizia a codificare con le nostre librerie client

Le librerie client rendono più facile lo sviluppo con le API del servizio web di Google Maps, fornendo semplici implementazioni native di compiti comuni come l’autenticazione, la limitazione delle richieste e la riprova automatica. L’API del fuso orario è disponibile nel client Java, client Python, client Go e client Node.js per i servizi Google Maps.

Autenticazione, quote, prezzi e politiche

Autenticazione

Per usare l’API del fuso orario, devi prima abilitare l’API e ottenere le credenziali di autenticazione appropriate. Per maggiori informazioni, vedi Iniziare con Google Maps Platform.

Quote e prezzi

Guarda la pagina di utilizzo e fatturazione per i dettagli sulle quote e i prezzi impostati per Time Zone API.

Politiche

L’uso di Time Zone API deve essere conforme alle politiche API.

Per saperne di più

Nella Time Zone API, puoi anche impostare un parametro di lingua per restituire risultati in lingue diverse da quella predefinita di inglese. Vedere la Time Zone API Developer Guide per ulteriori esempi e altri dettagli.