import_zones_read
Para leer geocercas de un archivo, use el método exchange/import_zones_read.
Endpoint
svc=exchange/import_zones_read¶ms={
"eventHash": <text>
}
El método es una solicitud que consume muchos recursos, por lo que se le aplica la restricción de solicitudes simultáneas de este tipo durante una sesión. Si se alcanza la restricción, se devuelve el error 1003 con la causa
LIMIT api_concurrent. Para ver la lista de solicitudes que consumen muchos recursos, consulte Restricciones.
Parámetros
Puede incluir el parámetro opcional eventHash en la solicitud. Este parámetro permite especificar el nombre del evento que se genera después de leer los datos.
Carga de un archivo
Para cargar un archivo con geocercas, use una solicitud POST con contenido múltiple (multipart/form-data). Por ejemplo:
Request URL: https://hst-api.wialon.com/wialon/ajax.html?svc=exchange/import_zones_read&sid=SESSION_IDENTIFIER
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--
Respuesta
Si la solicitud se completa correctamente, se devuelve una respuesta vacía.
{ }
Para asegurarse de que las geocercas se hayan leído, puede ejecutar el método avl_evts:
{
"tm": <uint>, /* hora actual del servidor (UTC) */
"events": [
{
"i": -1,
"d": { /* datos */
"hash": <text>, /* carga completa */
"zones": [<Object>] /* array de geocercas leídas */
}
}
]
}
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 1 | SID de solicitud no válido u obsoleto. |
| 4 | No se adjuntó ningún archivo. |
| 7 | No se pudo obtener el usuario. |