Pronto!

Para começar a desenvolver, acesse nossa documentação do desenvolvedor.

Ativar a Google Maps Time Zone API

Para começar, orientaremos você pelo Console do Desenvolvedor do Google para realizar algumas atividades:

  1. Criar ou selecionar um projeto
  2. Ativar a Google Maps Time Zone API
  3. Criar chaves apropriadas
Continuar

Primeiros passos

A Google Maps Time Zone API fornece dados de diferença de horários para áreas da superfície do planeta. Você solicita as informações de fuso horário para um par latitude/longitude e data específicos. A API retorna o nome do fuso horário, o deslocamento de tempo em relação ao UTC e o deslocamento do horário de verão.

Exemplo de solicitação e resposta

Você acessa a Google Maps Time Zone API por meio de uma interface HTTPS com solicitações criadas como uma string de URL, usando coordenadas de latitude/longitude para especificar location, um timestamp para especificar a data e a chave de API.

O exemplo a seguir solicita dados do 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

Esse exemplo pode ser testado inserindo o URL no navegador da Web (não deixe de substituir 'YOUR_API_KEY' pela chave de API real). A resposta inclui dados do fuso horário para o local e data (timestamp) especificados.

Consulte o guia do desenvolvedor para obter mais informações sobre a criação de URLs de solicitação e os parâmetros disponíveis, bem como sobre como interpretar a resposta.

Veja a seguir um exemplo de resposta em JSON:

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

Começar a codificar com nossas bibliotecas cliente

As bibliotecas cliente facilitam o desenvolvimento com as Web Service APIs do Google Maps, oferecendo implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e novas tentativas automáticas. A Google Maps Time Zone API está disponível nos clientes Java Client, Python Client, Go Client e Node.js Client for Google Maps Services.

Autenticação, cotas e políticas

Ativar a API e obter uma chave de API

Para usar a Google Maps Time Zone API, você deve antes ativar a API no Google API Console e obter as credenciais de autenticação adequadas. Você precisa informar uma chave de API em cada solicitação (ou um ID do cliente se tiver um Plano premium).

Clique no botão a seguir para continuar em um processo onde você poderá:

  1. Criar ou selecionar um projeto
  2. Ativar a API
  3. Obter uma chave de API
Obter uma chave

Saiba mais sobre a autenticação de credenciais.

Cotas

Consulte a página de limites de uso para obter detalhes sobre as cotas definidas para a Google Maps Time Zone API.

Políticas

O uso da Google Maps Time Zone API deve estar de acordo com as políticas de APIs.

Saiba mais

Na Time Zone API, você também pode definir um parâmetro de idioma para retornar resultados em idiomas diferentes do inglês (padrão). Consulte o guia do desenvolvedor da Time Zone API para obter mais exemplos e outros detalhes.

Enviar comentários sobre…

Google Maps Time Zone API
Google Maps Time Zone API
Precisa de ajuda? Acesse nossa página de suporte.