Содержание

Объекты

В зависимости от установленных флагов формат ответа может варьироваться.

В данном разделе рассмотрены флаги, применимые к объектам, и части результирующего JSON, за которые они отвечают. При указании нескольких флагов части будут собираться в один JSON.

:!: Все флаги используются только в DEC формате.

Флаги объектов:

Значение HEX Значение DEC Описание
0x00000001 1 базовый флаг
0x00000002 2 произвольные свойства
0x00000004 4 свойства биллинга
0x00000008 8 произвольные поля
0x00000010 16 изображение
0x00000020 32 сообщения
0x00000040 64 GUID
0x00000080 128 административные записи
0x00000100 256 дополнительные свойства
0x00000200 512 доступные в данный момент команды
0x00000400 1024 последнее сообщение и местоположение
0x00001000 4096 датчики
0x00002000 8192 счетчики
0x00008000 32768 техобслуживание
0x00020000 131072 конфигурация объекта в отчетах: детектор поездок и расход топлива
0x00080000 524288 список всех возможных команд
0x00100000 1048576 параметры сообщений
0x00200000 2097152 состояние подключения объекта
0x00400000 4194304 местоположение
0x00800000 8388608 характеристики
0x3FFFFFFFFFFFFFFF 4611686018427387903 устанавливает все возможные флаги для объекта

Основные свойства

Флаг - 0x00000001

{
	"mu":<uint>,	/* единицы измерения: 0 - si, 1 - us, 2 - имперская, 3 - метрическая с галлонами */
	"nm":<text>,	/* название */
	"cls":<uint>,	/* ID базового класса "avl_unit" */
	"id":<uint>,	/* ID объекта */
	"uacl":<uint>	/* уровень доступа к объекту у текущего пользователя */
}

Произвольные свойства

Флаг - 0x00000002

В произвольных свойствах вы можете сохранять любые нужные вам данные об объекте.
Пример использования с Wialon Hosting.

{
	"prp":{					/* произвольные свойства */
		"img_rot":<text>,		/* поворачивать иконки объектов: "1" - да, "0" - нет */
		"monitoring_sensor_id":<text>,	/* ID датчика, который будет отображаться в панели мониторинга */
		"motion_state_sensor_id":<text>,/* ID датчика, по которому будут отображаться состояния движения */
		"sensors_colors_id":<text>,	/* ID датчика - источника цвета для трека */
		"use_sensor_color":<text>, 	/* использовать цвет датчика в панели мониторинга: "1" - да, "0" - нет */
		"label_color":<text>, 	/* цвет подписи объекта */
		/* используется один из параметров для указания источника цвета для трека */
		"sensors_colors":<text>,	/* таблица цвета трека по датчику */
		"solid_colors":<text>,		/* цвет трека */	
		"speed_colors":<text>,		/* таблица цвета трека по скорости */
		/*используются для хранения последних используемых цветов*/
		"track_sensor":<text>,		/* таблица цвета трека по датчику */
		"track_solid":<text>,		/* цвет трека */
		"track_speed":<text>,		/* таблица цвета трека по скорости */
                "monitoring_battery_id":<text>, /* ID датчика, показывающий значение заряда батареи */
		...
	},
	"ct":<uint>,			/* дата создания */
}

Биллинг

Флаг - 0x00000004

{
	"crt":<uint>,	/* ID создателя */
	"bact":<uint>	/* ID учетной записи */
}

Произвольные поля

Флаг - 0x00000008

{
	"flds":{	/* список произвольных полей */			
		<text>:{		/* порядковый номер произвольного поля */
			"id":<uint>,	/* ID */
			"n":<text>,	/* имя */
			"v":<text>	/* значение */
		},
		...
	},
	"fldsmax":<long>,	/* максимальное количество произвольных полей (-1 - не ограничено) */
}

Изображение объекта

Флаг - 0x00000010

{
	"uri":<text>	/* ссылка на изображение */
	"ugi":<uint>	/* счетчик изменений изображения */
}

Сообщения

Флаг - 0x00000020

Установка данного флага позволяет принимать сообщения от объекта.

{}

GUID

Флаг - 0x00000040

{
	"gd":<text>	/* GUID  объекта */
}

Административные записи

Flag - 0x00000080

{
	"aflds":{	/* административные записи */		
		<text>:{	/* порядковый номер */
			"id":<uint>,	/* ID */
			"n":<text>,	/* название */
			"v":<text>	/* значение */
		},
		...
	},
	"afldsmax":<long>,	/* максимально допустимое количество административных записей (-1 - не ограничено) */
}

Дополнительные свойства

Флаг - 0x00000100

