create_messages_layer
Функция create_messages_layer используется для создания графического слоя на основе координат из сообщений.
svc=render/create_messages_layer¶ms={"layerName":"<text>",
"itemId":<long>,
"timeFrom":<uint>,
"timeTo":<uint>,
"tripDetector":<bool>,
"trackColor":"<text>",
"trackWidth":<int>,
"arrows":<bool>,
"points":<bool>,
"pointColor":"<text>",
"annotations":<bool>,
"flags":<uint>}
Этот запрос нельзя выполнить одновременно со следующими запросами:
Параметры
| Название | Описание |
|---|---|
| layerName | Имя слоя. |
| itemId | ID объекта, сообщения которого должен быть запрошены. |
| timeFrom | Начало интервала. |
| timeTo | Конец интервала. |
| tripDetector | Использование детектора поездок:
|
| trackColor | Цвет трека в формате ARGB (А — альфа-канал или уровень прозрачности) или "trip" для окрашивания треков по поездкам (требуется значение "tripDetector":1). |
| trackWidth | Толщина трека в пикселях. |
| arrows | Стрелки направления движения:
|
| points | Точки в местах получения сообщений:
|
| pointColor | Цвет точек. |
| annotations | Подписи к точкам:
|
| flags | Флаги для отображения маркеров (необязательный параметр). |
Примеры параметра trackColor:
| Цвет | Название | Код ARGB |
|---|---|---|
| Непрозрачный красный. | "FFFF0000" | |
| Полупрозрачный зеленый. | "7F00FF00" | |
Очень прозрачный синий. | "500000FF" |
Флаги маркеров:
| Флаг | Значение |
|---|---|
| 0x0001 | Группировка маркеров. |
| 0x0002 | Нумерация маркеров. |
| 0x0004 | Маркеры событий. |
| 0x0008 | Маркеров заправок. |
| 0x0010 | Маркеры изображений. |
| 0x0020 | Маркеры стоянок. |
| 0x0040 | Маркеры превышений скорости. |
| 0x0080 | Маркеры остановок. |
| 0x0100 | Маркеры сливов топлива. |
| 0x0800 | Маркеры видео. |
Возвращаемый результат
{
"name":"<text>", /* имя слоя */
"bounds":[ /* границы слоя */
<double>, /* минимальная широта */
<double>, /* минимальная долгота */
<double>, /* максимальная широта */
<double> /* максимальная долгота */
],
"units":[ /* массив объектов */
{
"id":<long>, /* ID объекта */
"msgs":{ /* информация о сообщениях */
"count":<uint>, /* количество сообщений */
"first":{ /* первое сообщение */
"time":<uint>, /* время */
"lat":<double>, /* широта */
"lon":<double> /* долгота */
},
"last":{ /* последнее сообщение */
"time":<uint>, /* время */
"lat":<double>, /* широта */
"lon":<double> /* долгота */
}
},
"mileage":<double>, /* пробег за интервал (метры) */
"max_speed":<unit> /* максимальная скорость за интервал */
}
],
"trips":[ /* только если tripDetector 1 */
{
"first":{ /* первое сообщение */
"time":<uint>, /* время */
"lat":<double>, /* широта */
"lon":<double> /* долгота */
},
"last":{ /* последнее сообщение */
"time":<uint>, /* время */
"lat":<double>, /* широта */
"lon":<double> /* долгота */
},
"mileage":<double>, /* пробег за интервал (метры) */
"max_speed":<unit> /* максимальная скорость за интервал */
"color":"<text>" /* цвет интервала в формате '#RRGGBB' */
}
]
}
См. также avl_render.
Возможные коды ошибок:
| Код | Описание |
|---|---|
| 1004 | Достигнут лимит сообщений. |
| 1003 | Достигнут лимит слоев. |
| 1001 | Нет сообщений для обработки. |
| 7 | Не удалось извлечь ресурс с требуемым ACL (ADF_ACL_ITEM_EXECUTE_REPORTS). |
| 6 | Неопределенная ошибка. |
| 4 | Неверные входные параметры. |