Skip to content

abheejani/SmartStroll

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

18 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

SmartStroll โ€“ Explore Smarter, Travel Better

Welcome to SmartStroll, your personalized travel companion! This application helps you discover the best routes between famous landmarks within a city, optimizing your travel experience based on time constraints and walking distances. Whether you're visiting museums, parks, or monuments, SmartStroll ensures you make the most of your time!


How to Use

  1. Enter Start Address and City
    Provide your starting point and the city you want to explore.

  2. Set Maximum Walking Time
    Set how much time you're willing to walk (in minutes), and we'll do the rest!

  3. Optimized Route
    SmartStroll runs Dijkstraโ€™s algorithm to find the best path through the city's landmarks that fits your time constraint.

  4. Enjoy Your Adventure!
    A list of landmarks is displayed in the optimized order โ€“ just follow along and explore!


Getting Started

Hereโ€™s how you can run SmartStroll on your local machine:

Prerequisites ๐Ÿ“‹

  1. Python 3.x installed on your machine.
  2. Google Places API Key:
    • Go to the Google Cloud Console.
    • Create a project and enable the Places API and Geocoding API.
    • Generate an API key and restrict it to specific APIs and IPs if needed.

Installation Steps โš™๏ธ

  1. Clone the Repository
    Open your terminal and run:

    git clone <repository_url>
    cd SmartStroll
  2. Install Required Dependencies

    You'll need Flask and requests to run the app. Install them via pip:

    pip install Flask
    pip install requests
  3. Set Up Your API Key

    Set your Google Places API key as an environment variable directly from the terminal.

    • For Windows (Command Prompt):

      set GOOGLE_API_KEY=your-api-key-here
    • For Windows (PowerShell):

      $env:GOOGLE_API_KEY="your-api-key-here"
    • For macOS/Linux/Git Bash:

      export GOOGLE_API_KEY=your-api-key-here
    • If this method dones't work, update the api_config.py file directly

  4. Run the Application

    Launch the Flask app with:

    python app.py
  5. Open the App in Your Browser

    Once the app is running, open your browser and go to:

    http://127.0.0.1:5000
    

Issues and Feedback ๐Ÿ“

If you encounter any bugs or have suggestions for improvement, please open an issue in the repository or send a pull request.

Get out there and explore the world smarter, one stroll at a time!

About

Optimize and See More!

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published