Wialon para desarrolladores Manual de usuario Documentación de API unit get_fuel_settings

get_fuel_settings

Para obtener los ajustes de consumo de combustible de una unidad, utilice el método unit/get_fuel_settings.

Endpoint

Copied!
svc=unit/get_fuel_settings&params={
	"itemId": <long>
}

Parámetros

La solicitud debe contener el siguiente parámetro:

Parámetro Descripción
itemId ID de la unidad.

Respuesta

Si la solicitud se completa con éxito, la respuesta se devuelve en el siguiente formato:

Copied!
{
	"calcTypes": <uint>,		/* Método de cálculo del consumo de combustible (ver abajo) */
	"fuelLevelParams": {		/* Detección de llenados y descargas de combustible */
		"flags": <uint>,		/* Flags para detectar llenados y descargas (ver abajo) */
		"ignoreStayTimeout": <uint>,	/* Ignorar mensajes después del inicio del movimiento (segundos) */
		"minFillingVolume": <double>,	/* Volumen mínimo de llenado de combustible (litros) */
		"minTheftTimeout": <uint>,	/* Tiempo mínimo de inactividad para detectar una descarga de combustible (segundos) */
		"minTheftVolume": <double>,	/* Volumen mínimo de descarga de combustible (litros) */
		"filterQuality": <ubyte>,	/* Nivel de filtración (rango: 0-255) */
		"fillingsJoinInterval": <uint>,	/* Intervalo para separar llenados consecutivos (segundos) */
		"theftsJoinInterval": <uint>,	/* Intervalo para separar descargas consecutivas (segundos) */
		"extraFillingTimeout": <uint>	/* Intervalo para detectar el volumen final del llenado (segundos) */
	},
	"fuelConsMath": {		/* Cálculo del consumo de combustible mediante fórmulas matemáticas */
		"idling": <double>,		/* Consumo de combustible en ralentí (litros por hora) */
		"urban": <double>,		/* Consumo en ciclo urbano (litros por 100 km) */
		"suburban": <double>		/* Consumo en ciclo extraurbano (litros por 100 km) */
	},
	"fuelConsRates": {		/* Consumo de combustible según normas estacionales */
		"consSummer": <double>,		/* Consumo en verano (litros por 100 km) */
		"consWinter": <double>,		/* Consumo en invierno (litros por 100 km) */
		"winterMonthFrom": <uint>,	/* Inicio del período de invierno (mes: 0-11) */
		"winterDayFrom": <uint>,	/* Inicio del período de invierno (día: 1-31) */
		"winterMonthTo": <uint>,	/* Fin del período de invierno (mes: 0-11) */
		"winterDayTo": <uint>		/* Fin del período de invierno (día: 1-31) */
	},
	"fuelConsImpulse": {		/* Sensores de impulsos del consumo de combustible */
		"maxImpulses": <uint>,		/* Cantidad máxima de impulsos */
		"skipZero": <uint>		/* Omitir el primer valor cero */
	}
}

Métodos de cálculo

El campo calcTypes contiene los siguientes flags:

Flag Descripción
0x0 No utilizar el consumo de combustible en los informes.
0x01 Calcular el consumo matemáticamente.
0x02 Sensores del nivel de combustible.
0x04 Reemplazar los valores incorrectos por los calculados matemáticamente.
0x08 Sensores del consumo de combustible absoluto.
0x10 Sensores de impulsos del consumo de combustible.
0x20 Sensores del consumo de combustible instantáneo.
0x40 Consumo según normas.

Flags de llenados y descargas de combustible

El campo flags del objeto fuelLevelParams contiene los siguientes flags:

Flag Descripción
0x01 Combinar los valores de los sensores del nivel de combustible con el mismo nombre.
0x02 Filtrar los valores de los sensores del nivel de combustible.
0x04 Combinar los valores de los sensores del consumo de combustible con el mismo nombre.
0x08 Detectar llenados de combustible solo durante las paradas.
0x10 Calcular el consumo de combustible por tiempo.
0x20 Ignorar la filtración del sensor al calcular la cantidad de combustible llenado y descargado (utilizar mensajes sin procesar).
0x40 Ignorar la filtración del sensor al calcular la cantidad de combustible llenado.
0x80 Ignorar la filtración del sensor al calcular la cantidad de combustible descargado.
0x100 Detectar descargas de combustible en movimiento.
0x200 Calcular los llenados de combustible por tiempo en lugar de por kilometraje.
0x400 Calcular las descargas de combustible por tiempo en lugar de por kilometraje.
0x800 Calcular el consumo de combustible por tiempo en lugar de por kilometraje.
0x1000 Reemplazar los valores incorrectos por los calculados matemáticamente.
0x2000 Devolver los ajustes de combustible predeterminados, si están configurados (filtración adaptativa y de mediana).
0x4000 Filtración adaptativa.

Estos ajustes pertenecen a la unidad. Los sensores de combustible de la unidad pueden tener sus propios ajustes en las claves calc_fuel y fuel_params de la configuración del sensor. Los ajustes del sensor anulan los ajustes de la unidad. Para más detalles, consulte unit/update_sensor.

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: falta itemId o no es un número.
7 La unidad no existe, o el usuario no tiene el derecho de acceso Ver objeto y sus propiedades básicas a ella.

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