get_zone_data
Функция get_zone_data используется для получения подробной информации о геозонах.
svc=resource/get_zone_data¶ms={"itemId":<long>,
"col":[<long>],
"flags":<uint>}
Параметры
Название | Описание |
---|---|
itemId | ID ресурса. |
col | Массив ID геозон. Необязательное поле. Если его нет, функция выполняется для всех ID. |
flags | Флаги, определяющие формат возвращаемого JSON (необязательно). Значение по умолчанию — 0x1C. |
Доступные следующие значения флагов:
Значение | Описание |
---|---|
0x01 | Площадь. |
0X02 | Периметр. |
0X04 | Координаты центра и границ геозоны. |
0X08 | Все точки. |
0X10 | Основные свойства. |
Возвращаемый результат
[ /* массив с данными о геозонах */
{
"n":"<text>", /* имя геозоны */
"d":"<text>", /* описание */
"id":<long>, /* ID геозоны в ресурсе/учетной записи */
"rid":<long>, /* ID ресурса/учетной записи */
"t":<byte>, /* тип: 1 — линия, 2 — полигон, 3 — круг */
"w":<uint>, /* толщина линии или радиус круга */
"f":<uint>, /* флаги геозоны (см. ниже) */
"c":<uint>, /* цвет (ARGB) */
"tc":<uint>, /* цвет текста (RGB) */
"ts":<uint>, /* размер шрифта */
"min":<uint>, /* показать на карте, начиная от этого масштаба */
"max":<uint>, /* показать на карте до этого масштаба */
"i":<ushort>, /* контрольная сумма изображения (CRC16) */
"icon":"<text>", /* URI изображения элемента зоны */
"path":"<text>", /* короткий путь к иконке по умолчанию */
"ar":<double>, /* площадь */
"pr":<double>, /* периметр */
"libId":<long>, /* ID библиотеки иконок, 0 — ID библиотеки иконок по умолчанию */
"jp":<JSON>, /* произвольный JSON */
"b":{ /* границы */
"min_x":<double>, /* минимальная долгота */
"min_y":<double>, /* минимальная широта */
"max_x":<double>, /* максимальная долгота */
"max_y":<double>, /* максимальная широта */
"cen_x":<double>, /* долгота центра */
"cen_y":<double> /* широта центра */
},
"p":[ /* массив точек геозоны */
{
"x":<double>, /* долгота */
"y":<double>, /* широта */
"r":<uint> /* радиус */
},
...
],
"ct":<uint>, /* время создания */
"mt":<uint> /* время последнего изменения */
},
...
]
Флаги геозоны (“f”):
Значение | Описание |
---|---|
0x20 | Показать форму. |
0X40 | Не упрощать геозону. |
Возможные коды ошибок:
Код | Описание |
---|---|
7 | Не удалось извлечь ресурс с требуемым ACL (ADF_ACL_AVL_RES_VIEW_ZONES и ADF_ACL_ITEM_EXECUTE_REPORTS) или не удалось извлечь объект с требуемым ACL (ADF_ACL_ITEM_VIEW). |
4 | Неверные входные параметры. |