Visão geral da API Time Zone

A API Time Zone é um serviço que aceita uma solicitação HTTP coordenadas de latitude/longitude e data e hora escolhidas. Ela retorna o horário dados de zona do local, incluindo deslocamentos para UTC e horário de verão tempo de resposta.

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, você pode mostrar os seguintes dados de fuso horário:

  • Nomes de fuso horário localizados para locais de mapas da Plataforma Google Maps.
  • Compensações de fuso horário em relação ao UTC e para o horário de verão.

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

O que é possível 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 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 carimbo de data/hora e, opcionalmente, um código de idioma. Ele retorna 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 na API Time Zone e os dados que ela retorna.

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

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

  • ID do fuso horário.
  • Nome do fuso horário (opcionalmente localizado)
  • Deslocamento em relação ao UTC, em segundos
  • Deslocamento para o horário de verão, em segundos
  • Consulte Fuso horário para conferir exemplos de respostas específicas.
  • 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.
2 Tentar uma solicitação de fuso horário Depois de ter uma chave de API, você pode 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 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 os serviços do Google Maps são bibliotecas de cliente com suporte da comunidade e código aberto regido pela 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