Inizia

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
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=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.