get_zone_data
Para obtener información detallada sobre geocercas, utilice el método resource/get_zone_data.
Endpoint
svc=resource/get_zone_data¶ms={
"itemId": <long>,
"col": [<long>],
"flags": <uint>
}
Parámetros
Solo el parámetro itemId es obligatorio.
| Parámetro | Descripción |
|---|---|
itemId |
ID del recurso. |
col |
Matriz de los ID de geocercas. Opcional. Si no se indica, el método devuelve todas las geocercas del recurso. Si se indica una matriz vacía, el método devuelve una matriz vacía. Los ID de geocercas que no existen en el recurso se omiten sin error. |
flags |
Flags que determinan el formato del JSON devuelto (vea más abajo). Opcional. El valor predeterminado es 0x1C. Este valor también se utiliza si el valor indicado es 0 o no es un entero sin signo (por ejemplo, -1). |
Están disponibles los siguientes valores de flags:
| Valor | Descripción |
|---|---|
0x01 |
Área. |
0x02 |
Perímetro. |
0x04 |
Coordenadas del centro y de los límites de la geocerca. |
0x08 |
Todos los puntos. |
0x10 |
Propiedades básicas. |
Los campos id, ct y mt se devuelven con cualquier flag.
Respuesta
Si la solicitud se completa con éxito, la respuesta se devuelve en el siguiente formato:
[ /* matriz con datos sobre geocercas */
{
"n": "<text>", /* nombre de la geocerca */
"d": "<text>", /* descripción */
"id": <long>, /* ID de la geocerca en el recurso/cuenta */
"rid": <long>, /* ID del recurso/cuenta */
"t": <byte>, /* tipo: 1 (línea), 2 (polígono), 3 (círculo) */
"w": <uint>, /* grosor de la línea o radio del círculo (vea las unidades más abajo) */
"f": <uint>, /* flags de geocerca (vea más abajo) */
"c": <uint>, /* color (ARGB) */
"tc": <uint>, /* color del texto (RGB) */
"ts": <uint>, /* tamaño de fuente */
"min": <uint>, /* mostrar en el mapa a partir de esta escala */
"max": <uint>, /* mostrar en el mapa hasta esta escala */
"i": <uint>, /* suma de comprobación de la imagen (CRC32); 4294967295 si la geocerca no tiene imagen */
"icon": "<text>", /* URI de la imagen de la geocerca; se devuelve solo si la geocerca tiene imagen */
"path": "<text>", /* ruta de acceso corta al icono de la biblioteca de iconos; vacía si la geocerca no tiene ese icono */
"ar": <double>, /* área (vea las unidades más abajo) */
"pr": <double>, /* perímetro (vea las unidades más abajo) */
"libId": <long>, /* ID de la biblioteca de iconos (0 para la biblioteca de iconos predeterminada) */
"jp": <JSON>, /* JSON personalizado; se devuelve solo si está especificado para la geocerca */
"b": { /* límites */
"min_x": <double>, /* longitud mínima */
"min_y": <double>, /* latitud mínima */
"max_x": <double>, /* longitud máxima */
"max_y": <double>, /* latitud máxima */
"cen_x": <double>, /* longitud del centro */
"cen_y": <double> /* latitud del centro */
},
"p": [ /* matriz de puntos de geocerca */
{
"x": <double>, /* longitud */
"y": <double>, /* latitud */
"r": <uint> /* radio (vea las unidades más abajo) */
},
...
],
"ct": <uint>, /* hora de creación */
"mt": <uint> /* hora de la última modificación */
},
...
]
Las unidades de w, r, ar y pr dependen del sistema de medida del recurso. Si es estadounidense o imperial, los valores se indican en pies (w, r, pr) y pies cuadrados (ar). En caso contrario, se indican en metros y metros cuadrados.
Flags de geocerca (f):
| Valor | Descripción |
|---|---|
0x2 |
Geocerca donde comienza una rutina. Se utiliza en los informes si las geocercas de inicio y fin de las rutinas no están indicadas en la configuración de la tabla. |
0x4 |
Geocerca donde termina una rutina. Se utiliza en los informes si las geocercas de inicio y fin de las rutinas no están indicadas en la configuración de la tabla. |
0x10 |
Se establece automáticamente al guardar la geocerca. |
0x20 |
Mostrar forma. |
0x40 |
No simplificar la geocerca. |
Si la solicitud falla, se devuelve un código de error.
Códigos de error
| Código de error | Descripción |
|---|---|
| 4 | Parámetros de entrada incorrectos. |
| 7 | El objeto con el ID indicado no existe o no es un recurso, o el usuario no tiene el derecho de acceso Ver geocercas al recurso. |