ПОИСК
 Аннотация
Позволяет в хронологическом порядке получить список данных от бортового компьютера. Благодаря данной функции Вы можете самостоятельно отслеживать уровень топлива в баке, применяя свои методы преобразования данных о напряжении в литры, калибровки и фильтрации, а также воспользоваться уже отфильтрованными и преобразованными данными для собственной визуализации или анализа. К критериям выборки относятся алгоритм расчетов, используемый для преобразования данных о напряжении в литры, флаги применения медианной фильтрации, фильтрации по среднему,фильтрации по бортовому напряжению
Запрос и получение данных с сервера происходит по протоколу http.
 Формат запроса
URL: http://api.car-online.ru/do?data=brk&skey=<ключ>&<другие параметры>
 Параметры запроса
ПараметрОписаниеЗначенияОбязательность
dataТип требуемой операцииbrkДа
skeyУникальный секретный ключ пользователя и его устройствакодовая строкаДа
patternШаблон представления данных с сервераИдентификатор шаблона (по умолчанию, ?)Нет
contentТип контента результата{text, xml} (по умолчанию, text). Если тип xml, то корневой элемент - root.Нет
beginДата/время начала выборки данныхДата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд. (по умолчанию, текущий день с нуля часов)Нет
endДата/время окончания выборки данныхДата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд. (по умолчанию, до конца текущего дня)Нет
algorithmАлгоритм преобразования данных о напряжении в литры1 - алгоритм интерполяции;2 - алгоритм мин\макс; 0 - без преобразования. (по умолчанию, 0)Нет
medianМедианная фильтрация данных1 - требуется фильтрация; 0 - без фильтрации. (по умолчанию, 0)Нет
averageФильтрация данных по среднему1 - требуется фильтрация; 0 - без фильтрации. (по умолчанию, 0)Нет
voltageФильтрация данных по напряжению - деление значения входа четыре на значение входа три1 - требуется фильтрация; 0 - без фильтрации. (по умолчанию, 0)Нет
 Формат ответа
Ответ с сервера формируется на основе заданного шаблона представления. Все данные закодированы таблицей UTF-8. В случае необходимости можно задавать атрибут contentType, указывающий на тип получаемой информации для служебных целей (например, чтобы корректно отображал браузер). Распространенные типы контента: text/html (информация представлена в html-формате) и text/xml (xml-разметка).
 Описание шаблона представления данных
Для получения данных с сервера нужно определить в каком формате их сформировать. Для этого необходимо задать шаблон. Вы можете использовать один из стандартных шаблонов Car-Online, либо создать свой.
 Шаблон для данных от брк
Для данных брк шаблон - это строка символов, описывающая данные, полученные с одним событием. В данную строку необходимо вставлять требуемые атрибуты событий. Шаблон может иметь любой формат (xml, просто текст..). Вы можете настраивать только нужные вам атрибуты. Для каждого события из протокла применяется указанный шаблон, которые разделяются новой строкой (то есть шаблоны отделяюся по переносу строки). В шаблоне допускается повторное использование одного и того же атрибута.
 Возможные атрибуты шаблона
АтрибутОписаниеЗначение
@datetimeДатаДата и время в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд.
@litreКоличество литров, вычисленное с помощью заданного в соответствующем параметре запроса алгоритма. Если алгоритм не выбран - всегда 0.Дробное число
@value3Значение третьего входа для данного событияЦелое число
@value4Значение четвертого входа для данного событияЦелое число
 Шаблон ошибок от сервера
В случае возникновения ошибок сервер отсылает информацию о возникшей проблеме. Чтобы получать в нужном виде эти сведения можно настроить соответствующий шаблон.
 Возможные атрибуты шаблона
АтрибутОписаниеЗначение
@codeУникальный код ошибкиЦелое число
@messageСообщение об ошибкеСтрока
 Примеры
Ниже представлены наиболее распространенные случаи использования экспорта данных брк.
 Простой запрос на получение событий текущего дня в стандартном виде
http://api.car-online.ru/do?data=brk&skey=914Ff68c6Cb5b65F535b254bb63E15&algorithm=2
Ответ
<brk datetime="30072009_182449" litre="60.4" value3="213" value4="62"/>
<brk datetime="30072009_175449" litre="60.5" value3="212" value4="63"/>
<brk datetime="30072009_172450" litre="60.7" value3="213" value4="65"/>
<brk datetime="30072009_165636" litre="60.8" value3="213" value4="66"/>
....
 Тот же запрос, но ответ в xml-представлении
http://api.car-online.ru/do?data=brk&skey=914Ff68c6Cb5b65F535b254bb63E15&algorithm=2&content=xml
Ответ
<?xml version="1.0" encoding="UTF-8"?>
 <root>
  <brk datetime="30072009_182449" litre="60.4" value3="213" value4="62"/>
  <brk datetime="30072009_175449" litre="60.5" value3="212" value4="63"/>
  <brk datetime="30072009_172450" litre="60.7" value3="213" value4="65"/>
  <brk datetime="30072009_165636" litre="60.8" value3="213" value4="66"/>
</root>
 Запрос на получение данных брк без использования алгоритма преобразования
http://api.car-online.ru/do?data=brk&skey=914Ff68c6Cb5b65F535b254bb63E15
Ответ
<brk datetime="30072009_182449" litre="0.0" value3="213" value4="62"/>
<brk datetime="30072009_175449" litre="0.0" value3="212" value4="63"/>
<brk datetime="30072009_172450" litre="0.0" value3="213" value4="65"/>
<brk datetime="30072009_165636" litre="0.0" value3="213" value4="66"/>
© 2009 Magic Systems. Все права защищены.