Comece agora

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, a diferença de horário em relação ao UTC e a diferença de 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 é definido como 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 fazer um teste, digite o URL no navegador da Web. Lembre-se de substituir YOUR_API_KEY pela chave de API. A resposta inclui os dados de fuso horário para o local e a data especificados: (timestamp).

Consulte o Guia para desenvolvedores 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 Web Service do Google Maps porque fornecem implementações nativas e simples de tarefas comuns, como autenticação, limitação de solicitações e novas tentativas automáticas. A API Time Zone está disponível nos clientes Java, Python, Go e Node.js para serviços do Google Maps.

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

Autenticação

Para usar a API Time Zone, primeiro ative a API e consiga as credenciais de autenticação adequadas. Para mais informações, consulte o artigo Começar a usar a Plataforma Google Maps.

Cotas e preços

Confira a página de uso e faturamento para mais 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 inglês padrão. Consulte o guia para desenvolvedores sobre a API Time Zone e veja 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 horário em mapas fornecidos por uma das APIs da Plataforma Google Maps. Ele traz uma introdução ao uso da API e materiais de referência sobre os parâmetros disponíveis.