Eso es todo.

Para comenzar a desarrollar, consulta nuestra documentación para desarrolladores.

Activar Google Maps Time Zone API

Para que puedas comenzar, te proporcionaremos orientación en la consola para desarrolladores de Google a fin de que hagas primero algunas acciones:

  1. Crear o seleccionar un proyecto
  2. Activar Google Maps Time Zone API
  3. Crear claves correspondientes
Continuar

Guía del desarrollador

Google Maps Time Zone API proporciona una interfaz sencilla para solicitar la zona horaria para una ubicación en la tierra, como también la diferencia de tiempo de esa ubicación con respecto a UTC.

Este documento está orientado a desarrolladores de sitios web y móviles que quieran incluir datos de hora en mapas proporcionados por una de las Google Maps API. Proporciona una introducción al uso de la API y material de referencia acerca de los parámetros disponibles.

Introducción

Google Maps Time Zone API proporciona datos de diferencia horaria para ubicaciones sobre la superficie de la tierra. Se solicita información sobre la zona horaria para una fecha y un par de latitud y longitud específicos. La API muestra el nombre de la zona horaria en cuestión, la diferencia horaria respecto de la zona UTC y la diferencia del período de ahorro de energía.

Puedes acceder a Google Maps Time Zone API a través de una interfaz HTTPS.

Antes de comenzar a realizar desarrollos con la Time Zone API, revisa los requisitos de autenticación (necesitas una clave de API) y los límites de uso de la API.

Solicitudes de zona horaria

Las solicitudes de Google Maps Time Zone API se construyen como una string de URL. La API muestra la zona horaria para un punto de la Tierra, especificada mediante un par de latitud y longitud. Ten en cuenta que los datos de zona horaria pueden no estar disponibles para ubicaciones que se encuentran sobre el agua, como océanos o mares.

Una solicitud de Google Maps Time Zone API debe respetar la siguiente forma:

https://maps.googleapis.com/maps/api/timezone/outputFormat?parameters

donde outputFormat puede ser cualquiera de los siguientes valores:

  • json (recomendado) indica el formato de salida en JavaScript Object Notation (JSON), o
  • xml, indica el formato de salida en XML, agrupado en un nodo <TimeZoneResponse>.

Importante: Debes enviar solicitudes a través de https, no de http.

Nota: Las URL deben estar correctamente codificadas para ser válidas y tienen una limitación de 8192 caracteres para todos los servicios web. Debes tener en cuenta este límite cuando construyas tus URL. Ten en cuenta que los diferentes navegadores, proxies y servidores también pueden tener límites de caracteres diferentes para las direcciones URL.

Parámetros de la solicitud

Como es norma en todas las direcciones URL, los parámetros se separan con el carácter de Y comercial (&). A continuación, se proporciona una lista de los parámetros y sus posibles valores.

Parámetros obligatorios

  • location: una tupla de latitud/longitud separada por comas (p. ej., location=-33.86,151.20), que representa la ubicación que se quiere buscar.
  • timestamp especifica la hora deseada en segundos a partir de la medianoche, UTC, del 1 de enero de 1970. Google Maps Time Zone API usa timestamp para determinar si se debe aplicar el horario de verano. Los horarios previos a 1970 pueden expresarse como valores negativos.
  • key: la clave de API de tu aplicación. Esta clave identifica tu aplicación a los fines de la administración de la cuota. Infórmate acerca de cómo obtener una clave.

    Nota: Los clientes de Google Maps APIs Premium Plan pueden usar una clave de API, o una firma digital y un ID de cliente válidos, en tus solicitudes de Time Zone. Obtén más información sobre parámetros de autenticación para clientes del Premium Plan.

Parámetros opcionales

  • language: el idioma en el que se devolverán los resultados. Consulta la lista de idiomas de dominio admitidos. Ten en cuenta que, a menudo, actualizamos los idiomas admitidos, por lo que es posible que esta lista no esté completa. El valor predeterminado es en.

Respuestas de zona horaria

