📖 Guida completa

Tutte le funzioni
di Gpx-Tool

Mappa globale, filtri avanzati, dettaglio attività, analisi pendenze, superfici stradali e Route Editor.

Indice rapido
🗺️

Strumento principale

La schermata centrale con mappa globale, filtri e lista attività. Si apre subito dopo il login.

🔐
Accesso con un click. Questa versione usa autenticazione via server. Clicca "↗ Accedi con Strava" sulla schermata iniziale, autorizza su Strava, e sei dentro. La sessione dura 30 giorni e si rinnova automaticamente — non dovrai mai reinserire credenziali.

🌍 Mappa globale

🎨
Tracce colorate per sport
Ogni attività è disegnata con un colore diverso per tipo di sport. La legenda in basso a destra mostra le discipline presenti.
🚴 Ride 🚵 MTB 🪨 Gravel 🏃 Run
↔️
Highlight bidirezionale
Passando il mouse su una traccia nella mappa, la scheda corrispondente si evidenzia. Viceversa, passando su una scheda, la traccia si illumina sulla mappa in bianco.
➡️
Frecce direzionali
A partire dallo zoom 13, su ogni traccia appaiono frecce che indicano la direzione di percorrenza. Si nascondono automaticamente a zoom più bassi.
🛰️
OSM / Satellite
I pulsanti OSM e Satellite in alto a destra cambiano il layer di sfondo tra OpenStreetMap e immagini satellitari.
Schermo intero
Il pulsante espande la mappa a tutto schermo. Premi Esc o clicca di nuovo per uscire.
Nascondi / Mostra mappa
Il pulsante "▲ Nascondi mappa" comprime la mappa per avere più spazio alla lista attività. Clicca di nuovo per ripristinarla.

🔍 Filtri

🏷️
Filtro per sport
I chip colorati filtrano per tipo di attività con multiselezione — tieni attivi più sport contemporaneamente. Il pulsante ··· espande gli sport meno comuni (Run, Trail, Hike, Walk, Swim, Virtual, E-Bike, Workout, Pesi). Clicca Tutti per azzerare.
📅
Filtro per data
I campi Da e A filtrano per intervallo di date. Il pulsante azzera entrambe le date.
📍
Filtro per località e raggio
  • Digita il nome di una città o zona e premi Invio o 🔍. Il tool cerca su OpenStreetMap e mostra un cerchio tratteggiato sulla mappa.
  • Il campo Raggio imposta il raggio in metri (default 500 m, fino a 100 km).
  • Il pulsante GPS usa la posizione reale del dispositivo.
  • Il filtro considera attività che passano in qualsiasi punto entro il raggio.
  • Clicca ✕ Rimuovi filtro per tornare alla vista completa.
💡
Se con i filtri attivi hai meno attività del previsto, in fondo alla lista compare un avviso con "⬇ Carica precedenti" o "⬇⬇ Carica tutte".

📂 Filtro traccia GPX

Carica una traccia di riferimento
Clicca "↑ Carica .gpx" per caricare un file GPX. La traccia appare sulla mappa in azzurro con frecce direzionali.
✂️
Mostra solo attività che si incrociano
Attiva la checkbox "Mostra solo tracce che si incrociano" per filtrare le attività che si sovrappongono geometricamente alla traccia caricata — utile per trovare tutte le uscite sullo stesso percorso.

🃏 Schede attività

🖼️
Thumbnail SVG della traccia
Ogni scheda mostra una miniatura vettoriale della traccia GPS colorata con il colore dello sport, con punto verde (partenza) e rosso (arrivo).
📊
Statistiche rapide
Distanza, dislivello positivo, tempo in movimento e, se disponibile, frequenza cardiaca media.
Download GPX singolo
Il pulsante "⬇ GPX" su ogni scheda scarica il file GPX dell'attività con coordinate GPS, altitudine e timestamp. Generato dal server.
🔎
Apri dettaglio
Clicca sul titolo o sul corpo della scheda per aprire la pagina di dettaglio con mappa, grafico, statistiche complete, superfici stradali e gallery foto.

