update_tag
Функция update_tag используется для создания, редактирования или удаления меток. Метки используются при назначении или снятии пассажиров.
svc=resource/update_tag¶ms={"itemId":<long>,
"id":<long>,
"callMode":"<text>",
"c":"<text>",
"ck":<short>,
"n":"<text>",
"p":"<text>",
"r":<double>,
"tz":<int>,
"f":<int>,
"art":<uint>,
"jp":{
"<text>":"<text>",
...
}}
Параметры
| Название | Описание |
|---|---|
| itemId | ID ресурса. |
| id | ID метки. Для создания метки отправьте 0. |
| callMode | Режимы:
|
Следующие параметры необходимы только для создания и редактирования меток:
| Название | Описание |
|---|---|
| c | Код. |
| ck | Контрольная сумма изображения метки. |
| n | Имя метки. |
| p | Телефонный номер в формате +1234567890. Должен быть закодирован в %2B. |
| tz | Временнáя зона. |
| jp | Произвольные поля в формате "имя":"значение". |
| f | Флаги (необязательно). По умолчанию — 0. |
| art | Время для автоматического снятия (необязательно). По умолчанию — 36000 (10 часов). |
Возвращаемый результат
Для запросов, связанных с созданием и редактированием:
[
<long>, /* ID метки */
{
"id":<long>, /* ID */
"n":"<text>", /* имя */
"c":"<text>", /* код */
"jp": { /* произвольные поля */
"<text>":"<text>", /* "имя":"значение" */
...
},
"r":<double>, /* пропорции изображения метки */
"ck":<ushort>, /* контрольная сумма изображения метки */
"f":<ushort>, /* флаг в настоящее время не используется, значение по умолчанию = 1 */
"bu":<long>, /* назначенный объект */
"pu":<long>, /* предыдущий назначенный объект */
"bt":<uint>, /* время последнего назначения/снятия */
"pos":{ /* местоположение */
"y":<double>, /* широта */
"x":<double> /* долгота */
}
}
]
Для запросов, связанных с удалением:
[
<long>, /* ID метки */
null
]
Возможные коды ошибок:
| Код | Описание |
|---|---|
| 7 | Не удалось извлечь ресурс с требуемым ACL (ADF_ACL_AVL_RES_EDIT_TAGS). |
| 6 | Неопределенная ошибка. |
| 4 | Неверные входные параметры. |