A API Time Zone fornece dados de ajuste de horário para locais na superfície da Terra. Solicite as informações de fuso horário para um par de latitude/longitude e data específicos. A API retorna o nome desse fuso horário, o intervalo de tempo em UTC e o horário de verão.
Exemplo de solicitação e resposta
Acesse a API Time Zone por meio de uma interface HTTPS, com solicitações criadas como uma string de URL usando coordenadas de latitude/longitude para especificar location
, um timestamp
para especificar a data e sua chave de API.
A consulta a seguir executa uma solicitação de fuso horário para Nevada, EUA. O carimbo de data/hora está definido como 8 de março de 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'
JavaScript
var axios = require('axios'); var config = { method: 'get', url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY', headers: { } }; axios(config) .then(function (response) { console.log(JSON.stringify(response.data)); }) .catch(function (error) { console.log(error); });
Python
import requests url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY" payload={} headers = {} response = requests.request("GET", url, headers=headers, data=payload) print(response.text)
Java
OkHttpClient client = new OkHttpClient().newBuilder() .build(); MediaType mediaType = MediaType.parse("text/plain"); RequestBody body = RequestBody.create(mediaType, ""); Request request = new Request.Builder() .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY") .method("GET", body) .build(); Response response = client.newCall(request).execute();
Ruby
require "uri" require "net/http" url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY") https = Net::HTTP.new(url.host, url.port) https.use_ssl = true request = Net::HTTP::Get.new(url) response = https.request(request) puts response.read_body
Go
package main import ( "fmt" "net/http" "io/ioutil" ) func main() { url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510×tamp=1331161200&key=YOUR_API_KEY" method := "GET" client := &http.Client { } req, err := http.NewRequest(method, url, nil) if err != nil { fmt.Println(err) return } res, err := client.Do(req) if err != nil { fmt.Println(err) return } defer res.Body.Close() body, err := ioutil.ReadAll(res.Body) if err != nil { fmt.Println(err) return } fmt.Println(string(body)) }
Correio
A especificação da OpenAPI também está disponível como uma coleção Postman.
Executar no PostmanPara testar isso, insira o URL no seu navegador da Web. Lembre-se de
substituir YOUR_API_KEY
pela chave de API real.
A resposta inclui os dados de fuso horário do local e da data especificados (timestamp)
.
Consulte o guia do desenvolvedor para mais informações sobre como criar URLs de solicitação e parâmetros disponíveis e como entender a resposta.
Veja a seguir um exemplo de resposta em 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>
Começar a codificar com nossas bibliotecas cliente
As bibliotecas de cliente facilitam o desenvolvimento com as APIs de serviços da Web do Google Maps ao oferecer implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e nova tentativa automática. A API Time Zone está disponível nos clientes Java, Python, Go e Node.js dos serviços do Google Maps.
Autenticação, cotas, preços e políticas
Autenticação
Para usar a API Time Zone, ative a API e consiga as credenciais de autenticação adequadas. Para mais detalhes, consulte o artigo Como começar a usar a Plataforma Google Maps.
Cotas e preços
Consulte a página de uso e faturamento para ver detalhes sobre as cotas e os preços definidos para a API Time Zone.
Políticas
O uso da API Time Zone precisa estar de acordo com as políticas da API.
Saiba mais
Na API Time Zone, também é possível definir um parâmetro de idioma para retornar resultados em idiomas diferentes do padrão inglês. Consulte o Guia do desenvolvedor da API Time Zone para mais exemplos e outros detalhes.
O Guia para desenvolvedores da API Time Zone é destinado a desenvolvedores de sites e dispositivos móveis que querem incluir dados de tempo em mapas fornecidos por uma das APIs da Plataforma Google Maps. Ele fornece uma introdução ao uso da API e a materiais de referência sobre os parâmetros disponíveis.