Получайте статистику по работе вашего объекта. Производится расчет различных характеристик на основе собранных данных, таких как, пробег за период, средняя и максимальная скорости, время работы двигателя, число маршрутов и стоянок... Со временем список доступных характеристик будет пополняться.
Запрос и получение данных с сервера происходит по протоколу http.
URL: http://api.car-online.ru/do?data=telemetry&skey=<ключ>&<другие параметры>
ПараметрОписаниеЗначенияОбязательность
dataТип требуемой операцииtelemetryДа
skeyУникальный секретный ключ пользователя и его устройствакодовая строкаДа
patternШаблон представления данных с сервераИдентификатор шаблона (по умолчанию, 186)Нет
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 секунд. (по умолчанию, до конца текущего дня)Нет
error_pШаблон представления ошибки от сервераИдентификатор шаблона (по умолчанию, 1)Нет
Ответ с сервера формируется на основе заданного шаблона представления. Все данные закодированы таблицей UTF-8. В случае необходимости можно задавать атрибут contentType, указывающий на тип получаемой информации для служебных целей (например, чтобы корректно отображал браузер). Распространенные типы контента: text/html (информация представлена в html-формате) и text/xml (xml-разметка).
Для получения данных с сервера нужно определить в каком формате их сформировать. Для этого необходимо задать шаблон. Вы можете использовать один из стандартных шаблонов Car-Online, либо создать свой.
Это строка символов, описывающая характеристики телеметрии. В данную строку необходимо вставлять требуемые рассчитанные параметры. Шаблон может иметь любой формат (xml, просто текст..). Вы можете настраивать только нужные вам характеристики. В шаблоне допускается повторное использование одного и того же атрибута.
АтрибутОписаниеЗначение
@engineTimeВремя работы двигателя (в минутах)Целое число. Например, 123.
@mileageПробег (в километрах)Вещественное число. Например, 1000.5 .
@averageCalculateSpeedСредняя рассчитанная скорость движения (в км/час)Вещественное число. Например, 54.1 .
@averageGpsSpeedСредняя GPS скорость движения (в км/час)Вещественное число. Например, 54.1 .
@maxSpeedМаксимальная скорость движения (в км/час)Вещественное число. Например, 120.8 .
@waysCountКоличество пройденных маршрутовЦелое число. Если не задано, то либо ничего не указывается, либо -1
@standsCountКоличество стоянокЦелое число. Если не задано, то либо ничего не указывается, либо -1
В случае возникновения ошибок сервер отсылает информацию о возникшей проблеме. Чтобы получать в нужном виде эти сведения можно настроить соответствующий шаблон.
АтрибутОписаниеЗначение
@codeУникальный код ошибкиЦелое число
@messageСообщение об ошибкеСтрока
Ниже представлены наиболее распространенные случаи использования экспорта телеметрической информации. В качестве тестируемого устройства используется PGSM.
http://api.car-online.ru/do?data=telemetry&skey=914Ff68c6Cb5b65F535b254bb63E15
Ответ
<telemetry engineTime="40" mileage="17.0" averageCalculateSpeed="19.4" averageGpsSpeed="19.6" maxSpeed="81.0" waysCount="3" standsCount="4"/>
http://api.car-online.ru/do?data=telemetry&skey=914Ff68c6Cb5b65F535b254bb63E15&content=xml
Ответ
<?xml version="1.0" encoding="UTF-8"?>
 <root>
  <telemetry engineTime="40" mileage="17.0" averageCalculateSpeed="19.4" averageGpsSpeed="19.6" maxSpeed="81.0" waysCount="3" standsCount="4"/>
 </root>
http://api.car-online.ru/do?data=telemetry&skey=914Ff68c6Cb5b65F535b254bb63E15
&begin=31072009_083000&end=01082009_100800
Ответ
<telemetry engineTime="242" mileage="326.9" averageCalculateSpeed="47.4" averageGpsSpeed="38.4" maxSpeed="132.0" waysCount="5" standsCount="6"/>
http://api.car-online.ru/do?data=telemetry&skey=914Ff68c6Cb5b65F535b254bb63E15
&pattern=187
Ответ
T:40/17.0/19.4/19.6/81.0