L'API Time Zone fornisce dati di offset temporale per le località sulla superficie terrestre. Richiedi le informazioni sul fuso orario per una coppia e una data di latitudine/longitudine specifiche. L'API restituisce il nome del fuso orario, la differenza di fuso orario rispetto al fuso orario UTC e l'ora legale.
Esempio di richiesta e risposta
Accedi all'API Time Zone tramite un'interfaccia HTTPS, con le richieste create come stringa URL, utilizzando le coordinate di latitudine/longitudine per specificare location
, timestamp
per specificare la data e la chiave API.
La seguente query esegue una richiesta di fuso orario per Nevada, Stati Uniti. Il timestamp è impostato sull'8 marzo 2012.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY'
Puoi verificare inserendo l'URL nel browser web (assicurati di sostituire YOUR_API_KEY
con la tua chiave API effettiva).
La risposta include i dati relativi al fuso orario per la località e la data specificate
(timestamp)
.
Consulta la guida per gli sviluppatori per ulteriori informazioni sulla creazione di URL di richieste di creazione e sui parametri disponibili e per comprendere la risposta.
Di seguito è riportato un esempio di risposta, in JSON:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
Inizia a programmare con le nostre librerie client
Le librerie client semplificano lo sviluppo con le API dei servizi web di Google Maps fornendo implementazioni semplici e native di attività comuni come autenticazione, limitazione delle richieste e nuovi tentativi automatici. L'API Time Zone è disponibile in client Java, client Python, client Go e client Node.js per i servizi Google Maps.
Autenticazione, quote, prezzi e criteri
Autenticazione
Per utilizzare l'API Time Zone, devi prima abilitarla e ottenere le credenziali di autenticazione corrette. Per maggiori informazioni, consulta la guida introduttiva a Google Maps Platform.
Quote e prezzi
Consulta la pagina relativa a utilizzo e fatturazione per i dettagli sulle quote e sui prezzi impostati per l'API Time Zone.
Criteri
L'utilizzo dell'API Time Zone deve essere conforme alle norme dell'API.
Scopri di più
Nell'API Time Zone puoi anche impostare un parametro della lingua per restituire risultati in lingue diverse dall'inglese predefinito. Consulta la guida per gli sviluppatori dell'API Time Zone per ulteriori esempi e altri dettagli.
La guida per gli sviluppatori dell'API Time Zone è rivolta agli sviluppatori di siti web e dispositivi mobili che vogliono includere dati temporali nelle mappe fornite da una delle API Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e materiale di riferimento sui parametri disponibili.