{
	"uid":<text>,	/* уникальный ID оборудования */
	"uid2":<text>,	/* второй уникальный ID оборудования */
	"hw":<long>,	/* тип оборудования */
	"ph":<text>,	/* телефонный номер */
	"ph2":<text>,	/* второй телефонный номер */
	"psw":<text>	/* пароль */
	"act":<bool>	/* деактивирован объект - 0, активирован - 1 */
	"dactt":<long>	/* время деактивация UNIX time, 0 - объект не был деактивирован */
 
}

Доступные в данный момент команды

Флаг - 0x00000200

{
	"cmds":[		/* массив команд */
		{			
			"n":<text>,	/* название команды */
			"a":<uint>,	/* уровень доступа */
			"t":<text>,	/* тип связи */
			"c":<text>	/* тип команды */
		}
	]
}

Типы команд и связи рассмотрены в разделе Команды: cоздание, редактирование и удаление, а список флагов доступа к объекту можно посмотреть в разделах Флаги доступа: Общие и Флаги доступа: Объекты и группы объектов.

Последнее сообщение и местоположение

Флаг - 0x00000400

{
	"pos":{			/* последнее известное местоположение */
		"t":<uint>,		/* время UTC */
		"y":<double>,		/* широта */
		"x":<double>,		/* долгота */
		"z":<double>,		/* высота над уровнем моря */
		"s":<int>,		/* скорость */
		"c":<int>,		/* курс */
		"sc":<int>		/* спутники */
	},
	"lmsg":{		/* последнее известное сообщение */
		...
	}
}

Формат последнего сообщения зависит от его типа, все типы рассмотрены в разделе Форматы данных: Сообщения.

Датчики

Флаг - 0x00001000

{
	"sens":{		/* датчики */
		<text>:{		/* номер датчика */
			"id":<long>,		/* ID */
			"n":<text>,		/* название */
			"t":<text>,		/* тип */
			"d":<text>,		/* описание */
			"m":<text>,		/* единица измерения */
			"p":<text>,		/* параметр */
			"f":<uint>,		/* флаги датчика */ 
			"c":<text>,		/* конфигурация */
			"vt":<uint>,		/* тип валидации */
			"vs":<uint>,		/* ID валидирующего датчика */
			"tbl":[			/* таблица расчета */
				{			/* параметры */
					"x":<double>, 
					"a":<double>,
					"b":<double>
				}
			]
		},
		...
	},
	"sens_max":<long>	/* количество датчиков, разрешенное тарифным планом (-1 - не ограничено) */
}

Флаги датчика, типы датчиков и валидации, а также примеры конфигурации рассмотрены в разделе Датчики: создание, редактирование и удаление.

Счетчики

Флаг - 0x00002000

{
	"cfl":<uint>,	/* флаги калькуляции */
	"cnm":<uint>,	/* счетчик пробега, км или мили */
	"cneh":<uint>,	/* счетчик моточасов, ч */
	"cnkb":<uint>	/* счетчик GPRS-трафика, Кб */
}

Флаги калькуляции рассмотрены в разделе Параметры калькуляции счетчиков.

Техобслуживание

Флаг - 0x00008000

{
	"si":{			/*записи о техобслуживании*/
		<text>:{		/* порядковый номер */
			"id":<uint>,	/* ID */
			"n":<text>,	/* название */
			"t":<text>,	/* описание */
			"im":<uint>,	/* интервал по пробегу */
			"it":<uint>,	/* интервал в днях */
			"ie":<uint>,	/* интервал по моточасам */
			"pm":<uint>,	/* последнее техобслуживание для интервала по пробегу, км */
			"pt":<uint>,	/* последнее техобслуживание для интервала в днях (дата в секундах) */
			"pe":<uint>,	/* последнее техобслуживание для интервала по моточасам, ч */
			"c":<uint>	/* количество выполнений */
		},
		...
	},
	"simax":<long>		 /* количество записей, разрешенное тарифным планом (-1 - не ограничено) */
}

Детектор поездок и расход топлива

Флаг - 0x00020000

