La API de Time Zone 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 y longitud y una fecha específicos. La API devuelve el nombre de esa zona horaria, la diferencia horaria con respecto al UTC y la diferencia del horario de verano.
Ejemplo de solicitud y respuesta
Accede a la API de Time Zone a través de una interfaz HTTPS, con solicitudes construidas como una cadena de URL, que usa coordenadas de latitud y longitud para especificar el location, un timestamp para especificar la fecha y tu clave de API.
La siguiente consulta realiza una solicitud de zona horaria para Nevada, EE. UU. La marca de tiempo se establece en el 8 de marzo de 2012.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1733428634 &key=YOUR_API_KEY
curl
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1733428634&key=YOUR_API_KEY'
Para probarlo, ingresa la URL en tu navegador web (asegúrate de reemplazar YOUR_API_KEY por tu clave de API real).
La respuesta incluye los datos de zona horaria para la ubicación y la fecha especificadas (timestamp).
Consulta la guía para desarrolladores para obtener más información sobre cómo compilar URLs de solicitud y los parámetros disponibles y cómo comprender la respuesta.
A continuación, se muestra un ejemplo de respuesta, en JSON:
JSON
{ "dstOffset": 0, "rawOffset": -28800, "status": "OK", "timeZoneId": "America/Los_Angeles", "timeZoneName": "Pacific Standard Time", }
XML
<TimeZoneResponse> <status>OK</status> <raw_offset>-28800.0000000</raw_offset> <dst_offset>0.0000000</dst_offset> <time_zone_id>America/Los_Angeles</time_zone_id> <time_zone_name>Pacific Standard Time</time_zone_name> </TimeZoneResponse>
Comienza a realizar codificaciones con nuestras bibliotecas de cliente
Las bibliotecas cliente facilitan el desarrollo con las APIs de los servicios web de Google Maps, ya que proporcionan implementaciones nativas y sencillas de tareas comunes, como la autenticación, la limitación de solicitudes y el reintento automático. La API de Time Zone está disponible en el cliente de Java, el cliente de Python, el cliente de Go y el cliente de Node.js para los servicios de Google Maps.
Autenticación, cuotas, precios y políticas
Autenticación
Para usar la API de Time Zone, primero debes habilitarla y obtener las credenciales de autenticación adecuadas. Para obtener más información, consulta Cómo comenzar a utilizar 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 Time Zone.
Políticas
El uso de la API de Time Zone debe cumplir con las políticas de la API.
Más información
En la API de Time Zone, también puedes establecer un parámetro de idioma para devolver resultados en idiomas distintos del inglés predeterminado. Consulta la guía para desarrolladores de la API de Time Zone para obtener más ejemplos y otros detalles.
La Guía para desarrolladores de la API de Time Zone está destinada a los desarrolladores de sitios web y aplicaciones para dispositivos móviles que desean incluir datos de hora en los mapas proporcionados por una de las APIs de Google Maps Platform. Proporciona una introducción al uso de la API y material de referencia sobre los parámetros disponibles.