Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

22 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🚍 RideFind - Transit Network Proximity Checker

A Streamlit web application that helps transit professionals determine if an address is within 3/4 mile of their transit service network using GTFS data.

⚠️ Important Disclaimer

THIS CODE DOES NOT REPLACE PROFESSIONAL ANALYSIS OR FTA/OTHER GRANTOR COMPLIANCE REQUIREMENTS. It does not account for every transit authority's specific situation regarding service modes and ADA compliance requirements. Use of this app is at your own discretion. All reporting and compliance with FTA policy and other grantors should be done with close reference to each grantor's policy manuals to ensure full compliance.

🚀 Live Demo

Web App: https://ridefind.streamlit.app/

✨ Features

  • GTFS File Upload: Upload your transit agency's GTFS feed
  • Address Search: Search any address with autocomplete functionality
  • Interactive Map: View your transit network plotted on an interactive Folium map
  • 3/4 Mile Buffer Visualization: See the ADA-compliant service area buffer around transit routes
  • Address Location: Pinpoint searched addresses on the map with a green marker
  • Downloadable Maps: Export maps as HTML files for documentation and reporting
  • All Service Modes: Plots all shapes from GTFS regardless of service mode

📋 Use Case

Whether a trip starts or ends within the 3/4 mile zone buffer is used for ADA program requirements. RideFind helps transit professionals quickly verify if an address falls within this service area. Note: Use of this app does not guarantee full compliance with ADA guidelines.

🛠️ Installation

Option 1: Use the Web App

Simply visit https://ridefind.streamlit.app/ - no installation needed!

Option 2: Local Installation

  1. Clone this repository:
git clone https://github.com/CJFData/RideFind.git
cd RideFind
  1. Install required packages:
pip install -r requirements.txt
  1. Run the application:
streamlit run RideFind.py
  1. Open your browser to http://localhost:8501

Option 3: Jupyter Notebook

You can run this as Jupyter notebook cells:

Cell 1 - Install libraries:

!python LibraryInstall.py

Cell 2 - Run the app:

!streamlit run RideFind.py --server.headless true

📖 How to Use

Step 1: Upload GTFS File

Click the upload button and select your transit agency's GTFS .zip file.

Upload GTFS

Step 2: Search Address

Enter the address you want to check. The app provides autocomplete suggestions - be sure to include at least the street address and town.

Search Address

Step 3: View on Map

Click "Show On Map" to plot the transit network from your GTFS file with the 3/4 mile buffer. The searched address appears as a green pin.

View Map

Step 4: Download Map (Optional)

Save the map by clicking "Download HTML Map" for your records or reports.

Download Map

📦 Requirements

  • Python 3.7+
  • streamlit
  • folium
  • geopandas
  • shapely
  • pandas
  • gtfs-kit (or similar GTFS processing library)
  • geopy (for geocoding)

See requirements.txt for full dependencies.

🎯 Technical Details

  • GTFS Processing: Reads shapes.txt from GTFS feeds to plot transit routes
  • Buffer Calculation: Creates 3/4 mile (1.207 km) buffers around all transit routes
  • Geocoding: Uses address geocoding to pinpoint locations
  • Mapping: Interactive Folium maps with OpenStreetMap tiles
  • Export: Generates standalone HTML map files

🤝 Contributing

Contributions, issues, and feature requests are welcome! This tool is designed to help transit professionals, and community input helps make it better.

📝 License

This project is licensed under the Creative Commons Attribution 4.0 International License (CC BY 4.0) - see the LICENSE file for details.

👏 Credits

Created by Christian J Ferreira

📧 Contact

Christian J Ferreira - LinkedIn - data@christianjferreira.com

Project Link: https://github.com/CJFData/RideFind

🔗 Related Resources


⭐ If you found this tool helpful for your transit agency, please consider giving it a star!

About

finds if an address is within 3/4 mile of a GTFS transit Network

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages