You’ve already contacted us, we’ve invited you to our Slack Workspace and now we pointed you to this site right? The path might be stony and invites you to get lost in the jungle. But we want to prevent this from happening so we created this site to keep you organized. A good workflow would be to create teams to work on the various parts shown here.

Part 1: Getting route data

In order to get the app to guide the app user we need of course the routes the public transportation vehicles are driving. Usually you obtain this kind of data from your public transportation authority. Usually the data you get is in one of the following file formats (GPX, JSON, GEOJSON, …). If you can’t handle the formats yourself then kindly ask us for help. Some of us are really good in such things and can convert between file formats. If your authority does not provide this kind of data then it is probably not nice and you need to gather this data by yourself on the field. For that we recommend the Android App “GPS Essentials”. Also on this one we can provide help if necessary.

Part 2: Importing route data to OpenStreetMap

OpenStreetMap is the “Wikipedia of Maps”. Like Wikipedia aims to provide free knowledge, OpenStreetMap aims to provide free Map Data (focuses on the underlying data a map is made of). We chose OSM because it makes routes easier to maintain and because we love Open Data Initiatives. In order to add data to OpenStreetMap your mapping team needs the following:

  • JOSM which is freeware and looking forward to meet you. It can be downloaded from here for Linux/Mac/Windows (it requires Java to be installed).
  • The configuration file for JOSM which makes mapping bus routes easier and which you can create by following this tutorial. Then Your mapping team can follow the tutorial here to activate it on their machines.

Now your team can start to add routes to OSM by following the tutorial series showing how to work with JOSM. Especially the section “how to add routes to OSM” might be worth to read. While experience in OSM is helpful, it is not required.

Part 3: Retrieving the trip times

App users do not just want the routes but also the times where a driver stops at a particular position. The format GTFS is common for conveying such information and we use this format.

Formal traffic

Formal traffic means that a timetable and bus stops exist. Is this the case in your city/country then your public transportation authority has such files. Just ask them friendly to hand you in that files.

Informal traffic

If your city’s public transportation works on demand, no bus stops and no timetable exists, then it is informal traffic. Your public transportation authority then has no GTFS files we strongly need in order to make the app work. But don’t worry! We have a solution for that. We developed a handy script that you can use to generate GTFS files out of the route data you entered into OSM (see section “Importing route data to OpenStreetMap”). Just fork the script and optionally clone it to your computer. Then follow our instructions in the README file. It is quite easy 🙂

Part 4: Developing the app

The app is needed to make navigating in your city’s public transportation infrastructure possible and to provide a friendly, good looking user experience. Don’t worry! You don’t need to do program much. We did the most work for you and developed a core that you can tweak easily according to your needs:

  • Retrieve its code from GitHub (Log in in/Create your GitHub Account, fork and optionally but recommended download it from your fork).
  • Modify the code according to your needs. You have contact with our tech-team and can ask them for help