ПОИСК
 Аннотация
Позволяет в хронологическом порядке получить список gps-координат от устройства по заданным критериям. Благодаря данной функции Вы можете самостоятельно отслеживать местоположение вашего авто. К критериям выборки относится временной интервал и фильтрация невалидных данных.
Запрос и получение данных с сервера происходит по протоколу http.
 Формат запроса
URL: http://api.car-online.ru/do?data=gpsPoints&skey=<ключ>&<другие параметры>
 Параметры запроса
ПараметрОписаниеЗначенияОбязательность
dataТип требуемой операцииgpsPointsДа
skeyУникальный секретный ключ пользователя и его устройствакодовая строкаДа
patternШаблон представления данных с сервераИдентификатор шаблона (по умолчанию, 179)Нет
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 секунд. (по умолчанию, до конца текущего дня)Нет
filterФлаг фильтрации невалидных точек (с точки зрения инженеров MagicSystems)1 - требуется фильтрация; 0 - без фильтрации. (по умолчанию, 0)Нет
error_pШаблон представления ошибки от сервераИдентификатор шаблона (по умолчанию, 1)Нет
 Формат ответа
Ответ с сервера формируется на основе заданного шаблона представления. Все данные закодированы таблицей UTF-8. В случае необходимости можно задавать атрибут contentType, указывающий на тип получаемой информации для служебных целей (например, чтобы корректно отображал браузер). Распространенные типы контента: text/html (информация представлена в html-формате) и text/xml (xml-разметка).
 Описание шаблона представления данных
Для получения данных с сервера нужно определить в каком формате их сформировать. Для этого необходимо задать шаблон. Вы можете использовать один из стандартных шаблонов Car-Online, либо создать свой.
 Шаблон gps-координат
Для набора gps - это строка символов, описывающая одну gps-точку. В данную строку необходимо вставлять требуемые атрибуты событий. Шаблон может иметь любой формат (xml, просто текст..). Вы можете настраивать только нужные вам атрибуты. Для каждой gps-точки из списка применяется указанный шаблон, которые разделяются новой строкой (то есть шаблоны отделяюся по переносу строки). В шаблоне допускается повторное использование одного и того же атрибута.
 Возможные атрибуты шаблона
АтрибутОписаниеЗначение
@eventidИдентификатор события, к которому относится gps-точкаЦелое число
@datetimeДата/время gpsДата и время gps-точки в формате ddMMyyyy_HHmmss. Например, 23072009_114059 - 23 июля 2009 года 11 часов 40 минут 59 секунд.
@dateДата gpsДата gps-точки в формате ddMMyyyy. Например, 23072009 - 23 июля 2009 года.
@timeВремя gpsВремя gps-точки в формате HHmmss. Например, 114059 - 11 часов 40 минут 59 секунд.
@longitudeДолгота (координата gps)Вещественное число. В случае восточной долготы - положительное, в случае западной - отрицательное. В градусах. Например, 30.685948
@latitudeШирота (координата gps)Вещественное число. В случае северной широты - положительное, в случае южной - отрицательное. В градусах. Например, 59.945694
@speedСкорость по gpsЦелое число. Представлено в километрах в час [км/ч]. Например, 15. Если неизвестно, то ничего не указывается, либо -1.
@courseКурс по gpsЦелое число [0..360]. В градусах. 0 градусов соответствует курсу вертикально вверх на север. Если курс не известен, тото ничего не указывается, либо равен -1.
@hdopСтепень достоверности gpsВещественное число. Если неизвестно, то ничего не указывается, либо -1.
@sputniksЧисло спутников, задающие gpsЦелое число. Если не задано, то либо ничего не указывается, либо -1
@nmeaСтрока gps, полученная от устройстваСимвольная строка в формате Nmea. Не имеет фиксированного формата. Например:
082814.249,A,5956.7439,N,03041.1532,E,0.00,,300909,U09,0.9,
GPRMC,082814.249,A,5956.7439,N,03041.1532,E,0.00,,300909,,,A*7E
 Шаблон ошибок от сервера
В случае возникновения ошибок сервер отсылает информацию о возникшей проблеме. Чтобы получать в нужном виде эти сведения можно настроить соответствующий шаблон.
 Возможные атрибуты шаблона
