[DOC] Import Evenement Geotrek > F&M Apidae / Entités de gestion et lieux #76
Description
Dans la version 2.3.0, l'import des évènements touristiques de Geotrek vers les "Fêtes et manifestations" d'Apidae a été finalisé et intégré : #69
Le fichier de documentation de MAPPING a été complété avec cette partie liée aux évènements (c3e0397) : https://github.com/GeotrekCE/Sitourisme/blob/main/MAPPING.md
Une partie un peu spéciale et complexe a été mise en place pour permettre d'attribuer les bonnes entités de gestion et les éventuels lieux dans Apidae à partir des infos présentes dans les évènements de Geotrek.
Celle-ci n'a pour l'instant pas été détaillée dans le fichier MAPPING.md, donc je les partage ici pour en garder la trace.
1. ENTITÉS DE GESTION (fait dans 62d5af5)
- Il nous faut pouvoir associer automatiquement une entité de gestion et des infos de contact sur chaque animation
- Actuellement nous n'avons pas directement l'info de l'entité de gestion Apidae dans chaque évènement Geotrek. Nous proposons donc d'utiliser l'info du secteur (district) calculé automatiquement dans Geotrek en intersectant la localisation carto de l'animation avec le zonage de chaque secteur. Pour les animations en dehors des 7 secteurs, ils seront associés à l'entité de gestion : Siège du PNE.
Les moyens de communication seront ceux de la MDP (Maison du Parc) du secteur dans lequel se trouve géographiquement l'animation.
Pour cela, il faudra établir une liste de correspondance entre les ID des secteurs dans le Geotrek du PNE et les ID Apidae des commerces et services de nos MDP, utilisées comme entités de gestion.
La route /touristicevent/ inclue une propriété "districts" indiquant le secteur géographique dans lequel est localisé l’événement.
Nous allons donc utiliser cela pour définir l'entité de gestion (et ses moyens de communication associés) de chaque événement.
Le mapping ci-dessous varie d'une instance Geotrek à une autre.
| id_district (Geotrek) | Entité de gestion (Apidae) |
|---|---|
| 1 (Briançonnais) | Parc national des Écrins - Briançonnais (771883) |
| 4 (Champsaur) | Parc national des Ecrins - Champsaur (5049092) |
| 3 (Embrunais) | Parc national des Ecrins - Embrunais (615667) |
| 7 (Oisans) | Parc national des Ecrins - Oisans (73900) |
| 6 (Valbonnais) | Parc national des Ecrins - Valbonnais (5049103) |
| 5 (Valgaudemar) | Parc national des Ecrins - Valgaudemar (5049077) |
| 2 (Vallouise) | Parc national des Ecrins - Vallouise (225837) |
Si aucun de ces districts n'est associé à un événement, alors l'associer à l'entité de gestion "Siège du Parc national des Ecrins (5308520)"
Pour les adresses associées, je ne sais pas trop comment il faut les renseigner.
2. LIEUX (fait dans 61d568f)
-
Il nous faut pouvoir associer certaines animations à des lieux Apidae, notamment pour pouvoir lister les animations de chaque MDP sur notre site internet, comme ici : https://www.ecrins-parcnational.fr/8925/maison-parc/maison-parc-national-ecrins-embrunais
-
Pour les lieux, il faudra aussi établir une correspondance entre certains lieux Geotrek des MDP et les ID des lieux correspondants dans Apidae
Mais pour le moment, la route API qui renvoie les événements, indique les lieux directement en texte et pas avec leur ID, propriété "place" : https://geotrek-admin.ecrins-parcnational.fr/api/v2/touristicevent/
Donc ça me semble un peu fragile pour faire une correspondance, mais peut-être qu'on peut commencer comme ça ?
Voila les 7 lieux Geotrek (propriété "place") à faire correspondance avec les lieux correspondants dans nos données APIDAE :- Maison de la Vallée du Champsaur, Pont-du-Fossé
- Maison du Parc national des Ecrins, Châteauroux-les-Alpes
- Maison du Parc national des Ecrins, Briançon
- Maison du Parc national des Ecrins, Entraigues
- Maison du Parc national des Ecrins, La Chapelle-en-Valgaudemar
- Maison du Parc national des Ecrins, Le Bourg d’Oisans
- Maison du Parc national des Ecrins, Vallouise
Dans Apidae :
- 11436 - Maison de la Vallée du Champsaur
- 11463 - Maison du Parc de l'Oisans
- 6765 - Maison du Parc du Valbonnais
- 11437 - Maison du Parc du Valgaudemar
- 10727 - Maison du Parc national des Ecrins - Briançonnais
- 10721 - Maison du Parc national des Ecrins - Embrunais
- 8421 - Maison du parc national des Ecrins - Vallouise
Si une autre info est renseignée dans la propriété "place", alors on n'associe à aucun lieu dans Apidae.
Il est possible que ce fonctionnement ne soit pas adapté dans d'autres contextes et territoires.
La correspondance des lieux Geotrek avec les lieux Apidae n'est certainement pas essentiel dans d'autres contextes, mais l'association des évènements à une entité de gestion est importante. Certaines structures préféreront peut-être pas définir les entités de gestion en fonction des secteurs (districts) de chaque événement Geotrek. Dans ce cas, ils pourront ne pas renseigner de correspondance entre districts Geotrek et entités de gestion Apidae et seulement en définir une unique par défaut (comme on le fait au PNE pour les événements Geotrek sans district associé.