Começar

A API Time Zone fornece dados de ajuste de tempo para locais na superfície da Terra. Solicite as informações de fuso horário para um par de latitude e longitude e uma data específicos. A API retorna o nome desse fuso horário, o ajuste de tempo do UTC e o ajuste de horário de verão.

Exemplo de solicitação e resposta

Acesse a API Time Zone por uma interface HTTPS, com solicitações criadas como uma string de URL, usando coordenadas de latitude e longitude para especificar o location, um timestamp para especificar a data e sua chave de API.

A consulta a seguir faz 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
  &timestamp=1733428634
  &key=YOUR_API_KEY

curl

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 essa solicitação, insira o URL no navegador da Web. Substitua YOUR_API_KEY pela sua chave de API. A resposta inclui os dados de fuso horário para o local e a data especificados (timestamp).

Para mais informações sobre como criar URLs de solicitação e os parâmetros disponíveis e como entender a resposta, consulte o guia para desenvolvedores.

O exemplo a seguir mostra uma 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 programar com bibliotecas de cliente

As bibliotecas de cliente simplificam o desenvolvimento com as APIs de serviço da Web do Google Maps, oferecendo implementações simples e integradas de tarefas comuns, como autenticação, limitação de solicitações e nova tentativa automática. A API Fuso Horário 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 de fuso horário, 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

Para detalhes sobre as cotas e os preços definidos para a API de Fuso Horário, consulte Uso e faturamento.

Políticas

O uso da API Fuso Horário precisa obedecer às políticas da API.

Saiba mais

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

O Guia para desenvolvedores da API Time Zone ajuda desenvolvedores de sites e dispositivos móveis a incluir dados de fuso horário em mapas fornecidos por uma das APIs da Plataforma Google Maps. Ele fornece uma introdução ao uso da API e material de referência sobre os parâmetros disponíveis.