Работа со списками ТС
Свойства общие
Описание
Тип
Операции
GroupsNum
Число групп
long
только чтение
CurrentGroupFileName
Файл текущей группы
BSTR
только чтение
CurrentCarDevice
Серийный номер текущего устройства
long
только чтение
Свойства группы
Описание
Тип
Операции
GroupIndex
Индекс выбранной группы (начинается с 1)
long
чтение/запись
GroupName
Название
BSTR
только чтение
GroupAddress
Адрес
BSTR
только чтение
GroupContacts
Контактная информация
BSTR
только чтение
GroupFileName
Файл группы (пустая строка – список по умолчанию CarsList.ini в рабочей папке)
BSTR
только чтение
GroupCarsNum
Число ТС
long
только чтение
Свойства ТС
Описание
Тип
Операции
CarIndex
Индекс выбранного ТС (начинается с 1)
long
чтение/запись
CarDevice
Серийный номер устройства
long
только чтение
CarModel
Марка/модель
BSTR
только чтение
CarNumber
Номер ТС
BSTR
только чтение
CarRoute
Маршрут
BSTR
только чтение
CarDrivers
Водители
BSTR
только чтение
CarAlias
Отображаемое название
BSTR
только чтение
CarTelNum
Номер телефона SIM-карты
BSTR
только чтение
CarCheckPointsFile
Файл со списком КТ
BSTR
только чтение
CarGeoZonesFile
Файл со списком ГЗ
BSTR
только чтение
Свойства online ТС
Описание
Тип
Операции
CarLatitude
Широта (< - 90 – координаты неизвестны)
double
только чтение
CarLongitude
Долгота (< - 180 – координаты неизвестны)
double
только чтение
CarCourse
Направление
double
только чтение
CarSpeed
Скорость
double
только чтение
CarParkTime
Время простоя (0 – движение; если > 1 ч, подсчёт продолжительности прекращается)
BSTR
только чтение
CarLastTime
-»- последних данных
BSTR
только чтение
CarLastATime
-»- последних координат
BSTR
только чтение
CarFlags
Состояние дискретных датчиков в битовых полях:
0x08 – питание; 0x04 – перемычка/время; 0x400 – остановка; 0x8000000 – координаты; 0x02, 0x01, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200 – датчики 1 – 8
long
только чтение
CarSensor1
Датчик 1 (0 – выключен, 1 – включен)
long
только чтение
CarSensor2
Датчик 2 (0 – выключен, 1 – включен)
long
только чтение
CarSensor3
Датчик 3 (0 – выключен, 1 – включен)
long
только чтение
CarSensor4
Датчик 4 (0 – выключен, 1 – включен)
long
только чтение
CarSensor5
Датчик 5 (0 – выключен, 1 – включен)
long
только чтение
CarSensor6
Датчик 6 (0 – выключен, 1 – включен)
long
только чтение
CarSensor7
Датчик 7 (0 – выключен, 1 – включен)
long
только чтение
CarSensor8
Датчик 8 (0 – выключен, 1 – включен)
long
только чтение
Функции
Описание
Вход
Выход
SetGroupIndexByFileName
Установить индекс группы
по имени файла группы
BSTR GroupFileName
HRESULT
SetCarIndexByDevice
Установить индекс ТС
по серийному номеру устройства
long CarDevice
HRESULT
SetCarChPParameters
(требуется ввод пароля)
Установить для ТС
параметры КТ
BSTR GroupFileName, long CarDevice,
long CarDefault, BSTR CarCheckPointsFile,
long CarCallPointsByPark, long CarCallPointsByParkTime,
long CarCallPointsBySens, long CarCallPointsBySensIndex,
long CarCallPointsBySensTime, BSTR CarGeoZonesFile
HRESULT
События
Описание
Тип
Операции
OnChangeCarsLists
Произошли изменения в списках ТС
TObject
–
OnReceiveOnlineData
Поступили новые online данные
TObject
–
Управление расчётами
Свойства
Описание
Тип
Операции
ComputingMode
Расчёт: 0 – переднего плана, 1 – фоновый (по умолчанию: 0)
long
чтение/запись
ComputingTimeout
Таймаут в секундах для функции WaitForComputing (по умолчанию: 15)
long
чтение/запись
ComputingBusy
Признак выполнения расчётов: 0 – готов, 1 – занят
long
только чтение
ComputingPercents
Процент выполнения расчётов
long
только чтение
ComputingCheck
Сверка параметров расчёта: 0 – не совпадают, 1 – совпадают
long
только чтение
Функции
Описание
Вход
Выход
StartComputing
Установить курсор на ТС, параметры и приступить к расчёту
DataSource – источник расчётов – «GSM» или «USB»
TakeTripsSetup – учитывать настройки рейсов ТС
BSTR GroupFileName, long CarDevice,
BSTR FirstTime, BSTR LastTime,
BSTR DataSource, long TakeTripsSetup
HRESULT
WaitForComputing
Установить курсор на ТС, параметры и дождаться окончания расчёта
DataSource – источник расчётов – «GSM» или «USB»
TakeTripsSetup – учитывать настройки рейсов ТС
BSTR GroupFileName, long CarDevice,
BSTR FirstTime, BSTR LastTime,
BSTR DataSource, long TakeTripsSetup
HRESULT
События
Описание
Тип
Операции
OnEndComputing
Завершение расчётов
TObject
–
Алгоритм управления расчётами переднего плана COM-клиентом (далее – клиент):
1. Вызвать функцию StartComputing с нужными параметрами:
GroupFileName – файл группы (пустая строка – список по умолчанию);
CarDevice – серийный номер устройства;
FirstTime – время начала расчётного периода;
LastTime – время окончания расчётного периода;
DataSource – источник расчётов – «GSM» или «USB».
После вызова этой функции программа АвтоГРАФ COM-сервер (далее – сервер) перейдёт в режим отображения данных за период, установит заданные начальное и конечное время и попытается установить курсор на заданное транспортное средство. Если в Data-папке сервера имеются файлы от заданного источника расчётов, то сервер попытается произвести расчёт. При этом признак ComputingBusy установится в значение 1, а переменная ComputingPercents будет показывать процент выполнения расчётов. После завершения расчётов ComputingBusy и ComputingPercents обнулятся, и возникнет событие OnEndComputing.
Признак ComputingBusy, переменная ComputingPercents меняют свои значения, а событие OnEndComputing возникает каждый раз при любом выполнении расчёта независимо от того, был этот расчёт вызван функцией StartComputing из данного клиента, какого-то другого или действиями оператора через интерфейс программы. Поэтому после окончания расчётов необходимо сверить параметры чтением признака ComputingCheck, который может принимать значение 1, если параметры расчёта не изменились с момента последнего вызова функции StartComputing, или – 0 в противном случае. При нулевом значении следует повторить попытку расчёта повторным вызовом функции StartComputing.
2. Дождаться завершения расчётов. Возможно два способа:
– ждать сброса признака ComputingBusy (с индикацией по ComputingPercents);
– ждать события OnEndComputing (с индикацией по ComputingPercents).
3. Сверить параметры расчёта чтением признака ComputingCheck. Если ComputingCheck равен 0, перейти к п. 1.
4. Получить данные выполненного расчёта.
Списки рейсов, пройденных контрольных точек, записей и координат
Свойства общие
Описание
Тип
Операции
TripsNum
Число рейсов
long
только чтение
CurrentTripIndex
Индекс текущего рейса (начинается с 1)
long
только чтение
Свойства рейса
Описание
Тип
Операции
TripIndex
Индекс выбранного рейса (начинается с 1)
long
чтение/запись
TripCase
Причина начала рейса
long
только чтение
TripRouteName
Название маршрута
BSTR
только чтение
TripDriverName
Водитель
BSTR
только чтение
TripDriverID
Идентификатор водителя
BSTR
только чтение
TripStartName
Название начальной точки
BSTR
только чтение
TripStartAddress
Адрес-»-
BSTR
только чтение
TripStartIDP
Идентификатор -»-
BSTR
только чтение
TripStartLatitude
Начальная широта (< - 90 – координаты неизвестны)
double
только чтение
TripStartLongitude
Начальная долгота (< - 180 – координаты неизвестны)
double
только чтение
TripStartRealTime
Время начала фактическое
BSTR
только чтение
TripStartRegTime
-»- начала регистрации координат
BSTR
только чтение
TripEndName
Название конечной точки
BSTR
только чтение
TripEndAddress
Адрес-»-
BSTR
только чтение
TripEndIDP
Идентификатор -»-
BSTR
только чтение
TripEndLatitude
Конечная широта (< - 90 – координаты неизвестны)
double
только чтение
TripEndLongitude
Конечная долгота (< - 180 – координаты неизвестны)
double
только чтение
TripEndRealTime
Время окончания фактическое
BSTR
только чтение
TripEndRegTime
-»- окончания регистрации координат
BSTR
только чтение
TripDistance
Пробег общий
double
только чтение
TripRealCont
Продолжительность фактическая
BSTR
только чтение
TripRegCont
-»- регистрации координат
BSTR
только чтение
TripMoveCont
-»- движения
BSTR
только чтение
TripParkCont
-»- остановок
BSTR
только чтение
TripMaxSpeed
Скорость максимальная
double
только чтение
TripAverSpeed
-»- средняя
double
только чтение
TripTank1StartLevel
Начальный уровень топлива в баке 1
double
только чтение
TripTank1EndLevel
Конечный -»-
double
только чтение
TripTank2StartLevel
Начальный уровень топлива в баке 2
double
только чтение
TripTank2EndLevel
Конечный -»-
double
только чтение
TripTank3StartLevel
Начальный уровень топлива в баке 3
double
только чтение
TripTank3EndLevel
Конечный -»-
double
только чтение
TripTank4StartLevel
Начальный уровень топлива в баке 4
double
только чтение
TripTank4EndLevel
Конечный -»-
double
только чтение
TripMotor1Hours
Время работы двигателя 1
double
только чтение
TripMotor1MoveHours
-»- во время движения
double
только чтение
TripMotor1ParkHours
-»- во время остановки
double
только чтение
TripMotor1Fuel
Расход топлива двигателем 1
double
только чтение
TripMotor2Hours
Время работы двигателя 2
double
только чтение
TripMotor2MoveHours
-»- во время движения
double
только чтение
TripMotor2ParkHours
-»- во время остановки
double
только чтение
TripMotor2Fuel
Расход топлива двигателем 2
double
только чтение
TripEntriesListTypeName,
TripEntriesListKindName
Тип и вид выбранного списка записей (точек/отрезков)
BSTR,
BSTR
чтение/запись,
чтение/запись
Тип
Вид
Описание
checkpoints
points
Контрольные точки
checkpoints
stages
Контрольные отрезки
geozones
zones
Геозоны
geozones
stages
Отрезки между геозонами
parks
Список остановок
blinds
Периоды отсутствия сигнала
power_off
Периоды пропадания питания
over_speed
Периоды превышения скорости
tank
num
Заправки и слива бака
sensor_on
num
Включение датчика
TripEntriesNum
Число информационных записей
long
только чтение
TripSensor1Cntr
Число включений датчика 1
long
только чтение
TripSensor1Distance
Пробег с включенным датчиком 1
double
только чтение
TripSensor1Cont
Продолжительность включений датчика 1
BSTR
только чтение
TripSensor2Cntr
Число включений датчика 2
long
только чтение
TripSensor2Distance
Пробег с включенным датчиком 2
double
только чтение
TripSensor2Cont
Продолжительность включений датчика 2
BSTR
только чтение
TripSensor3Cntr
Число включений датчика 3
long
только чтение
TripSensor3Distance
Пробег с включенным датчиком 3
double
только чтение
TripSensor3Cont
Продолжительность включений датчика 3
BSTR
только чтение
TripSensor4Cntr
Число включений датчика 4
long
только чтение
TripSensor4Distance
Пробег с включенным датчиком 4
double
только чтение
TripSensor4Cont
Продолжительность включений датчика 4
BSTR
только чтение
TripSensor5Cntr
Число включений датчика 5
long
только чтение
TripSensor5Distance
Пробег с включенным датчиком 5
double
только чтение
TripSensor5Cont
Продолжительность включений датчика 5
BSTR
только чтение
TripSensor6Cntr
Число включений датчика 6
long
только чтение
TripSensor6Distance
Пробег с включенным датчиком 6
double
только чтение
TripSensor6Cont
Продолжительность включений датчика 6
BSTR
только чтение
TripSensor7Cntr
Число включений датчика 7
long
только чтение
TripSensor7Distance
Пробег с включенным датчиком 7
double
только чтение
TripSensor7Cont
Продолжительность включений датчика 7
BSTR
только чтение
TripSensor8Cntr
Число включений датчика 8
long
только чтение
TripSensor8Distance
Пробег с включенным датчиком 8
double
только чтение
TripSensor8Cont
Продолжительность включений датчика 8
BSTR
только чтение
TripCrdEntriesNum
Число координатных записей
long
только чтение
TripCntr12EntriesNum
Число записей с данными счётчиков 1-2
long
только чтение
TripCntr34EntriesNum
-»- счётчиков 3-4
long
только чтение
TripCntr56EntriesNum
-»- счётчиков 5-6
long
только чтение
TripCntr78EntriesNum
-»- счётчиков 7-8
long
только чтение
Методы рейса
Описание
Вход
Выход
ExportListToFile
Экспортировать список заданного типа и вида в файл: csv, dbf или txt
(определяется по расширению файла)
BSTR FileName,
BSTR ListType,
BSTR ListKind,
long Add,
long CreateAlways
HRESULT
Тип списка
ListType
ListKind
Список рейсов
trips
Контрольные точки и отрезки
checkpoints
points_by_time
points_by_name
arrivals
stages
points_and_stages
Геозоны и отрезки
geozones
zones_by_time
zones_by_name
arrivals
stages
zones_and_stages
Остановки и отрезки движения
parks
Периоды отсутствия сигнала
blinds
Периоды отключения питания
power_off
Периоды превышения скорости
over_speed
Заправки и сливы бака
tank
num
Включение датчика
sensor_on
num
Тип данных
ListType
ListKind
Координаты (пробег, скорость)
data_coords
Уровень топлива в баке
data_level
num
Показания счётчиков
data_counters
num
Показания 1-wire температуры
data_1w_thermo
num
– индекс бака или датчика (начинается с 1);
– счётчики 12, 34, 56 или 78;
– термодатчики 14 или 58;
Add = 1 – добавление записей к уже существующему файлу
CreateAlways = 1 – в случае ошибки создавать пустой файл
Все списки, кроме списка рейсов, относятся к выбранному рейсу
ExportDataToFile
Экспортировать данные выбранного рейса в файл dbf
DataTypes – комбинация из следующих флагов:
0x0000001 – координаты;
0x0000002 – аналоговые данные;
0x0000004 – счётчики 1-2;
0x0000008 – счётчики 3-4;
0x0000010 – характеристика движения;
0x0000020 – событие;
0x0000040 – 1-wire ID водителя;
0x0000080 – 1-wire температура 1-4;
0x0000100 – 1-wire температура 5-8;
0x0000200 – RS-485: датчики LLS 1-4;
0x0000400 – RS-485: датчики LLS 5-8;
0x0000800 – CAN1: скор., упр,. расход;
0x0001000 – CAN2: уровни топлива;
0x0002000 – CAN3: обороты, моточасы;
0x0004000 – CAN4: температура;
0x0008000 – CAN5: пробеги общ. и сут.;
0x0010000 – CAN6: нагрузка на колёса;
0x0020000 – CAN7: записи пользователя;
0x0040000 – счётчики 5-6;
0x0080000 – счётчики 7-8;
0x0100000 – RS-485: объём заправки;
0x0200000 – RS-485: расход топлива;
0x0400000 – RS-485: продолжительность заправки;
0x0800000 – RS-485: расширитель входов;
0x1000000 – RS-485: пассажиропоток;
0x2000000 – RS-485: вес (уровень);
0x4000000 – CAN: коды ошибок;
0x8000000 – CAN: калькулированный расход
CreateAlways = 1 – в случае ошибки создавать пустой файл
BSTR FileName,
long DataTypes,
long CreateAlways
HRESULT
Свойства записи
Описание
Тип
Операции
EntryIndex
Индекс выбранной записи (начинается с 1)
long
чтение/запись
EntryID
Идентификатор записи
long
только чтение
EntryStartName
Название начальной точки
BSTR
только чтение
EntryStartAddress
Адрес-»-
BSTR
только чтение
EntryStartIDP
Идентификатор -»-
BSTR
только чтение
EntryStartType
Тип -»-
BSTR
только чтение
EntryStartChannel
Резерв
BSTR
только чтение
EntryStartLatitude
Начальная широта (< - 90 – координаты неизвестны)
double
только чтение
EntryStartLongitude
Начальная долгота (< - 180 – координаты неизвестны)
double
только чтение
EntryStartRealTime
Время прибытия/начала фактическое
BSTR
только чтение
EntryStartPlanTime
-»- прибытия планируемое
BSTR
только чтение
EntryEndName
Название конечной точки
BSTR
только чтение
EntryEndAddress
Адрес-»-
BSTR
только чтение
EntryEndIDP
Идентификатор -»-
BSTR
только чтение
EntryEndType
Тип -»-
BSTR
только чтение
EntryEndChannel
Резерв
BSTR
только чтение
EntryEndLatitude
Конечная широта (< - 90 – координаты неизвестны)
double
только чтение
EntryEndLongitude
Конечная долгота (< - 180 – координаты неизвестны)
double
только чтение
EntryEndRealTime
Время отправления/окончания фактическое
BSTR
только чтение
EntryEndPlanTime
-»- отправления планируемое
BSTR
только чтение
EntryDistance
Пробег общий
double
только чтение
EntryParkCntr
Число остановок
long
только чтение
EntryRealCont
Продолжительность фактическая
BSTR
только чтение
EntryPlanCont
-»- планируемая
BSTR
только чтение
EntryMoveCont
-»- движения
BSTR
только чтение
EntryParkCont
-»- остановок
BSTR
только чтение
EntryMaxSpeed
Скорость максимальная
double
только чтение
EntryAverSpeed
-»- средняя
double
только чтение
EntryTank1StartLevel
Начальный уровень топлива в баке 1
double
только чтение
EntryTank1EndLevel
Конечный -»-
double
только чтение
EntryTank2StartLevel
Начальный уровень топлива в баке 2
double
только чтение
EntryTank2EndLevel
Конечный -»-
double
только чтение
EntryTank3StartLevel
Начальный уровень топлива в баке 3
double
только чтение
EntryTank3EndLevel
Конечный -»-
double
только чтение
EntryTank4StartLevel
Начальный уровень топлива в баке 4
double
только чтение
EntryTank4EndLevel
Конечный -»-
double
только чтение
EntryMotor1Hours
Время работы двигателя 1
double
только чтение
EntryMotor1MoveHours
-»- во время движения
double
только чтение
EntryMotor1ParkHours
-»- во время остановки
double
только чтение
EntryMotor1Fuel
Расход топлива двигателем 1
double
только чтение
EntryMotor2Hours
Время работы двигателя 2
double
только чтение
EntryMotor2MoveHours
-»- во время движения
double
только чтение
EntryMotor2ParkHours
-»- во время остановки
double
только чтение
EntryMotor2Fuel
Расход топлива двигателем 2
double
только чтение
Свойства координат
Описание
Тип
Операции
CrdEntryIndex
Индекс выбранной координаты (начинается с 1)
long
чтение/запись
CrdEntryTime
Время
BSTR
только чтение
CrdEntryLongitude
Долгота
double
только чтение
CrdEntryLatitude
Широта
double
только чтение
CrdEntryDistance
Пробег (от начала рейса)
double
только чтение
CrdEntrySpeed
Скорость
double
только чтение
CrdEntryFlags
Состояние дискретных датчиков в битовых полях:
0x08 – питание; 0x04 – перемычка/время; 0x400 – остановка; 0x8000000 – координаты; 0x02, 0x01, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200 – датчики 1 – 8
long
только чтение
CrdEntrySensor1
Датчик 1 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor2
Датчик 2 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor3
Датчик 3 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor4
Датчик 4 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor5
Датчик 5 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor6
Датчик 6 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor7
Датчик 7 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor8
Датчик 8 (0 – выключен, 1 – включен)
long
только чтение
CrdEntryLLS1
Показание датчика LLS 1
long
только чтение
CrdEntryLLS2
Показание датчика LLS 2
long
только чтение
CrdEntryLLS3
Показание датчика LLS 3
long
только чтение
CrdEntryLLS4
Показание датчика LLS 4
long
только чтение
CrdEntryLLS5
Показание датчика LLS 5
long
только чтение
CrdEntryLLS6
Показание датчика LLS 6
long
только чтение
CrdEntryLLS7
Показание датчика LLS 7
long
только чтение
CrdEntryLLS8
Показание датчика LLS 8
long
только чтение
CrdEntryDriverName
Водитель
BSTR
только чтение
CrdEntryDriverID
Идентификатор водителя
BSTR
только чтение
CrdEntryChPName
Имя контрольной точки
BSTR
только чтение
CrdEntryChPAddress
Адрес контрольной точки
BSTR
только чтение
CrdEntryChPID
Идентификатор контрольной точки
BSTR
только чтение
CrdEntryGeoZName
Имя геозоны
BSTR
только чтение
CrdEntryGeoZAddress
Адрес геозоны
BSTR
только чтение
CrdEntryGeoZID
Идентификатор геозоны
BSTR
только чтение
TrackCrdsStr
Координаты трека в виде строки: долгота1 широта1,долгота2 широта2 и т. д.
BSTR
только чтение
TrackCrdsArray
Массив, содержащий последовательно следующие данные типа double:
– время;
– широта;
– долгота;
– пробег (от начала рейса);
– скорость
VARIANT
только чтение
Свойства счётчиков
Описание
Тип
Операции
Counters12Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 1;
– счётчик 2
VARIANT
только чтение
Counters34Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 3;
– счётчик 4
VARIANT
только чтение
Counters56Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 5;
– счётчик 6
VARIANT
только чтение
Counters78Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 7;
– счётчик 8
VARIANT
только чтение
Функции
Описание
Вход
Выход
ExportCarsToFile
Экспортировать последние положения ТС текущей группы в kml-файл.
CarDevices – список серийных номеров устройств, разделённых запятыми (пустая строка – все ТС группы);
TimeOffset – смещение времени в часах;
CreateAlways = 1 – в случае ошибки создавать пустой файл;
WaitForCompleted = 1 – ждать завершения экспорта
BSTR FileName, BSTR CarDevices,
long PropDefault, BSTR Comment,
BSTR Placemark, long TimeOffset,
long CreateAlways,
long WaitForCompleted
HRESULT
ExportTrackToFile
Экспортировать трек выбранного рейса в файл: kml или plt
(определяется по расширению файла)
IconTypes – комбинация из следующих флагов:
0x00002 – остановки;
0x00004 – отсутствие сигнала;
0x00008 – отключение питания;
0x00010 – превышение скорости;
0x00020 – заправки и сливы;
0x01000 – включение датчика 1;
0x80000 – включение датчика 8;
IconTypes = - 1 – текущие настройки карты;
TimeOffset – смещение времени в часах;
CreateAlways = 1 – в случае ошибки создавать пустой файл;
WaitForCompleted = 1 – ждать завершения экспорта
BSTR FileName, long PropDefault,
BSTR Comment, BSTR Placemark,
long TrackThick, long TrackColorIndex,
long IconTypes, long TimeOffset,
long CreateAlways,
long WaitForCompleted
HRESULT
SetCrdEntryIndexByTime
Установить индекс записи по времени
BSTR Time
HRESULT
Работа со списком КТ
Свойства общие
Описание
Тип
Операции
CheckPointsNum
Число КТ
long
только чтение
CurrentCheckPointIndex
Индекс КТ, содержащей координаты, заданные SetCurrentCoords (0 – нет КТ)
long
только чтение
Свойства КТ
Описание
Тип
Операции
CheckPointIndex
Индекс выбранной КТ (начинается с 1)
long
чтение/запись
CheckPointName
Название
BSTR
чтение/запись
CheckPointAddress
Адрес
BSTR
чтение/запись
CheckPointID
Идентификатор
BSTR
чтение/запись
CheckPointLatitude
Широта (для полигонов только чтение)
double
чтение/запись
CheckPointLongitude
Долгота (для полигонов только чтение)
double
чтение/запись
CheckPointRadius
Радиус (для полигонов только чтение)
long
чтение/запись
CheckPointFixTime
Время фиксации, с (по умолчанию: 0)
long
чтение/запись
CheckPointWeekDays
Проверочные дни недели (по умолчанию: все)
long
чтение/запись
Функции общие
Описание
Вход
Выход
LoadChPFromFile
Загрузить список КТ из файла
BSTR FileName – имя файла
HRESULT
SaveChPToFile
Сохранить список КТ в файл
BSTR FileName – имя файла
HRESULT
ClearCheckPoints
Очистить список КТ
–
HRESULT
AddCheckPoint
Добавить КТ (окружность) в список
BSTR Name, BSTR Address, BSTR ID, double Latitude, double Longitude, long Radius
HRESULT
AddCheckPointEx
Добавить КТ (окружность) в список
BSTR Name, BSTR Address, BSTR ID, double Latitude, double Longitude, long Radius, long FixTime, long WeekDays
HRESULT
DeleteCheckPoint
Удалить выбранную КТ
–
HRESULT
SetCurrentCoords
Установить текущие координаты для проверки CurrentCheckPointIndex
double Latitude, double Longitude
HRESULT
Свойства и функции прочие
Свойства
Описание
Тип
Операции
CurrentVersion
Текущая версия ПО
BSTR
только чтение
WorkDirectory
Рабочая папка
BSTR
только чтение
PropertyName
Задаёт имя параметра для последующего чтения его значения свойством PropertyValue
BSTR
чтение/запись
Имя
Описание
Current_Version
Текущая версия ПО
Operator
Рабочая папка
Group_Name
Название
Group_Address
Адрес
Group_Contacts
Контактная информация
Group_FileName
Файл группы
Group_CarsNum
Число ТС
Car_Device
Серийный номер устройства
Car_Model
Марка/модель
Car_Number
Номер ТС
Car_Route
Маршрут
Car_Drivers
Водители
Car_Alias
Отображаемое название
Car_TelNum
Номер телефона SIM-карты
Car_CheckPointsFile
Файл со списком КТ
Car_GeoZonesFile
Файл со списком ГЗ
Car_LastTime
Время последних данных
Car_LastATime
-»- последних координат
Trip_Case
Причина начала рейса
Trip_RouteName
Название маршрута
Trip_StartRealTime
Время начала фактическое
Trip_StartRegTime
-»- начала регистрации координат
Trip_EndRealTime
Время окончания фактическое
Trip_EndRegTime
-»- окончания регистрации координат
Trip_Distance
Пробег общий
Trip_RealCont
Число остановок
Trip_RegCont
Продолжительность фактическая (в пределах рейса)
Trip_MoveCont
-»- движения
Trip_ParkCont
-»- остановок
Trip_MaxSpeed
Скорость максимальная
Trip_AverSpeed
-»- средняя
Trip_Tank1StartLevel
Начальный уровень топлива в баке 1
Trip_Tank1EndLevel
Конечный -»-
Trip_Tank2StartLevel
Начальный уровень топлива в баке 2
Trip_Tank2EndLevel
Конечный -»-
Trip_Tank3StartLevel
Начальный уровень топлива в баке 3
Trip_Tank3EndLevel
Конечный -»-
Trip_Tank4StartLevel
Начальный уровень топлива в баке 4
Trip_Tank4EndLevel
Конечный -»-
Trip_Motor1Hours
Время работы двигателя 1
Trip_Motor1MoveHours
-»- во время движения
Trip_Motor1ParkHours
-»- во время остановки
Trip_Motor1Fuel
Расход топлива двигателем 1
Trip_Motor2Hours
Время работы двигателя 2
Trip_Motor2MoveHours
-»- во время движения
Trip_Motor2ParkHours
-»- во время остановки
Trip_Motor2Fuel
Расход топлива двигателем 2
PropertyCheck
Проверка параметра на существование: 0 – не существует, 1 – существует
long
только чтение
PropertyValue
Принимает значение параметра, заданного по имени свойством PropertyName
BSTR
чтение/запись
CmnExPropertyValue
Принимает значение параметра, заданного функцией CmnExPropertySet
BSTR
чтение/запись
CarExPropertyValue
Принимает значение параметра, заданного функцией CarExPropertySet
BSTR
чтение/запись
Функции
Описание
Вход
Выход
CmnExPropertySet
Установить общий произвольный параметр для последующего чтения свойством CmnExPropertyValue
BSTR PropertyName
HRESULT
CarExPropertySet
Установить произвольный параметр ТС для последующего чтения свойством CarExPropertyValue
BSTR PropertyName, long SerNum
HRESULT
WaitForInitializing
Дождаться инициализации online данных ТС
–
HRESULT
Sleep
Ждать (выполнения расчёта)
long Milliseconds
HRESULT
ShowApplication
Показать приложение
–
HRESULT
HideApplication
Скрыть приложение
–
HRESULT
GoToCarLastPosition
Перейти к последнему местоположению ТС
BSTR GroupFileName, long CarDevice
HRESULT
GoToCarLastTrack
Перейти к последнему треку ТС
BSTR GroupFileName, long CarDevice
HRESULT
EnterPassword
Ввести пароль
BSTR Password
HRESULT
События
Описание
Тип
Операции
OnCloseServer
Сервер завершил работу
TObject
–
OnCloseNotifier
Клиентская программа оповещения должна завершить работу
TObject
–
OnChangeParameters
Произошли изменения в параметрах
TObject
–
13PAGE 15
13PAGE 141615
Заголовок 115
Свойства общие
Описание
Тип
Операции
GroupsNum
Число групп
long
только чтение
CurrentGroupFileName
Файл текущей группы
BSTR
только чтение
CurrentCarDevice
Серийный номер текущего устройства
long
только чтение
Свойства группы
Описание
Тип
Операции
GroupIndex
Индекс выбранной группы (начинается с 1)
long
чтение/запись
GroupName
Название
BSTR
только чтение
GroupAddress
Адрес
BSTR
только чтение
GroupContacts
Контактная информация
BSTR
только чтение
GroupFileName
Файл группы (пустая строка – список по умолчанию CarsList.ini в рабочей папке)
BSTR
только чтение
GroupCarsNum
Число ТС
long
только чтение
Свойства ТС
Описание
Тип
Операции
CarIndex
Индекс выбранного ТС (начинается с 1)
long
чтение/запись
CarDevice
Серийный номер устройства
long
только чтение
CarModel
Марка/модель
BSTR
только чтение
CarNumber
Номер ТС
BSTR
только чтение
CarRoute
Маршрут
BSTR
только чтение
CarDrivers
Водители
BSTR
только чтение
CarAlias
Отображаемое название
BSTR
только чтение
CarTelNum
Номер телефона SIM-карты
BSTR
только чтение
CarCheckPointsFile
Файл со списком КТ
BSTR
только чтение
CarGeoZonesFile
Файл со списком ГЗ
BSTR
только чтение
Свойства online ТС
Описание
Тип
Операции
CarLatitude
Широта (< - 90 – координаты неизвестны)
double
только чтение
CarLongitude
Долгота (< - 180 – координаты неизвестны)
double
только чтение
CarCourse
Направление
double
только чтение
CarSpeed
Скорость
double
только чтение
CarParkTime
Время простоя (0 – движение; если > 1 ч, подсчёт продолжительности прекращается)
BSTR
только чтение
CarLastTime
-»- последних данных
BSTR
только чтение
CarLastATime
-»- последних координат
BSTR
только чтение
CarFlags
Состояние дискретных датчиков в битовых полях:
0x08 – питание; 0x04 – перемычка/время; 0x400 – остановка; 0x8000000 – координаты; 0x02, 0x01, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200 – датчики 1 – 8
long
только чтение
CarSensor1
Датчик 1 (0 – выключен, 1 – включен)
long
только чтение
CarSensor2
Датчик 2 (0 – выключен, 1 – включен)
long
только чтение
CarSensor3
Датчик 3 (0 – выключен, 1 – включен)
long
только чтение
CarSensor4
Датчик 4 (0 – выключен, 1 – включен)
long
только чтение
CarSensor5
Датчик 5 (0 – выключен, 1 – включен)
long
только чтение
CarSensor6
Датчик 6 (0 – выключен, 1 – включен)
long
только чтение
CarSensor7
Датчик 7 (0 – выключен, 1 – включен)
long
только чтение
CarSensor8
Датчик 8 (0 – выключен, 1 – включен)
long
только чтение
Функции
Описание
Вход
Выход
SetGroupIndexByFileName
Установить индекс группы
по имени файла группы
BSTR GroupFileName
HRESULT
SetCarIndexByDevice
Установить индекс ТС
по серийному номеру устройства
long CarDevice
HRESULT
SetCarChPParameters
(требуется ввод пароля)
Установить для ТС
параметры КТ
BSTR GroupFileName, long CarDevice,
long CarDefault, BSTR CarCheckPointsFile,
long CarCallPointsByPark, long CarCallPointsByParkTime,
long CarCallPointsBySens, long CarCallPointsBySensIndex,
long CarCallPointsBySensTime, BSTR CarGeoZonesFile
HRESULT
События
Описание
Тип
Операции
OnChangeCarsLists
Произошли изменения в списках ТС
TObject
–
OnReceiveOnlineData
Поступили новые online данные
TObject
–
Управление расчётами
Свойства
Описание
Тип
Операции
ComputingMode
Расчёт: 0 – переднего плана, 1 – фоновый (по умолчанию: 0)
long
чтение/запись
ComputingTimeout
Таймаут в секундах для функции WaitForComputing (по умолчанию: 15)
long
чтение/запись
ComputingBusy
Признак выполнения расчётов: 0 – готов, 1 – занят
long
только чтение
ComputingPercents
Процент выполнения расчётов
long
только чтение
ComputingCheck
Сверка параметров расчёта: 0 – не совпадают, 1 – совпадают
long
только чтение
Функции
Описание
Вход
Выход
StartComputing
Установить курсор на ТС, параметры и приступить к расчёту
DataSource – источник расчётов – «GSM» или «USB»
TakeTripsSetup – учитывать настройки рейсов ТС
BSTR GroupFileName, long CarDevice,
BSTR FirstTime, BSTR LastTime,
BSTR DataSource, long TakeTripsSetup
HRESULT
WaitForComputing
Установить курсор на ТС, параметры и дождаться окончания расчёта
DataSource – источник расчётов – «GSM» или «USB»
TakeTripsSetup – учитывать настройки рейсов ТС
BSTR GroupFileName, long CarDevice,
BSTR FirstTime, BSTR LastTime,
BSTR DataSource, long TakeTripsSetup
HRESULT
События
Описание
Тип
Операции
OnEndComputing
Завершение расчётов
TObject
–
Алгоритм управления расчётами переднего плана COM-клиентом (далее – клиент):
1. Вызвать функцию StartComputing с нужными параметрами:
GroupFileName – файл группы (пустая строка – список по умолчанию);
CarDevice – серийный номер устройства;
FirstTime – время начала расчётного периода;
LastTime – время окончания расчётного периода;
DataSource – источник расчётов – «GSM» или «USB».
После вызова этой функции программа АвтоГРАФ COM-сервер (далее – сервер) перейдёт в режим отображения данных за период, установит заданные начальное и конечное время и попытается установить курсор на заданное транспортное средство. Если в Data-папке сервера имеются файлы от заданного источника расчётов, то сервер попытается произвести расчёт. При этом признак ComputingBusy установится в значение 1, а переменная ComputingPercents будет показывать процент выполнения расчётов. После завершения расчётов ComputingBusy и ComputingPercents обнулятся, и возникнет событие OnEndComputing.
Признак ComputingBusy, переменная ComputingPercents меняют свои значения, а событие OnEndComputing возникает каждый раз при любом выполнении расчёта независимо от того, был этот расчёт вызван функцией StartComputing из данного клиента, какого-то другого или действиями оператора через интерфейс программы. Поэтому после окончания расчётов необходимо сверить параметры чтением признака ComputingCheck, который может принимать значение 1, если параметры расчёта не изменились с момента последнего вызова функции StartComputing, или – 0 в противном случае. При нулевом значении следует повторить попытку расчёта повторным вызовом функции StartComputing.
2. Дождаться завершения расчётов. Возможно два способа:
– ждать сброса признака ComputingBusy (с индикацией по ComputingPercents);
– ждать события OnEndComputing (с индикацией по ComputingPercents).
3. Сверить параметры расчёта чтением признака ComputingCheck. Если ComputingCheck равен 0, перейти к п. 1.
4. Получить данные выполненного расчёта.
Списки рейсов, пройденных контрольных точек, записей и координат
Свойства общие
Описание
Тип
Операции
TripsNum
Число рейсов
long
только чтение
CurrentTripIndex
Индекс текущего рейса (начинается с 1)
long
только чтение
Свойства рейса
Описание
Тип
Операции
TripIndex
Индекс выбранного рейса (начинается с 1)
long
чтение/запись
TripCase
Причина начала рейса
long
только чтение
TripRouteName
Название маршрута
BSTR
только чтение
TripDriverName
Водитель
BSTR
только чтение
TripDriverID
Идентификатор водителя
BSTR
только чтение
TripStartName
Название начальной точки
BSTR
только чтение
TripStartAddress
Адрес-»-
BSTR
только чтение
TripStartIDP
Идентификатор -»-
BSTR
только чтение
TripStartLatitude
Начальная широта (< - 90 – координаты неизвестны)
double
только чтение
TripStartLongitude
Начальная долгота (< - 180 – координаты неизвестны)
double
только чтение
TripStartRealTime
Время начала фактическое
BSTR
только чтение
TripStartRegTime
-»- начала регистрации координат
BSTR
только чтение
TripEndName
Название конечной точки
BSTR
только чтение
TripEndAddress
Адрес-»-
BSTR
только чтение
TripEndIDP
Идентификатор -»-
BSTR
только чтение
TripEndLatitude
Конечная широта (< - 90 – координаты неизвестны)
double
только чтение
TripEndLongitude
Конечная долгота (< - 180 – координаты неизвестны)
double
только чтение
TripEndRealTime
Время окончания фактическое
BSTR
только чтение
TripEndRegTime
-»- окончания регистрации координат
BSTR
только чтение
TripDistance
Пробег общий
double
только чтение
TripRealCont
Продолжительность фактическая
BSTR
только чтение
TripRegCont
-»- регистрации координат
BSTR
только чтение
TripMoveCont
-»- движения
BSTR
только чтение
TripParkCont
-»- остановок
BSTR
только чтение
TripMaxSpeed
Скорость максимальная
double
только чтение
TripAverSpeed
-»- средняя
double
только чтение
TripTank1StartLevel
Начальный уровень топлива в баке 1
double
только чтение
TripTank1EndLevel
Конечный -»-
double
только чтение
TripTank2StartLevel
Начальный уровень топлива в баке 2
double
только чтение
TripTank2EndLevel
Конечный -»-
double
только чтение
TripTank3StartLevel
Начальный уровень топлива в баке 3
double
только чтение
TripTank3EndLevel
Конечный -»-
double
только чтение
TripTank4StartLevel
Начальный уровень топлива в баке 4
double
только чтение
TripTank4EndLevel
Конечный -»-
double
только чтение
TripMotor1Hours
Время работы двигателя 1
double
только чтение
TripMotor1MoveHours
-»- во время движения
double
только чтение
TripMotor1ParkHours
-»- во время остановки
double
только чтение
TripMotor1Fuel
Расход топлива двигателем 1
double
только чтение
TripMotor2Hours
Время работы двигателя 2
double
только чтение
TripMotor2MoveHours
-»- во время движения
double
только чтение
TripMotor2ParkHours
-»- во время остановки
double
только чтение
TripMotor2Fuel
Расход топлива двигателем 2
double
только чтение
TripEntriesListTypeName,
TripEntriesListKindName
Тип и вид выбранного списка записей (точек/отрезков)
BSTR,
BSTR
чтение/запись,
чтение/запись
Тип
Вид
Описание
checkpoints
points
Контрольные точки
checkpoints
stages
Контрольные отрезки
geozones
zones
Геозоны
geozones
stages
Отрезки между геозонами
parks
Список остановок
blinds
Периоды отсутствия сигнала
power_off
Периоды пропадания питания
over_speed
Периоды превышения скорости
tank
num
Заправки и слива бака
sensor_on
num
Включение датчика
TripEntriesNum
Число информационных записей
long
только чтение
TripSensor1Cntr
Число включений датчика 1
long
только чтение
TripSensor1Distance
Пробег с включенным датчиком 1
double
только чтение
TripSensor1Cont
Продолжительность включений датчика 1
BSTR
только чтение
TripSensor2Cntr
Число включений датчика 2
long
только чтение
TripSensor2Distance
Пробег с включенным датчиком 2
double
только чтение
TripSensor2Cont
Продолжительность включений датчика 2
BSTR
только чтение
TripSensor3Cntr
Число включений датчика 3
long
только чтение
TripSensor3Distance
Пробег с включенным датчиком 3
double
только чтение
TripSensor3Cont
Продолжительность включений датчика 3
BSTR
только чтение
TripSensor4Cntr
Число включений датчика 4
long
только чтение
TripSensor4Distance
Пробег с включенным датчиком 4
double
только чтение
TripSensor4Cont
Продолжительность включений датчика 4
BSTR
только чтение
TripSensor5Cntr
Число включений датчика 5
long
только чтение
TripSensor5Distance
Пробег с включенным датчиком 5
double
только чтение
TripSensor5Cont
Продолжительность включений датчика 5
BSTR
только чтение
TripSensor6Cntr
Число включений датчика 6
long
только чтение
TripSensor6Distance
Пробег с включенным датчиком 6
double
только чтение
TripSensor6Cont
Продолжительность включений датчика 6
BSTR
только чтение
TripSensor7Cntr
Число включений датчика 7
long
только чтение
TripSensor7Distance
Пробег с включенным датчиком 7
double
только чтение
TripSensor7Cont
Продолжительность включений датчика 7
BSTR
только чтение
TripSensor8Cntr
Число включений датчика 8
long
только чтение
TripSensor8Distance
Пробег с включенным датчиком 8
double
только чтение
TripSensor8Cont
Продолжительность включений датчика 8
BSTR
только чтение
TripCrdEntriesNum
Число координатных записей
long
только чтение
TripCntr12EntriesNum
Число записей с данными счётчиков 1-2
long
только чтение
TripCntr34EntriesNum
-»- счётчиков 3-4
long
только чтение
TripCntr56EntriesNum
-»- счётчиков 5-6
long
только чтение
TripCntr78EntriesNum
-»- счётчиков 7-8
long
только чтение
Методы рейса
Описание
Вход
Выход
ExportListToFile
Экспортировать список заданного типа и вида в файл: csv, dbf или txt
(определяется по расширению файла)
BSTR FileName,
BSTR ListType,
BSTR ListKind,
long Add,
long CreateAlways
HRESULT
Тип списка
ListType
ListKind
Список рейсов
trips
Контрольные точки и отрезки
checkpoints
points_by_time
points_by_name
arrivals
stages
points_and_stages
Геозоны и отрезки
geozones
zones_by_time
zones_by_name
arrivals
stages
zones_and_stages
Остановки и отрезки движения
parks
Периоды отсутствия сигнала
blinds
Периоды отключения питания
power_off
Периоды превышения скорости
over_speed
Заправки и сливы бака
tank
num
Включение датчика
sensor_on
num
Тип данных
ListType
ListKind
Координаты (пробег, скорость)
data_coords
Уровень топлива в баке
data_level
num
Показания счётчиков
data_counters
num
Показания 1-wire температуры
data_1w_thermo
num
– термодатчики 14 или 58;
Add = 1 – добавление записей к уже существующему файлу
CreateAlways = 1 – в случае ошибки создавать пустой файл
Все списки, кроме списка рейсов, относятся к выбранному рейсу
ExportDataToFile
Экспортировать данные выбранного рейса в файл dbf
DataTypes – комбинация из следующих флагов:
0x0000001 – координаты;
0x0000002 – аналоговые данные;
0x0000004 – счётчики 1-2;
0x0000008 – счётчики 3-4;
0x0000010 – характеристика движения;
0x0000020 – событие;
0x0000040 – 1-wire ID водителя;
0x0000080 – 1-wire температура 1-4;
0x0000100 – 1-wire температура 5-8;
0x0000200 – RS-485: датчики LLS 1-4;
0x0000400 – RS-485: датчики LLS 5-8;
0x0000800 – CAN1: скор., упр,. расход;
0x0001000 – CAN2: уровни топлива;
0x0002000 – CAN3: обороты, моточасы;
0x0004000 – CAN4: температура;
0x0008000 – CAN5: пробеги общ. и сут.;
0x0010000 – CAN6: нагрузка на колёса;
0x0020000 – CAN7: записи пользователя;
0x0040000 – счётчики 5-6;
0x0080000 – счётчики 7-8;
0x0100000 – RS-485: объём заправки;
0x0200000 – RS-485: расход топлива;
0x0400000 – RS-485: продолжительность заправки;
0x0800000 – RS-485: расширитель входов;
0x1000000 – RS-485: пассажиропоток;
0x2000000 – RS-485: вес (уровень);
0x4000000 – CAN: коды ошибок;
0x8000000 – CAN: калькулированный расход
CreateAlways = 1 – в случае ошибки создавать пустой файл
BSTR FileName,
long DataTypes,
long CreateAlways
HRESULT
Свойства записи
Описание
Тип
Операции
EntryIndex
Индекс выбранной записи (начинается с 1)
long
чтение/запись
EntryID
Идентификатор записи
long
только чтение
EntryStartName
Название начальной точки
BSTR
только чтение
EntryStartAddress
Адрес-»-
BSTR
только чтение
EntryStartIDP
Идентификатор -»-
BSTR
только чтение
EntryStartType
Тип -»-
BSTR
только чтение
EntryStartChannel
Резерв
BSTR
только чтение
EntryStartLatitude
Начальная широта (< - 90 – координаты неизвестны)
double
только чтение
EntryStartLongitude
Начальная долгота (< - 180 – координаты неизвестны)
double
только чтение
EntryStartRealTime
Время прибытия/начала фактическое
BSTR
только чтение
EntryStartPlanTime
-»- прибытия планируемое
BSTR
только чтение
EntryEndName
Название конечной точки
BSTR
только чтение
EntryEndAddress
Адрес-»-
BSTR
только чтение
EntryEndIDP
Идентификатор -»-
BSTR
только чтение
EntryEndType
Тип -»-
BSTR
только чтение
EntryEndChannel
Резерв
BSTR
только чтение
EntryEndLatitude
Конечная широта (< - 90 – координаты неизвестны)
double
только чтение
EntryEndLongitude
Конечная долгота (< - 180 – координаты неизвестны)
double
только чтение
EntryEndRealTime
Время отправления/окончания фактическое
BSTR
только чтение
EntryEndPlanTime
-»- отправления планируемое
BSTR
только чтение
EntryDistance
Пробег общий
double
только чтение
EntryParkCntr
Число остановок
long
только чтение
EntryRealCont
Продолжительность фактическая
BSTR
только чтение
EntryPlanCont
-»- планируемая
BSTR
только чтение
EntryMoveCont
-»- движения
BSTR
только чтение
EntryParkCont
-»- остановок
BSTR
только чтение
EntryMaxSpeed
Скорость максимальная
double
только чтение
EntryAverSpeed
-»- средняя
double
только чтение
EntryTank1StartLevel
Начальный уровень топлива в баке 1
double
только чтение
EntryTank1EndLevel
Конечный -»-
double
только чтение
EntryTank2StartLevel
Начальный уровень топлива в баке 2
double
только чтение
EntryTank2EndLevel
Конечный -»-
double
только чтение
EntryTank3StartLevel
Начальный уровень топлива в баке 3
double
только чтение
EntryTank3EndLevel
Конечный -»-
double
только чтение
EntryTank4StartLevel
Начальный уровень топлива в баке 4
double
только чтение
EntryTank4EndLevel
Конечный -»-
double
только чтение
EntryMotor1Hours
Время работы двигателя 1
double
только чтение
EntryMotor1MoveHours
-»- во время движения
double
только чтение
EntryMotor1ParkHours
-»- во время остановки
double
только чтение
EntryMotor1Fuel
Расход топлива двигателем 1
double
только чтение
EntryMotor2Hours
Время работы двигателя 2
double
только чтение
EntryMotor2MoveHours
-»- во время движения
double
только чтение
EntryMotor2ParkHours
-»- во время остановки
double
только чтение
EntryMotor2Fuel
Расход топлива двигателем 2
double
только чтение
Свойства координат
Описание
Тип
Операции
CrdEntryIndex
Индекс выбранной координаты (начинается с 1)
long
чтение/запись
CrdEntryTime
Время
BSTR
только чтение
CrdEntryLongitude
Долгота
double
только чтение
CrdEntryLatitude
Широта
double
только чтение
CrdEntryDistance
Пробег (от начала рейса)
double
только чтение
CrdEntrySpeed
Скорость
double
только чтение
CrdEntryFlags
Состояние дискретных датчиков в битовых полях:
0x08 – питание; 0x04 – перемычка/время; 0x400 – остановка; 0x8000000 – координаты; 0x02, 0x01, 0x10, 0x20, 0x40, 0x80, 0x100, 0x200 – датчики 1 – 8
long
только чтение
CrdEntrySensor1
Датчик 1 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor2
Датчик 2 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor3
Датчик 3 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor4
Датчик 4 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor5
Датчик 5 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor6
Датчик 6 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor7
Датчик 7 (0 – выключен, 1 – включен)
long
только чтение
CrdEntrySensor8
Датчик 8 (0 – выключен, 1 – включен)
long
только чтение
CrdEntryLLS1
Показание датчика LLS 1
long
только чтение
CrdEntryLLS2
Показание датчика LLS 2
long
только чтение
CrdEntryLLS3
Показание датчика LLS 3
long
только чтение
CrdEntryLLS4
Показание датчика LLS 4
long
только чтение
CrdEntryLLS5
Показание датчика LLS 5
long
только чтение
CrdEntryLLS6
Показание датчика LLS 6
long
только чтение
CrdEntryLLS7
Показание датчика LLS 7
long
только чтение
CrdEntryLLS8
Показание датчика LLS 8
long
только чтение
CrdEntryDriverName
Водитель
BSTR
только чтение
CrdEntryDriverID
Идентификатор водителя
BSTR
только чтение
CrdEntryChPName
Имя контрольной точки
BSTR
только чтение
CrdEntryChPAddress
Адрес контрольной точки
BSTR
только чтение
CrdEntryChPID
Идентификатор контрольной точки
BSTR
только чтение
CrdEntryGeoZName
Имя геозоны
BSTR
только чтение
CrdEntryGeoZAddress
Адрес геозоны
BSTR
только чтение
CrdEntryGeoZID
Идентификатор геозоны
BSTR
только чтение
TrackCrdsStr
Координаты трека в виде строки: долгота1 широта1,долгота2 широта2 и т. д.
BSTR
только чтение
TrackCrdsArray
Массив, содержащий последовательно следующие данные типа double:
– время;
– широта;
– долгота;
– пробег (от начала рейса);
– скорость
VARIANT
только чтение
Свойства счётчиков
Описание
Тип
Операции
Counters12Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 1;
– счётчик 2
VARIANT
только чтение
Counters34Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 3;
– счётчик 4
VARIANT
только чтение
Counters56Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 5;
– счётчик 6
VARIANT
только чтение
Counters78Array
Массив, содержащий последовательно следующие данные типа double:
– время;
– счётчик 7;
– счётчик 8
VARIANT
только чтение
Функции
Описание
Вход
Выход
ExportCarsToFile
Экспортировать последние положения ТС текущей группы в kml-файл.
CarDevices – список серийных номеров устройств, разделённых запятыми (пустая строка – все ТС группы);
TimeOffset – смещение времени в часах;
CreateAlways = 1 – в случае ошибки создавать пустой файл;
WaitForCompleted = 1 – ждать завершения экспорта
BSTR FileName, BSTR CarDevices,
long PropDefault, BSTR Comment,
BSTR Placemark, long TimeOffset,
long CreateAlways,
long WaitForCompleted
HRESULT
ExportTrackToFile
Экспортировать трек выбранного рейса в файл: kml или plt
(определяется по расширению файла)
IconTypes – комбинация из следующих флагов:
0x00002 – остановки;
0x00004 – отсутствие сигнала;
0x00008 – отключение питания;
0x00010 – превышение скорости;
0x00020 – заправки и сливы;
0x01000 – включение датчика 1;
0x80000 – включение датчика 8;
IconTypes = - 1 – текущие настройки карты;
TimeOffset – смещение времени в часах;
CreateAlways = 1 – в случае ошибки создавать пустой файл;
WaitForCompleted = 1 – ждать завершения экспорта
BSTR FileName, long PropDefault,
BSTR Comment, BSTR Placemark,
long TrackThick, long TrackColorIndex,
long IconTypes, long TimeOffset,
long CreateAlways,
long WaitForCompleted
HRESULT
SetCrdEntryIndexByTime
Установить индекс записи по времени
BSTR Time
HRESULT
Работа со списком КТ
Свойства общие
Описание
Тип
Операции
CheckPointsNum
Число КТ
long
только чтение
CurrentCheckPointIndex
Индекс КТ, содержащей координаты, заданные SetCurrentCoords (0 – нет КТ)
long
только чтение
Свойства КТ
Описание
Тип
Операции
CheckPointIndex
Индекс выбранной КТ (начинается с 1)
long
чтение/запись
CheckPointName
Название
BSTR
чтение/запись
CheckPointAddress
Адрес
BSTR
чтение/запись
CheckPointID
Идентификатор
BSTR
чтение/запись
CheckPointLatitude
Широта (для полигонов только чтение)
double
чтение/запись
CheckPointLongitude
Долгота (для полигонов только чтение)
double
чтение/запись
CheckPointRadius
Радиус (для полигонов только чтение)
long
чтение/запись
CheckPointFixTime
Время фиксации, с (по умолчанию: 0)
long
чтение/запись
CheckPointWeekDays
Проверочные дни недели (по умолчанию: все)
long
чтение/запись
Функции общие
Описание
Вход
Выход
LoadChPFromFile
Загрузить список КТ из файла
BSTR FileName – имя файла
HRESULT
SaveChPToFile
Сохранить список КТ в файл
BSTR FileName – имя файла
HRESULT
ClearCheckPoints
Очистить список КТ
–
HRESULT
AddCheckPoint
Добавить КТ (окружность) в список
BSTR Name, BSTR Address, BSTR ID, double Latitude, double Longitude, long Radius
HRESULT
AddCheckPointEx
Добавить КТ (окружность) в список
BSTR Name, BSTR Address, BSTR ID, double Latitude, double Longitude, long Radius, long FixTime, long WeekDays
HRESULT
DeleteCheckPoint
Удалить выбранную КТ
–
HRESULT
SetCurrentCoords
Установить текущие координаты для проверки CurrentCheckPointIndex
double Latitude, double Longitude
HRESULT
Свойства и функции прочие
Свойства
Описание
Тип
Операции
CurrentVersion
Текущая версия ПО
BSTR
только чтение
WorkDirectory
Рабочая папка
BSTR
только чтение
PropertyName
Задаёт имя параметра для последующего чтения его значения свойством PropertyValue
BSTR
чтение/запись
Имя
Описание
Current_Version
Текущая версия ПО
Operator
Рабочая папка
Group_Name
Название
Group_Address
Адрес
Group_Contacts
Контактная информация
Group_FileName
Файл группы
Group_CarsNum
Число ТС
Car_Device
Серийный номер устройства
Car_Model
Марка/модель
Car_Number
Номер ТС
Car_Route
Маршрут
Car_Drivers
Водители
Car_Alias
Отображаемое название
Car_TelNum
Номер телефона SIM-карты
Car_CheckPointsFile
Файл со списком КТ
Car_GeoZonesFile
Файл со списком ГЗ
Car_LastTime
Время последних данных
Car_LastATime
-»- последних координат
Trip_Case
Причина начала рейса
Trip_RouteName
Название маршрута
Trip_StartRealTime
Время начала фактическое
Trip_StartRegTime
-»- начала регистрации координат
Trip_EndRealTime
Время окончания фактическое
Trip_EndRegTime
-»- окончания регистрации координат
Trip_Distance
Пробег общий
Trip_RealCont
Число остановок
Trip_RegCont
Продолжительность фактическая (в пределах рейса)
Trip_MoveCont
-»- движения
Trip_ParkCont
-»- остановок
Trip_MaxSpeed
Скорость максимальная
Trip_AverSpeed
-»- средняя
Trip_Tank1StartLevel
Начальный уровень топлива в баке 1
Trip_Tank1EndLevel
Конечный -»-
Trip_Tank2StartLevel
Начальный уровень топлива в баке 2
Trip_Tank2EndLevel
Конечный -»-
Trip_Tank3StartLevel
Начальный уровень топлива в баке 3
Trip_Tank3EndLevel
Конечный -»-
Trip_Tank4StartLevel
Начальный уровень топлива в баке 4
Trip_Tank4EndLevel
Конечный -»-
Trip_Motor1Hours
Время работы двигателя 1
Trip_Motor1MoveHours
-»- во время движения
Trip_Motor1ParkHours
-»- во время остановки
Trip_Motor1Fuel
Расход топлива двигателем 1
Trip_Motor2Hours
Время работы двигателя 2
Trip_Motor2MoveHours
-»- во время движения
Trip_Motor2ParkHours
-»- во время остановки
Trip_Motor2Fuel
Расход топлива двигателем 2
PropertyCheck
Проверка параметра на существование: 0 – не существует, 1 – существует
long
только чтение
PropertyValue
Принимает значение параметра, заданного по имени свойством PropertyName
BSTR
чтение/запись
CmnExPropertyValue
Принимает значение параметра, заданного функцией CmnExPropertySet
BSTR
чтение/запись
CarExPropertyValue
Принимает значение параметра, заданного функцией CarExPropertySet
BSTR
чтение/запись
Функции
Описание
Вход
Выход
CmnExPropertySet
Установить общий произвольный параметр для последующего чтения свойством CmnExPropertyValue
BSTR PropertyName
HRESULT
CarExPropertySet
Установить произвольный параметр ТС для последующего чтения свойством CarExPropertyValue
BSTR PropertyName, long SerNum
HRESULT
WaitForInitializing
Дождаться инициализации online данных ТС
–
HRESULT
Sleep
Ждать (выполнения расчёта)
long Milliseconds
HRESULT
ShowApplication
Показать приложение
–
HRESULT
HideApplication
Скрыть приложение
–
HRESULT
GoToCarLastPosition
Перейти к последнему местоположению ТС
BSTR GroupFileName, long CarDevice
HRESULT
GoToCarLastTrack
Перейти к последнему треку ТС
BSTR GroupFileName, long CarDevice
HRESULT
EnterPassword
Ввести пароль
BSTR Password
HRESULT
События
Описание
Тип
Операции
OnCloseServer
Сервер завершил работу
TObject
–
OnCloseNotifier
Клиентская программа оповещения должна завершить работу
TObject
–
OnChangeParameters
Произошли изменения в параметрах
TObject
–
13PAGE 15
13PAGE 141615
Заголовок 115