Содержание

Информация об элементе по известным координатам

Для того, чтобы получить информацию о каком-любо элементе на графическом слое по известным координатам, нужно использовать запрос: 

http://{host}/avl_hittest?rname=<text>&lat=<double>&lon=<double>&scale=<uint>&
radius=<double>&sdk=<text>

:!: Внимание
Перед выполнением данной команды необходимо создать соответствующий слой одной из команд: Создание слоя POI, Создание слоя геозон, Создание слоя треков.

Параметры

Название Описание
rname имя рендерера (см. Создать рендерер изображений)
lat широта
lon долгота
scale масштаб: 0-17
radius радиус поиска
sdk запрос отправляется через SDK: 0 - нет, 1 - да (для совместимости со старыми версиями), наиболее часто указывается 1. Значение данного параметра указывается без кавычек, иначе в ответе вернется ERROR.

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

Для сообщений: 

{
	"type":2,		/* тип результата (2 - сообщение) */
	"msg":{		/* текущее сообщение */
		...
	},
	"_msg":{		/* предыдущее сообщение */
		...
	},
	"imsg":<uint>,	/* индекс текущего сообщения */
	"unit_id":<long>	/* ID объекта */
}

Форматы текущего и предыдущего сообщения рассмотрены в разделе Форматы данных: Сообщения.

Для маркеров: 

{
	"type":1,		/* тип результата (1 - маркер) */
	"lat":<double>,		/* широта */
	"lon":<double>,		/* долгота */
	"header":<text>,	/* подпись маркера */
	"text":<text>,		/* информация о маркере: зависит от типа маркера */
	"marker":{}		/* дополнительная информация о маркере, если есть */
}

Для геозон: 

{
	"type":3,		/* тип результата (3 - геозона) */
	"lat":<double>,		/* широта */
	"lon":<double>,		/* долгота */
	"rname":<text>,		/* имя рендерера */
	"lname":<text>,		/* имя слоя */
	"shape":{}		/* информация о геозоне, например название */
}