一个实验性的在线 GPX 分析工具，但它是完全不同的动物
An experimental online GPX tool, but a whole different animal
TrailScope is a pure front-end GPX track analysis tool designed for hikers and trail runners. Upload your GPX file，input weather data, get a professional route analysis report, including elevation profile, grade visualization, difficulty rating, segment statistics, gear recommendations, and safety considerations.
-
📂 GPX Parsing & Visualization
Supports.gpxformat, automatically extracts position and elevation. -
🗺️ Interactive Map
Renders with Leaflet, offers multiple map sources (OpenStreetMap, Windy Outdoor Map, Google Satellite, Amap, etc.), color‑coded by grade or elevation. -
📈 Elevation Profile
Displays elevation changes along the entire route; supports zoom, pan, and hover/touch to inspect distance, elevation, and grade at any point.
Switch between "Grade" and "Elevation" coloring modes. -
📊 Comprehensive Statistics
- Total distance, total ascent/descent (D+/D-), max/min elevation
- Average grade, uphill/downhill/flat distances
- Maximum uphill/downhill grade
- Raw/smooth elevation accumulation to reduce GPS and baro altitude noise
- Grade distribution analysis and tech tips for hiking and trail running
-
🏔️ Difficulty Rating
Combines distance, elevation gain, and grade into a 0–100 score and a difficulty label (Casual → Bomber). -
⏱️ Time & Fitness Estimation
Based on Naismith’s Rule with steep‑terrain correction, estimates total time, moving/rest time, average pace, and energy expenditure (kcal).
Provides a 1–5 fitness level description. -
⚠️ Safety Consideration
Automatically identifies potential risks from route characteristics (high altitude, steep sections, long distance, large ascent, etc.) and weather condition, gives an overall safety concern level. -
☀️ Weather Analysis
Input temperature, humidity, wind speed, and weather type; get tailored gear advice and action suggestions.
Advanced parameters (wet‑bulb temperature, dew point, solar radiation, air pressure, etc.) allow estimation of the WBGT (Wet‑Bulb Globe Temperature) for heat‑stress assessment. -
🎒 Gear & Supply Recommendations
Generates essential gear, recommended gear, and supplies (water, meals, snacks) based on route difficulty, altitude, and weather conditions.
Supplies automatically convert between Metric and US Customary (imperial) units; water is displayed in fluid ounces (oz) for US Customary units. -
📋 Segment Statistics
Split the route by "grade variation", "fixed distance (1 km)", or "waypoints". Each segment shows distance, ascent, descent, average grade, max grade, time, and difficulty rating.
Click any segment to highlight it on both the map and the elevation profile. -
🌐 Unit Switching
Toggle between Metric (km, m) and US Customary (mi, ft) units instantly; all displayed values update accordingly. -
📱 Mobile Optimized
Touch‑friendly interactions; supports swipe gestures to explore the profile; full‑screen map mode adapts to portrait/landscape orientations. -
🔒 Privacy First
All processing is done locally in your browser; no data is ever sent to a server. Your data, only yours.
-
Open the Page
- Launch
TrailScope-English.htmlin your browser. - Click here for online version.
- Launch
-
Load a Track
- Click the upload area and select a
.gpxfile, or drag and drop it. - Alternatively, click the “DEMO” button to load a sample track.
- Click the upload area and select a
-
Explore the Analysis
Go to analysis section, showing:- Overview stats cards (distance, ascent, descent, max elevation)
- Interactive trail map and elevation profile chart
- Difficulty rating, time & fitness estimates, risk assessment
- Weather analysis (requires manual input)
- Gear & supply recommendations
- Segment statistics table
- Grade distribution with technical tips
- Route summary
-
Interact
- Map: Zoom, pan, switch map sources; click waypoints for details.
- Profile: Scroll to zoom (desktop), drag to pan; hover/touch to inspect points; export as PNG.
- Segment Table: Click any row to highlight the corresponding section on map and profile.
- Unit Toggle: Click the Metric (km, m)/US Customary (mi, ft) button at the top to convert all values.
- HTML5 / CSS3 – Structure and styling, with Tailwind CSS for layout
- JavaScript (ES6+) – All logic
- Leaflet – Map rendering and interaction
- Canvas API – Elevation profile drawing
- Font Awesome – Icons
- Native GPX Parsing – DOM‑based XML parsing
No backend dependencies; mobile friendly; runs completely offline.
TrailScope/
├── TrailScope-Chinese.html # Chinese main page
├── TrailScope-English.html # English main page
├── css/
│ ├── leaflet-1p9p4.css
│ ├── fonts.css
│ └── all.min.css # Font Awesome
├── js/
│ ├── tailwind-3p4p17.js
│ └── leaflet-1p9p4.js
├── demo.gpx # Chinese demo track
├── demo-en.gpx # English demo track
└── README.md # This file
| Term | Description |
|---|---|
| Elevation Gain (D+) | Total vertical rise along the track (raw or smoothed with a 4m threshold) |
| Elevation Loss (D-) | Total vertical drop along the track |
| Grade | Percent slope (positive for uphill, negative for downhill) |
| Pace | Minutes per kilometer (or per mile) |
| Naismith’s Rule | Classic hiking time formula (1 hour per 5 km + 0.5 hour per 300 m ascent), with steep‑terrain correction added |
| WBGT | Wet‑Bulb Globe Temperature – a composite index for heat‑stress assessment |
| Waypoint | A named point in a GPX file (e.g., "supply", "viewpoint") |
| Segment | A sub‑section of the route, defined by grade changes, fixed distance, or waypoints |
TrailScope provides analysis for planning purposes only.
Outdoor activities involve risks.
Always consider:
- fitness level
- weather conditions
- equipment
- route conditions
before starting your adventure.
Issues and pull requests are welcome! If you have better algorithms, additional map sources, or UI improvements, feel free to get involved.
- Please review the code structure before making changes; the main logic resides within the
<script>tags. - Ensure compatibility with both desktop and mobile devices when adding new features.
This project is licensed under the MIT License. You are free to use, modify, and distribute it.
- Inspired by awesome outdoor softwares and existed gpx visualizers (Strava, Zepp, Mapy, Organic Maps, GPX Studio, Gaia GPS).
- Thanks to all open‑source libraries (Leaflet, Tailwind CSS, Font Awesome).
- Thanks to OpenStreetMap and all map providers.
- Special thanks to outdoor enthusiasts and trail runners for their track data.
TrailScope – Visualize every track.
Made with ❤️ for hikers & trail runners