Visão geral da API Time Zone

A API Time Zone aceita um serviço que aceita uma solicitação HTTP de coordenadas de latitude/longitude e uma data e hora desejadas. Ele retorna os dados do fuso horário do local, incluindo deslocamentos para o horário UTC e horário de verão.

Por que usar a API Time Zone

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

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

Os dados de fuso horário podem ser especialmente úteis quando você quer que o site ou app exiba dados baseados em tempo relevantes aos usuários.

O que você pode fazer com a API Time Zone

Com a API Time Zone, é possível solicitar o fuso horário de locais na superfície da Terra com o ajuste de horário em relação ao UTC e o horário de verão de cada um desses locais.

Como funciona a API Time Zone

A API Time Zone aceita uma solicitação HTTPS de coordenadas de latitude/longitude, a data e a hora desejadas 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=1331161200
    &key=YOUR_API_KEY

Recursos

A tabela a seguir resume os recursos disponíveis na API Time Zone com os dados retornados.

Recursos de dados Dados retornados Formato da devolução
Fuso horário

Informe sua solicitação e o local e o carimbo de data/hora. Veja os parâmetros obrigatórios.

  • ID do fuso horário.
  • Nome do fuso horário, opcionalmente localizado
  • Deslocamento do UTC em segundos
  • Deslocamento para DST, em segundos
  • Consulte "Fuso horário" para ver exemplos específicos de respostas.
  • JSON
  • XML

Como usar a API Time Zone

1 Começar a configuração Comece com Configurar o projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Teste uma solicitação de fuso horário Depois de conseguir a chave de API, você poderá começar a testar a API Time Zone 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 Confira como usar os dados de fuso horário no seu app ou site. Consulte as respostas do fuso horário para mais detalhes.
5 Incorpore dados de fuso horário ao seu app. É possível usar os dados de fuso horário para aprimorar apps e sites de usuários em diferentes localidades baseadas em tempo.

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, com código aberto sob a Licença Apache 2.0. Faça o download no GitHub, que também inclui instruções de instalação e amostras de código.

A seguir