Geotrek dispose d’une API (Application Programming Interface) qui sert à exposer les données stockées dans une instance de Geotrek-admin, dans le but de pouvoir la faire communiquer avec d'autres outils, systèmes et plateforme et ainsi échanger des données.
Cette API, désormais dans sa version 2 permet à toute structure tierce de récupérer des données et de les intégrer dans son système ou ses applications.
À ce jour de nombreux partenaires des structures utilisatrices de l’application Geotrek ont déjà utilisé cette API pour intégrer les données dans leurs outils.
L'API Geotrek est le point central pour permettre les interconnexions avec divers services. Grâce à cette interface de données, Geotrek s'est positionné comme un point central dans un écosystème de solutions du monde de la gestion et promotion des activités de pleine nature.
Pour changer les paramètres d'accès de l'API, référez vous à cette section API <api>
Geotrek-admin est capable de produire un flux des itinéraires et POIs présents dans sa BDD au format Cirkwi pour pouvoir les importer directement dans IGNrando' (https://makina-corpus.com/sig-webmapping/geotrek-et-lign-ca-fonctionne).
Exemple des randonnées et POIs du Parc national des Ecrins publiées sur IGNrando' depuis Geotrek-admin : https://ignrando.fr/fr/communautes/parc-national-des-ecrins
Depuis cette version, 2 flux sont automatiquement générés par Geotrek-admin au format attendu par l'IGN :
- [URL_GEOTREK-ADMIN]/api/cirkwi/circuits.xml
- [URL_GEOTREK-ADMIN]/api/cirkwi/pois.xml
Il est possible d'exclure les POI du flux pour ne diffuser que les randonnées. Pour cela, ajouter le paramètre ?withoutpois=1 à la fin de l'URL (http://XXXXX/api/cirkwi/circuits.xml?withoutpois=1).
Il est possible de filtrer les POI du flux par structure. Pour cela, ajouter le paramètre ?structures=<identifiant_de_la_structure> à la fin de l'URL (http://XXXXX/api/cirkwi/pois.xml?structures=2). Vous pouvez filtrer avec plusieurs structures : en séparant les identifiants par des virgules (http://XXXXX/api/cirkwi/pois.xml?structures=2,5,3).
Il est également possible de filtrer les randonnées du flux par structure et par portail. Pour cela, ajouter le paramètre ?structures=<identifiant_de_la_structure> ou ?portals=<identifian_de_la_structure> à la fin de l'URL (http://XXXXX/api/cirkwi/circuits.xml?portals=3).
Il est également possible d'exclure du flux les randonnées provenant de sources externes à Geotrek-Admin. Ce filtre est notamment nécessaire pour ne pas renvoyer à Cirkwi les randonnées qui en proviennent déjà. Pour cela, ajouter le paramètre ?include_externals=false à la fin de l'URL (http://XXXXX/api/cirkwi/circuits.xml?include_externals=false).
Il est possible de cumuler ces différents filtres, en séparant les valeurs par un & (http://XXXXX/api/cirkwi/circuits.xml?portals=3&structures=1&include_externals=false).
Il est également possible d'exclure du flux les randonnées provenant de sources externes à Geotrek-Admin. Ce filtre est notamment nécessaire pour ne pas renvoyer à Cirkwi les randonnées qui en proviennent déjà. Pour cela, ajouter le paramètre ?include_externals=false à la fin de l'URL (http://XXXXX/api/cirkwi/circuits.xml?include_externals=false).
Il est possible de cumuler ces différents filtres, en séparant les valeurs par un & (http://XXXXX/api/cirkwi/circuits.xml?portals=3&structures=1&include_externals=false).
Le référentiel CIRKWI a été intégré dans 3 tables accessibles dans le module de configuration (à ne pas modifier) :
Si vous ne souhaitez pas utiliser les valeurs par défaut ou avez créez vos propres typologies, il faut que vous renseigniez les correspondances entre les catégories de votre Geotrek et celles du référentiel IGN (Cirkwi) dans le module de configuration. Comme indiqué ici : #806.
- Pratique >> locomotion/loisirs
- Accessibilite >> thematiques/tags
- Themes >> thematiques/tags
- Types de POI >> Categories POI
Les correspondances avec les valeurs de ces 3 tables sont donc à renseigner dans les tables Geotrek des Pratiques, Accessibilités, Thèmes et Types de POI.
Ce même flux est aussi utilisable pour alimenter directement la plateforme Cirkwi : https://pro.cirkwi.com/importez-vos-donnees-geotrek-dans-cirkwi/.
Note
Geotrek-admin dispose aussi d'une API générique permettant d'accéder aux contenus d'une instance à l'adresse : [URL_GEOTREK-ADMIN]/api/v2/
Il existe plusieurs passerelles entre la plateforme d'informations touristiques APIDAE et Geotrek.
Actuellement, certains contenus touristiques peuvent être synchronisés automatiquement avec une base APIDAE. Il s'agit des contenus situés dans les catégories suivantes :
- Contenus touristiques (hébergements, restaurants, produits du territoire, lieux de visites...)
- Evénements touristiques (expositions, conférences, sorties...)
Les contenus touristiques peuvent aussi être synchronisés depuis des flux Tourinsoft ou Esprit Parc National.
Il est également possible de mettre en place des passerelles pour importer des POIs, des lieux de renseignement, des aménagements ainsi que des randonnées d'APIDAE vers Geotrek. Il est aussi possible d'enrichir le lien avec les contenus touristiques pour avoir par exemple d'autres catégories.
Pour configurer APIDAE, se référer à cette section Configure APIDAE (ex-SITRA) import <configure-apidae-ex-sitra-import>
Il existe aussi un lien dans l'autre sens, permettant d'importer automatiquement vers APIDAE les itinéraires existants dans une instance Geotrek.
L'API permet de connecter une instance Geotrek pour importer des itinéraires vers les objets de type "Équipements" dans APIDAE.
Les randonnées VTT, trail, vélo et les tours itinérants sont également intégrés dans la passerelle.
Pour plus d'information, se référer à la documentation en ligne de Sitourisme.