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 deseadas. Muestra los datos de zona horaria de la ubicación, incluidas las compensaciones de 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 de un mapa. Por ejemplo, puedes mostrar los siguientes datos de zona horaria:

  • Nombres localizados de las zonas horarias de las ubicaciones en el mapa de Google Maps Platform.
  • Desfases de zona horaria de UTC y para el horario de verano.

Los datos de zona horaria pueden ser particularmente útiles cuando deseas que tu sitio web o app muestren datos temporales 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 las ubicaciones sobre la superficie de la Tierra, con la diferencia de tiempo de UTC y el horario de verano para cada una de 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 marca de tiempo y, de forma opcional, un código de idioma. Muestra 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=1331161200
    &key=YOUR_API_KEY

Recursos

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

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

Proporcionas tu solicitud junto con la ubicación y la marca de tiempo. Consulta los parámetros requeridos.

  • ID de zona horaria.
  • Nombre de zona horaria (opcional localizado)
  • Desplazamiento de UTC, en segundos
  • Desplazamiento para DST, en segundos
  • Consulta la zona horaria para ver ejemplos de respuestas específicas.
  • JSON
  • XML

Cómo usar la API de Time Zone

1 Configuración Comienza con Configura tu proyecto de Google Cloud y completa las siguientes instrucciones de configuración.
2 Cómo probar una solicitud de zona horaria Una vez que tengas una clave de API, podrás comenzar a probarla directamente desde tu navegador. Consulta los ejemplos de zona horaria en la guía Solicitudes y respuestas de zona horaria para obtener más detalles.
3 Comprende los conceptos básicos de las respuestas Explora cómo usar los datos de la zona horaria en tu app o sitio web. Consulta Respuestas de zona horaria para obtener más detalles.
5 Incorpora datos de zona horaria en tu propia app Puedes usar los datos de zona horaria a fin de mejorar las apps y los sitios web para usuarios de diferentes configuraciones regionales basadas en la hora.

Bibliotecas cliente disponibles

Llama a esta API en el lenguaje 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 cliente compatibles con la comunidad y de código abierto bajo la licencia Apache 2.0. Descárgalas de GitHub, donde también encontrarás instrucciones de instalación y código de muestra.

Próximos pasos