A API de Fuso Horário fornece dados de compensação de tempo para locais na superfície da terra. Solicite as informações do fuso horário para um par específico de latitude/longitude e data. A API retorna o nome desse fuso horário, o offset de tempo do UTC e o offset de horário de verão.

Requisição e resposta de amostra

Acesso à API de fuso horário através de uma interface HTTPS, com requisições construídas como uma string URL, usando coordenadas de latitude/longitude para especificar o location, um timestamp para especificar a data, e sua chave API.

O seguinte exemplo solicita os dados de fuso horário para Washington, DC, EUA, em 15 de março de 2016, no formato JSON:

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Você pode testar isso digitando a URL no seu navegador da web (não se esqueça de substituir YOUR_API_KEY pela sua chave API real). A resposta inclui os dados de fuso horário para o local e data especificados (timestamp).

Veja o guia do desenvolvedor para obter mais informações sobre como construir URLs de solicitação e parâmetros disponíveis e compreender a resposta.

Below é um exemplo de resposta, em JSON:

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Comece a codificar com as nossas bibliotecas clientes

Bibliotecas clientes facilitam o desenvolvimento com as APIs de serviços web do Google Maps, fornecendo implementações simples e nativas de tarefas comuns, tais como autenticação, aceleração de pedidos e tentativas automáticas de nova tentativa. A API de fuso horário está disponível no Cliente Java, Cliente Python, Cliente Go e Cliente Node.js para os Serviços do Google Maps.

Autenticação, quotas, preços e políticas

Autenticação

Para usar a API de fuso horário, você deve primeiro habilitar a API e obter as credenciais de autenticação adequadas. Para mais informações, veja Começar com a plataforma Google Maps.

Cotas e preços

Reveja a página de uso e faturamento para obter detalhes sobre as cotas e preços definidos para a API de Fuso Horário.

Políticas

O uso da API de Fuso Horário deve estar de acordo com as políticas da API.

Aprenda mais

Na API de Fuso Horário, você também pode definir um parâmetro de idioma para retornar resultados em outros idiomas que não o padrão do inglês. Veja o Guia do Desenvolvedor da API de Fuso Horário para mais exemplos e outros detalhes.