upload_zone_image
Функция upload_zone_image используется для прикрепления изображения к геозоне и для копирования изображения из одной геозоны в другую.
svc=resource/upload_zone_image¶ms={"itemId":<long>,
"id":<long>,
"eventHash":<text>,
"oldItemId":<long>,
"oldZoneId":<uint>}
&sid="<text>"
Чтобы удалить изображение, используйте функцию update_zone.
Чтобы получить изображение, используйте функцию avl_zone_image.
Параметры
| Name | Description |
|---|---|
| itemId | ID ресурса. |
| id | ID геозоны. |
| eventHash | Имя события, которое должно быть сгенерировано после прикрепления изображения. |
| oldItemId | ID ресурса геозоны, изображение которой должно быть применено. Необязательный параметр. |
| oldZoneId | ID геозоны, изображение которой должно быть применено. Необязательный параметр. |
Чтобы загрузить изображение, используйте запрос POST (multipart/form-data), в котором в одной части содержатся параметры, а в другой — изображение.
Пример:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=resource/upload_zone_image
Request Method: POST
Host: hst-api.wialon.com
Connection: keep-alive
Content-Length: 31753
Cache-Control: no-cache
Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryX2W1y7AVnQkXQAM0
Accept: text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8
Accept-Charset: windows-1251,utf-8;q=0.7,*;q=0.3
Accept-Encoding: gzip,deflate,sdch
Accept-Language: ru,en-US;q=0.8,en;q=0.6
------WebKitFormBoundaryX2W1y7AVnQkXQAM0
Content-Disposition: form-data; name="params"
{"itemId":717314,"id":1,"eventHash":"jUploadForm1372768029714"}
------WebKitFormBoundaryX2W1y7AVnQkXQAM0
Content-Disposition: form-data; name="eventHash"
jUploadForm1372768029714
------WebKitFormBoundaryX2W1y7AVnQkXQAM0
Content-Disposition: form-data; name="zone_create_upload_image"; filename="zZeVUgLEJXE.jpg"
Content-Type: image/jpeg
------WebKitFormBoundaryX2W1y7AVnQkXQAM0--
Также можно скопировать изображение из одной геозоны в другую. Для этого выполните запрос без изображения, но с полями oldItemId и oldZoneId.
Возвращаемый результат
Если запрос выполнен успешно, возвращается пустой JSON.
{ }
В противном случае возвращается код ошибки. Возможные коды ошибок:
| Код | Описание |
|---|---|
| 7 | Не удалось извлечь элемент с требуемым ACL (ADF_ACL_AVL_RES_EDIT_ZONES) или не удалось найти элемент/геозону с oldItemId or oldZoneId (при копировании изображения из одной геозоны в другую). |
| 6 | Неопределенная ошибка. |
| 4 | Неверные входные параметры. |
Чтобы убедиться, что изображение загружено, выполните запрос avl_evts:
{
"tm":<uint>, /* текущее время сервера (UTC) */
"events":[
{
"i":<long>, /* ID геозоны (-1, если неизвестно) */
"d":{ /* данные */
"hash":<text> /* загрузка завершена */
}
}
]
}