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 | Неверные входные параметры. |