Historial (dailyhistory)

Esta llamada REST permite:

  • Obtener el historial de posiciones de un dispositivo, para un día determinado.

Url

http://dts.location-world.com/api/fleet/dailyhistory

Parámetros

Token
(requerido)
Es el identificador único del cliente.Valor de ejemplo:
AAAAA7916A9DAAAAA184192A9C3AAAAA
Imei
(requerido)
Es el identificador único del dispositivo.Valor de ejemplo:
860599000219964
Year
(requerido)
Es el año a ser consultado.Valor de ejemplo:
2016
Month
(requerido)
Es el mes a ser consultado.Valor de ejemplo:
8
Day
(requerido)
Es el día a ser consultado.Valor de ejemplo:
31
time_zone_offset
(requerido)
Es el huso horario con el cual se desea consultar la información. Los valores pueden ser en el rango desde -12 a 12Valor de ejemplo:
-5
culture
(requerido)
Es el idioma en el cual se desean recibir los valores de la respuesta del servicio

Los valores permitidos son:
Español = es
Inglés = en
Portugués = pt
Valor de ejemplo:
es

Consulta de ejemplo:

http://dts.location-world.com/api/fleet/dailyhistory?token=AAAAA7916A9DAAAAA184192A9C3AAAAA&imei=860599000219964&year=2016&month=8&day=31&timezoneoffset=-5&culture=es

Respuesta

Respuesta de ejemplo:

{  
   "0":[  
      {  
         "date":"2016-08-31",
         "time":"00:04:31",
         "latitude":-0.195263,
         "longitude":-78.48505,
         "address":"Mariano Aguilera y La Pradera, Quito",
         "speed":0,
         "mileage":50394.1,
         "temperature_1":23.25,
         "temperature_2":null,
         "temperature_3":null,
         "temperature_4":null,
         "internal_battery_level":100,
         "is_exception":false,
         "alert_message":null,
         "zone":""
      },
        {  
         "date":"2016-08-31",
         "time":"07:45:00",
         "latitude":-0.20719,
         "longitude":-78.48188,
         "address":"Av. La Coruna y Francisco Salazar, Quito",
         "speed":7.2,
         "mileage":50395.7,
         "temperature_1":18.5,
         "temperature_2":null,
         "temperature_3":null,
         "temperature_4":null,
         "internal_battery_level":100,
         "is_exception":true,
         "alert_message":"El dispositivo Sandero-AZ salió de Location World",
         "zone":"Location World"
      },
      {  
         "date":"2016-08-31",
         "time":"07:45:22",
         "latitude":-0.207218,
         "longitude":-78.4818649,
         "address":"Av. La Coruna y Francisco Salazar, Quito",
         "speed":0,
         "mileage":50395.7,
         "temperature_1":18.5,
         "temperature_2":null,
         "temperature_3":null,
         "temperature_4":null,
         "internal_battery_level":100,
         "is_exception":false,
         "alert_message":null,
         "zone":""
      } 
     ]
  }

La respuesta está formada por 1 arreglo que corresponde a lo siguiente:

  • Arreglo [0] (primer arreglo): Contiene todas las posiciones generadas por el dispositivo en la fecha solicitada.
  • Cada ítem dentro del primer arreglo es un resultado de la búsqueda solicitada.

Arreglo [0]: Permite consultar todas las posiciones generadas en la fecha solicitada.

Los atributos que contiene cada elemento se describen a continuación:

AtributoDescripción
dateFecha de generación de la posición
timeHora de generación de la posición
latitudeLatitud
longitudeLongitud
addressDirección dónde ocurrió la posición
speedVelocidad reportada por el dispositivo al momento de generación del mensaje (Km/h)
mileageOdómetro del vehículo (Kilómetros)
temperature_1Temperatura del sensor 1 (ºC)
temperature_2Temperatura del sensor 2 (ºC)
temperature_3Temperatura del sensor 3 (ºC)
temperature_4Temperatura del sensor 4 (ºC)
internal_battery_levelNivel de la batería de respaldo (%)
is_exceptionIndica si el mensaje generó una alerta
alert_messageMensaje de la alerta generada, en texto
zoneNombre de la zona dónde se generó la alerta
Facebook Comments

Was this article helpful?

Articulos relacionados

Leave A Comment?

You must be logged in to post a comment.