nstonic / bus_map

Автобусы на карте Москвы

Веб-приложение показывает передвижение автобусов на карте Москвы.

Как запустить

• Скачайте код и установить зависимости pip install -r requirements.txt

• Запустите сервер:python server.py [-h] [--buses_port] [--browser_port] [--no-log]

  • --buses_port - Порт для получения данных об автобусах
  • --browser_port - Порт для отправки данных в браузер
  • --no-log - Отключить логирование

• Запустите клиент для генерации данных:python fake_bus.py [-h] [--server] [--routes_dir] [--routes_number] [--buses_per_route] [--websockets_number] [--emulator_id] [--refresh_timeout] [--no-log]

  • --server - Адрес сервера
  • --routes_dir - Папка с json-ами маршрутов
  • --routes_number - Количество маршрутов
  • --buses_per_route - Количество автобусов на каждом маршруте
  • --websockets_number - Количество открытых веб-сокетов
  • --emulator_id - Префикс к busId на случай запуска нескольких экземпляров имитатора
  • --refresh_timeout - Задержка в обновлении координат сервера в секундах
  • --no-log - Отключить логирование

• Откройте в браузере файл index.html

Настройки

Внизу справа на странице можно включить отладочный режим логгирования и указать нестандартный адрес веб-сокета.

Настройки сохраняются в Local Storage браузера и не пропадают после обновления страницы. Чтобы сбросить настройки удалите ключи из Local Storage с помощью Chrome Dev Tools —> Вкладка Application —> Local Storage.

Если что-то работает не так, как ожидалось, то начните с включения отладочного режима логгирования.

Формат данных

Фронтенд ожидает получить от сервера JSON сообщение со списком автобусов:

{
  "msgType": "Buses",
  "buses": [
    {"busId": "c790сс", "lat": 55.7500, "lng": 37.600, "route": "120"},
    {"busId": "a134aa", "lat": 55.7494, "lng": 37.621, "route": "670к"},
  ]
}

Те автобусы, что не попали в список buses последнего сообщения от сервера будут удалены с карты.

Фронтенд отслеживает перемещение пользователя по карте и отправляет на сервер новые координаты окна:

{
  "msgType": "newBounds",
  "data": {
    "east_lng": 37.65563964843751,
    "north_lat": 55.77367652953477,
    "south_lat": 55.72628839374007,
    "west_lng": 37.54440307617188,
  },
}

Используемые библиотеки

• Leaflet — отрисовка карты
• loglevel для логгирования

Цели проекта

Код написан в учебных целях — это урок в курсе по Python и веб-разработке на сайте Devman.