Объекты

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

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

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

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

Флаг - 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" - нет */
		/* используется один из параметров для указания источника цвета для трека */
		"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

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

{}

Флаг - 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>	/* значение поля */
	}
}