Table of Contents

Geofences: Image

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&params={"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.

Parameters

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--

Response

{}	/* 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 */
			}
		}
	]
}