![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=4&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 la hora
datos de zona para la ubicación, incluidas las compensaciones para la UTC y el horario de verano
tiempo.
Por qué usar la API de Time Zone
Con la API de Time Zone, puedes desarrollar aplicaciones que brinden el ID y el nombre de la zona horaria para las fechas y horas de ubicaciones específicas en un mapa. Por ejemplo, puedes mostrar lo siguiente datos de zona horaria:
- Nombres de zonas horarias localizados para ubicaciones en mapas de Google Maps Platform
- La zona horaria se diferencia de UTC y para el 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 latitud/longitud coordenadas, la fecha y hora deseadas como una marca de tiempo y, opcionalmente, 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 ×tamp=1331161200 &key=YOUR_API_KEY
Recursos
En la siguiente tabla, se resumen los recursos disponibles mediante las Time Zone API junto con los datos que muestra.
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 obligatorio parámetros. |
|
|
Cómo usar la API de Time Zone
1 | Preparación | Para comenzar, configura tu Proyecto de Google Cloud y completa la configuración instrucciones que se detallan 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 Time Zone directamente desde tu navegador. Consulta los ejemplos de zona horaria. en la guía Solicitudes y respuestas de la 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 aplicación o sitio web. Consulta las Respuestas de zona horaria. para conocer los 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 lenguaje de que elijas mediante una de las siguientes bibliotecas cliente:
- Java Cliente de los servicios de Google Maps
- Python Cliente de los servicios de Google Maps
- Cliente Go para los servicios de Google Maps
- Node.js Cliente de los servicios de Google Maps
Los clientes de Java, Python, Go y Node.js para Google Maps Los servicios son bibliotecas cliente con asistencia de la comunidad, de código abierto en el Licencia 2.0 de Apache. Descárgalas desde GitHub, donde también encontrarás instrucciones de instalación y código de muestra.
¿Qué sigue?
- Obtén información para realizar solicitudes de zona horaria: Ve a Solicitudes y respuestas de zonas horarias.
- Sigue las prácticas recomendadas: Ve a Prácticas recomendadas para servicios web.