get_zones_by_unit
El método get_zones_by_unit comprueba si las unidades especificadas se encuentran dentro de las geocercas especificadas.
Endpoint
svc=resource/get_zones_by_unit¶ms={
"spec": {
"zoneId": {
"<long>": [<long>, ...],
...
},
"units": [<long>],
"time": <long>
}
}
Parámetros
La solicitud debe contener el siguiente parámetro:
| Nombre | Tipo | Descripción |
|---|---|---|
| spec | object | Contiene información sobre las geocercas (zoneId), las unidades (units) y el tiempo (time) para los que se comprueba la ubicación de las unidades dentro de las geocercas. Consulte la descripción de estos parámetros a continuación. |
Parámetros de spec
Se requieren los siguientes parámetros de spec:
| Nombre | Tipo | Descripción |
|---|---|---|
| zoneId | object | Objeto JSON que asocia los ID de recursos con matrices de ID de geocercas. Cada clave es el ID del recurso, y el valor es una matriz de los ID de las geocercas correspondientes de este recurso. Ejemplo "zoneId": {"912": [4, 5, 6, 7, 8, 9],"913": [1, 2, 3, 4, 5, 76]En este ejemplo:
|
| units | array of integers | Lista de ID de unidades cuya presencia en las geocercas se comprueba. Ejemplo "units": [917]En este ejemplo, se comprueba la unidad con ID 917. |
| time | integer | Especifica el tiempo para el que se comprueba la ubicación de la unidad dentro de las geocercas:
Ejemplo "time": 0En este ejemplo, se comprueba la última ubicación de la unidad. |
Ejemplo de solicitud
https://hst-api.wialon.com/wialon/ajax.html?svc=resource/get_zones_by_unit&sid=SESSION_IDENTIFIER¶ms={"spec":{"zoneId":{"912":[4,5,6,7,8,9],"913":[1,2,3,4,5,76]},"units":[917],"time":0}}
En este ejemplo:
- La solicitud comprueba si la unidad con ID 917 se encuentra dentro de las geocercas especificadas de dos recursos con ID 912 y 913.
- time=0 indica que se comprueba la última ubicación de la unidad 917.
Respuesta
La respuesta indica si las unidades especificadas se encontraban dentro de las geocercas especificadas en el momento solicitado.
{
"<text>": { /* ID del recurso */
"<text>": [ /* ID de la geocerca */
<long>, /* ID de unidades */
...
]
},
...
}
Ejemplo de respuesta correcta
{"912": {"4": [917]}}
En este ejemplo, la unidad con ID 917 se encuentra dentro de la geocerca con ID 4. La geocerca pertenece al recurso con ID 912.
Respuesta vacía
Si no se encuentran unidades en las geocercas en el momento especificado, se devuelve un JSON vacío.
{}
Códigos de error
Si la solicitud no se completa correctamente, se devuelve un código de error.
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada no válidos. |
| 6 | Error desconocido. |