La API de Time Zone proporciona datos de compensación horaria para ubicaciones en la superficie de la 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 respecto de UTC y horario de verano.
Ejemplo de solicitud y respuesta
Acceder a la API de Time Zone a través de una interfaz HTTPS, con
construidas como una cadena de URL, usando coordenadas de latitud y longitud para
especifica la location
, una 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 está configurada para el 8 de marzo de 2012.
URL
https://maps.googleapis.com/maps/api/timezone/json ?location=39.6034810%2C-119.6822510 ×tamp=1331161200 &key=YOUR_API_KEY
cURL
curl -L -X GET 'https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810%2C-119.6822510×tamp=1331161200&key=YOUR_API_KEY'
Para probar esto, 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 la zona horaria de la ubicación y la fecha especificadas
(timestamp)
Consulta la guía para desarrolladores para obtener más información Creación de URLs de solicitud y parámetros disponibles y 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 API de Google Maps para servicio web al proporcionar implementaciones nativas de tareas comunes, como la autenticación, y el reintento automático. La API de Time Zone está disponible en la Java Client, Python, Go y 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 habilitar la API y obtener los permisos credenciales de autenticación. Para obtener más información, consulta Comienza a utilizar Google Maps Platform.
Cuotas y precios
Revisa la página 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 las APIs
Más información
En la API de Time Zone, también puedes establecer un parámetro de idioma para que se muestren resultados de otros idiomas además del inglés predeterminado. Consulta la API de Time Zone Guía para desarrolladores donde se detallan más ejemplos y otros detalles.
El La guía para desarrolladores sobre la API de Time Zone está diseñada para sitios web y dispositivos móviles. desarrolladores que desean incluir datos de tiempo en mapas proporcionados por una de las plataformas de Google Maps Platform APIs Proporciona una introducción al uso de la API y material de referencia en los parámetros.