![Descripción general de la API de Timezone](https://developers-dot-devsite-v2-prod.appspot.com/static/maps/images/landing/places-api_480.png?authuser=6&hl=es)
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 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:
- Nombres de zonas horarias localizados para las ubicaciones en el mapa de Google Maps Platform.
- Desfases de zona horaria con respecto a UTC y para el horario de verano
Los datos de zona horaria pueden ser particularmente útiles cuando quieres que tu sitio web o app muestre datos basados en el tiempo relevantes para los usuarios.
Qué puedes hacer con la API de Time Zone
Con la API de Time Zone, puedes solicitar la zona horaria para las ubicaciones sobre la superficie de la Tierra, con la diferencia horaria respecto 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 que se especifica en 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 ×tamp=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 devolución |
---|---|---|
Zona horaria
Debes proporcionar tu solicitud junto con la ubicación y la marca de tiempo. Consulta los parámetros obligatorios. |
|
|
Cómo usar la API de Time Zone
1 | Prepárate | Para comenzar, consulta Configura tu proyecto de Google Cloud y completa las instrucciones de configuración que se indican a continuación. |
2 | Probar una solicitud de zona horaria | Una vez que tengas una clave de API, puedes comenzar a probar la API de Time Zone directamente desde tu navegador. Para obtener más información, consulta los ejemplos de zona horaria en la guía Solicitudes y respuestas de zona horaria. |
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 la zona horaria para obtener más detalles. |
5 | Incorpora datos de zona horaria a tu propia app | Puedes usar los datos de zona horaria a fin de mejorar las apps y los sitios web para los usuarios de diferentes configuraciones regionales basadas en la hora. |
Bibliotecas cliente disponibles
Llama a esta API en el lenguaje que prefieras mediante una de las siguientes bibliotecas cliente:
- Cliente de Java para los servicios de Google Maps
- Cliente de Python para los servicios de Google Maps
- Cliente de Go para los servicios de Google Maps
- Cliente de Node.js para los servicios de Google Maps
Las bibliotecas cliente de Java, Python, Go y Node.js para los servicios de Google Maps son bibliotecas de código abierto basadas en la licencia Apache 2.0 que asisten a la comunidad. Descárgalos desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
Próximos pasos
- Obtén información para realizar solicitudes de zona horaria: Ve a Solicitudes y respuestas de zona horaria.
- Sigue las prácticas recomendadas: Consulta las Prácticas recomendadas para los servicios web.