Começar

A API Time Zone fornece dados de deslocamento de tempo 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 uma interface HTTPS, com solicitações construídas como uma string de URL, usando coordenadas de latitude/longitude para especificar o 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.

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

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

Para testar isso, insira o URL no navegador da Web. Substitua YOUR_API_KEY pela chave de API real. A resposta inclui os dados de fuso horário para a data e o local 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:

{
  "dstOffset": 0,
  "rawOffset": -28800,
  "status": "OK",
  "timeZoneId": "America/Los_Angeles",
  "timeZoneName": "Pacific Standard Time",
}

<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 do serviço da Web do Google Maps, fornecendo implementações nativas e simples de tarefas comuns, como autenticação, limitação de solicitações e repetição automática. 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 é necessário ativá-la e receber as credenciais de autenticação adequadas. Para mais informações, consulte Começar a usar a Plataforma Google Maps.

Cotas e preços

Consulte a página Uso e faturamento para saber mais 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, que é o inglês. Consulte o guia para desenvolvedores da API Time Zone para conferir 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. Ela fornece uma introdução ao uso da API e material de referência sobre os parâmetros disponíveis.