Começar

A API Time Zone fornece dados de ajuste de horário para locais na superfície da Terra. Solicite as informações de fuso horário para um par de latitude/longitude e data específicos. A API retorna o nome desse fuso horário, o intervalo de tempo em UTC e o horário de verão.

Exemplo de solicitação e resposta

Acesse a API Time Zone 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 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 como 8 de março de 2012.

URL

https://maps.googleapis.com/maps/api/timezone/json
  ?location=39.6034810%2C-119.6822510
  &timestamp=1331161200
  &key=YOUR_API_KEY

cURL

curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY'

JavaScript

var axios = require('axios');

var config = {
  method: 'get',
  url: 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY',
  headers: { }
};

axios(config)
.then(function (response) {
  console.log(JSON.stringify(response.data));
})
.catch(function (error) {
  console.log(error);
});

Python

import requests

url = "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"

payload={}
headers = {}

response = requests.request("GET", url, headers=headers, data=payload)

print(response.text)

Java

OkHttpClient client = new OkHttpClient().newBuilder()
  .build();
MediaType mediaType = MediaType.parse("text/plain");
RequestBody body = RequestBody.create(mediaType, "");
Request request = new Request.Builder()
  .url("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")
  .method("GET", body)
  .build();
Response response = client.newCall(request).execute();

Ruby

require "uri"
require "net/http"

url = URI("https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510&timestamp=1331161200&key=YOUR_API_KEY")

https = Net::HTTP.new(url.host, url.port)
https.use_ssl = true

request = Net::HTTP::Get.new(url)

response = https.request(request)
puts response.read_body

Go

package main

import (
  "fmt"
  "net/http"
  "io/ioutil"
)

func main() {

  url := "https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY"
  method := "GET"

  client := &http.Client {
  }
  req, err := http.NewRequest(method, url, nil)

  if err != nil {
    fmt.Println(err)
    return
  }
  res, err := client.Do(req)
  if err != nil {
    fmt.Println(err)
    return
  }
  defer res.Body.Close()

  body, err := ioutil.ReadAll(res.Body)
  if err != nil {
    fmt.Println(err)
    return
  }
  fmt.Println(string(body))
}

Correio

A especificação da OpenAPI também está disponível como uma coleção Postman.

Executar no Postman

Para testar isso, insira o URL no seu navegador da Web. Lembre-se 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 do desenvolvedor para mais informações sobre como criar URLs de solicitação e parâmetros disponíveis e como 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 APIs de serviços da Web do Google Maps ao oferecer implementações simples e nativas de tarefas comuns, como autenticação, limitação de solicitações e nova tentativa automática. A API Time Zone está disponível nos clientes Java, Python, Go e Node.js dos serviços do Google Maps.

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

Autenticação

Para usar a API Time Zone, ative a API e consiga as credenciais de autenticação adequadas. Para mais detalhes, consulte o artigo Como começar a usar a Plataforma Google Maps.

Cotas e preços

Consulte 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 as políticas da API.

Saiba mais

Na API Time Zone, também é possível definir um parâmetro de idioma para retornar resultados em idiomas diferentes do padrão inglês. Consulte o Guia do desenvolvedor da API Time Zone para mais exemplos e outros detalhes.

O Guia para desenvolvedores da API Time Zone é destinado a desenvolvedores de sites e dispositivos móveis que querem incluir dados de tempo em mapas fornecidos por uma das APIs da Plataforma Google Maps. Ele fornece uma introdução ao uso da API e a materiais de referência sobre os parâmetros disponíveis.