Inizia

L'API Time Zone fornisce dati sull'offset di tempo per le località sulla superficie della Terra. Richiedi le informazioni sul fuso orario per una data e una coppia di latitudine/longitudine specifiche. L'API restituisce il nome del fuso orario, la differenza di tempo rispetto a UTC e la differenza di tempo dell'ora legale.

Richiesta e risposta di esempio

Accedi all'API Fuso orario tramite un'interfaccia HTTPS, con richieste costruite come stringa URL, utilizzando le coordinate di latitudine/longitudine per specificare il location, un timestamp per specificare la data e la tua chiave API.

La query seguente esegue una richiesta relativa al fuso orario per il Nevada, negli Stati Uniti. Il timestamp è impostato su 8 marzo 2012.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1733428634
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1733428634&key=YOUR_API_KEY'

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

Consulta la guida per gli sviluppatori per saperne di più su come creare URL di richiesta e parametri disponibili e interpretare la risposta.

Di seguito è riportata una risposta di esempio 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 di servizio web di Google Maps fornendo implementazioni native semplici di attività comuni come autenticazione, throttling delle richieste e riprova automatica. L'API Fuso orario è disponibile nel client Java, nel client Python, nel client Go e nel client Node.js per i servizi Google Maps.

Autenticazione, quote, prezzi e norme

Autenticazione

Per utilizzare l'API Fuso orario, devi prima attivarla e ottenere le credenziali di autenticazione appropriate. Per saperne di più, consulta Introduzione a Google Maps Platform.

Quote e prezzi

Consulta la pagina Utilizzo e fatturazione per informazioni dettagliate sulle quote e sui prezzi impostati per l'API Fuso orario.

Norme

L'utilizzo dell'API Fuso orario deve essere conforme alle norme relative alle API.

Scopri di più

Nell'API Fuso orario, puoi anche impostare un parametro di lingua per restituire risultati in lingue diverse dall'inglese predefinito. Per ulteriori esempi e altri dettagli, consulta la Guida per gli sviluppatori dell'API fuso orario.

La Guida per gli sviluppatori dell'API Time Zone è rivolta agli sviluppatori di siti web e mobile che vogliono includere dati sull'ora nelle mappe fornite da una delle API di Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e materiale di riferimento sui parametri disponibili.