get_trips
Para obtener información sobre los viajes de un período determinado, cargue los mensajes de la unidad y ejecute el método unit/get_trips.
Endpoint
svc=unit/get_trips¶ms={
"itemId": <long>,
"msgsSource": <text>,
"timeFrom": <uint>,
"timeTo": <uint>
}
El método es una solicitud que consume muchos recursos, por lo que se le aplica la restricción de solicitudes simultáneas de este tipo durante una sesión. Si se alcanza la restricción, se devuelve el error 1003 con la causa
LIMIT api_concurrent. Para ver la lista de solicitudes que consumen muchos recursos, consulte Restricciones.
Parámetros
| Parámetro | Descripción |
|---|---|
itemId |
ID de la unidad. |
timeFrom |
Inicio del intervalo. |
timeTo |
Fin del intervalo. |
msgsSource |
Nombre de la capa de mensajes (solo está disponible una capa). Indique 1 para utilizar el cargador de mensajes. |
Respuesta
Si la solicitud se completa correctamente, la respuesta contiene información sobre los viajes.
[
{
"from": { /* Punto de inicio del viaje */
"i": <uint>, /* Índice del mensaje */
"t": <uint>, /* Hora */
"p": { /* Ubicación */
"y": <double>, /* Latitud */
"x": <double> /* Longitud */
}
},
"to": { /* Punto final del viaje */
"i": <uint>, /* Índice del mensaje */
"t": <uint>, /* Hora */
"p": { /* Ubicación */
"y": <double>, /* Latitud */
"x": <double> /* Longitud */
}
},
"m": <double> /* Kilometraje (metros) */
}
]
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | ID de elemento o formato de entrada incorrecto. |
| 6 | No se pudieron obtener los mensajes de la unidad. |
| 7 | El usuario no tiene el derecho de acceso Solicitar informes y mensajes a la unidad. |