![Visão geral da API Timezone](https://developers.google.cn/static/maps/images/landing/places-api_480.png?authuser=6&hl=pt-br)
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 ×tamp=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. |
|
|
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:
- Java Cliente para serviços do Google Maps
- Python Cliente para serviços do Google Maps
- Cliente Go para serviços do Google Maps
- Node.js Cliente para serviços do Google Maps
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
- Saiba como fazer solicitações de fuso horário: acesse Solicitações e respostas de fuso horário.
- Seguir as práticas recomendadas: acessar Práticas recomendadas para Serviços da Web.