☑️ Selezione multipla e export bulk

1

Seleziona le attività

Clicca sul quadratino in alto a sinistra di ogni scheda per selezionarla.

2

Compare la barra di selezione

In basso appare una barra con il conteggio delle attività selezionate.

3

Scarica come ZIP

Clicca "⬇ Scarica GPX (.zip)": il tool scarica i file GPX e crea un archivio .zip con tutti i percorsi selezionati.


📊 Riepilogo totali

Σ
Totali del filtro attivo
Barra con i totali delle attività filtrate: n. attività, km totali, dislivello, ore e calorie. Si aggiorna automaticamente ad ogni cambio di filtro.
🏅
Breakdown per sport
Se presenti più sport, compaiono pillole per ogni disciplina con km, dislivello e tempo, ordinate per numero di attività.


🗺️ Tab Percorsi

Il tab Percorsi mostra i percorsi salvati su Strava con distanza, dislivello e tempo stimato. Per ogni percorso:
  • ⬇ Scarica GPX — scarica il file GPX del percorso direttamente da Strava
  • ↗ Strava — apre il percorso su strava.com
I percorsi vengono caricati a pagine da 30.

✏️ Apri nel Route Editor

Il pulsante "✏️ Apri in Route Editor" apre l'editor passando le attività filtrate in quel momento. La traccia GPX di riferimento, se caricata, viene passata all'editor.
💡
Quando torni dall'editor alla lista attività, tutti i filtri vengono ripristinati automaticamente.
📊

Dettaglio attività

Si apre cliccando su una scheda dalla lista. Layout a due colonne: mappa a sinistra, statistiche e grafici a destra.

📋
Header attività
Nome dell'attività, tipo di sport, data, link diretto a Strava e pulsante di download GPX.
📦
KPI Strip
Griglia con tutti i dati disponibili:
  • Distanza, dislivello positivo/negativo
  • Tempo in movimento e totale
  • Velocità media e massima
  • Frequenza cardiaca media e massima
  • Potenza media, normalizzata e TSS
  • Cadenza, calorie

📈 Grafico multicanale

Grafico dei dati in funzione della distanza. Canali attivabili/disattivabili:
Altitudine Frequenza cardiaca Velocità Potenza Cadenza
Cliccando sul grafico la mappa si sposta sul punto corrispondente della traccia. Assi multipli per grandezze con scale diverse.

🎨 Vista pendenza

Il pulsante "📐 Pendenza" sovrappone alla traccia una colorazione che indica la percentuale di pendenza tratto per tratto.
> 15%
9–15%
5–9%
2–5%
-2–+2% (piano)
-5–-2%
-9–-5%
-15–-9%
< -15%

🪨 Vista superfici stradali

Il pulsante "🪨 Superfici" interroga OpenStreetMap (API Overpass) per il tipo di superficie di ogni tratto.
ColoreSuperficieEsempi
Asfaltostrade asfaltate, piste ciclabili
Sterratodirt, earth, ground, track
Ghiaia / Gravelgravel, fine_gravel, compacted
Pavé / Acciottolatocobblestone, sett, paving_stones
Sentiero / Erbagrass, path, footway
Non classificatodati OSM non disponibili

La sezione "Superficie" a destra mostra km e percentuale per ogni tipo di fondo.

ℹ️
I dati di superficie provengono da OpenStreetMap e possono essere incompleti in alcune zone. Il tool usa l'inferenza dal tipo di strada come fallback.

📸 Gallery foto e video

Se l'attività ha media caricati su Strava, la sezione mostra una griglia di miniature. I video sono indicati da un badge ▶. Clicca per aprire in lightbox. Per i video l'API Strava non fornisce file riproducibili direttamente — viene mostrato un pulsante per aprire il video su Strava.
✏️

Route Editor

Componi percorsi personalizzati assemblando segmenti dalle tue attività Strava. Esporta il risultato in formato GPX.

