/best-biking-roads-explorer

User-friendly web app for motorcyclists to filter roads by country, type, and rating, and export routes to GPX for navigation.

Primary LanguageJavaScript

Best Biking Roads Explorer

Live Demo

Best Biking Roads Explorer is a user-friendly web application designed to help motorcycling enthusiasts discover and navigate the most interesting motorcycling routes. By allowing users to filter roads by country, type, and rating, this application simplifies the process of finding the perfect motorcycling path tailored to individual preferences. Additionally, it offers the functionality to export filtered routes to GPX format, enabling seamless integration with navigation apps like OsmAnd for on-the-go routing.

Access the Live App Here

Features

  • Comprehensive Filtering: Easily filter motorcycling roads based on:

    • Country: Select your desired country to view its top motorcycling routes.
    • Road Type: Choose from various road types to find routes that match your motorcycling style.
    • Rating: Filter roads by their ratings to discover the best-reviewed paths.

  • Interactive Map Interface:

    • Visualize all available motorcycling routes on an interactive map.
    • Click on any road to view its name and access a direct link to its dedicated page on BestBikingRoads.com.

  • GPX Export:

    • Export your selected and filtered motorcycling routes to a GPX file.
    • Import the GPX file into your preferred navigation app (e.g., OsmAnd) for real-time routing and navigation during your motorcycling adventures.

How It Works

  1. Automated Data Updates:

    • All motorcycling routes are sourced from BestBikingRoads.com using a dedicated Go utility (main.go).
    • Data is automatically updated daily via GitHub Actions to ensure you always have the latest routes.
    • Fresh data is also fetched whenever the website is updated.

  2. Using the Application:

    • Filtering Routes:

      • Navigate to the filter section to select your preferred country, road type, and rating range.
      • The map will dynamically update to display roads that match your selected criteria.

    • Exploring Roads:

      • Click on any displayed road on the map to view its name.
      • Click on the road name link to visit its detailed page on BestBikingRoads.com, where you can find more information about the route.

    • Exporting to GPX:

      • After applying your desired filters, click the "Export to GPX" button.
      • Download the generated GPX file and import it into your navigation app to start your motorcycling journey with ease.

Development

Project Structure

  • master branch: Contains source code and automation
    • main.go & go.mod: Go utility for data fetching
    • website/: Website source files (index.html, css/, js/)
    • .github/workflows/: Automated deployment and data update workflows
  • gh-pages branch: Deployed website with current data

Automated Workflows

  • Deploy on commits: When you push to master, the website is automatically deployed with fresh data
  • Daily data updates: Data is refreshed daily at 6 AM UTC, updating only if changes are detected
  • Race condition prevention: Workflows are queued to prevent conflicts

Manual Development

# Fetch data manually for testing
go build main.go
./main -out=./data

# Website files are in the website/ directory
# - website/index.html
# - website/css/
# - website/js/

Acknowledgements