Tutoriel : Créer des itinéraires cyclables personnalisés avec GraphHopper

Si vous rêvez de créer des parcours cyclables sur-mesure, GraphHopper se révèle un allié robuste et flexible. Derrière son interface minimaliste se cache un moteur puissant, capable de traiter les données OpenStreetMap pour tracer l’itinéraire le plus adapté à vos désirs, qu’il s’agisse d’une balade urbaine ou d’un itinéraire multi-étapes. Cet article vous guide étape par étape, depuis l’installation du service jusqu’à l’export de vos traces, en passant par la personnalisation fine des profils vélos.

Pourquoi opter pour GraphHopper en cyclotourisme ?

GraphHopper n’est pas qu’un simple outil de routage : il s’appuie sur une communauté active, des mises à jour régulières et un socle GPLv3. Vous bénéficiez d’un algorithme de plus en plus optimisé pour le vélo, capable d’intégrer les nouvelles pistes et véloroutes. En comparant avec d’autres solutions, on constate que sa modularité (profil JSON, API HTTP) laisse une grande liberté, notamment si vous souhaitez l’héberger sur votre propre serveur pour ne pas dépendre de services tiers.

Fiabilité et performance

Le cœur de GraphHopper repose sur des structures de données compressées, qui accélèrent le calcul en mémoire. Résultat : vos requêtes d’itinéraires cyclables s’exécutent en quelques millisecondes, même sur un ensemble de données couvrant tout un pays.

Flexibilité des profils

On peut définir un profil « vélo urbain », « vélo de route » ou « VTT », en ajustant les vitesses moyennes et les types de routes à éviter. Ce paramétrage très granulaire améliore significativement la qualité de l’itinéraire proposé à l’utilisateur.

Installation et configuration initiale

Via Docker

Lancez GraphHopper en quelques commandes : récupérez l’image officielle, montez un volume pour les données OSM et exposez le port HTTP. Cette approche isole votre environnement et garantit une mise à jour simplifiée.

docker pull graphhopper/graphhopper
docker run -d -v cheminguide/osm:/data -p 8989:8989 graphhopper/graphhopper

Installation locale

Si vous préférez compiler vous-même, clonez le dépôt GitHub, installez Java 11 et Maven, puis lancez :

mvn clean package -DskipTests

Copiez ensuite votre fichier PBF OpenStreetMap dans le dossier graphs et démarrez l’application avec java -jar web/target/graphhopper-web-*.jar server config.yml.

Création de profils cyclables personnalisés

Le cœur de la personnalisation réside dans les fichiers JSON de profiles. Exemple pour un VTT :

{
  "profiles": [
    {
      "name": "vtt",
      "vehicle": "bike",
      "weighting": "fastest",
      "turn_costs": false,
      "hints": {"elevation": true}
    }
  ]
}

En ajustant weighting et hints, vous influez sur le choix des chemins : chemins forestiers, pistes cyclables ou routes secondaires.

Ajouter un profil mixte

Pour un itinéraire combinant route goudronnée et sentiers, copiez le bloc JSON d’un profil existant, modifiez la propriété vehicle en custom_bike et créez une recette dans graphhopper.yml pour charger votre profil mixte.

Génération d’itinéraires sur mesure

Une fois le service prêt, interrogez l’API REST en envoyant un POST vers /route avec votre profil et vos coordonnées :

{
  "points": [[48.8566,2.3522],[45.7640,4.8357]],
  "profile": "bike",
  "locale": "fr"
}

Le résultat renvoyé contient plusieurs sections, dont paths pour la trace GPS et instructions pour chaque segment, avec le niveau de zoom et les informations de virage.

Export et intégration dans WordPress

Pour embarquer votre carte interactive, vous pouvez :

• Afficher la trace GPX dans un lecteur JavaScript dédié.
• Exposer directement l’API GraphHopper derrière un shortcode WordPress.

Dans un gabarit PHP, récupérez les points JSON, convertissez-les en GeoJSON, puis intégrez-les via Leaflet ou OpenLayers. Si vous souhaitez enrichir la présentation, vous pouvez afficher une carte de France routière en arrière-plan pour situer vos itinéraires.

Cas d’usage avancés et bonnes pratiques

Outre la planification cyclable, GraphHopper sert aussi pour des itinéraires plus spécifiques, par exemple la route des Châteaux de la Loire ou pour des trajets à forte dénivelée. Pensez à :

• Mettre à jour régulièrement vos données OSM pour profiter des dernières pistes.
• Tester plusieurs profils avant de placer en production.
• Limiter les requêtes simultanées ou mettre en cache les réponses pour éviter une surcharge.

FAQ

Faut-il un serveur puissant pour héberger GraphHopper ?

Un VPS doté de 2 vCPU et 4 Go de RAM suffit pour un usage cyclable sur un pays entier. Au-delà, passez à 8 Go pour des zones très denses.

Comment obtenir un export GPX compatible GPS de randonnée ?

L’API retourne déjà un tableau de points adapté au format GPX. Il suffit de transformer ce flux JSON en balises XML <trkpt>.

Peut-on mixer plusieurs modes de transport ?

Oui : créez des profils distincts pour chaque segment (vélo + train, vélo + ferry) et synchronisez les points de transition.