🔐
Prerequisito: essere già loggati. L'editor condivide la sessione con index.html. Se apri editor.html senza essere connesso, vieni reindirizzato alla pagina di login.
Pannello sinistro — Attività
Lista delle attività con traccia GPS disponibile. Se arrivi da "Apri in Route Editor", la lista è pre-filtrata. Altrimenti mostra tutte le attività.
🗺️
Mappa centrale
Occupa tutta la parte centrale. Mostra i segmenti risultanti dalla suddivisione delle tracce caricate.
✏️
Pannello destro — Percorso
Campo nome, lista dei segmenti aggiunti in ordine, distanza totale e pulsanti di azione.
📱
Compatibilità mobile
Su smartphone i pannelli sono apribili con due pulsanti flottanti: ☰ (attività) e ✏️ (percorso). La mappa occupa tutto lo schermo.

▶️ Come costruire un percorso

1

Seleziona le attività da usare

Nel pannello sinistro, spunta le attività che contengono i tratti da utilizzare. Se hai caricato una traccia GPX in index.html, appare in cima alla lista (in verde) già spuntata.

2

Carica le tracce in mappa

Clicca "Carica N attività in mappa". Il tool scarica i dati GPS da Strava, calcola i punti di intersezione e divide le tracce in segmenti ai punti di incrocio.

3

Clicca i segmenti per costruire il percorso

Clicca un segmento sulla mappa per aggiungerlo al percorso. Il segmento si evidenzia in arancione. I segmenti non collegabili diventano semitrasparenti.

🔗
Il tool permette di aggiungere solo segmenti topologicamente collegabili — che condividono un nodo con il percorso attuale.
4

Inversione automatica dei segmenti

Se un segmento è collegabile solo invertendo la direzione, il tool lo aggiunge automaticamente al contrario. Nel pannello i segmenti invertiti mostrano l'indicatore .

5

Il percorso può crescere in entrambe le direzioni

Puoi aggiungere segmenti sia in fondo che in testa. Il tool capisce automaticamente dove collegare il nuovo segmento.

6

Collegamento forzato tra segmenti non adiacenti

Clicca un segmento non collegabile: diventa giallo. Cliccalo di nuovo entro 5 secondi: il tool inserisce un bridge grigio tratteggiato e aggiunge il segmento.

7

Annulla, rimuovi, svuota

↩ Annulla — rimuove l'ultimo segmento (supporta più annullamenti).
✕ sul segmento — rimuove il primo o ultimo segmento della lista.
✕ Svuota percorso — cancella tutto e ricomincia.

🔧 Strumenti della mappa

➡️
Frecce direzionali sui segmenti
A partire dallo zoom 15, frecce indicano la direzione originale di ogni segmento. I segmenti invertiti mostrano ancora la direzione originale — per la direzione nel percorso, guarda ◀/▶ nel pannello destro.
Annulla dalla mappa
Il pulsante nella toolbar rimuove l'ultimo segmento senza aprire il pannello destro. Comodo su mobile.
Mostra/nascondi nodi
Il pulsante mostra i punti di intersezione tra le tracce (pallini arancioni). Utile per capire dove terminano i segmenti.
🟢
Traccia GPX di riferimento
Se hai caricato una traccia GPX da index.html, appare nell'editor come linea verde tratteggiata più spessa. Sempre visibile anche durante la selezione.

⬇️ Export GPX

Clicca "⬇ Esporta GPX" per scaricare il percorso come file GPX. Il file:
  • Usa il nome digitato nel campo in cima al pannello destro
  • Include le coordinate GPS precise (non la polyline compressata)
  • Include i dati di altitudine smussata
  • Gestisce correttamente la giunzione tra segmenti
  • È compatibile con Garmin, Komoot, RideWithGPS, ecc.
ℹ️
Il GPX esportato è un percorso pianificato, non un'attività registrata. Non avrà timestamp o frequenza cardiaca — solo il tracciato geografico con l'altitudine.
← Guida installazione  ·  Apri lo strumento →
Gpx-Tool · Guida funzioni