Démonstration — carte interactive des itinéraires et du patrimoine d'un territoire fictif (Eure), données fictives — réalisée par Vauclen. Accessibilité

API & open data

Les données du service — itinéraires, patrimoine, points d'eau, aires et accès — sont exposées par une API REST publique, sans authentification, au format GeoJSON. C'est la même API qui alimente l'application mobile du service.

Licence. Les données produites par la communauté de communes sont publiées sous licence ODbL 1.0 (mention d'attribution : « CC de la Plaine et du Bosc »). Les points d'intérêt touristiques issus du web service régional partenaire restent soumis à leur licence propre et sont exclus du flux ouvert.

Démonstration. Dans cette démonstration statique, les réponses de l'API sont servies sous forme de fichiers pré-générés, identiques au contenu de l'application. Le territoire et les données sont fictifs.

Conventions générales

Base d'appel (production type) : https://carto.plaine-et-bosc.example/api/v1
Format de réponse : GeoJSON (application/geo+json), encodage UTF-8 ;
Coordonnées en WGS84 (CRS84, longitude puis latitude), conformément à la RFC 7946. Les données sources sont gérées en RGF93 / Lambert-93 côté SIG et reprojetées à la publication ;
Champs calculés à partir du tracé (jamais saisis) : longueur_m, communes, coordonnées de départ et d'arrivée ;
Pas d'authentification ; limitation d'appel indicative : 600 requêtes/heure/IP ;
En-têtes CORS ouverts (Access-Control-Allow-Origin: *).

Points d'accès

GET /itineraires

Retourne l'intégralité des objets géographiques du service dans une FeatureCollection GeoJSON : itinéraires en LineString, lieux et équipements en Point.

Paramètres de requête (facultatifs, combinables)
Paramètre	Type	Valeurs	Exemple
`type`	chaîne, multiple	`iti`, `patrimoine`, `eau`, `aire`, `acces`	`?type=iti,eau`
`usage`	chaîne, multiple	`pied`, `velo`, `vtt`	`?usage=velo`
`difficulte`	chaîne	`facile`, `moyen`, `difficile`	`?difficulte=facile`
`bbox`	4 nombres	lng min, lat min, lng max, lat max	`?bbox=0.55,49.05,0.66,49.16`

Le tableau défile horizontalement sur petit écran.

Réponse d'exemple (démonstration, jeu complet) : api/itineraires.geojson (26 objets, ~23 Ko).

GET /itineraires/{id}

Retourne une Feature GeoJSON unique. L'identifiant {id} est le slug pérenne de l'objet — le même qui compose l'URL publique de sa fiche (#/itineraire/sentier-du-moulin).

Réponse d'exemple : api/itineraire_sentier-du-moulin.geojson

{
  "type": "Feature",
  "id": "sentier-du-moulin",
  "properties": {
    "id": "sentier-du-moulin",
    "nom": "Sentier du Moulin",
    "type": "iti",
    "usages": ["pied"],
    "difficulte": "facile",
    "parcours": "boucle",
    "longueur_m": 7898,
    "communes": ["Valcourt-en-Plaine", "Bracquetot"],
    "balisage": "PR — jaune"
  },
  "geometry": { "type": "LineString", "coordinates": [[0.5995, 49.1005], "…"] }
}

Extrait abrégé — la réponse complète comprend le chapo, la durée par usage, le gestionnaire et le tracé intégral.

GET /itineraires/{id}.gpx · /itineraires/{id}.kml

Exports du tracé au format GPX 1.1 ou KML 2.2 pour réutilisation dans un GPS ou un autre outil. Dans cette démonstration, ces exports sont générés côté client depuis chaque fiche détaillée (boutons « Télécharger le tracé GPX / KML »).

Dictionnaire des propriétés

Propriétés des objets (`properties`)
Propriété	Type	Présence	Description
`id`	chaîne	toujours	Identifiant pérenne (slug), stable dans le temps.
`nom`	chaîne	toujours	Intitulé de l'objet.
`type`	chaîne	toujours	Catégorie : `iti`, `patrimoine`, `eau`, `aire`, `acces`.
`chapo`	chaîne	toujours	Description courte (une à deux phrases).
`usages`	tableau	itinéraires	Types d'usage : `pied`, `velo`, `vtt`.
`difficulte`	chaîne	itinéraires	`facile`, `moyen` ou `difficile`.
`parcours`	chaîne	itinéraires	`boucle` ou `itinerance`.
`duree`	objet	itinéraires	Durée indicative par usage, ex. `{"pied": "2 h 15"}`.
`longueur_m`	entier	itinéraires	Longueur en mètres, calculée du tracé.
`communes`	tableau	itinéraires	Communes traversées, calculées du tracé.
`balisage`	chaîne	itinéraires	Type et couleur de balisage sur le terrain.
`commune`	chaîne	lieux	Commune d'implantation du lieu ou de l'équipement.
`eau_potable`	booléen	points d'eau	`true` si l'eau est potable (contrôle sanitaire), sinon `false`.
`gestionnaire`	chaîne	si connu	Structure gestionnaire de l'objet.

Le tableau défile horizontalement sur petit écran.

Réutiliser les données

Le fichier itineraires.geojson s'ouvre directement dans QGIS, uMap, geojson.io ou toute bibliothèque cartographique. Exemple d'appel :

curl -H "Accept: application/geo+json" \
  "https://carto.plaine-et-bosc.example/api/v1/itineraires?usage=pied&difficulte=facile"

En production. Dans la démonstration, télécharger directement le fichier ci-dessus.