Passerelle MyCity <> Apidae Tourisme

Contexte - Préambule

Dans le cadre du projet Interreg “Objectif Découverte Léman”, une passerelle d’échange d’informations entre les deux Systèmes d’Information Touristique (SIT) MyCity et Apidae a été développée. Celle-ci a pour but de permettre le partage des objets touristiques entre les destinations touristiques faisant usage de ces deux systèmes. Un tel partage favorise la collaboration entre les destinations touristiques, y compris entre la frontière, en offrant aux visiteurs une expérience globale et pas seulement locale.

La passerelle permet à une destination utilisant MyCity d’utiliser des objets touristiques provenant de destinations utilisant Apidae, et de partager avec elles ses propres objets. Et inversement, pour une destination d’Apidae vis-à-vis d’une destination de MyCity.

Ce document a pour objectif d’expliquer le fonctionnement technique de cette passerelle et de servir de manuel utilisateur pour l’utiliser dans les deux SIT.

Fonctionnement

La passerelle d’échange d’informations touristiques MyCity <-> Apidae permet à une destination touristique de publier des objets vers une destination du système opposé et faire usage d’objets provenant du système opposé.

Je peux donc :

• Publier des objets touristiques m’appartenant vers MyCity,
• Utiliser dans mes projets de diffusion des objets provenant de MyCity.

La passerelle est synchronisée une fois par jour (durant la nuit) : les données sont échangées entre les deux SIT automatiquement et les objets ainsi partagés sont mis à jour ou ajoutés dans le système opposé à ce moment.

Objets supportés

Les objets touristiques supportés par la passerelle sont : 

• Point d’intérêt*
• Événement
• Itinéraire (en développement au moment de la rédaction de ce document, mars 2022)

Pour chaque objet, une correspondance des champs composant l’objet a été faite entre Apidae et MyCity. Par exemple, le champ “Résumé” dans MyCity correspond au champ “Descriptif court” dans Apidae. C’est-à-dire que lorsqu’un objet est envoyé depuis MyCity vers Apidae, le texte saisi dans le champ “Résumé” sera inséré dans le champ “Descriptif court” de l’objet créé dans Apidae. Et inversement, le texte saisi dans “Descriptif court” côté Apidae sera inséré dans le champ “Résumé” du côté MyCity.

Pour autant, tous les champs n’ont pas une correspondance exacte entre les deux systèmes. Il peut arriver qu’un champ dans MyCity n’existe pas dans Apidae (et inversement).

Nota Bene : 

• Les fiches qui ne seraient pas traduites dans les 3 langues (FR, DE, EN) ne remontent pas sur MyCity
• Les fiches dont le descriptif détaillé est vide ne remontent pas sur MyCity
• Les fiches dont les catégories ne répondent pas au mapping fait ne remonteront pas dans MyCity

Un listing exhaustif des champs a été fait dans le document suivant  :

MyCity <-> Apidae : Champs import/export

*Du côté d’Apidae, les objets suivants sont considérés comme des points d’intérêt (POI) :

Utilisation des données

Comment envoyer un objet de Apidae vers MyCity ?

La destination qui souhaite envoyer un objet vers MyCity doit préalablement en faire la demande à l’adresse support@apidae-tourisme.com afin d’être ajoutée en membre collaborateur sur le projet numérique créé par Apidae Tourisme. Un paramétrage doit également être fait côté MyCity.

Cette même destination pourra ensuite créer sa sélection avec la liste des objets qu’elle souhaite envoyer. Le nommage de la sélection doit se faire de la manière suivante : Offres_Nom de structure

Nous suggérons de limiter l'envoi de données dans un premier temps et d'utiliser cette recherche avancée : Sélection pour passerelle avec la suisse ‹ Résultats ‹ Consulter ‹ Apidae (apidae-tourisme.com)

et de l'enregistrer comme filtre et sélection pour le projet. Rappel : Comment créer un filtre et une sélection en même temps

Comment utiliser un objet provenant de MyCity dans Apidae ?

Tous les objets touristiques envoyés depuis MyCity sont publiés comme tout autre objet Apidae, le membre propriétaire de ces objets est : EDSI Tech Sarl. Les objets sont donc disponibles dans vos recherches. En revanche, ils seront accessibles, dans un premier temps en “lecture seule”. Cela signifie que vous ne pourrez pas les modifier.

Comment retrouver une donnée MyCity ?

Se connecter à la recherche avancée et effectuer une recherche avancée avec le membre propriétaire EDSI-Tech Sàrl 

Comment retrouver une donnée d’une destination spécifique ?

Il vous suffit de faire une recherche selon la commune recherchée.