A API Time Zone fornece dados de ajuste de horário para locais na superfície do terra. Solicitar informações de fuso horário para um par de latitude/longitude e data específicos. A API retorna o nome do fuso horário, a diferença de horário em relação ao UTC e o de horário de verão.
Exemplo de solicitação e resposta
Acesse a API Time Zone por uma interface HTTPS, com
criadas como uma string de URL, usando coordenadas de latitude/longitude para
especificar location
e timestamp
para especificar a data;
e sua chave de API.
A consulta a seguir executa uma solicitação de fuso horário para Nevada, EUA. O carimbo de data/hora está definido para 8 de março de 2012.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY'
Para testar isso, insira o URL em seu navegador da Web (não se esqueça de substituir
YOUR_API_KEY
pela chave de API real).
A resposta inclui os dados de fuso horário do local e da data especificados
(timestamp)
:
Consulte o Guia para desenvolvedores para mais informações sobre criar URLs de solicitação e parâmetros disponíveis e para entender a resposta.
Veja a seguir um exemplo de resposta em JSON:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
Começar a codificar com nossas bibliotecas cliente
As bibliotecas de cliente facilitam o desenvolvimento com as Web Service APIs do Google Maps, oferecendo recursos implementações nativas de tarefas comuns, como autenticação, solicitação limitação e nova tentativa automática. A API Time Zone está disponível no cliente Java, Cliente Python, Cliente Go e Cliente Node.js para serviços do Google Maps.
Autenticação, cotas, preços e políticas
Autenticação
Para usar a API Time Zone, é necessário ativar a API primeiro e conseguir as credenciais de autenticação. Para mais informações, consulte Comece a usar a Plataforma Google Maps.
Cotas e preços
Revise a página de uso e faturamento para ver detalhes sobre as cotas e os preços definidos para a API Time Zone.
Políticas
O uso da API Time Zone precisa estar de acordo com a Políticas de API.
Saiba mais
Na API Time Zone, você também pode definir um parâmetro de idioma para retornar resultados em idiomas diferentes do padrão do inglês. Consulte a API Time Zone guia para desenvolvedores para mais exemplos e outros detalhes.
O O guia do desenvolvedor da API Time Zone é destinado a sites e dispositivos móveis. desenvolvedores que querem incluir dados de tempo em mapas fornecidos por uma das plataformas do Google Maps APIs de terceiros. Ele fornece uma introdução ao uso da API e materiais de referência sobre os parâmetros.