README.md

Fuel-Planner - The Smart Refueling Assistant

Fuel-Planner is a smart refueling assistant that helps drivers plan their routes and find the best refueling options based on their vehicle's current mileage and fuel level. The app uses the Google Maps API to calculate routes, determine when a vehicle might need to refuel, and find nearby refueling stations that meet the driver's criteria.

Features

• Calculates the total distance and duration of a route between two locations.
• Identifies potential break points along a route where a vehicle might need to refuel.
• Finds nearby refueling stations based on a query and minimum rating.
• Provides the distance and duration from the break point to all the nearby refueling stations.

Getting Started

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

Prerequisites

You will need to have Python and pip installed on your machine. You can download Python from the official website https://www.python.org/downloads/

You will also need to have a Google Maps API key. You can get one from the Google Cloud Console https://console.cloud.google.com/

Installing

Clone the repository to your local machine.

git clone https://github.com/lemontree404/Fuel-Planner.git

Create a virtual environment and activate it.

python -m venv env
source env/bin/activate

Install the required dependencies.

pip install -r requirements.txt

Running the App

To run the app run the following command:

streamlit run app.py

The app will be available at http://localhost:8501/ in your web browser.

Built With

• Python - Programming language
• pandas - Data manipulation library
• numpy - Scientific computing library
• streamlit - App framework
• googlemaps - Google Maps API client library
• pydeck - 3D visualization library

Authors

• Manav Karthikeyan - Github
• P Rahulram - Github

Acknowledgments

Karun A Github (Thank you for the API key 💖💖)

License

This project is licensed under the MIT License