L'API Time Zone fornisce dati sull'offset orario per le località sulla superficie della Terra. Richiedi le informazioni sul fuso orario per una specifica coppia di latitudine/longitudine e data. L'API restituisce il nome del fuso orario, la differenza oraria rispetto all'UTC e la differenza oraria per l'ora legale.
Richiesta e risposta di esempio
Accedi all'API Time Zone tramite un'interfaccia HTTPS, con
richieste create come stringa URL, utilizzando le coordinate di latitudine/longitudine per
specificare location, un timestamp per specificare la data
e la tua chiave API.
La query riportata di seguito esegue una richiesta di fuso orario per il Nevada, Stati Uniti. Il timestamp è impostato sul 8 marzo 2012.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Puoi testare questa operazione inserendo l'URL nel browser web (assicurati di sostituire
YOUR_API_KEY con la tua chiave API).
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 sui parametri disponibili e come interpretare la risposta.
Di seguito è riportato un esempio di risposta in formato 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 del servizio web Google Maps fornendo implementazioni native e semplici di attività comuni come autenticazione, limitazione delle richieste e riprova automatica. L'API Time Zone è 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 Time Zone, devi prima abilitarla e ottenere le credenziali di autenticazione appropriate. Per saperne di più, consulta la pagina Inizia a utilizzare Google Maps Platform.
Quote e prezzi
Consulta la pagina Utilizzo e fatturazione per informazioni dettagliate sulle quote e sui prezzi impostati per l'API Time Zone.
Norme
L'utilizzo dell'API Time Zone deve essere conforme alle norme delle API.
Scopri di più
Nell'API Time Zone, puoi anche impostare un parametro della lingua per restituire risultati in lingue diverse dall'inglese, che è la lingua predefinita. Per altri esempi e dettagli, consulta la guida per gli sviluppatori dell'API Time Zone.
La guida per gli sviluppatori dell'API Time Zone è rivolta agli sviluppatori di siti web e app mobile che vogliono includere dati sull'ora nelle mappe fornite da una delle API Google Maps Platform. Fornisce un'introduzione all'utilizzo dell'API e materiale di riferimento sui parametri disponibili.