API доступа к данным

общественного транспорта г.Шымкент



1. Все устройства

Описание

Таблица последовательно выводит перечень всех устройств, подключённых к публичной раздаче.

Ссылка

http://transport.p17.kz/default.php?api=alldevices

Структура данных и описание полей
[{"deviceID":"value","imeiNumber":"IMEI"},{...},{...},...]

[{"deviceID":"график-3","imeiNumber":"862170010786703"},{...},{...},...]
Поле Описание
DeviceID код устройства, например: график-3, или гос.номер, или название машины
imeiNumber IMEI GPS-трекера
Примечания

В настоящее время ведутся работы по унификации, переходу к идентификации по номеру автомобиля.



2. Все маршруты

Описание

Таблица всех маршрутов

Ссылка

http://transport.p17.kz/default.php?api=allroutes

Структура данных и описание полей
[{"codeid":"value","title":"value"},{...},{...},...]

[{"codeid":"3","title":"75"},{"codeid":"8","title":"5"},{...},{...},...]
Поле Описание
codeid код маршрута, route_id
title название маршрута или номер маршрута, оно же route_short_name
Примечания

После унификации route_short_name таблица будет обновлена и представлена в стандарте GTFS



3. Геопозиция одной транспортной единицы по IMEI

Описание

Геопозиция конкретной транспортной единицы на основании IMEI (близко по значению с GTFS Realtime / Vehicle Position / Position)

Ссылка

http://transport.p17.kz/default.php?api=select&imei=861074020954825

Структура данных и описание полей
[{"deviceID":"txt_value","latitude":"WGS-84_value","longitude":"WGS-84_value","speedKPH":"demical_value",
"updated":"date_time_value","id_eventdata":"value","IMEI":"IMEI_value","status":"value"}]

[{"deviceID":"график-4","latitude":"42.331293","longitude":"69.574975","speedKPH":"0",
"updated":"2019-02-08 22:10:57","id_eventdata":"513276151","IMEI":"861074020954825","status":"861074020954825"}]
Поле Значение (пример) Описание
deviceID график-4 24h unique device name
latitude 42.331293 градусы северной широты в системе координат WGS-84
longitude 69.574975 градусы восточной долготы в системе координат WGS-84
speedKPH 12 Текущая скорость транспортного средства в км/час
updated 2019-02-08 22:10:57 время последнего обновления YYYY-MM-DD HH:MM:SS
id_eventdata 513276151 ID пакета данных
IMEI 861074020954825 IMEI поставщика данных
status 861074020954825 Контрольное поле.
Принимает значение IMEIесли на маршруте
Принимает значение «offline» если отключён
Примечания

Неполное соответствие GTFS Realtime / VehiclePosition / Position

Bearing – Отсутствует направление движения транспортного средства. Наши бортовые устройства не отдают вектор движения.

Odometer – Отсутствует расстояние, пройдённое транспортным средством.

speedKPH<>Speed – мгновенная скорость, измеренная приборами транспортного средства в нашей выдаче km/h, в то время как в стандарте GTSF – m/s.

Offline устройства. Платформа сообщает последнее состояние устройства, в том числе статус НЕ АКТИВНОГО устройства.



4. Геопозиция всего транспорта на заданном маршруте

Описание

Геопозиция каждой транспортной единицы на заданном маршруте.

Близко по значению с GTFS Realtime / VehiclePosition / Position.

Формат тот же, что в предыдущем пункте, но последовательно для каждой транспортной единицы на заданном маршруте.

Ссылка

http://transport.p17.kz/default.php?api=select&rout=115

в данном случае запрос транспорта на маршруте с кодом 115 (это 55 маршрут)

Структура данных и описание полей
[{"deviceID":"txt_value","latitude":"WGS-84_value","longitude":"WGS-84_value","speedKPH":"demical_value",
"updated":"date_time_value", "id_eventdata":"value","IMEI":"IMEI_value","status":"value"},{...},{...},...]

[{"deviceID":"график-5","latitude":"42.33141","longitude":"69.574968", "speedKPH":"0",
"updated":"2019-02-08 22:37:59","IMEI":"861074023095584", "status":"861074023095584"},{...},{...},...]
Поле Значение (пример) Описание
deviceID график-4 24h unique device name
latitude 42.331293 градусы северной широты в системе координат WGS-84
longitude 69.574975 градусы восточной долготы в системе координат WGS-84
speedKPH 12 Текущая скорость транспортного средства в км/час
updated 2019-02-08 22:10:57 время последнего обновления YYYY-MM-DD HH:MM:SS
id_eventdata 513276151 ID пакета данных
IMEI 861074020954825 IMEI поставщика данных
status 861074020954825 Контрольное поле.
Принимает значение IMEI если на маршруте
Принимает значение «offline» если отключён
Примечания

Неполное соответствие GTFS Realtime / VehiclePosition / Position

Bearing – Отсутствует направление движения транспортного средства. Наши бортовые устройства не отдают вектор движения.

Odometer – Отсутствует расстояние, пройдённое транспортным средством.

speedKPH<>Speed – мгновенная скорость, измеренная приборами транспортного средства в нашей выдаче km/h, в то время как в стандарте GTSF – m/s.

Offline устройства. Платформа сообщает последнее состояние устройств, в том числе статус НЕ АКТИВНЫХ устройств.



5. Геопозиция всего активного транспорта города

Описание

Геопозиция всего городского транспорта на всех маршрутах города в данный момент.

Формат тот же, что в предыдущем пункте, но для каждой активной транспортной единицы на каждом маршруте. Отфильтрованы все неактивные в настоящее время устройства.

Ссылка

http://transport.p17.kz/default.php?api=all

Структура данных и описание полей

Та же что в предыдущем пункте, но последовательно для каждой транспортной единицы на маршруте.

[{"id_eventdata":"int","deviceID":"string","latitude":"decimal_float","longitude":"decimal_float","speedKPH":"int",
"updated":"string","IMEI":"int","codeid":"int","route_id":"int","route_short_name":"string"},{...},{...},...]

[{"id_eventdata":"546293695","deviceID":"график-4","latitude":"42.3631808","longitude":"69.590304","speedKPH":"0","updated":"2019-02-19 20:41:53","IMEI":"352848026742839","codeid":"8","route_id":"8","route_short_name":"5"}, {...},{...},...]

 

Поле Значение (пример) Описание
id_eventdata 546293695 ID пакета данных
deviceID график-11 device name
latitude 42.2991840 градусы северной широты в системе координат WGS-84
longitude 69.6096832 градусы восточной долготы в системе координат WGS-84
speedKPH 0 Текущая скорость транспортного средства в км/час
updated 2019-02-08 22:10:57 время последнего обновления YYYY-MM-DD HH:MM:SS
IMEI 861074020954825 IMEI поставщика данных
codeid 8 deprecated, код маршрута, route_id
route_id 8 код маршрута
route_short_name 5 название маршрута или номер маршрута, оно же route_short_name

 

Загрузить API 0.2 в формате .pdf по ссылке: 20190217 traffic API v.0.2