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. Ele retorna os dados do fuso horário do local, incluindo deslocamentos para o UTC e o 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 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.
  • 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 especialmente úteis quando você quer que seu site ou app exiba dados baseados 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 de locais na superfície terrestre, com a diferença de horário em relação ao UTC e ao 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 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 e os dados que ela retorna.

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

Você envia sua solicitação 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 em relação ao UTC, em segundos
  • Deslocamento para o horário de verão, em segundos
  • Consulte a seção "Fuso horário" para conferir exemplos de respostas específicas.
  • JSON
  • XML

Como usar a API Time Zone

1 Configurar Comece com Configurar seu projeto do Google Cloud e siga as instruções de configuração.
2 Tente 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 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. Você pode usar dados de fuso horário para melhorar apps e sites para usuários em diferentes localidades baseadas em horário.

Bibliotecas de clientes disponíveis

Chame essa API no idioma de sua escolha usando 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 códigos de exemplo.

A seguir