get_zones_by_point
La función 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.
svc=resource/get_zones_by_point¶ms={"spec": {
"lat":<double>,
"lon":<double>,
"radius":<double>,
"zoneId":{
"<long>":[<uint>,
...
],
...
},
}
}
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.
Resultado devuelto
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 */
...
],
...
}
]
Los códigos de errores posibles son:
Código | Descripción |
---|---|
6 | Error general. |
4 | Parámetros de entrada incorrectos. |