Trouve les coordonnées d'un lieu (village, sommet, parking, lac…) par son nom.

    `country` : code ISO à 2 lettres (fr, ch, it…) pour lever les ambiguïtés.
    

Cherche des points notables autour d'un lieu pour planifier un itinéraire : cascades, points de vue, lacs, sommets et cols, curiosités, patrimoine, eau, refuges… Ajouter la catégorie transport pour les arrêts de bus et gares (départ sans voiture).

    Résultats triés par intérêt. Seuls les lieux cartographiés dans OpenStreetMap apparaissent.
    

Sentiers balisés (GR, GRP, PR, sentiers locaux) qui passent à proximité d'un lieu, des plus importants (réseau international/national) aux plus locaux.

    Utile pour proposer un itinéraire balisé ; pour tracer une portion, utiliser route_between
    avec des points situés sur le sentier.
    

Calcule un tracé sur de vrais chemins passant par les points donnés, dans l'ordre.

    - `loop=True` : revient au premier point (boucle). Pour une boucle via un lieu imposé
      (cascade, sommet), donner départ + lieu(x) avec loop=True.
    - `max_sac_scale` : difficulté maximale acceptée (hiking = T1 facile … alpine_hiking = T4).
    Jusqu'à 30 points : suffisant pour une itinérance de plusieurs jours.
    Distance et dénivelé sont recalculés sur un MNT précis (IGN en France, Copernicus ailleurs).
    

Génère automatiquement des boucles depuis un départ pour une distance (et un D+) cible, dans plusieurs directions, et renvoie les n meilleures, déjà mesurées sur le MNT.

    Classement : écart à la distance et au D+ demandés, pénalité pour les allers-retours et le
    goudron, bonus pour les sentiers balisés ; `avoid_done` pénalise les boucles qui reprennent
    des randos marquées comme faites (mark_done). Prévoir ~20–40 s.
    

Importe un fichier GPX local comme itinéraire et calcule ses statistiques.

    `elevation="dem"` (défaut) recalcule les altitudes sur le MNT, pour des chiffres comparables
    aux itinéraires générés ; `"file"` garde celles du fichier (ex. altimètre barométrique).
    Lancer ensuite data_quality pour vérifier que la trace suit des chemins (règle G1).
    

Itinéraire de repli : depuis le point situé à at_km sur le tracé, rejoindre au plus court le départ, l'arrivée, ou un lieu donné (target : parking, village, arrêt de bus).

    À proposer pour les passages exposés, la météo incertaine ou une fatigue imprévue.
    

Enregistre les contraintes de l'utilisateur sur un itinéraire ; validate_route les vérifie : distance et D+ visés (±10 % / ±15 %), durée max, date et heure de départ (coucher du soleil, neige, météo), chien (parcs et réserves), enfants, poussette, difficulté max, part de goudron. Seuls les paramètres fournis sont modifiés.

Recalcule distance, D+/D-, altitudes et durée avec d'autres paramètres.

    `walker` applique un profil prédéfini qui remplace les vitesses (famille : 3 km/h et
    200 m/h en montée ; moyen : 4 km/h et 300 m/h ; sportif : 5 km/h et 450 m/h).
    Les paramètres de lissage par défaut conviennent à la plupart des cas.
    

Liste les points notables le long du tracé, avec leur position au km : cascades, rivières traversées (gués signalés), lacs, points de vue, sommets, patrimoine…

    `describe` ajoute une courte description et le lien Wikipédia des lieux connus de Wikidata.
    Les points sont ajoutés au GPX, à la carte et à la fiche.
    

Indique les passages techniques au km près : difficulté T3+ (échelle CAS), pentes fortes, via ferrata, échelles, câbles, sentier peu visible, pierriers, glaciers, dangers signalés, passages délicats de refuges.info. Chaque passage précise pourquoi il est signalé.

Zones réglementées traversées : parcs nationaux, réserves naturelles, zones protégées, terrains militaires — avec les règles probables (chiens, bivouac). Ne dit jamais « autorisé » : renvoie vers le règlement du site.

Score de confiance des données (altimétrie, difficulté renseignée, fraîcheur OSM) et vérification que le tracé suit des chemins cartographiés (indispensable pour une trace importée).

Prévisions Open-Meteo sur la plage horaire de marche, au départ, au point culminant et à l'arrivée : températures, pluie, rafales, orage, neige au sol. Jusqu'à 15 jours à l'avance. Utilise la date/heure de set_constraints si elles ne sont pas fournies (départ 9 h par défaut).

Tableau comparatif de plusieurs itinéraires (distance, D+, durée, goudron, sentiers balisés, allers-retours, recouvrement avec les randos déjà faites, difficulté, validation).

Compare un itinéraire à une trace de référence (ex. GPX enregistré sur le terrain, importé avec import_gpx) : écart géométrique, écarts de distance et de D+. Sert à calibrer et à vérifier la précision des calculs.

Vérifie l'itinéraire : géométrie, accès interdits, zones réglementées, difficulté, cohérence des chiffres, contraintes demandées, pentes, gués, eau, horaires, saison, météo, qualité des données. Statut ok, warning ou error, avec la position au km.

    Lance automatiquement les analyses manquantes (points notables, passages techniques, zones).
    

Emplacements pour dormir le long du tracé : refuges, cabanes et gîtes (refuges.info, OSM), aires de bivouac, et emplacements calculés (terrain plat < 8 %, eau à moins de 500 m si possible, loin des routes, hors pierriers et zones où le bivouac est interdit).

    Chaque emplacement indique sa source, le détour, la distance à l'eau et les avertissements
    réglementaires. Les emplacements calculés sont des pistes à vérifier sur place.
    `abrite_seulement` : uniquement refuges, cabanes, abris, grottes et abris sous roche
    (bivouac à l'abri de la pluie et du vent).
    

Découpe un itinéraire en étapes de plusieurs jours, avec un hébergement (refuge, cabane, gîte) ou un bivouac en fin de chaque étape ; overnight="abri" : uniquement des nuits à l'abri (refuge, cabane, abri, grotte, abri sous roche). Donner days et/ou max_hours_per_day (par défaut : la durée max enregistrée par set_constraints).

    Les durées sont équilibrées, un passage technique en fin d'étape est évité. Le GPX exporté
    contient alors une trace par jour, et la fiche une section par étape.
    

Résumé d'un itinéraire (stats, avertissements, statut de validation), sans la géométrie.

Liste les itinéraires enregistrés ; done=True : seulement les randos faites, done=False : seulement les projets.

Marque une rando comme faite (date, impressions). Les boucles générées ensuite éviteront de repasser par les mêmes chemins (generate_loop_candidates, avoid_done).

Écrit les fichiers d'un itinéraire et renvoie leurs chemins, à communiquer à l'utilisateur : - gpx : montre, applis — itinéraire complet en une trace (points notables et nuits en waypoints) + un fichier jour-N.gpx par étape si plan_stages a été lancé ; - md : fiche Obsidian (frontmatter Dataview) ; - html : carte interactive (fond topo, points notables, passages techniques, profil) ; - roadbook : page imprimable (Ctrl+P → PDF) avec étapes, passages, eau, météo. vault_dir : copie aussi la fiche, le GPX et la carte dans <vault_dir>/Randos/<nom>/.