|
|
ru:pro:remoteapi:apiref:resource:update_zone [05/12/2013 12:58] zuve |
ru:pro:remoteapi:apiref:resource:update_zone [05/12/2013 13:58] |
{{indexmenu_n>70}} | |
====== Геозоны: создание, редактирование и удаление ====== | |
| |
Для создания, редактирования и удаления геозон используется команда **resource/update_zone**: | |
| |
<code javascript> | |
svc=resource/update_zone¶ms={"itemId":<long>, | |
"id":<long>, | |
"callMode":<text>, | |
"n":<text>, | |
"t":<int>, | |
"w":<int>, | |
"p":[{ | |
"x":<double>, | |
"y":<double>, | |
"r":<int> | |
}], | |
"d":{ | |
"addr":<unit>, | |
"rideBegin":<uint>, | |
"rideEnd":<uint>, | |
"color":<uint> | |
}} | |
| |
</code> | |
| |
===== Параметры ===== | |
| |
^ Название ^ Описание ^ | |
| itemId | ID ресурса | | |
| id | ID геозоны | | |
| callMode | режим: создание, редактирование, удаление (create, update, delete) | | |
| **Параметры, обязательными только при создании и редактировании:** || | |
| n | название геозоны | | |
| t | тип: 1 - линия, 2 - полигон, 3 - круг | | |
| w | толщина линии или радиус круга | | |
| p | массив точек геозоны | | |
| x | долгота | | |
| y | широта | | |
| r | радиус | | |
| d | описание | | |
| addr | источник адреса: 0 - нет, 1 - да | | |
| rideBegin | отправной пункт: 0 - нет, 1 - да | | |
| rideEnd | конечный пункт: 0 - нет, 1 - да | | |
| color | цвет (ARGB) | | |
| |
===== Возвращаемый результат ===== | |
При создании и редактировании: | |
<code javascript> | |
[ | |
<long>, /* ID геозоны */ | |
{ | |
"n":<text>, /* название */ | |
"id":<long>, /* ID геозоны */ | |
"t":<int>, /* тип: 1 - линия, 2 - полигон, 3 - круг */ | |
"d":<int> /* толщина линии или радиус круга */ | |
"dr":{ /* описание */ | |
"addr":<uint>, /* источник адреса: 0 - нет, 1 - да */ | |
"rideBegin":<uint>, /* отправной пункт: 0 - нет, 1 - да */ | |
"rideEnd":<uint>, /* конечный пункт: 0 - нет, 1 - да */ | |
"color":<uint>, /* цвет (ARGB) */ | |
} | |
} | |
] | |
</code> | |
| |
При удалении: | |
<code javascript> | |
[ | |
<long>, /* ID геозоны */ | |
null | |
] | |
</code> | |
| |
===== Возможные ошибки ===== | |
^ Код ^ Значение ^ | |
| 1 | недействительная сессия | | |
| 2 | неверное имя сервиса | | |
| 3 | неверный результат | | |
| 4 | - неверный формат или значение параметров\\ - ошибка изменения данных геозоны | | |
| 6 | - не существует геозоны с указанным ID\\ - ошибка создания геозоны\\ - ошибка удаления геозоны | | |
| 7 | - доступ запрещен\\ - не подключен сервис | | |