Содержание

Маршруты: создание, редактирование и удаление

Маршруты: создание, редактирование и удаление

Для создания, редактирования и удаления маршрутов используется команда resource/update_route:

svc=resource/update_route&params={"itemId":<long>,
				  "id":<long>,
				  "callMode":<text>,
				  "resourceId":<long>,
				  "zoneId":<long>,
				  "d":<text>,
				  "n":<text>,
				  "f":<long>,
				  "at":<long>}

Параметры

Название	Описание
itemId	ID ресурса
id	ID маршрута
callMode	режим: создание, редактирование, удаление (create, update, delete)
Параметры, обязательными только при создании и редактировании:
resourceId	ID ресурса для геозоны
zoneId	ID геозоны типа линия, которая будет использоваться в качестве маршрута
d	описание
n	название
f	флаги маршрута (см. ниже)
at	время активации

Флаги маршрута:

Флаг	Описание
0x1	геозона определена по ссылке
0x2	удалять завершенные рейсы с временной шкалы
0x8	зарегистрировать как сообщение объекта
0x10	порядок прохождения точек: возможны пропуски
0x20	сгенерировать событие для объекта
0x40	порядок прохождения точек: произвольный

Возвращаемый результат

При создании и редактировании:

[
	<long>,		/* ID маршрута */
	{
		"i":<long>,	/* ID маршрута */
		"nm":<text>,	/* название */
		"de":<text>,	/* описание */
		"at":<uint>,	/* время активации */
		"fl":<long>,	/* флаги маршрута (см. выше) */
		"st":<long>,	/* состояние маршрута (см. ниже) */
		"pt":<uint>,	/* индекс последней пройденной точки маршрута */
		"tm":<uint>,	/* время смены статуса */
		"ri":<long>,	/* ID ресурса */
		"z":<long>	/* ID геозоны */
	}
]

Флаги состояния маршрута:

Флаг	Описание
0x01	проверка статуса неактивна
0x02	пройдены все контрольные точки
0x04	прибытие в контрольную точку
0x08	отправление из контрольной точки
0x10	объект вышел за пределы геозоны, по которой строился маршрут
0x20	объект движется с опозданием
0x40	объект движется с опережением
0x80	проверка статуса запрещена

При удалении:

[
	<long>,		/* ID маршрута */
	null
]

Возможные ошибки

Код	Значение
1	недействительная сессия
2	неверное имя сервиса
3	неверный результат
4	неверный формат или значение параметров
6	- доступ запрещен - не подключен сервис - не существует геозоны с указанным ID - не существует маршрута с указанным ID - ошибка удаления маршрута - ошибка изменения данных маршрута