Para cada solicitud válida, el servicio de zona horaria devolverá una respuesta en el formato indicado en la dirección URL de la solicitud. Cada respuesta contendrá los siguientes elementos:

  • dstOffset: la diferencia horaria para el horario de verano en segundos. Este valor será de cero si la zona horaria no se encuentra en horario de verano durante el timestamp especificado.
  • rawOffset: la diferencia horaria respecto de UTC (en segundos) para la ubicación determinada. Esto no considera los horarios de verano.
  • timeZoneId: una cadena que contiene el id. de "tz" de la zona horaria, como "Estados Unidos/Los_Angeles" o "Australia/Sídney". Esos id. se definen en la Base de datos de zonas horarias de IANA, que también está disponible en formato que admite búsqueda en la Lista de zonas horarias de la base de datos de tz en Wikipedia.
  • timeZoneName: una cadena que contiene el nombre en formato largo de la zona horaria. Este campo se localizará si está configurado el parámetro de idioma; p. ej., "Horario de verano del Pacífico" u "Horario de verano del este de Australia"
  • status: una cadena que indica el estado de la respuesta.
    • OK indica que la solicitud fue exitosa.
    • INVALID_REQUEST indica que el formato de la solicitud es incorrecto.
    • OVER_QUERY_LIMIT indica que el solicitante excedió su cuota.
    • REQUEST_DENIED indica que la API no completó la solicitud. Confirma que la solicitud se haya enviado a través de HTTPS en lugar de HTTP.
    • UNKNOWN_ERROR indica un error desconocido.
    • ZERO_RESULTS indica que no se encontraron datos de zona horaria para la ubicación o la hora especificados. Confirma que la solicitud se haya realizado para una ubicación sobre la superficie terrestre y no sobre el agua.
  • error_message: información más detallada sobre los motivos que subyacen a un código de estado determinado, si es diferente de OK.

    Nota: No se garantiza que este campo aparezca siempre, y su contenido está sujeto a modificaciones.

Cálculo de la hora local

La hora local de una ubicación determinada es la suma del parámetro timestamp y de los campos dstOffset y rawOffset del resultado.

Ejemplos de solicitudes

Esta sección incluye algunos ejemplos de consultas que demuestran funciones de la API.

La siguiente consulta realiza una solicitud de zona horaria para Nevada, EE. UU. La marca de tiempo está configurada en 8 de marzo de 2012.

JSON

Solicitud:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

Respuesta:

{
   "dstOffset" : 0,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Standard Time"
}
    
XML

Solicitud:

https://maps.googleapis.com/maps/api/timezone/xml?location=39.6034810,-119.6822510&timestamp=1331161200&key=YOUR_API_KEY

Respuesta:

<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>

La siguiente consulta realiza una solicitud de zona horaria para Nevada, EE. UU. La ubicación es la misma que en la solicitud anterior, pero la marca de tiempo está configurada en 15 de marzo de 2012. La respuesta ahora incluye una diferencia horaria para el horario de verano.

JSON

Solicitud:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331766000&key=YOUR_API_KEY

Respuesta:

{
   "dstOffset" : 3600,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Pacific Daylight Time"
}
    
XML

Solicitud:

https://maps.googleapis.com/maps/api/timezone/xml?location=39.6034810,-119.6822510&timestamp=1331766000&key=YOUR_API_KEY

Respuesta:

<TimeZoneResponse>
  <status>OK</status>
  <raw_offset>-28800.0000000</raw_offset>
  <dst_offset>3600.0000000</dst_offset>
  <time_zone_id>America/Los_Angeles</time_zone_id>
  <time_zone_name>Pacific Daylight Time</time_zone_name>
</TimeZoneResponse>

Este ejemplo es similar a los dos anteriores, pero establece un parámetro de idioma. La respuesta ahora se localizará para España.

JSON

Solicitud:

https://maps.googleapis.com/maps/api/timezone/json?location=39.6034810,-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY

Respuesta:

{
   "dstOffset" : 3600,
   "rawOffset" : -28800,
   "status" : "OK",
   "timeZoneId" : "America/Los_Angeles",
   "timeZoneName" : "Hora de verano del Pacífico"
}
    
XML

Solicitud:

https://maps.googleapis.com/maps/api/timezone/xml?location=39.6034810,-119.6822510&timestamp=1331766000&language=es&key=YOUR_API_KEY

Respuesta:

<TimeZoneResponse>
  <status>OK</status>
  <raw_offset>-28800.0000000</raw_offset>
  <dst_offset>3600.0000000</dst_offset>
  <time_zone_id>America/Los_Angeles</time_zone_id>
  <time_zone_name>Hora de verano del Pacífico</time_zone_name>
</TimeZoneResponse>

El parámetro sensor

Antes, la Google Maps API requería que incluyeras el parámetro sensor para indicar si tu aplicación usaba un sensor para determinar la ubicación del usuario. El uso de este parámetro ya no es obligatorio.

Enviar comentarios sobre...

Google Maps Time Zone API
Google Maps Time Zone API
Si necesitas ayuda, visita nuestra página de asistencia.