Skip to content

alechudson/route-scouter

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

2 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Route Scouter

Search for places along your route using KML or GPX files.

Quick Start

  1. Clone and install:

    git clone <repo-url>
    cd route-scouter
    pip install -r requirements.txt
  2. Set up your API key:

    cp .env.example .env
    # Edit .env and add your Google API key
  3. Run:

    streamlit run app.py
    # Or use: ./run.sh

Getting a Google API Key

  1. Go to Google Cloud Console
  2. Create a new project (or use existing)
  3. Enable the Places API
  4. Create an API key under Credentials
  5. Paste it in your .env file

Usage

  1. Upload a KML or GPX route file
  2. Enter what you're looking for (e.g., "coffee shops", "bars", "restaurants")
  3. Adjust filters as needed
  4. Click Search

The map will show your route and all matching places. Results include ratings, prices, and distance from your route.

Features

  • Upload KML or GPX route files
  • Search along route with Google Places API
  • Filter by rating, price, distance, and open hours
  • Interactive map with route and results
  • Export results to table view

Requirements

  • Python 3.8+
  • Google Places API key (free tier available)
  • KML or GPX file with your route

About

Search for places along your routes using Google Places API

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors