API: Temperature
M: Listar lecturas de temperatura
Límite de Tasa de Peticiones
Máximo de 20 peticiones por IP en 5 minutos
HTTP GET:
https://<hostname>/api/temperature
URL PARAMETERS:
Nombre | Tipo | Requerido | Descripción | |
---|---|---|---|---|
date |
Fecha | Texto | sí | Fecha en formato YYYY-MM-DD |
start_time |
Hora de inicio | Texto | sí | Hora en formato HH:MM:SS |
end_time |
Hora de fin | Texto | sí | Hora en formato HH:MM:SS |
unit_of_measure |
Unidad de medida | Texto | sí | "C" o "F" |
temp_min |
Temperatura mínima | Número | no | -9999 por defecto. |
temp_max |
Temperatura máxima | Número | no | 9999 por defecto. |
vehicle_ids |
Lista de vehículos | Lista de números | no | Listado de ids de vehículos separados por coma. Todos por defecto. |
OUTPUT:
Json con los campos:
success
:boolean
timezone
:string
identificador TZdata
: lista de Temperature Data Object
EJEMPLO CON CURL:
$ curl -u <api_key>:<password>
-X GET
https://<hostname>/api/temperature?vehicle_ids=199&date=2019-03-15&start_time=00:00&end_time=23:59&unit_of_measure=C
RESPUESTA:
{
"success": true,
"timezone": "America/Guatemala",
"data": [
{
"vehicle_id": 199,
"sensor_id": 56,
"place": "La Esquina",
"event": "respuesta a comando de rastreo",
"lat": "14.621393",
"lon": "-90.513953",
"temperature": 42.1,
"datetime_iso": "2019-03-15T12:00:35-06:00",
},
{
"vehicle_id": 199,
"sensor_id": 56,
"place": "La Esquina",
"event": "fuente de poder desconectada",
"lat": "14.621393",
"lon": "-90.513953",
"temperature": 43.2,
"datetime_iso": "2019-03-15T12:01:35-06:00",
},
]
}
O: Temperature Data Object
Cada objeto de lectura de temperatura tiene estos campos:
Campo | Tipo | Descripción |
---|---|---|
vehicle_id |
Número | Id del vehículo. |
sensor_id |
Número | Id del sensor que mandó la lectura. |
event |
Texto | Nombre del evento cuando se hizo la lectura. |
place |
Texto | Lugar en que se hizo la lectura. |
lat |
Texto | Latitud. |
lon |
Texto | Longitud. |
temperature |
Número | Valor de la lectura de temperatura. |
datetime_iso |
Fecha y hora en formato ISO | Fecha y hora. |