get_all_rounds
Para obtener información sobre las rutinas durante un intervalo de tiempo especificado, utilice el método route/get_all_rounds:
svc=route/get_all_rounds
params={
"itemId": <long>,
"timeFrom": <uint>,
"timeTo": <uint>,
"fullJson": <uint>
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
| itemId | ID de la ruta. |
| timeFrom | Inicio del intervalo. |
| timeTo | Fin del intervalo. |
| fullJson | Formato de la respuesta. Pase 1 para obtener información detallada, o 0 para obtener información básica. |
Respuesta
Si la solicitud se completa con éxito, la respuesta contiene información básica o detallada sobre las rutinas, según el valor del parámetro fullJson.
Una respuesta con información básica se devuelve en el siguiente formato:
{
"actual": [ /* Rutinas con los estados "en curso" y "finalizada". */
{
...
}
],
"history": [ /* Rutinas con el estado "historial". */
{
...
}
],
"virtual": [ /* Rutinas con el estado "estimada". */
{
"time": <uint>, /* Inicio de la rutina. */
"schedule": {
"id": <long>, /* ID del horario. */
"n": <text>, /* Nombre del horario. */
"f": <uint>, /* Tipo. */
"tz": <uint>, /* Zona horaria. */
"cfg": { /* Configuración personalizada. Se pasa desde el objeto de horario sin cambios. */
"autoName": <uint>, /* Generar nombres de rutinas automáticamente: 0 = no, 1 = sí. */
"enabled": 1, /* Creación automática de rutinas: 1 = habilitar, 0 = deshabilitar. */
"name": <text>, /* Nombre de la rutina. */
"description":<text>, /* Descripción. */
"roundFlags": <uint>, /* Flags de la rutina. */
"units": [<long>], /* Array de ID de unidades. */
"validityPeriod": <uint> /* Periodo de validez. */
},
"tm": [ /* Tiempo de paso por los puntos de control. */
{
"at": <uint>, /* Hora de llegada. */
"ad": <uint>, /* Desviación respecto a la hora de llegada. */
"dt": <uint>, /* Hora de salida. */
"dd": <uint> /* Desviación respecto a la hora de salida. */
}
],
"sch": {
"f1": <uint>, /* Inicio del intervalo 1. */
"f2": <uint>, /* Inicio del intervalo 2. */
"t1": <uint>, /* Fin del intervalo 1. */
"t2": <uint>, /* Fin del intervalo 2. */
"m": <uint>, /* Máscara de días del mes. */
"y": <uint>, /* Máscara de meses. */
"w": <uint> /* Máscara de días de la semana. */
}
}
}
]
}
El formato de los arrays actual y history es similar al descrito en la página load_rounds (información básica).
Los tipos de horario se describen en la página update_schedule.
Una respuesta con información detallada es similar a la que contiene información básica, excepto que el formato de los elementos en los arrays actual y history es el mismo que el descrito en la página get_round_data.