To upload an image for a Geofence or set an image of other Geofence, use the command resource/upload_zone_image:
svc=resource/upload_zone_image¶ms={"itemId":<long>, "id":<long>, "eventHash":<text>, "oldItemId":<long>, "oldZoneId":<uint>}
To delete an image, use the command Geofences: create, edit, delete.
To get an image, use Geofence image.
| Name | Description |
|---|---|
| itemId | resource ID |
| id | geofence ID |
| eventHash | event name, which will be generated after uploading the image |
| oldItemId | resource id of other Geofence to set its image (optional parameter) |
| oldZoneId | other Geofence id of to set its image (optional parameter) |
To upload an image, use a POST request with multiple contents (multipart/form-data), where one part contains parameters and the other contains the image.
For example:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=resource/upload_zone_image&sid=8157df114c0e601f0f31091c3c2ac53d
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--
{} /* empty object if execution successful, if not - error code */
To be sure that the image has been uploaded, you can execute the command Events:
{ "tm":<uint>, /* current server time (UTC) */ "events":[ { "i":<long>, /* пeofence ID (-1 if unknown) */ "d":{ /* data */ "hash":<text> /* upload is complete */ } } ] }
|