Visão geral da API Time Zone

A API Time Zone é um serviço que aceita uma solicitação HTTP de coordenadas de latitude/longitude e uma data e hora escolhidas. Ela retorna os dados de fuso horário do local, incluindo as diferenças em relação ao UTC e ao horário de verão.

Por que usar a API Time Zone

Com a API Time Zone, você pode desenvolver aplicativos que fornecem o ID e o nome do fuso horário para datas e horas em locais específicos em um mapa. Por exemplo, é possível mostrar os seguintes dados de fuso horário:

  • Nomes de fusos horários localizados para locais do mapa da Plataforma Google Maps.
  • Compensações de fuso horário do UTC e do horário de verão.

Os dados de fuso horário são particularmente úteis quando você quer que seu site ou app exiba dados baseados em tempo relevantes para as pessoas que usam seu aplicativo.

O que você pode fazer com a API Time Zone

Com a API Time Zone, você pode solicitar o fuso horário de locais na superfície da Terra, com o ajuste de tempo do UTC e do horário de verão para cada um desses locais.

Como a API Time Zone funciona

A API de fuso horário aceita uma solicitação HTTPS de coordenadas de latitude e longitude, a data e hora selecionadas como um carimbo de data/hora e, opcionalmente, um código de idioma. Ela retorna dados no formato especificado pela solicitação. O exemplo a seguir mostra uma solicitação para Nevada, EUA, com uma saída solicitada em JSON:

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

Recursos

A tabela a seguir resume os recursos disponíveis na API Time Zone, além dos dados que ela retorna:

Recursos de dados Dados retornados Formato de retorno
Fuso horário

Você fornece sua solicitação junto com o local e o carimbo de data/hora. Consulte parâmetros obrigatórios.
  • ID do fuso horário.
  • Nome do fuso horário, opcionalmente localizado.
  • Diferença do UTC, em segundos.
  • Deslocamento para o horário de verão, em segundos.
  • Consulte Fuso horário para ver exemplos de resposta específicos.
  • JSON
  • XML

Como usar a API Time Zone

1 Configurar Comece com Configurar seu projeto do Google Cloud e conclua as instruções de configuração a seguir.
2 Teste uma solicitação de fuso horário Depois de ter uma chave de API, você pode começar a testar a API de fuso horário diretamente no navegador. Consulte os exemplos de fuso horário no guia Solicitações e respostas de fuso horário para mais detalhes.
3 Noções básicas sobre respostas Saiba como usar dados de fuso horário no seu app ou site. Consulte Respostas do fuso horário para mais detalhes.
5 Incorpore dados de fuso horário ao seu app. Você pode usar dados de fuso horário para melhorar apps e sites em diferentes locais com base no horário.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem de sua escolha usando uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js dos serviços do Google Maps são bibliotecas de cliente apoiadas pela comunidade e que têm código aberto sob a Licença Apache 2.0. Faça o download delas no GitHub, onde você também encontra instruções de instalação e exemplos de código.

A seguir