Archives by date

You are browsing the site archives by date.

AutoMap — rest — protocols

22 января 2015 admin

mapSurfer GS / Руководство разработчика REST / Протоколы

Протоколы

Список протоколов

GET /daemon/protocols

Структура запроса:


GET /daemon/protocols?token=mbs90lon2a8

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

[{
	"id": 1,
	"name": "galileo",
	"title": "Галилео",
	"listener": true,
	"receiver": false,
	"writer": false,
	"stable": true
},…]


// id протокола, целое число
// название протокола, строка
// заголовок, строка
// протокол получения данных, булевое поле
// протокол сбора данных, булевое поле
// протокол отправки данных, булевое поле
// стабильность протокола, булевое поле

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

Информация о протоколе по ID

GET /daemon/protocols/{id}

Структура запроса:


GET /daemon/protocols/12?token=mbs90lon2a8

id: id протокола

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

{
	"id": 12,
	"name": "protocol",
	"title": "protocol",
	"listener": true,
	"receiver": false,
	"writer": false,
	"stable": true
}


// id протокола, целое число
// название протокола, строка
// заголовок, строка
// протокол получения данных, булевое поле
// протокол сбора данных, булевое поле
// протокол отправки данных, булевое поле
// стабильность протокола, булевое поле

Статус: 404 — объект не найден

Формат: text/plain

Содержит описание ошибки

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

Количество протоколов

GET /daemon/protocols/count

Структура запроса:


GET /daemon/protocols/count?token=mbs90lon2a8

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

52

// количество протоколов

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

AutoMap — rest — graphreport

22 января 2015 admin

mapSurfer GS / Руководство разработчика REST / Графические отчеты

Графический отчет

Информация о графическом отчете ТС по его ГЛОНАСС ID

GET /reports/graphical/{glonassId}/{tsFrom}/{tsTo}

Структура запроса:


GET /reports/graphical/152/1381361961000/1381362010000?token=mbs90lon2a8

glonassId: id ГЛОНАСС

tsFrom: время, начиная с которого необходимо построить отчет

tsTo: время окончания построения отчета

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

{
	"extent": [49.0916,55.7301,49.2581,55.8429],
	"speedTracks": [{
		"dateFrom": 1381361961000,
		"dateTill": 1381362010000,
		"length": 221,
		"line": {
		     "type": "LineString",
		     "coordinates": [[49.22249,55.78706],
		     [48.91387939,54.0351994]],
                },
		"avgSpeed": 13,
		"type": 1
	}]
}


// координаты левой нижней и правой верхней точек графика
// массив треков скорости
// начало отчетного периода, целое число
// конец отчетного периода, целое число
// расстояние, целое число
// информация о линии, объект
// тип, строка
// координаты, массив


// средняя скорость, целое число
// тип, целое число

Статус: 404 — объект не найден

Формат: text/plain

Содержит описание ошибки

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

Потери сигнала

GET /reports/nosignal/{glonassId}/{tsFrom}/{tsTo}

Структура запроса:


GET /reports/nosignal/1220/1390359960000/1421917560000?token=mbs90lon2a8

glonassId: id ГЛОНАСС

tsFrom: время, начиная с которого необходимо построить отчет

tsTo: время окончания построения отчета

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

[{
	"date": 1416484479000,
	"eventId": 2,
	"line": {
		"type": "LineString",
		"coordinates": [[47.63689041, 65.75249005],
		[48.55682373, 56.79862241]]
	},
	"direction": 996812,
	"duration": 4667080000,
	"info": "Потеря сигнала (00 01:17:47)"
},...]


// дата, timestamp
// id события, целое число
// информация о линии
// тип линии, строка
// координаты


// направление, целое число
// продолжительность, целое число
// информация, строка

Статус: 404 — объект не найден

Формат: text/plain

Содержит описание ошибки

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

Повороты

GET /reports/turns/{glonassId}/{tsFrom}/{tsTo}

Структура запроса:


GET /reports/turns/1220/1390359960000/1421917560000?token=mbs90lon2a8

glonassId: id ГЛОНАСС

tsFrom: время, начиная с которого необходимо построить отчет

tsTo: время окончания построения отчета

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

[{
	"date": 1421330137000,
	"address": "Ульяновская область",
	"point": {
		"type": "Point",
		"coordinates": [48.62493897, 53.76533768]
	},
	"direction": 351,
	"duration": 1000000,
	"info": "Поворот с юга на север",
	"eventId": 3
},...]


// дата, timestamp
// адрес, строка
// точка, объект
// тип, строка
// координаты, число с плавающей точкой

// направление, целое число
// продолжительность, целое число
// информация о повороте, строка
// id события, целое число

Статус: 404 — объект не найден

Формат: text/plain

Содержит описание ошибки

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

Остановки

GET /reports/parkings/{glonassId}/{tsFrom}/{tsTo}

Структура запроса:


GET /reports/parkings/1220/1390359960000/1421917560000?token=mbs90lon2a8

glonassId: id ГЛОНАСС

tsFrom: время, начиная с которого необходимо построить отчет

tsTo: время окончания построения отчета

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

[{
	"eventId": 1,
	"date": 1421917560000,
	"address": "Татарстан, Казань, улица Эсперанто, 29",
	"point": {
		"type": "Point",
		"coordinates": [49.1413912, 55.7741655]
	},
	"info": "Остановка (01 08:25:41)"
},...]


// id события, целое число
// дата, timestamp
// адрес, строка
// информация о точке, объект
// тип, строка
// координаты, массив

// информация, строка

Статус: 404 — объект не найден

Формат: text/plain

Содержит описание ошибки

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

События генерируемые датчиками

GET /reports/gaugeevents/{glonassId}/{tsFrom}/{tsTo}

Структура запроса:


GET /reports/gaugeevents/99/1390359960000/1421917560000?token=mbs90lon2a8

glonassId: id ГЛОНАСС

tsFrom: время, начиная с которого необходимо построить отчет

tsTo: время окончания построения отчета

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

[{
	"date": null,
	"data": null,
	"address": "-",
	"info": "Событие аналогового датчика Топливо",
	"point": null,
	"eventId": 9
},…]


// дата, timestamp
// данные
// адрес, строка
// информация о событии, строка

// id события, целое число

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки

События входа и выхода из контрольной зоны

GET /reports/zones/{glonassId}/{tsFrom}/{tsTo}

Структура запроса:


GET /reports/zones/188/1390359960000/1436971763000?token=mbs90lon2a8

glonassId: id ГЛОНАСС

tsFrom: время, начиная с которого необходимо построить отчет

tsTo: время окончания построения отчета

token: ключ доступа

Ответ:

Статус: 200 — успешное выполнение

Формат: json

[{
	"date": 1421917560000,
	"address": "Ульяновская область, Мелекесский район",
	"point": {
		"type": "Point",
		"coordinates": [49.75186157,54.11896983]
	},
	"direction": 0,
	"eventId": 6,
	"info": "Вход в зону(100km)"
},...]


// дата, timestamp
// адрес, строка
// информация о точке, объект
// тип, строка
// координаты, массив

// направление, целое число
// id события, целое число
// текст события, строка

Статус: 404 — объект не найден

Формат: text/plain

Содержит описание ошибки

Статус: 500 — ошибка на сервере

Формат: text/plain

Содержит описание ошибки