Информация об элементе по известным координатам
Для того, чтобы получить информацию о каком-любо элементе на графическом слое по известным координатам, нужно использовать запрос:
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":{} /* информация о геозоне, например название */ }
