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 a data e a hora desejadas. Ele retorna os dados de fuso horário da localização, incluindo deslocamentos para 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 do 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 fuso horário localizados para locais em mapas da Plataforma Google Maps.
  • Compensação de fuso horário do UTC e para o horário de verão.

Os dados de fuso horário podem ser especialmente úteis quando você quer que seu site ou app exiba dados com base em tempo relevantes para os usuários.

O que você pode fazer com a API Time Zone

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

Como a API Time Zone funciona

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 por meio da API Time Zone com os dados que ela retorna.

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

Forneça sua solicitação com o local e o carimbo de data/hora. Confira os parâmetros obrigatórios.

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

Como usar a API Time Zone

1 Configuração Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração a seguir.
2 Tentar solicitar um fuso horário Depois de gerar uma chave de API, você pode começar a testar a API Time Zone diretamente no navegador. Para mais detalhes, consulte Exemplos de fuso horário no guia Solicitações e respostas de fuso horário.
3 Noções básicas sobre respostas Explore como usar os dados de fuso horário no seu aplicativo ou site. Consulte Respostas de fuso horário para mais detalhes.
5 Incorpore dados de fuso horário no seu app. Você pode usar os dados de fuso horário para aprimorar apps e sites para usuários em diferentes localidades com base no horário.

Bibliotecas de clientes disponíveis

Chame essa API na linguagem que quiser usando uma destas 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 também é possível encontrar instruções de instalação e exemplos de código.

A seguir