To read geofences from a file, use the command exchange/import_zones_read:
svc=exchange/import_zones_read¶ms={"eventHash":<text>}
Current request can't be executed simultaneously with any request from this chapter and following requests:
Name | Description |
---|---|
eventHash | event name, which will be generated after reading geofences (optional parameter) |
To upload a file with geofences, use a POST request with multiple contents (multipart/form-data).
For example:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_zones_read&sid=8157df114c0e601f0f31091c3c2ac53d Request Method: POST Connection: keep-alive Content-Length: 1281 Cache-Control: no-cache Content-Type: multipart/form-data; boundary=----WebKitFormBoundaryzmBiAUFQVzA8mRkx 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 ------WebKitFormBoundaryzmBiAUFQVzA8mRkx Content-Disposition: form-data; name="params" {"eventHash":"jUploadForm1372771850650"} ------WebKitFormBoundaryzmBiAUFQVzA8mRkx Content-Disposition: form-data; name="eventHash" jUploadForm1372771850650 ------WebKitFormBoundaryzmBiAUFQVzA8mRkx Content-Disposition: form-data; name="import_file"; filename="geofence.kml" Content-Type: application/vnd.google-earth.kml+xml ------WebKitFormBoundaryzmBiAUFQVzA8mRkx--
{} /* empty object if execution successful, if not - error code */
To be sure that geofences has been read, you can execute the command Events:
{ "tm":<uint>, /* current server time (UTC) */ "events":[ { "i":-1, "d":{ /* data */ "hash":<text>, /* upload is complete */ "zones":[<Object>] /* array of geofences read */ } } ] }