La API de zonas horarias proporciona datos de desfase horario para ubicaciones en la superficie de la tierra. Solicita la información de la zona horaria para un par de latitud/longitud y una fecha específicos. La API devuelve el nombre de esa zona horaria, el desfase horario con respecto a UTC y el desfase por ahorro de luz diurna.

Muestra de solicitud y respuesta

Acceda a la API de zona horaria a través de una interfaz HTTPS, con solicitudes construidas como una cadena de URL, utilizando las coordenadas de latitud/longitud para especificar el location, un timestamp para especificar la fecha y su clave de API.

El siguiente ejemplo solicita los datos de la zona horaria de Washington, DC, Estados Unidos, el 15 de marzo de 2016, en formato JSON:

https://maps.googleapis.com/maps/api/timezone/json?location=38.908133,-77.047119&timestamp=1458000000&key=YOUR_API_KEY

Puede probarlo introduciendo la URL en su navegador web (asegúrese de sustituir YOUR_API_KEY por su clave API real). La respuesta incluye los datos de la zona horaria para la ubicación y la fecha especificadas (timestamp).

Vea la guía del desarrollador para obtener más información sobre la construcción de las URL de solicitud y los parámetros disponibles y la comprensión de la respuesta.

A continuación se muestra un ejemplo de respuesta, en JSON:

{ "dstOffset" : 3600, "rawOffset" : -18000, "status" : "OK", "timeZoneId" : "America/New_York", "timeZoneName" : "Eastern Daylight Time"}

Comienza a codificar con nuestras bibliotecas de clientes

Las bibliotecas de clientes facilitan el desarrollo con las API de servicios web de Google Maps al proporcionar implementaciones nativas y sencillas de tareas comunes como la autenticación, la limitación de solicitudes y el reintento automático. La API de zona horaria está disponible en el cliente Java, el cliente Python, el cliente Go y el cliente Node.js para los servicios de Google Maps.

Autenticación, cuotas, precios y políticas

Autenticación

Para utilizar la API de zonas horarias, primero debes habilitar la API y obtener las credenciales de autenticación adecuadas. Para obtener más información, consulta Introducción a Google Maps Platform.

Cuotas y precios

Revisa la página de uso y facturación para obtener detalles sobre las cuotas y los precios establecidos para la API de zonas horarias.

Políticas

El uso de la API de la zona horaria debe estar de acuerdo con las políticas de la API.

Aprenda más

En la API de la zona horaria, también puede establecer un parámetro de idioma para devolver resultados en idiomas distintos del predeterminado, el inglés. Consulte la Guía del desarrollador de la API de zona horaria para obtener más ejemplos y otros detalles.