Descripción general de la API de Time Zone

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

Por qué usar la API de Time Zone

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 en un mapa. Por ejemplo, puedes mostrar los siguientes datos de zona horaria:

  • Son nombres de zonas horarias localizados para las ubicaciones de mapas de Google Maps Platform.
  • Desfases de zona horaria respecto de UTC y del horario de verano.

Los datos de zona horaria pueden ser especialmente útiles cuando desea que su sitio web o aplicación muestran datos basados en el tiempo que sean relevantes para tus usuarios.

Qué puedes hacer con la API de Time Zone

Con la API de Time Zone, puedes solicitar la zona horaria de ubicaciones en la superficie de la Tierra, con la diferencia de tiempo desde UTC y para el horario de verano para cada en esas ubicaciones.

Cómo funciona la API de Time Zone

La API de Time Zone acepta una solicitud HTTPS de coordenadas de latitud y longitud, la fecha y la hora deseadas como una marca de tiempo y, de manera opcional, un código de idioma. Muestra datos en el formato que se especifica en la solicitud. En el siguiente ejemplo, se muestra una solicitud de Nevada, EE.UU., con un resultado solicitado en JSON.

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

Recursos

En la siguiente tabla, se resumen los recursos disponibles a través de la API de Time Zone junto con los datos que muestra.

Recursos de datos Datos mostrados Formato de la devolución
Zona horaria

Tú proporcionas tu solicitud, junto con la ubicación y la marca de tiempo. Consulta obligatorio parámetros.

  • ID de zona horaria.
  • Nombre de la zona horaria, localizado de forma opcional
  • Desplazamiento respecto de UTC, en segundos
  • Diferencia horaria para el horario de verano, en segundos
  • Consulta Zona horaria para ver ejemplos de respuesta específicos.
  • JSON
  • XML

Cómo usar la API de Time Zone

1 Prepárate Para comenzar, configura tu Proyecto de Google Cloud y completa la configuración instrucciones que se detallan a continuación.
2 Cómo probar una solicitud de zona horaria Una vez que tengas una clave de API, podrás comenzar a probar la API de Time Zone directamente desde tu navegador. Consulta Ejemplos de zonas horarias en la guía Solicitudes y respuestas de zonas horarias para obtener más detalles.
3 Comprende los conceptos básicos de 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 la zona horaria en tu propia app. Puedes usar los datos de la zona horaria para mejorar las apps y los sitios web de los usuarios diferentes configuraciones regionales basadas en el tiempo.

Bibliotecas cliente disponibles

Llama a esta API en el idioma que elijas a través de 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. Descargarlas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra

¿Qué sigue?