Recursos
Esta sección describe los flags que se pueden aplicar a los recursos. Estos flags determinan qué secciones de datos se incluyen en el objeto de respuesta JSON. Si se especifican varios flags, sus respectivas partes se combinan en un solo JSON.
Dependiendo de los flags especificados, el formato de respuesta puede variar.
Indique los flags en formato DEC. Para obtener más información, consulte Formato de datos.
Flags de recursos
Los siguientes flags pueden aplicarse a los recursos:
| Valor HEX | Valor DEC | Descripción |
|---|---|---|
| 0x00000001 | 1 | Flag base |
| 0x00000002 | 2 | Propiedades personalizadas |
| 0x00000004 | 4 | Información de facturación |
| 0x00000008 | 8 | Campos personalizados comunes |
| 0x00000020 | 32 | Mensajes |
| 0x00000040 | 64 | GUID |
| 0x00000080 | 128 | Campos personalizados administrativos |
| 0x00000100 | 256 | Conductores |
| 0x00000200 | 512 | Tareas |
| 0x00000400 | 1024 | Notificaciones |
| 0x00000800 | 2048 | POI |
| 0x00001000 | 4096 | Geocercas |
| 0x00002000 | 8192 | Plantillas de informes |
| 0x00004000 | 16384 | Lista de unidades a las que se pueden asignar conductores automáticamente |
| 0x00008000 | 32768 | Grupos de conductores |
| 0x00010000 | 65536 | Remolques |
| 0x00020000 | 131072 | Grupos de remolques |
| 0x00040000 | 262144 | Lista de unidades a las que se pueden asignar remolques automáticamente |
| 0x00080000 | 524288 | Pedidos |
| 0x00100000 | 1048576 | Grupos de geocercas |
| 0x00200000 | 2097152 | Etiquetas (pasajeros) |
| 0x00400000 | 4194304 | Lista de unidades a las que se pueden asignar etiquetas (pasajeros) automáticamente |
| 0x00800000 | 8388608 | Grupos de etiquetas (grupos de pasajeros) |
| 0x3FFFFFFFFFFFFFFF | 4611686018427387903 | Establecer todos los flags de recurso posibles |
Propiedades básicas
El flag de las propiedades básicas es 0x00000001.
{
"nm": <text>, /* Nombre */
"cls": <uint>, /* ID de superclase: "avl_resource" */
"id": <uint>, /* ID del recurso */
"mu": <uint>, /* Sistema de medida:
0 — SI,
1 — US,
2 — imperial,
3 — métrico con galones */
"uacl": <uint> /* Derechos de acceso del usuario actual al recurso */
}
Propiedades personalizadas
El flag de las propiedades personalizadas es 0x00000002.
Puede almacenar cualquier dato del recurso en las propiedades personalizadas.
{
"prp": { /* Propiedades personalizadas */
"emails": "[<text>]", /* Lista de emails para tareas */
"nf_rep_emails": "[<text>]", /* Lista de emails para notificaciones */
"phones": "[<text>]" /* Lista de números de teléfono para la tarea "Enviar información de combustible por email o SMS" */
...
},
"ftp": { /* Configuración FTP */
"hs": <text>, /* Host */
"lg": <text>, /* Inicio de sesión */
"pt": <text>, /* Ruta del directorio */
"ch": <uint>, /* Validez de la configuración FTP: 1 — sí, 0 — no */
"tp": <uint>, /* Usar FTP de Wialon Hosting: 1 — sí, 0 — no */
"fl": <uint> /* Disponibilidad de FTP de Wialon Hosting: 1 — sí, 0 — no */
}
}
Información de facturación
El flag de la información de facturación es 0x00000004.
{
"crt": <uint>, /* ID del creador */
"bact": <uint>, /* ID de la cuenta */
"bpact": <uint> /* ID de la cuenta principal */
}
Campos personalizados comunes
El flag de los campos personalizados es 0x00000008.
{
"flds": { /* Campos personalizados */
"<uint>": { /* Número de secuencia */
"id": <uint>, /* ID */
"n": <text>, /* Nombre */
"v": <text> /* Valor */
},
...
},
"fldsmax": <long> /* Cantidad máxima de campos personalizados (-1 para ilimitado) */
}
Mensajes
El flag de los mensajes es 0x00000020.
Después de establecer este flag, puede recibir mensajes del recurso.
{}
GUID
El flag del GUID es 0x00000040.
{
"gd":<text> /* GUID del recurso */
}
Campos personalizados administrativos
El flag de los campos personalizados administrativos es 0x00000080.
{
"aflds": { /* Campos administrativos */
"<uint>": { /* Número de secuencia */
"id": <uint>, /* ID */
"n": <text>, /* Nombre */
"v": <text> /* Valor */
},
...
},
"afldsmax": <long> /* Cantidad máxima de campos administrativos (-1 para ilimitado) */
}
Conductores
El flag de los conductores es 0x00000080.
{
"drvrs": {
<text>: { /* Número de secuencia del conductor */
"id": <long>, /* ID */
"n": <text>, /* Nombre */
"c": <text>, /* Código */
"pwd": <text>, /* Contraseña para autorización móvil */
"ej": <text>, /* JSON extendido */
"jp": { /* Campos personalizados */
<text>: <text>, /* Nombre: valor */
...
},
"ds": <text>, /* Descripción */
"p": <text>, /* Número de teléfono */
"r": <double>, /* Relación de aspecto de la imagen */
"ck": <ushort>, /* Suma de verificación (CRC16) */
"bu": <long>, /* Unidad asignada */
"pu": <long>, /* Unidad previamente asignada */
"bt": <uint>, /* Hora de la última asignación/separación */
"pos": { /* Ubicación */
"y": <double>, /* Latitud */
"x": <double> /* Longitud */
},
"infr": { /* Parámetros para analizar las infracciones de trabajo y descanso del conductor (AETR) */
"a": <uint>, /* Actividad actual */
"t": <uint>, /* Hora de inicio de la actividad actual */
"ud": <uint>, /* Duración de conducción ininterrumpida antes de la actividad actual */
"ur": <uint>, /* Duración de descanso ininterrumpido antes de la actividad actual */
"uil": <uint>, /* Duración permitida de conducción ininterrumpida */
"uim": <uint>, /* Duración máxima de conducción ininterrumpida para una infracción menor */
"uis": <uint>, /* Duración máxima de conducción ininterrumpida para una infracción grave. Si se excede, la infracción se clasifica como muy grave. */
"uir": <uint>, /* Duración de descanso requerida */
"ddt": <uint>, /* Tiempo de conducción diario antes de la actividad actual */
"ddc": <uint>, /* Cantidad de veces que se puede prolongar la conducción diaria esta semana */
"ddil": <uint>,/* Duración permitida de conducción diaria */
"ddim": <uint>,/* Duración máxima de conducción diaria para una infracción menor */
"ddis": <uint>,/* Duración máxima de conducción diaria para una infracción grave. Si se excede, la infracción se clasifica como muy grave. */
"wdt": <uint>, /* Duración de conducción semanal antes de la actividad actual */
"wdil": <uint>,/* Duración permitida de conducción semanal */
"wdim": <uint>,/* Duración máxima de conducción semanal para una infracción menor */
"wdis": <uint>,/* Duración máxima de conducción semanal para una infracción grave. Si se excede, la infracción se clasifica como muy grave. */
"twdt": <uint>,/* Duración de conducción quincenal antes de la actividad actual */
"twdil": <uint>,/* Duración permitida de conducción quincenal */
"twdim": <uint>,/* Duración máxima de conducción quincenal para una infracción menor */
"twdis": <uint>,/* Duración máxima de conducción quincenal para una infracción grave. Si se excede, la infracción se clasifica como muy grave. */
"drt": <uint>, /* Duración del descanso diario anterior*/
"drd": <uint>, /* Duración de descanso diario requerida */
"dril": <uint>, /* Tiempo antes del cual debe ocurrir el descanso diario */
"drim": <uint>, /* Tiempo antes del cual la infracción se clasifica como menor */
"dris": <uint>, /* Tiempo antes del cual la infracción se clasifica como grave. Si se excede, la infracción se clasifica como muy grave. */
"wrt": <uint>, /* Duración del descanso semanal anterior*/
"wrd": <uint>, /* Duración de descanso semanal requerida */
"wril": <uint>, /* Tiempo antes del cual debe ocurrir el descanso semanal */
"wrim": <uint>, /* Tiempo antes del cual la infracción se clasifica como menor */
"wris": <uint> /* Tiempo antes del cual la infracción se clasifica como grave. Si se excede, la infracción se clasifica como muy grave. */
}
},
...
},
"drvrsmax": <long> /* Cantidad máxima de conductores (-1 para ilimitado) */
}
Tareas
El flag de las tareas es 0x00000200.
{
"ujb": {
"<text>": { /* Número de secuencia de la tarea */
"id": <uint>, /* ID */
"n": <text>, /* Nombre */
"d": <text>, /* Descripción */
"m": <uint>, /* Cantidad máxima permitida de ejecuciones */
"st": { /* Estado */
"e": <uint>, /* Activa (1) / Inactiva (0) */
"c": <uint>, /* Cantidad de ejecuciones */
"l": <uint> /* Hora de la última ejecución (UTC) */
},
"act": <text> /* Tipo de acción */
},
...
},
"ujbmax": <long> /* Cantidad máxima de tareas (-1 para ilimitado) */
}
Los tipos de acción se describen en la sección get_job_data.
Notificaciones
El flag de las notificaciones es 0x00000400.
{
"unf": {
"<text>": { /* Número de secuencia de la notificación */
"id": <long>, /* ID de la notificación */
"n": <text>, /* Nombre */
"ta": <uint>, /* Hora de activación */
"td": <uint>, /* Hora de desactivación */
"ma": <uint>, /* Cantidad máxima de activaciones (0 para ilimitado) */
"fl": <uint>, /* Tipos de notificación */
"ac": <uint>, /* Cantidad de activaciones */
"un": [<long>], /* Matriz de ID de unidades */
"act": [<text>], /* Lista de acciones */
"trg": <text>, /* Tipo de control */
"crc": <long> /* Suma de verificación de la vista binaria de la notificación */
},
...
},
"unfmax": <long> /* Cantidad máxima de notificaciones (-1 para ilimitado) */
}
Los tipos de acción, tipos de control y flags de notificación se describen en la sección get_notification_data.
POI
El flag de los POI es 0x00000800.
{
"poi": {
"<text>": { /* Número de secuencia del POI */
"id": <long>, /* ID del POI */
"n": <text>, /* Nombre */
"y": <double>, /* Latitud */
"x": <double>, /* Longitud */
"t": <double>, /* Relación de aspecto de la imagen */
"i": <short>, /* Suma de verificación de la imagen (CRC16) */
"e": <ushort> /* Suma de verificación del POI (CRC16) */
},
...
},
"poimax": <long> /* Cantidad máxima de POI (-1 para ilimitado) */
}
Geocercas
El flag de las geocercas es 0x00001000.
{
"zl": {
"<text>": { /* Número de secuencia de la geocerca */
"n": <text>, /* Nombre */
"d": <text>, /* Descripción */
"id": <long>, /* ID */
"f": <uint>, /* Flags */
"t": <int>, /* Tipo: 1 — línea, 2 — polígono, 3 — círculo */
"e": <ushort>, /* Suma de verificación (CRC16) */
"b": { /* Configuración para renderizar geocercas */
"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 de la geocerca */
"cen_y": <double> /* Latitud del centro de la geocerca */
}
},
...
},
"zlmax": <long> /* Cantidad máxima de geocercas (-1 para ilimitado) */
}
Los flags de geocercas se describen en la sección get_zone_data.
Plantillas de informes
El flag de las plantillas de informes es 0x00002000.
{
"rep": {
<text>: { /* Número de secuencia de la plantilla */
"id": <long>, /* ID de la plantilla */
"n": <text>, /* Nombre de la plantilla */
"ct": <text>, /* Tipo de plantilla */
"c": <ushort> /* Suma de verificación (CRC16) */
},
...
},
"repmax": <long> /* Cantidad máxima de plantillas (-1 para ilimitado) */
}
Los tipos de plantilla se describen en la sección get_report_data.
Lista de unidades a las que se pueden asignar conductores automáticamente
El flag de las unidades a las que se pueden asignar conductores automáticamente es 0x00004000.
{
"drvrun": [<long>] /* Matriz de ID de unidades */
}
Grupos de conductores
El flag de los grupos de conductores es 0x00008000.
{
"drvrsgr": { /* Grupos de conductores */
<text>: { /* Número de secuencia del grupo */
"id": <long>, /* ID del grupo */
"n": <text>, /* Nombre del grupo */
"d": <text>, /* Descripción del grupo */
"drs": [<uint>] /* Matriz de ID de conductores */
},
...
},
"drvrsgrmax": <long> /* Cantidad máxima de grupos de conductores (-1 para ilimitado) */
}
Remolques
El flag de los remolques es 0x00010000
{
"trlrs": { /* Remolques */
<text>: { /* Número de secuencia del remolque */
"id": <long>, /* ID del remolque */
"n": <text>, /* Nombre del remolque */
"c": <text>, /* Código del remolque */
"ej": <text>, /* JSON extendido */
"jp": { /* Campos personalizados */
<text>: <text>, /* Nombre: valor */
...
},
"ds": <text>, /* Descripción */
"p": <text>, /* Número de teléfono */
"r": <double>, /* Relación de aspecto de la imagen */
"ck": <short>, /* Suma de verificación de la imagen */
"bu": <long>, /* Unidad asignada */
"pu": <long>, /* Unidad previamente asignada */
"bt": <uint>, /* Hora de la última asignación/separación */
"pos": { /* Ubicación */
"y": <double>, /* Latitud */
"x": <double> /* Longitud */
}
}
},
"trlrsmax": <long> /* Cantidad máxima de remolques (-1 para ilimitado) */
}
Grupos de remolques
El flag de los grupos de remolques es 0x00020000.
{
"trlrsgr": { /* Grupos de remolques */
<text>: { /* Número de secuencia del grupo */
"id": <long>, /* ID del grupo */
"n": <text>, /* Nombre del grupo */
"d": <text>, /* Descripción del grupo */
"drs": [<uint>] /* Matriz de ID de remolques */
}
},
"trlrsgrmax": <long> /* Cantidad máxima de grupos de remolques (-1 para ilimitado) */
}
Lista de unidades a las que se pueden asignar remolques automáticamente
El flag de las unidades a las que se pueden asignar remolques automáticamente es 0x00040000.
{
"trlrun": [<long>] /* Matriz de ID de unidades */
}
Pedidos
El flag de los pedidos es 0x00080000.
{
"orders": {
"<uint>": { /* Número de pedido, el mismo que en el parámetro "id" */
"id": <uint>, /* ID del pedido dentro del recurso */
"n": <text>, /* Nombre del pedido */
"p": { /* Contenido del objeto definido por el usuario */
...
},
"f": <bool>, /* Flags del pedido: 1 - se marca como completado si hay al menos un mensaje dentro del área del pedido con velocidad cero */
"tf": <uint>, /* Límite inferior del tiempo de finalización del pedido */
"tt": <uint>, /* Límite superior del tiempo de finalización del pedido */
"uid": <uint>, /* ID único (se utiliza como clave única en el historial de pedidos) */
"r": <uint>, /* Radio del punto del pedido */
"y": <double>, /* Latitud del punto del pedido */
"x": <double>, /* Longitud del punto del pedido */
"u": <long>, /* ID de la unidad */
"s": <uint>, /* Estado del pedido:
0 - inactivo (sin unidad asignada)
1 - activo (unidad asignada)
2 - completado a tiempo
3 - completado con retraso
4 - cancelado (no se utiliza) */
"st": <uint> /* Hora de la última modificación del estado */
},
...
}
}
Grupos de geocercas
El flag de los grupos de geocercas es 0x00100000.
{
"zg": { /* Grupos de geocercas */
"<text>": { /* Número de secuencia del grupo */
"id": <long>, /* ID del grupo */
"n": <text>, /* Nombre */
"d": <text>, /* Descripción */
"drs": [<uint>] /* Matriz de ID de geocercas */
},
...
},
"zgmax": <long> /* Cantidad máxima de grupos de geocercas (-1 para ilimitado) */
}
Etiquetas (pasajeros)
El flag de las etiquetas (pasajeros) es 0x00200000.
{
"item": {
"tags": {
"<uint>": { /* ID de la etiqueta */
"id": <uint>, /* ID de la etiqueta */
"n": <text>, /* Nombre de la etiqueta */
"c": <text>, /* Código de la etiqueta */
"jp": { /* Campos personalizados (clave:valor) */
"<text>": <text>
},
"r": <double>, /* Relación de aspecto de la imagen */
"ck": <ushort>, /* Suma de verificación (CRC16) */
"bu": <long>, /* Unidad asignada */
"pu": <long>, /* Unidad previamente asignada */
"bt": <uint>, /* Hora de la última asignación/separación */
"tz": <int>, /* Zona horaria */
"pos": { /* Ubicación */
"y": <double>, /* Latitud */
"x": <double> /* Longitud */
}
},
...
},
"tagsmax": -1 /* Cantidad máxima de etiquetas (-1 para ilimitado) */
}
}
Lista de unidades a las que se pueden asignar etiquetas automáticamente
El flag de las unidades a las que se pueden asignar etiquetas (pasajeros) automáticamente es 0x00400000.
{
"tagrun":[<long>] /* Matriz de ID de unidades */
}
Grupos de etiquetas (grupos de pasajeros)
El flag de los grupos de etiquetas (grupos de pasajeros) es 0x00800000.
{
"tagsgr": {
<long>: { /* ID del grupo */
"id": <long>, /* ID del grupo */
"n": <text>, /* Nombre del grupo */
"d": <text>, /* Descripción */
"tgs": [<uint>] /* Matriz de ID de etiquetas */
},
...
}
"tagsgrmax": -1 /* Cantidad máxima de grupos */
}