get_zones_by_point
El método get_zones_by_point se usa para comprobar si hay un punto dentro de una geocerca determinada o para buscar la geocerca más cercana.
Endpoint
svc=resource/get_zones_by_point¶ms={
"spec": {
"lat": <double>,
"lon": <double>,
"radius": <double>,
"zoneId": {
"<long>": [<long>, ...],
...
}
}
}
Parámetros
| Nombre | Descripción |
|---|---|
| zoneId | Lista de geocercas: {“ID del recurso”:[ID de la geocerca,…], …}. |
| lat | Latitud. |
| lon | Longitud. |
| radius | Radio de la búsqueda de geocercas, m. Campo opcional. |
Si la matriz de los ID de geocercas para el “ID del recurso” especificado está vacía, se toman todas las geocercas del recurso.
Respuesta
Si el punto está dentro de la geocerca, el resultado devuelto es el siguiente:
{
"<text>": { /* ID del recurso */
"<text>": 0, /* ID de la geocerca: distancia a la geocerca, m (en este caso siempre 0) */
...
},
...
}
Si el punto está fuera de la geocerca, el resultado devuelto es el siguiente:
{
"<text>": { /* ID del recurso */
"<text>": <double> /* ID de la geocerca: distancia a la geocerca, m */
}
}
Si no hay campo radius, el resultado devuelto es el siguiente:
{
"<text>": [ /* ID del recurso */
<long>, /* ID de geocercas */
...
],
...
}
Si no hay campo radius y el punto no está dentro de ninguna de las geocercas especificadas, se devuelve un objeto vacío ({}).
Códigos de error
| Código | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. |
| 6 | Error general. |