АтрибутОписаниеЗначение
@codeУникальный код ошибкиЦелое число
@messageСообщение об ошибкеСтрока
 Примеры
Ниже представлены наиболее распространенные случаи использования экспорта gps-данных. В качестве тестируемого устройства используется PGSM.
 Простой запрос на получение gps-точек текущего дня в стандартном виде
http://api.car-online.ru/do?data=gpsPoints&skey=914Ff68c6Cb5b65F535b254bb63E15
Ответ
<gps date="30092009_122711" lon="30.685886" lat="59.945731" speed="0"/>
<gps date="30092009_122659" lon="30.685885" lat="59.945758" speed="6"/>
<gps date="30092009_122658" lon="30.685861" lat="59.945771" speed="8"/>
<gps date="30092009_122657" lon="30.685815" lat="59.945776" speed="12"/>
<gps date="30092009_122651" lon="30.685315" lat="59.94558" speed="35"/>
<gps date="30092009_122631" lon="30.683171" lat="59.944385" speed="33"/>
<gps date="30092009_122630" lon="30.683058" lat="59.944316" speed="38"/>
<gps date="30092009_122609" lon="30.679023" lat="59.942646" speed="52"/>
....
 Тот же запрос, но ответ в xml-представлении
http://api.car-online.ru/do?data=gpsPoints&skey=914Ff68c6Cb5b65F535b254bb63E15&content=xml
Ответ
<?xml version="1.0" encoding="UTF-8"?>
 <root>
  <gps date="30092009_125146" lon="30.685625" lat="59.945514" speed="0"/>
  <gps date="30092009_124544" lon="30.686211" lat="59.945115" speed="0"/>
 ....
  <gps date="30092009_092236" lon="30.672871" lat="59.940993" speed="53"/>
  <gps date="30092009_092221" lon="30.676785" lat="59.942121" speed="62"/>
  <gps date="30092009_092215" lon="30.678448" lat="59.942521" speed="54"/>
 </root>
 Запрос на получение гео-информации за выбранный временной интервал
http://api.car-online.ru/do?data=gpsPoints&skey=914Ff68c6Cb5b65F535b254bb63E15
&begin=31072009_083000&end=31072009_100800
Ответ
<gps date="31072009_100725" lon="30.685628" lat="59.94558" speed="0"/>
<gps date="31072009_100431" lon="30.68567" lat="59.94557" speed="0"/>
<gps date="31072009_100127" lon="30.685973" lat="59.945436" speed="0"/>
<gps date="31072009_095823" lon="30.68533" lat="59.945825" speed="0"/>
<gps date="31072009_095533" lon="30.685346" lat="59.946043" speed="0"/>
<gps date="31072009_095230" lon="30.686014" lat="59.945408" speed="0"/>
....
 Использование фильтрации невалидных точек
http://api.car-online.ru/do?data=gpsPoints&skey=914Ff68c6Cb5b65F535b254bb63E15
&filter=1
Ответ
<gps date="30092009_122711" lon="30.685886" lat="59.945731" speed="0"/>
<gps date="30092009_122659" lon="30.685885" lat="59.945758" speed="6"/>
<gps date="30092009_122658" lon="30.685861" lat="59.945771" speed="8"/>
<gps date="30092009_122657" lon="30.685815" lat="59.945776" speed="12"/>
<gps date="30092009_122651" lon="30.685315" lat="59.94558" speed="35"/>
<gps date="30092009_122631" lon="30.683171" lat="59.944385" speed="33"/>
....
 Применение шаблона представления списка gps-данных
http://api.car-online.ru/do?data=gpsPoints&skey=914Ff68c6Cb5b65F535b254bb63E15
&pattern=180
Ответ
G:122956/30.685801/59.945606
G:122956/30.685801/59.945606
G:122956/30.685801/59.945606
G:122907/30.685786/59.945588
G:122907/30.685786/59.945588
G:122907/30.685786/59.945588
G:122907/30.685786/59.945588
G:122903/30.685808/59.9456
....
© 2009 Magic Systems. Все права защищены.