DeckIst is a hobby project that offers a visual depiction of daily bus traffic in Istanbul. Leveraging the GTFS dataset provided by The Istanbul Metropolitan Municipality, DeckIst employs Deck.gl by Uber to offer an enjoyable visual experience for users, allowing them to explore the city's bus traffic patterns through captivating visualizations. Inspired Uber's visualization of NYC Taxi Trip data.

Explore the live version of DeckIst here.

DeckIst comprises two components:

The backend of DeckIst is developed using FastAPI. This component is responsible for processing data and manipulate the bus traffic data. For more technical details, refer to the Webservice README.

The frontend of DeckIst is built with React and utilizes Deck.gl to create captivating visualizations of the bus traffic data. Users can visualize their preferred bus lines at different times of the day, allowing for interactive exploration of bus traffic trends. For more technical details, refer to the Frontend README.

Project utilizes a straightforward approach to visualize bus traffic in Istanbul. The GTFS dataset includes trips, stops, and stop times, with stop times containing arrival data, stops containing geographical and trips containing stop sequence information. By leveraging combinations of these datasets, source code interpolates paths between stops with haversine method. However, it's worth noting that this approach may result in figures appearing off-road in cases where stop distances are too far apart (eg. 500T). Additionally, the GTFS dataset also includes shape data, which could provide a more reliable path compared to the interpolation approach used by DeckIst.

To run DeckIst, simply follow these steps:

1. Run the Webservice: Start the FastAPI-based backend to handle data processing and serve data endpoints.
2. Launch the Frontend: Access the React-based frontend to visualize the bus traffic data using Deck.gl. The frontend provides a user-friendly interface for exploring the data interactively.

DeckIst is licensed under the MIT License, allowing for flexibility in use and distribution.

It's important to note that while the code for this repository is licensed under the MIT License, the GTFS dataset used in the project is subject to its own licensing terms. Users should refer to the specifics licensing information provided by The Istanbul Metropolitan Municipality for the dataset.