Descripción general de la API de Time Zone

La API de zona horaria es un servicio que acepta una solicitud HTTP de coordenadas de latitud y longitud, y una fecha y hora elegidas. Devuelve los datos de la zona horaria de la ubicación, incluidas las diferencias con UTC y el horario de verano.

Por qué usar la API de zona horaria

Con la API de Time Zone, puedes desarrollar aplicaciones que proporcionen el ID y el nombre de la zona horaria para fechas y horas en ubicaciones específicas de un mapa. Por ejemplo, puedes mostrar los siguientes datos de zona horaria:

  • Nombres de zonas horarias localizados para ubicaciones de mapas de Google Maps Platform
  • Desfases de zona horaria con respecto a UTC y para el horario de verano.

Los datos de zona horaria son especialmente útiles cuando quieres que tu sitio web o app muestre datos basados en el tiempo que sean relevantes para las personas que usan tu aplicación.

Qué puedes hacer con la API de zona horaria

Con la API de Time Zone, puedes solicitar la zona horaria de ubicaciones en la superficie de la Tierra, con la compensación de tiempo respecto de la hora UTC y el horario de verano para cada una de esas ubicaciones.

Cómo funciona la API de zona horaria

La API de zona horaria acepta una solicitud HTTPS de coordenadas de latitud y longitud, la fecha y hora seleccionadas como marca de tiempo y, de forma opcional, un código de idioma. Devuelve los datos en el formato especificado por la solicitud. En el siguiente ejemplo, se muestra una solicitud para Nevada, EE.UU., con un resultado solicitado en JSON:

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

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de zona horaria, junto con los datos que devuelve:

Recursos de datos Datos devueltos Formato de devolución
Zona horaria

Proporcionas tu solicitud junto con la ubicación y la marca de tiempo. Consulta los parámetros obligatorios.
  • ID de la zona horaria.
  • Nombre de la zona horaria, localizado de forma opcional.
  • Es la diferencia con respecto a la hora UTC, en segundos.
  • Es la diferencia con respecto al horario de verano, en segundos.
  • Consulta Zona horaria para ver ejemplos de respuestas específicas.
  • JSON
  • XML

Cómo usar la API de zona horaria

1 Inicia la configuración Comienza con Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación.
2 Prueba una solicitud de zona horaria Una vez que tengas una clave de API, podrás comenzar a probar la API de zona horaria directamente desde tu navegador. Consulta los ejemplos de zonas horarias en la guía Solicitudes y respuestas de la API de Time Zone para obtener más detalles.
3 Información básica sobre las respuestas Explora cómo usar los datos de zona horaria en tu app o sitio web. Consulta Respuestas de zona horaria para obtener más detalles.
5 Incorpora datos de zonas horarias en tu propia app. Puedes usar los datos de zona horaria para mejorar las apps y los sitios web en diferentes configuraciones regionales basadas en el tiempo.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje que prefieras con una de las siguientes bibliotecas cliente:

Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas de código abierto según la licencia Apache 2.0 que cuentan con asistencia de la comunidad. Descárgalas de GitHub, donde también puedes encontrar instrucciones de instalación y código de muestra.

¿Qué sigue?