update_checkpoints
Para actualizar la lista de puntos de control de la ruta, utilice el método update_checkpoints:
svc=route/update_checkpoints
params={
"itemId": <long>,
"checkPoints": [
{}
]
}
Parámetros
La solicitud debe contener los siguientes parámetros:
| Parámetro | Descripción |
|---|---|
| itemId | ID de la ruta. |
| checkPoints | Array de puntos de control. |
El formato del punto de control varía según su tipo, es decir, si se trata de un punto de control desde el mapa, una geocerca o una unidad.
Puntos de control desde el mapa
El formato de los puntos de control desde el mapa es el siguiente:
{
"f": 1, // Tipo de punto.
"n": <text>, // Nombre.
"y": <double>, // Latitud.
"x": <double>, // Longitud.
"r": <uint> // Radio.
}
Puntos de control desde geocercas
Para los puntos de control desde geocercas son posibles dos formatos:
- formato 1: con la indicación del campo
gz, que contiene los datos de la geocerca; - formato 2: con la indicación del ID del recurso y el ID de la geocerca.
Formato 1
{
"f": 2, // Tipo de punto.
"n": <text>, // Nombre.
"gz": { // Información de la geocerca.
"n": <text>, // Nombre de la geocerca.
"d": <text>, // Descripción de la geocerca.
"id": <long>, // ID de la geocerca.
"t": <byte>, // Tipo de geocerca: 1 = línea, 2 = polígono, 3 = círculo.
"w": <uint>, // Ancho de línea o radio del círculo.
"f": <uint>, // Flags de la geocerca.
"c": <uint>, // Color (ARGB).
"b": { // Parámetros del cuadro delimitador.
"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": [ // Array de puntos de la geocerca.
{
"x": <double>, // Longitud.
"y": <double>, // Latitud.
"r": <uint> // Radio.
}
]
}
}
Formato 2
{
"f": 2, // Tipo de punto.
"n": <text>, // Nombre.
"resource": <long>, // ID del recurso que contiene la geocerca.
"zone": <long> // ID de la geocerca dentro del recurso.
}
Puntos de control desde unidades
El formato de los puntos de control desde unidades es el siguiente:
{
"f": 4, // Tipo de punto.
"u": <long>, // ID de la unidad.
"r": <uint> // Radio.
}
Respuesta
Si la solicitud se completa con éxito, la respuesta se devuelve en el siguiente formato:
{
"rpts": [ // Array de puntos de control.
{
"n": <text>, // Nombre.
"f": <uint>, // Tipo.
"u": <long>, // ID de la unidad (0 si el tipo no es un punto de control desde una unidad).
"y": <double>, // Latitud.
"x": <double>, // Longitud.
"r": <uint> // Radio.
}
]
}
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 no válidos, o error al actualizar los puntos de control. |
| 6 | Error interno. |
| 7 | Error interno o falta el derecho de acceso Modificar propiedades de la ruta a la ruta. |