Comenzar

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

Ejemplo de solicitud y respuesta

Accede a la API de zona horaria a través de una interfaz HTTPS, con solicitudes construidas como una cadena de URL, usando coordenadas de latitud y longitud para especificar la location, una 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 se establece en el 8 de marzo de 2012.

URL

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

curl

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

Para probar esta solicitud, 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).

Para obtener más información sobre cómo crear URLs de solicitud y los parámetros disponibles y cómo interpretar la respuesta, consulta la guía para desarrolladores.

En el siguiente ejemplo, se muestra una 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 programar con las bibliotecas cliente

Las bibliotecas cliente simplifican el desarrollo con las APIs de servicios web de Google Maps, ya que proporcionan implementaciones integradas y directas de tareas comunes, como la autenticación, la limitación de solicitudes y el reintento automático. La API de zona horaria está disponible en los clientes de Java, Python, Go y Node.js para los servicios de Google Maps.

Autenticación, cuotas, precios y políticas

Autenticación

Para usar la API de zona horaria, 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

Para obtener detalles sobre las cuotas y los precios establecidos para la API de zona horaria, consulta Uso y facturación.

Políticas

El uso de la API de zona horaria debe cumplir con las políticas de la API.

Más información

En la API de zona horaria, también puedes establecer un parámetro de idioma para devolver resultados en idiomas que no sean el inglés predeterminado. Consulta la guía para desarrolladores de la API de zona horaria para obtener más ejemplos y otros detalles.

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