Comenzar

La API de Time Zone proporciona los datos de compensación horaria para ubicaciones sobre la superficie de la Tierra. Solicita la información de la zona horaria para una fecha y un par de latitud y longitud específicos. La API muestra el nombre de esa zona horaria, la diferencia horaria respecto de la zona UTC y la diferencia horaria respecto del horario de verano.

Ejemplo de solicitud y respuesta

Accede a la API de Time Zone a través de una interfaz HTTPS, con solicitudes construidas como una string de URL, mediante coordenadas de latitud y longitud para especificar location, un timestamp para especificar la fecha y tu clave de API.

La siguiente consulta realiza una solicitud de zona horaria para Nevada, EE. UU. La marca de tiempo está configurada en 8 de marzo 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

Comienza a usarlo

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))
}

Postman

La especificación de OpenAPI también está disponible como una colección de Postman.

Ejecutar en Postman

Para probar esto, ingresa la URL en tu navegador web (asegúrate de reemplazar YOUR_API_KEY por tu clave de API real). La respuesta incluye los datos de la zona horaria para la ubicación y la fecha especificadas (timestamp).

Consulta la guía para desarrolladores a fin de obtener más información sobre cómo compilar las URL de solicitud y los parámetros disponibles, y cómo comprender la respuesta.

A continuación, se muestra un ejemplo de respuesta, en 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>

Comienza a realizar codificaciones con nuestras bibliotecas de cliente

Las bibliotecas cliente facilitan el desarrollo con las API del servicio web de Google Maps, ya que proporcionan implementaciones nativas simples de tareas comunes, como la autenticación, la limitación de solicitudes y los reintentos automáticos. La API de Time Zone está disponible en el cliente Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps.

Autenticación, cuotas, precios y políticas

Autenticación

Para usar la API de Time Zone, primero debes habilitarla y obtener las credenciales de autenticación adecuadas. Para obtener más información, consulta Cómo comenzar a utilizar Google Maps Platform.

Cuotas y precios

Revisa la página sobre uso y facturación para obtener detalles sobre las cuotas y los precios establecidos para la API de Time Zone.

Políticas

El uso de la API de Time Zone debe cumplir con las políticas de API.

Más información

En la API de Time Zone, también puedes configurar un parámetro de idioma para que se muestren resultados de otros idiomas además del inglés predeterminado. Consulta la Guía para desarrolladores de la API de Time Zone a fin de obtener más ejemplos y otros detalles.

La Guía para desarrolladores de la API de Time Zone está dirigida a desarrolladores de sitios web y dispositivos móviles que deseen incluir datos de hora en los mapas proporcionados por una de las API de Google Maps Platform. Proporciona una introducción al uso de la API y material de referencia sobre los parámetros disponibles.