Справочный центр Wialon

create_messages_layer

Функция create_messages_layer используется для создания графического слоя на основе координат из сообщений.

Copied!
svc=render/create_messages_layer&params={"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 Использование детектора поездок:
  • 0 — нет;
  • 1 — да.
trackColor Цвет трека в формате ARGB (А — альфа-канал или уровень прозрачности) или “trip” для окрашивания треков по поездкам (требуется значение “tripDetector”:1).
trackWidth Толщина трека в пикселях.
arrows Стрелки направления движения:
  • 0 — нет;
  • 1 — да.
points Точки в местах получения сообщений:
  • 0 — нет;
  • 1 — да.
pointColor Цвет точек.
annotations Подписи к точкам:
  • 0 — нет;
  • 1 — да.
flags Флаги для отображения маркеров (необязательный параметр).

Примеры параметра trackColor:

Цвет Название Код ARGB
Непрозрачный красный. “FFFF0000”
Полупрозрачный зеленый. “7F00FF00”
Очень прозрачный синий. “500000FF”

Флаги маркеров:

Флаг Значение
0x0001 Группировка маркеров.
0x0002 Нумерация маркеров.
0x0004 Маркеры событий.
0x0008 Маркеры заправок.
0x0010 Маркеры изображений.
0x0020 Маркеры стоянок.
0x0040 Маркеры превышений скорости.
0x0080 Маркеры остановок.
0x0100 Маркеры сливов топлива.
0x0800 Маркеры видео.

Ответ

Copied!
{
	"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 Объект не существует, или у пользователя нет права доступа Запрос сообщений и отчетов к нему.
6 Неопределенная ошибка.
4 Неверные входные параметры.

Если вы заметили ошибку в тексте, пожалуйста, выделите её и нажмите Ctrl+Enter.