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 data e hora desejadas. Ela retorna o horário dados de zona do local, incluindo deslocamentos para UTC e horário de verão momento.

Por que usar a API Time Zone

Com a API Time Zone, é possível desenvolver aplicativos que 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 fuso horário localizados para locais de mapas da Plataforma Google Maps.
  • Deslocamentos de fuso horário em relação ao UTC e ao horário de verão.

Os dados de fuso horário podem ser especialmente úteis quando você deseja que seus site ou app mostram dados baseados em tempo relevantes para os usuários.

O que você pode fazer com a API Time Zone

Com a API Time Zone, você pode solicitar o fuso horário de localizações na superfície terrestre, com a diferença de horário UTC e para o horário de verão para cada um dos nesses locais.

Como a API Time Zone funciona

A API Time Zone aceita uma solicitação HTTPS de latitude/longitude a data e a hora desejadas como um carimbo de data e hora e, opcionalmente, um código de idioma. Ela retorna os dados no formato especificado pela solicitação. O exemplo a seguir mostra uma solicitação 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 no API Time Zone com os dados retornados.

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

Você fornece sua solicitação com o local e o carimbo de data/hora. Consulte obrigatório parâmetros.

  • ID do fuso horário.
  • Nome do fuso horário (opcionalmente localizado)
  • Diferença do UTC, em segundos
  • Deslocamento do horário de verão, em segundos
  • Consulte "Fuso horário" para ver exemplos de respostas específicas.
  • JSON
  • XML

Como usar a API Time Zone

1 Configuração Comece com a etapa Configurar seu projeto do Google Cloud e conclua a configuração as instruções a seguir.
2 Tentar uma solicitação de fuso horário Quando você tiver uma chave de API, poderá começar a testar a API Time Zone diretamente no seu navegador. Consulte 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 de fuso horário para mais detalhes.
5 Incorpore dados de fuso horário ao seu app. É possível usar dados de fuso horário para aprimorar apps e sites para usuários em em locais diferentes com base no horário.

Bibliotecas de clientes disponíveis

Chame essa API no idioma do sua escolha por meio de uma das seguintes bibliotecas de cliente:

Os clientes Java, Python, Go e Node.js para Google Maps Os serviços são bibliotecas-cliente com suporte da comunidade, com código aberto de acordo com a Licença Apache 2.0. Faça o download deles no GitHub, onde também é possível encontrar instruções de instalação e exemplos de código.

A seguir