Wialon para desarrolladores Manual de usuario Documentación de API render create_messages_layer

create_messages_layer

El método render/create_messages_layer permite crear una capa gráfica empleando las coordenadas de mensajes.

Endpoint

Copied!

svc=render/create_messages_layer&params={
  "layerName": "<text>",
  "itemId": <long>,
  "timeFrom": <uint>,
  "timeTo": <uint>,
  "tripDetector": <bool>,
  "trackColor": "<text>",
  "trackWidth": <int>,
  "arrows": <bool>,
  "points": <bool>,
  "pointColor": "<text>",
  "annotations": <bool>,
  "flags": <uint>
}

El método es una solicitud que consume muchos recursos, por lo que se le aplica la restricción de solicitudes simultáneas de este tipo durante una sesión. Si se alcanza la restricción, se devuelve el error 1003 con la causa LIMIT api_concurrent. Para ver la lista de solicitudes que consumen muchos recursos, consulte Restricciones.

Parámetros

Parámetro	Descripción
`layerName`	Nombre de capa.
`itemId`	ID de la unidad cuyos mensajes deben solicitarse.
`timeFrom`	Inicio del intervalo.
`timeTo`	Fin del intervalo.
`tripDetector`	El uso del detector de viajes: `0`: no; `1`: sí.
`trackColor`	Color del recorrido en el formato ARGB (A es el canal alfa o el nivel de transparencia) o `"trip"` para colorear recorridos por viajes (se requiere `"tripDetector":1`).
`trackWidth`	Ancho del recorrido en píxeles.
`arrows`	Flechas de dirección de movimiento: `0`: no; `1`: sí.
`points`	Puntos en los lugares donde se recibieron mensajes: `0`: no; `1`: sí.
`pointColor`	Color de los puntos.
`annotations`	Descripciones para los puntos: `0`: no; `1`: sí.
`flags`	Flags para la visualización de marcadores (parámetro opcional).

Ejemplos del parámetro trackColor:

Color	Nombre	Código ARGB
	Rojo opaco.	“FFFF0000”
	Verde semitransparente.	“7F00FF00”
	Azul muy transparente.	“500000FF”

Flags de marcadores:

Flag	Valor
`0x0001`	Marcadores de agrupación.
`0x0002`	Numeración de marcadores.
`0x0004`	Marcadores de eventos.
`0x0008`	Marcadores de llenados de combustible.
`0x0010`	Marcadores de imágenes.
`0x0020`	Marcadores de estacionamientos.
`0x0040`	Marcadores de excesos de velocidad.
`0x0080`	Marcadores de paradas.
`0x0100`	Marcadores de descargas de combustible.
`0x0800`	Marcadores de vídeos.

Respuesta

Copied!

{
  "name": "<text>",         /* nombre de capa */
  "bounds": [               /* límites de capa */
    <double>,               /* latitud mínima */
    <double>,               /* longitud mínima */
    <double>,               /* latitud máxima */
    <double>                /* longitud máxima */
  ],
  "units": [                /* matriz de unidades */
    {
      "id": <long>,         /* ID de unidad */
      "msgs": {             /* información sobre mensajes */
        "count": <uint>,    /* cantidad de mensajes */
        "first": {          /* primer mensaje */
          "time": <uint>,   /* tiempo */
          "lat": <double>,  /* latitud */
          "lon": <double>   /* longitud */
        },
        "last": {           /* último mensaje */
          "time": <uint>,   /* tiempo */
          "lat": <double>,  /* latitud */
          "lon": <double>   /* longitud */
        }
      },
      "mileage": <double>,  /* kilometraje para intervalo (metros) */
      "max_speed": <uint>   /* velocidad máxima para intervalo */
    }
  ],
  "trips": [                /* solo si tripDetector es 1 */
    {
      "first": {            /* primer mensaje */
        "time": <uint>,     /* tiempo */
        "lat": <double>,    /* latitud */
        "lon": <double>     /* longitud */
      },
      "last": {             /* último mensaje */
        "time": <uint>,     /* tiempo */
        "lat": <double>,    /* latitud */
        "lon": <double>     /* longitud */
      },
      "mileage": <double>,  /* kilometraje para intervalo (metros) */
      "max_speed": <uint>,  /* velocidad máxima para intervalo */
      "color": "<text>"     /* color de intervalo en formato '#RRGGBB' */
    }
  ]
}

Vea también avl_render.

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.
6	Error no definido.
7	La unidad no existe o el usuario no tiene el derecho de acceso Solicitar informes y mensajes a ella.
1001	No hay mensajes para procesar.
1003	Se alcanzó una de las siguientes restricciones: la restricción de 50 capas de mensajes (causa `LAYERS_MAX_COUNT`); la restricción de solicitudes simultáneas que consumen muchos recursos (causa `LIMIT api_concurrent`).
1004	El límite de mensajes alcanzado.

Si nota un error en el texto, por favor resáltelo y presione Ctrl+Intro.