Ctrl+K

APIs

APIs#

API Geotrek#

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 tiers de récupérer des données et de les intégrer dans son système ou ses applications.

A 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.

C’est le cas des applications de :

  • Visorando

  • Kalkin

  • Apidae

  • IGNrando’

  • Outdooractive

Pour changer les paramètres d’accès de l’API, référez vous à cette section API

APIs externes#

Geotrek et IGNrando’#

Depuis la version 0.32.0, 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). Tout comme les pois Vous pouvez filtrer avec plusieurs structures et portails : en séparant les identifiants par des virgules.

Il est possible de filtrer les randonnées par portail et structure en même temps en séparant les 2 filtres par un & (http://XXXXX/api/cirkwi/circuits.xml?portals=3&structures=1).

Le référentiel CIRKWI a été intégré dans 3 tables accessibles dans le module de configuration (à ne pas modifier) :

Ensemble des champs paramétrables pour le référentiel CIRKWI

Ensemble des champs paramétrables pour le référentiel CIRKWI#

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 : GeotrekCE/Geotrek-admin#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/

Geotrek et APIDAE#

Il existe plusieurs passerelles entre la plateforme d’informations touristiques APIDAE et Geotrek.

APIDAE vers 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

Geotrek vers APIDAE#

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.

Contents