upload_zone_image
La función upload_zone_image se usa para adjuntar una imagen a una geocerca, así como para copiar una imagen de una geocerca a otra.
svc=resource/upload_zone_image¶ms={"itemId":<long>,
"id":<long>,
"eventHash":<text>,
"oldItemId":<long>,
"oldZoneId":<uint>}
&sid="<text>"
Para eliminar una imagen, use la función update_zone.
Para obtener una imagen, use la función avl_zone_image.
Parámetros
| Nombre | Descripción |
|---|---|
| itemId | ID del recurso. |
| id | ID de la geocerca. |
| eventHash | Nombre del evento que debe generarse una vez adjuntada la imagen. |
| oldItemId | ID del recurso de la geocerca cuya imagen debe aplicarse. Parámetro opcional. |
| oldZoneId | ID de la geocerca cuya imagen debe aplicarse. Parámetro opcional. |
Para cargar una imagen, use una solicitud POST (multipart/form-data) en que una parte contiene los parámetros y la otra, la imagen.
Ejemplo:
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--
También puede copiar una imagen de una geocerca a otra. Para hacerlo, ejecute una solicitud sin imagen pero con los campos oldItemId y oldZoneId.
Resultado devuelto
Si la solicitud se procesa correctamente, se devuelve un JSON vacío.
{ }
Si no es así, se devuelve un código de error. Los códigos de errores posibles son:
| Code | Description |
|---|---|
| 7 | Error al obtener el recurso con la ACL deseada (ADF_ACL_AVL_RES_EDIT_ZONES) o error al encontrar el objeto/la geocerca con el oldItemId o oldZoneId (al copiar la imagen de otra geocerca). |
| 6 | Error no definido. |
| 4 | Parámetros de entrada incorrectos. |
Para asegurarse de que la imagen se haya cargado, ejecute la solicitud avl_evts:
{
"tm":<uint>, /* hora actual del servidor (UTC) */
"events":[
{
"i":<long>, /* ID de la geocerca (-1 si se desconoce) */
"d":{ /* datos */
"hash":<text> /* carga completa */
}
}
]
}