Documentation

Comment
ça marche.

RunPath transforme un point sur une carte en un fichier GPX prêt à l'import. Voici exactement ce qui se passe à chaque étape — de votre clic jusqu'au fichier dans votre téléphone.

Aperçu en direct

Voyez l'app
en action.

Les étapes

Trois étapes,
expliquées en détail.

01
📍

Posez votre départ sur la carte

Tout commence par un point. Cliquez n'importe où sur la carte OpenStreetMap intégrée — rues, parcs, sentiers, chemins de campagne — et un marqueur se pose instantanément à cet endroit.

Recherche d'adresse

Vous ne savez pas où vous êtes ? Utilisez la barre de recherche en haut de la carte. RunPath interroge Nominatim (l'API de géocodage d'OpenStreetMap) et centre la vue sur le résultat.

Géolocalisation automatique

Au premier chargement, RunPath demande votre position GPS au navigateur et centre la carte dessus. Vous voyez directement votre quartier, sans rien taper.

Marqueur interactif

Le marqueur se déplace à chaque clic. Vous pouvez affiner votre point de départ autant de fois que nécessaire avant de générer l'itinéraire.

02
⚙️

Configurez votre itinéraire

Deux paramètres suffisent : le type d'activité et la distance. RunPath calcule le reste — waypoints, profil de routage, boucle — sans que vous ayez à y penser.

5 types d'activité

Course 🏃 (foot-walking), Trail ⛰️ (foot-hiking), Route 🚴 (cycling-road), VTT 🚵 (cycling-mountain), Marche 🚶 (foot-walking). Chaque type sélectionne le bon profil OpenRouteService pour coller aux bonnes voies.

Distance de 1 à 100 km

Le curseur ajuste la distance totale de la boucle. RunPath calcule le rayon correspondant, place 3 waypoints sur un cercle de ce rayon, puis confie l'optimisation du chemin réel à ORS.

Boucle qui revient au départ

Le dernier point de l'itinéraire est toujours identique au premier. Vous partez d'une place, faites le tour, et revenez exactement au même endroit — comme une vraie sortie.

03
⬇️

Téléchargez et utilisez le GPX

Un clic sur « Télécharger le GPX » et votre fichier est généré côté serveur en moins d'une seconde. Aucun stockage, aucun compte requis pour cette étape.

Contenu du fichier

Le GPX 1.1 contient une séquence de <trkpt> avec latitude, longitude et élévation réelle. Le type d'activité est encodé dans la balise <type> pour que les applis l'importent dans la bonne catégorie.

Applications compatibles

Strava, Garmin Connect, Komoot, Apple Fitness, Wahoo, Suunto App, Polar Flow, TrainingPeaks — toute application qui accepte le format GPX 1.1 standard. C'est le format universel de la trace GPS.

Nommage automatique

Le nom que vous avez saisi dans le formulaire devient le nom du fichier (.gpx) et la balise <name> dans le XML. Pratique pour retrouver vos traces.

Technique

Sous le capot.

Ce qui se passe entre votre clic et le fichier GPX.

🗺️

Routage OpenRouteService

RunPath envoie une requête POST à l'API ORS avec vos waypoints et votre profil. ORS calcule le chemin optimal sur le graphe routier d'OpenStreetMap. Si l'API est indisponible (quota dépassé, réseau), RunPath bascule en silence sur un tracé circulaire géométrique — le fichier GPX reste téléchargeable.

openrouteservice.org
📡

Variance GPS naturelle

Chaque point de trace reçoit une perturbation aléatoire de ±3 mètres, calculée en coordonnées polaires (rayon uniforme, angle aléatoire). Cette dispersion reflète la précision typique d'un récepteur GPS grand public en conditions normales — conforme aux standards CEP de 3 à 5 mètres.

lib/geo.ts · addNoise()
⛰️

Élévation réelle (SRTM)

Avec le paramètre elevation: true, ORS enrichit chaque coordonnée d'un troisième élément : l'altitude en mètres issue des données SRTM (Shuttle Radar Topography Mission, résolution ~30m). Une variation sub-métrique (±0.2m) est appliquée pour compenser les artefacts de quantification introduits par la résolution SRTM.

elevation: true → [lng, lat, ele]
📄

Format GPX 1.1

Le fichier généré respecte strictement le schéma GPX 1.1 du Topografix. Structure : <gpx> → <trk> → <trkseg> → N×<trkpt lat= lon=>…<ele>. Les caractères spéciaux dans le nom sont échappés (XML entities). Aucune extension propriétaire.

topografix.com/GPX/1/1

FAQ

Questions fréquentes.

Mes données sont-elles sauvegardées ?+

Non. Tout est généré à la volée côté serveur au moment du téléchargement. Aucune coordonnée, aucune trace et aucun fichier GPX n'est conservé après la réponse HTTP.

Pourquoi l'élévation ne correspond pas à mon GPS ?+

ORS fournit des altitudes ellipsoïdales (au-dessus de l'ellipsoïde WGS84). Votre montre GPS affiche une altitude orthométrique (au-dessus du géoïde, c'est-à-dire du « niveau de la mer » physique). L'écart — appelé ondulation du géoïde — varie de 30 à 50 m en Europe occidentale, et peut dépasser 100 m dans d'autres régions.

Quelles applications acceptent les fichiers GPX ?+

Strava, Garmin Connect, Komoot, Apple Fitness, Wahoo, Suunto App, Polar Flow, TrainingPeaks, et toute application supportant le format GPX 1.1. C'est le standard universel de la trace GPS sportive.

Puis-je choisir un itinéraire précis ?+

Non. RunPath génère une boucle automatique depuis votre point de départ. L'algorithme place des waypoints intermédiaires sur un cercle d'un rayon proportionnel à la distance choisie, avec un bearing aléatoire pour varier les sorties, puis laisse ORS trouver le meilleur chemin réel entre ces points.

Que faire si le routage échoue ?+

Si l'API ORS est indisponible ou retourne une erreur, RunPath bascule automatiquement sur un tracé circulaire géométrique (100 points régulièrement espacés). Un message vous informe du repli. Le fichier GPX reste générable et téléchargeable.

Prêt ?

Générez votre
premier GPX.

Posez une épingle, choisissez votre distance, téléchargez. Moins d'une minute.

Ouvrir RunPath →