Руководство пользователя
Версия 7.6
×

API Автобусных рейсов

 
Это API создавалось для коммуникации с Барнаульским 1C модулем и сейчас не должно использоваться или отдаваться клиентам так как оно работает только в плане назначения на рейс
Прогноз прибытия не был реализован, Отсылка сообщений на URL не производится так как сильно тормозила систему.
 
Адрес сервиса:
https://<address>/api/etraffic/api.php
 
Post параметры:
cmd - комманда , возможные варианты:
  • setLine - Создать новый рейс
  •  setControl - назначить автобус на рейс
  • unsetControl - удалить назначение на рейс
  • bindControl -
  • unbindControl -
data - данные в формате JSON
 
Форматы данных и описание для разных команд:
Команда позволяет завести новый автобусный маршрут со всеми остановками в систему ПИЛОТ
данные в поле
 
 data:
{
 "account_id": "3008",   // Номер договора (цифра)
 "bidirectional": 1,    // Рейс друнаправленный (туда-обратно) 1 или 0
 "description": "Маршрут №9",  // Описание рейса (текст)
 "label": "123",    // Дополнительная метка рейса (текст)
 "name": "Маршрут №9",  // Нащвание рейса (текст)
 "number": "12304",      // Номер рейса (текст или цифра)
 "type_id": 0,    // Тип рейса (type_id : 0 -автобус, 1-троллейбус, 2 - трамвай, 3 -маршрутка)
 "uid": "dhqwdh"  // Уникальный идентификатор рейса (текст)
 "points": [  // Массив со списком остановочных пунктов
    {
     "lat": "45.0207",  //Широта центра остановки (десятичная цифра)
     "lon": "33.9993",  //Долгота центра остановки (десятичная цифра)
     "name": "Аэропорт__",   //Название остановки
     "price": 15.35,   //Стоимость проезда от предыдущей остановки (десятичная цифра)
     "radius": "91",  //Радиус в метрах (цифра )
     "silent": 0, //Запрет отправки сообщений от событий на этой остановки (1 или 0)
     "stop_type": 0, //Тип остановки 0 - обычная, 1 - техническая (пассажиры не считаются) 2 - конечная (счетчик обнуляется - все выходят)
     "ts": 600, //Время прибытия на остановку относительно предыдущей остановки в секундах (цифра)
     "te": 700,  //Время стоянки на остановке в секундах (цифра)
     "uid": "819897e2-843b-11e4-bf52-002354656fea" //Уникальный идентификатор остановки (текст)
    },
    {
     "lat": "44.9078",
     "lon": "34.0784",
     "name": "7я горбольница",
     "price": 15.35,
     "radius": "90",
     "silent": 0,
     "stop_type": 0,
     "te": 1000,
     "ts": 900,
     "uid": "819897e8-843b-11e4-bf52-002354656fea"
     }
  ]
}
 
 
Создание привязки транспортного средства к автобусной линии. В интерфейсе это делается так:
 
 
{
"uid": "121e1e1e12",   // Уникальный идентификатор привязки (текст)
"imei": "12304",  //  IMEI транспортного средства (текст)
"lineuid": "2e23e23e2e", // Уникальный идентификатор маршрута (текст)
"ts": "1392294840", // Время начала действия привязки
"te": "1392321600", // Время окончания действия привязки (пустое если без ограничения)
"message_url":"http://example.com/message.php",   // URL на который шлются сообщения от автобуса (дверь открылась,
автобус прибыл на остановку, вошло такое-то количество пассажиров)
"prognoze_url":"http://example.com/prognoze.php", // URL на который шлется прогноз прибытия на остановку
}
 
Удаление привязки транспортного средства к автобусной линии.
{
   "uid": "qiwduhqiwdqkdqkn"  // Уникальный идентификатор привязки (текст)
}
Команда - комбинация команд setLine и bindControl. Создается автобусный маршрут и к нему привязывается транспортное средство.
 
{
"uid": "qiwduhqiwdqkdqkn", //Уникальный идентификатор рейса (текст)
"ts": "1392294840",  // Время начала действия привязки
"te": "1392321600",   // Время окончания действия привязки (пустое если без ограничения)
"name": "test",  // Название рейса (текст)
"imei": "359772039289781",  // IMEI транспортного средства (текст)
"number":"861A"  // Номер рейса (текст или цифра)
"message_url":"http://example.com/message.php",   // URL на который шлются сообщения от автобуса (дверь открылась, автобус прибыл на остановку, вошло такое-то количество пассажиров)
"prognoze_url":"http://example.com/prognoze.php", // URL на который шлется прогноз прибытия на остановку
"points": [
{
"uid": "1", //Уникальный идентификатор остановки и привязки (текст)
"lat": "53.352142",  //Широта центра остановки (десятичная цифра)
"lon": "83.758749",  //Долгота центра остановки (десятичная цифра)
"name": "Барнаульский автовокзал",      //Название остановки
"radius":"50",  //Радиус в метрах (цифра )
"stop_type":0,  //Тип остановки 0 - обычная, 1 - техническая (пассажиры не считаются) 2 - конечная (счетчик обнуляется - все выходят)
"price":15.35 //Стоимость проезда от предыдущей остановки (десятичная цифра)
},
{
"uid": "2",
"lat": "52.534012",
"lon": "85.178777",
"name": "Бийский автовокзал",
"radius":"100",
"stop_type":0,
"price":15.35
}
]
}
Удаление привязки установленной командой setControl
{
   "uid": "qiwduhqiwdqkdqkn"  // Уникальный идентификатор привязки (текст)
}
Формат данных присылаемый на URL оповещения.