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 ×tamp=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. |
|
|
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:
- Java Cliente para serviços do Google Maps
- Python Cliente para serviços do Google Maps
- Cliente Go para serviços do Google Maps (em inglês)
- Cliente Node.js para serviços do Google Maps
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
- Saiba como fazer solicitações de fuso horário: acesse Solicitações e respostas de fuso horário.
- Siga as práticas recomendadas: acesse Práticas recomendadas para serviços da Web.