Table of Contents
Commuting can be a stressful and time-consuming process, with traffic conditions and other unforeseen events often causing delays and frustration. Additionally, the transportation sector is a significant contributor to greenhouse gas emissions that contribute to climate change. To address these challenges, a navigation app for commuters will be developed.
This project aims to develop an app-based navigation system that will help commuters in Batangas City to travel efficiently. The app will provide accurate and up-to-date information on transportation schedules, traffic conditions, and directions, making it easier for users to plan their journeys and promoting sustainable transportation solutions.
Furthermore, the app-based navigation system can contribute to achieving the Sustainable Development Goals (SDGs), particularly SDG 11, which aims to make cities and human settlements more inclusive, safe, resilient, and sustainable, and SDG 13, which seeks to take urgent action to combat climate change and its impacts. By promoting sustainable transportation solutions and reducing greenhouse gas emissions, the app-based navigation system can make a valuable contribution towards achieving these global goals.
Despite the rapid advancement of technology and the information we have access to, many people still lack accessible information about sustainable transportation. Public transit remains the primary means of transportation for many, making it crucial to provide easily accessible information on options that support SDGs 11 and 13.
![SDG 11](images/xjirn7s3.png)
SDG 11 emphasizes the need for more inclusive and sustainable cities and communities, with a focus on enhancing the accessibility, security, and environmental friendliness of transportation systems. Sustainable transportation is key to achieving this goal, as it can help reduce traffic congestion, air pollution, and greenhouse gas emissions, while also improving citizens' quality of life and public health.
![SDG 13](images/y9zrlhaf.png)
SDG 13 aims to tackle climate change and its effects as soon as possible. Transportation is a significant source of greenhouse gas emissions, making the shift to more environmentally friendly means of transportation crucial to achieving this goal. Promoting sustainable transportation options can reduce the carbon footprint of transportation systems and mitigate the effects of climate change.
Currently, there is a lack of tools that use information about the schedules, routes, and usage of public transportation to offer environmentally friendly options to users. This restricts people from making informed decisions that align with global sustainable development goals. A technology that can effectively compile information on available public transportation options, analyze it, and offer consumers personalized recommendations for more environmentally friendly solutions is needed to address this problem. Such a tool would support the global effort to attain SDGs 11 and 13 by promoting environmentally friendly transportation and reducing carbon emissions.
The primary objective of this project is to help people with the developed mobile-based application that promotes the use of efficient and environmentally-friendly public transportation routes. This will be accomplished by providing accurate and real-time information on public transportation schedules, routes, and various options available to commuters. The app will enable users to easily search for transportation options based on their location, destination, and travel time preferences. Additionally, a community-driven system will be incorporated into the app, allowing users to share their preferred routes based on previous travels and preferences, and make them accessible to other users.
This system makes public transportation more accessible and efficient for users but also encourage more individuals to contribute to this feature and keep the project relevant over an extended period. By promoting sustainable transportation options, the project will contribute towards achieving the Sustainable Development Goals (SDGs), particularly SDG 11, which emphasizes making cities and human settlements more inclusive, safe, resilient, and sustainable. Ultimately, the mobile application will help people choose the best transportation options, reduce travel time and cost, and minimize the environmental impact of public transportation.
-
π½ Develop a data scraper that can collect and analyze data on public transportation schedules and routes from various sources.
-
π² Integrate the collected data into a user-friendly mobile-based application that allows users to easily search for transportation options based on their current location, destination, and preferred travel time.
-
π£οΈ Conduct user testing and feedback sessions to ensure that the platform is user-friendly and provides accurate and helpful information to users.
-
βοΈ Continuously update the platform with the latest data on public transportation schedules and routes to ensure the accuracy of the recommendations provided to users. This will involve utilizing data from the users as well.
-
π Students: Since they often rely on public transportation to get to school or college, making access to sustainable transportation options is especially critical. This program will serve to aid students in selecting environmentally responsible transportation options, identifying the most efficient routes, and reducing their carbon footprint by providing information on sustainable transportation choices.
-
π Commuters: They are significant contributors to carbon emissions, and providing them with information on environmentally friendly transportation options can help to mitigate their environmental impact. Additionally, commuting can be a stressful experience, and this program can alleviate some of that stress by offering personalized and efficient transit options.
-
π« Tourists: In unfamiliar cities, tourists frequently rely on public transportation to get around and may need to be made aware of more environmentally friendly options. This resource can assist tourists in choosing the most effective mode of transportation to get them to where they're going and minimize the impact of their travels on the environment.
-
π Public Transportation Drivers: By providing recommendations for more efficient routes or forms of transportation, this program can also help public transportation drivers. They can help create more sustainable transportation systems by conserving fuel and optimizing their routes more efficiently.
The mobile app have features that mainly aim to make commuting more convenient for commuters. Specifically, the app will have the following features:
-
π± Available on Android devices
-
π°οΈ Realtime location tracking using GPS
-
πΊοΈ Interactive map where users can mark destinations and check places
-
βοΈ Route suggestions using only public transport such as jeepneys and buses -
π Contains information on transport vehicle routes and schedules
-
π¨βπ©βπ§βπ¦ Users can share transport routes and update transport vehicle schedules for other users to see
To speed up and improve the development of the mobile application, the developers will use various tools. These include:
-
Python - a high-level, general-purpose programming language. This is used to program the logic for the application.
-
Kivy - a cross-platform Python application development framework. This is used to create an application that can run in android.
-
Flask - a python web framework for developing static web pages. This is used to create the RESTful API for the project to handle all computation-heavy tasks.
-
OpenStreetMap - a free, open geographic database updated and maintained by a community of volunteers via open collaboration. This is used to obtain map data such as names of places and routes through its API.
-
MySQL - an open-source relational database management system. This is used to store the information about the routes and places as well as the transport schedules shared by users.
-
Docker - a software platform that allows developers to build, test, and deploy applications quickly. It ensures that the application running in one machine will run on all the other machines. This is used to containerize the API application so that the developers can deploy it to the server online.
-
Linux - a family of open-source Unix-like operating systems based on the Linux kernel, an operating system kernel. This is used to run the API server locally and natively as well as for building the Android app from source.
-
GitHub - an Internet hosting service for software development and version control using Git. This is used to make collaboration more convenient for the developers of the project.
The aim of the project is to develop an app-based navigation system to help commuters in Batangas City access real-time information on public transportation schedules, traffic conditions, and alternative route suggestions. The app will be accessible to both public and private transportation users and will feature a community-powered planning feature for users to customize their own transport route based on their preferences.
However, the accuracy of the data in the app, such as traffic and transportation schedules, is dependent on the reliability of the data sources. The app will only be available on Android devices, limiting the accessibility for some users who may not have access to this technology. Additionally, features such as lane guidance, street view, and voice command will not be included in the initial release of the app. These limitations will be taken into account during the development process, and efforts will be made to ensure the app is as reliable and accessible as possible.
Video Presentation YouTube Link: https://www.youtube.com/watch?v=4sIvN9gS_E4
- Clone the repository in your machine
git clone https://github.com/baddddddddd/SanDaan.git
cd SanDaan
- Download all the dependencies (we recommend using a virtual environment before proceeding to this step)
pip install -r requirements.txt
- Run the app
python src/app/main.py -- --online
- Download the .apk file from our releases page. Check out our latest release.
- Allow installation from unknown sources in your android device then install the .apk.
- Open the app once to allow requested permissions then close.
- Open the app again and enjoy :D
Disclaimers
- Android 12 and newer versions of Android is currently not supported by the latest release.
- The app is also not supported for Android devices that do not have GPS Location Tracking.
- If the app closes automatically or is stuck in the loading screen, this means that the server is turned off or sleeping. Please contact the developers to turn on or wake up the server. Additionally, you can wake the server up yourself by visiting this link and wait for the page to load.
If the app is stuck in the loading screen, chances are the server is turned off due to limited resources or is sleeping. Visit this link and wait for the page to load to wake up the server. If the page still failed to respond, the server is turned off. Please contact the developers in case this happens.
Optionally, you can host the API server locally in your machine.
Disclaimer
Running the server requires having the environment variables to connect to our database. In order to obtain these environment variables, please contact the developers. Optionally, you can host your own database with the database schema (src/api/db_schema.sql) that we provided.
- Clone the repository in your machine
git clone https://github.com/baddddddddd/SanDaan.git
- Navigate to the API folder
cd SanDaan/src/api
- Download all the dependencies (we recommend using a virtual environment before proceeding to this step)
pip install -r requirements.txt
- Run the server using gunicorn
gunicorn api:app -b 0.0.0.0:5000 --timeout 300
- Download and install Docker in your machine.
- Create the docker image.
docker build -t sandaan-api .
- Run the docker image.
docker run -p 5000:5000 sandaan-api
- Repeat the steps from Running the App section except for the last step.
- Run the app without the "--online" argument.
python src/app/main.py
Building the app from source is only supported on linux machines.
- Download and install "buildozer" in your linux machine as well as all of its dependencies.
- Build the .apk using buildozer
buildozer android debug
- Navigate to the "bin" directory to find the .apk