To get detailed round information, use the commandĀ route/get_round_data:
svc=route/get_round_data¶ms={"itemId":<long>,
"col":[<long>]}
Parameters
Name |
Description |
itemId |
route ID |
col |
array of rounds IDs |
Response
[
{
"id":<long>, /* round ID */
"n":<text>, /* name */
"d":<text>, /* description */
"tz":<uint>, /* timezone */
"u":<long>, /* unit appointed to this round: if not specified - first unit of "cu" array which goes out from the first check point */
"cu":[<long>], /* array of unit IDs */
"pt":[ /* check points */
{
"n":<text>, /* name */
"f":<uint>, /* type */
"u":<long>, /* unit ID, 0 - if check point not of the type: check point from unit */
"y":<double>, /* latitude */
"x":<double>, /* longitude */
"r":<uint> /* radius */
}
],
"sh":{ /* schedule */
"id":<long>, /* ID */
"n":<text>, /* name */
"f":<uint>, /* type */
"tz":<uint>, /* timezone */
"cfg":{ /* custom configuration (example) */
"enabled":<byte>, /* auto create rounds for current schedule: 1 - enable, 0 - disable */
"name":<text>, /* name */
"roundFlags":<uint>, /* round flags (see below) */
"units":[<long>], /* array of units IDs */
"validityPeriod":<uint> /* validity period */
},
"tm":[ /* time of passing points */
{
"at":<uint>, /* arrival time */
"ad":<uint>, /* deviation from arrival time */
"dt":<uint>, /* departure time */
"dd":<uint> /* deviation from departure time */
}
],
"sch":{ /* time limitation */
"f1":<uint>, /* beginning of interval 1 */
"f2":<uint>, /* beginning of interval 2 */
"t1":<uint>, /* ending of interval 1 */
"t2":<uint>, /* ending of interval 2 */
"m":<uint>, /* days of month mask */
"y":<uint>, /* months mask */
"w":<uint> /* days of week mask */
}
},
"at":<uint>, /* activation time */
"vt":<uint>, /* time from which validity period begins */
"vp":<uint>, /* validity period */
"f":<uint>, /* round flags (see below) */
"st":{ /* round state */
"st":{ /* general round state */
"pi":<uint>, /* check point index, if 4294967295 - round isn't started */
"ps":<uint>, /* state flags + event flags (see below) */
"ut":<uint> /* last event time */
},
"pts":{ /* state by points */
<text>:{ /* check point ID */
"st": <uint>, /* event flags (see below) */
"tm": <uint> /* last event time */
},
...
}
}
}
]
Types of check points are described in the chapterĀ Update check points.
Schedule types are described in the chapterĀ Schedules: create, edit, delete.
Round flags
Flag |
Description |
0x0 |
check points order: strict |
0x2 |
remove finished rounds from the timeline |
0x10 |
check points order: skipping possible |
0x20 |
allows to make reports upon performance on a round |
0x40 |
check points order: arbitrary |
Round state flags
Flag |
Description |
0x010000 |
not active |
0x020000 |
finished |
0x040000 |
expecting arrival |
0x080000 |
expecting departure |
0x200000 |
is late |
0x400000 |
outrun |
0x800000 |
stopped |
Event flags
Flag |
Description |
0x1 |
round begins |
0x2 |
round finished |
0x4 |
round aborted |
0x8 |
arrive in check point |
0x10 |
pass check point |
0x20 |
depart from check point |
0x40 |
registered late arrival |
0x80 |
registered outrun |
0x100 |
pass check point in time |
0x200 |
delayed arrival |