Primeiros passos

A API Time Zone fornece dados de ajuste de horário para locais na superfície do terra. Solicitar informações de fuso horário para um par de latitude/longitude e data específicos. A API retorna o nome do fuso horário, a diferença de horário em relação ao UTC e o de horário de verão.

Exemplo de solicitação e resposta

Acesse a API Time Zone por uma interface HTTPS, com criadas como uma string de URL, usando coordenadas de latitude/longitude para especificar location e 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 para 8 de março de 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'

Para testar isso, insira o URL em seu navegador da Web (não se esqueça 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 para desenvolvedores para mais informações sobre criar URLs de solicitação e parâmetros disponíveis e para 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 Web Service APIs do Google Maps, oferecendo recursos implementações nativas de tarefas comuns, como autenticação, solicitação limitação e nova tentativa automática. A API Time Zone está disponível no Cliente Java, Cliente Python, Cliente Go e Cliente Node.js para serviços do Google Maps.

Autenticação, cotas, preços e políticas

Autenticação

Para usar a API Time Zone, é necessário ativar a API primeiro e conseguir as credenciais de autenticação. Para mais informações, consulte Comece a usar a Plataforma Google Maps.

Cotas e preços

Revise 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 a Políticas de API.

Saiba mais

Na API Time Zone, você também pode definir um parâmetro de idioma para retornar resultados em idiomas diferentes do padrão do inglês. Consulte a API Time Zone guia para desenvolvedores para mais exemplos e outros detalhes.

O O guia do desenvolvedor da API Time Zone é destinado a sites e dispositivos móveis. desenvolvedores que querem incluir dados de tempo em mapas fornecidos por uma das plataformas do Google Maps APIs de terceiros. Ele fornece uma introdução ao uso da API e materiais de referência sobre os parâmetros.