Recursos

Esta sección describe las marcas (flags) que se pueden aplicar a los recursos. Estas marcas determinan qué secciones de datos se incluyen en el objeto de respuesta JSON. Si se especifican varias marcas, sus respectivas partes se combinan en un solo JSON.

Dependiendo de las marcas especificadas, el formato de respuesta puede variar.

Marcas de recursos

Las siguientes marcas pueden aplicarse a los recursos:

Valor HEX Valor DEC Descripción
0x00000001 1 Marca 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 todas las marcas de recurso posibles

Propiedades básicas

La marca de las propiedades básicas es 0x00000001.

Copied!
{
    "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

La marca de las propiedades personalizadas es 0x00000002.

Puede almacenar cualquier dato del recurso en las propiedades personalizadas.

Copied!
{
    "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

La marca de la información de facturación es 0x00000004.

Copied!
{
    "crt": <uint>,   /* ID del creador */
    "bact": <uint>,  /* ID de la cuenta */
    "bpact": <uint>  /* ID de la cuenta principal */
}

Campos personalizados comunes

La marca de los campos personalizados es 0x00000008.

Copied!
{
    "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

La marca de los mensajes es 0x00000020.

Después de establecer esta marca, puede recibir mensajes del recurso.

Copied!
{}

GUID

La marca del GUID es 0x00000040.

Copied!
{
	"gd":<text>	/* GUID del recurso */
}

Campos personalizados administrativos

La marca de los campos personalizados administrativos es 0x00000080.

Copied!
{
	"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

La marca de los conductores es 0x00000080.

Copied!
{
	"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

La marca de las tareas es 0x00000200.

Copied!
{
	"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

La marca de las notificaciones es 0x00000400.

Copied!
{
	"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 marcas de notificación se describen en la sección get_notification_data.

POI

La marca de los POI es 0x00000800.

Copied!
{
	"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

La marca de las geocercas es 0x00001000.

Copied!
{
	"zl": {
		"<text>": {  /* Número de secuencia de la geocerca */
			"n": <text>,    /* Nombre */
			"d": <text>,    /* Descripción */
			"id": <long>,   /* ID */
			"f": <uint>,    /* Marcas */
			"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) */
}

Las marcas de geocercas se describen en la sección get_zone_data.

Plantillas de informes

La marca de las plantillas de informes es 0x00002000.

Copied!
{
	"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

La marca de las unidades a las que se pueden asignar conductores automáticamente es 0x00004000.

Copied!
{
	"drvrun": [<long>]	/* Matriz de ID de unidades */
}

Grupos de conductores

La marca de los grupos de conductores es 0x00008000.

Copied!
{
	"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

La marca de los remolques es 0x00010000

Copied!
{
	"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

La marca de los grupos de remolques es 0x00020000.

Copied!
{
	"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

La marca de las unidades a las que se pueden asignar remolques automáticamente es 0x00040000.

Copied!
{
	"trlrun": [<long>]	/* Matriz de ID de unidades */
}

Pedidos

La marca de los pedidos es 0x00080000.

Copied!
{
   "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>,    /* Marcas 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

La marca de los grupos de geocercas es 0x00100000.

Copied!
{
   "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)

La marca de las etiquetas (pasajeros) es 0x00200000.

Copied!
{
   "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

La marca de las unidades a las que se pueden asignar etiquetas (pasajeros) automáticamente es 0x00400000.

Copied!
{
    "tagrun":[<long>]	/* Matriz de ID de unidades */
}

Grupos de etiquetas (grupos de pasajeros)

La marca de los grupos de etiquetas (grupos de pasajeros) es 0x00800000.

Copied!
{
    "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 */
}

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

Informar de un error

Su mensaje ha sido enviado. ¡Gracias!

Se produjo un error al enviar el formulario