|
Получайте статистику по работе вашего объекта. Производится расчет различных характеристик на
основе собранных данных, таких как, пробег за период, средняя и максимальная скорости,
время работы двигателя, число маршрутов и стоянок... Со временем список доступных характеристик
будет пополняться.
Запрос и получение данных с сервера происходит по протоколу 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
Ответ
|