{
	"rtd":{				/* детектор поездок */
		"type":<uint>,			/* тип определения движения */
		"gpsCorrection":<int>,		/* коррекция по GPS: 0 - выключить, 1 - включить */
		"minSat":<uint>,		/* минимальное количество спутников */
		"minMovingSpeed":<uint>,	/* минимальная скорость движения, км/ч */
		"minStayTime":<uint>,		/* минимальное время стоянки, секунд */
		"maxMessagesDistance":<uint>,	/* максимальное расстояние между сообщениями, метров */
		"minTripTime":<uint>,		/* минимальное время поездки, секунд */
		"minTripDistance":<uint>	/* минимальное расстояние поездки, метров */
	},
	"rfc":{				/* расход топлива */
		"calcTypes":<uint>,		/* тип расчета */
		"fuelLevelParams":{		/* определение заправок/сливов топлива */
			"flags":<uint>,			/* флаги заправки/слива топлива */ 
			"ignoreStayTimeout":<uint>,	/* игнорировать сообщения после начала движения, секунд */
			"minFillingVolume":<uint>,	/* минимальный объем заправки, литров */
			"minTheftTimeout":<uint>,	/* минимальное время остановки для определения слива, секунд */
			"minTheftVolume":<uint>,	/* минимальный объем слива, литров */
			"filterQuality":<ubyte>,	/* степень фильтрации (0..255) */
			"fillingsJoinInterval":<uint>,	/* таймаут для разделения заправок, секунд */
			"theftsJoinInterval":<uint>,	/* таймаут для разделения сливов, секунд */
			"extraFillingTimeout":<uint>	/* таймаут для определения полного объема заправки, секунд */
		},
		"fuelConsMath":{		/* расход по расчету */
			"idling":<double>,		/* на холостом ходу, литров в час */
			"urban":<double>,		/* городской цикл, литров на 100 км */
			"suburban":<double>		/* загородный цикл, литров на 100 км */
		},
		"fuelConsRates":{		/* расход по нормам */
			"consSummer":<int>,		/* расход летом, литров на 100 км */
			"consWinter":<int>,		/* расход зимой, литров на 100 км */
			"winterMonthFrom":<int>,	/* зима от (месяц 0-11) */
			"winterDayFrom":<int>,		/* зима от (день 1-31) */
			"winterMonthTo":<int>,		/* зима до (месяц 0-11) */
			"winterDayTo":<int>		/* зима до (день 1-31) */
		},
		"fuelConsImpulse":{		/* импульсные датчики расхода топлива */
			"maxImpulses":<int>,		/* максимум импульсов */
			"skipZero":<int>		/* пропускать начальные нулевые значения */
		}
	}
}

Типы определения движения рассмотрены в разделе Детектор поездок, а типы расчета расхода топлива и флаги заправки и слива можно посмотреть в разделе Расход топлива.

Команды

Флаг - 0x00080000

{
	"cml":{			/* список команд */
		<text>:{		/* порядковый номер команды */
			"id":<uint>,		/* ID */
			"n":<text>,		/* названиe */
			"c":<text>,		/* тип */
			"l":<text>,		/* тип связи */
			"p":<text>,		/* параметры */
			"a":<uint>,		/* уровень доступа (права, которыми должен обладать пользователь, чтобы выполнить данную команду) */
			"f":<uint>		/* отправлять на номер: 0-любой (первичный, затем вторичный), 0x1-первичный, 0x2-вторичный */
		},
		...
	},
	"cml_max":<long>	/* максимальное количество команд, разрешенное тарифным планом (-1 - не ограничено) */
}

Типы команд и связи рассмотрены в разделе Команды: cоздание, редактирование и удаление, а список флагов доступа к объекту можно посмотреть в разделах Флаги доступа: Общие и Флаги доступа: Объекты и группы объектов.

Параметры сообщений

Позволяет ипользовать накопительную систему значений параметров сообщений. Параметры будут сохранятся в соответствующем разделе JSON объекта, в котором будут хранится значения не только параметров, присутствующих в последнем сообщении, но и значения параметров из более ранних сообщений.

Flag - 0x00100000

{
	"prms":{	/* список параметров сообщений */
		<text>:{	/* имя параметра */
			"v":<any>,	/*значение параметра */
			"ct":<uint>,	/* время последнего изменения значения */
			"at":<uint>	/* время последнего сообщения, содержащего данный параметр */
		},
		...
	}
}

Состояние подключения

Показывает состояние подключения объекта.

Flag - 0x00200000

{
	"item":{
		"netconn":<bool>
	}
}

Местоположение

Флаг - 0x00400000

{
	"pos":{			/* последнее известное местоположение */
		"t":<uint>,		/* время UTC */
		"y":<double>,		/* широта */
		"x":<double>,		/* долгота */
		"z":<double>,		/* высота над уровнем моря */
		"s":<int>,		/* скорость */
		"c":<int>,		/* курс */
		"sc":<int>		/* спутники */
	}
}

Характеристики

Флаг - 0x00800000

{
	"pflds":{
		"<long>":{		/* ID поля*/
			"id":<long>,	/* ID поля */
			"n":<text>,	/* имя поля */
			"v":<text>	/* значение поля */
	}
}