Les ouvertures (champ ouverture) permettent de déterminer quand un objet touristique est accessible aux visiteurs.
Conseils d’utilisation
En fonction des besoins de votre application, plusieurs informations sont disponibles avec des niveaux de complexité d’exploitation différentes. Il est important de déterminer quels sont les besoins à traiter de manière à exploiter le plus judicieusement possible les informations à disposition.
Le champ à favoriser, sauf besoin plus précis, est le champ periodeEnClair. C’est un champ textuel simple (internationalisé).
En cas de besoin de recherche (quel objet est ouvert tel jour), favorisez l’utilisation du champ datesOuverture (disponible dans les API ou exports) ou des recherches API qui vous fournissent l’information de manière simple en interprétant pour vous les périodes d’ouverture.
N’utilisez l’interprétation des périodes d’ouverture que si cela s’avère nécessaire. Simplifiez-vous la vie avec les champs periodeEnClair ou datesOuverture autant que possible.
> Outils pour l’exploitation des ouvertures
Champ ouverture
| Nom du champ | Type | Contenu |
|---|---|---|
| ouvertTouteLAnnee | enum | « OUVERT_TOUTE_L_ANNEE » ou rien Sert principalement pour gérer la saisie. |
| fermeTemporairement | enum | « FERME_TEMPORAIREMENT » ou rien Indique si un établissement est fermé. Les périodes d’ouverture classiques restent disponibles. |
| periodeEnClair | libellé internationalisé | la période en clair |
| indicationsPeriode | liste d’éléments de référence | Indication sur la saisonnalité. Indication sur des cas particuliers (Fermé le lundi soir, …) Attention : les valeurs été, automne, hiver, printemps sont auto gérées : vous ne pouvez ni les ajouter, ni les supprimer (ignorées silencieusement lors de l’écriture). |
| ouverturesComplementaires | liste d’éléments de référence | Sert entre autre à la génération automatique du libellé en clair (à la demande, ouvert 24h/24, …) |
| periodesOuvertures | liste de périodes d’ouverture | Voir la suite |
| fermeturesExceptionnelles | liste de fermetures exceptionnelles | Voir la suite. Ces informations sont à combiner avec les périodes pour déterminer les jours d’ouverture |
Périodes d’ouverture
Les périodes d’ouverture sont stockées dans le champ ouverture.periodesOuvertures.
Les types de période disponibles sont les suivants :
- OUVERTURE_TOUS_LES_JOURS : indique que l’objet est ouvert tous les jours sur la période indiquée. Les listes ouverturesJourDuMois et ouverturesJournalieres sont vides.
- OUVERTURE_SAUF : indique que l’objet est ouvert tous les jours sur la période indiquée sauf les jours de la semaine indiqués dans la liste ouverturesJournalieres. Si aucune ouverturesJournalieres n’est présente, alors il faut considérer une ouverture tous les jours de la semaine.
- OUVERTURE_SEMAINE : indique que l’objet est ouvert seulement les jours de la semaine indiqués dans ouverturesJournalieres sur la période indiquée.
- OUVERTURE_MOIS : indique que l’objet est ouvert seulement les jours du mois indiqués dans la liste ouverturesJourDuMois sur la période indiquée.
Si le booléen tousLesAns est à true, les années présentes dans les dates ne doivent pas être prises en compte. Les dates restent valable sur toutes les années, celle en cours, celle à venir, etc.
| Nom du champ | Type | Contenu |
|---|---|---|
| nom | libellé internationalisé | non utilisé |
| complementHoraire | libellé internationalisé | Complément d’informations sur la période d’ouverture |
| dateDebut | date | début de la période, date incluse dans la période. |
| dateFin | date | fin de la période, inclus dans la période. |
| horaireOuverture | heure | heure d’ouverture, peut être absent. |
| horaireFermeture | heure | heure de fermeture ; peut être absent. |
| type | enum | Voir liste ci-dessus. |
| tousLesAns | booléen | Indique si la période est à prendre en compte tous les ans.Dans ce cas, l’année indiquée pour les débuts et fins de périodes ne sont pas significatives. Il faut considérer que la période s’applique de manière continuelle. |
| ouverturesJournalieres | Voir la suite | seulement pour les OUVERTURE_SAUF et OUVERTURE_SEMAINE |
| ouverturesJourDuMois | Voir la suite | seulement pour les OUVERTURE_MOIS |
| ouverturesExceptionnelles | Voir la suite | |
| identifiantTechnique | entier | identifiant unique correspondant à la version de saisie de la tranche horaire |
Ouverture jour du mois
L’ouverture jour du mois permet de définir les jours du mois concernés par une période OUVERTURE_MOIS.
| Nom du champ | Type | Contenu |
|---|---|---|
| jourDuMois | enum | Permet de définir quel est le jour du mois concerné (exemple : Lundi et D_1ER = le premier lundi du mois)D_1ER : premierD_2EME : deuxièmeD_3EME : troisièmeD_4EME : quatrièmeD_DERNIER : dernier |
| jour | enum | LUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE |
Ouverture journalière
L’ouverture jour du mois permet de définir les jours du mois concernés par une période OUVERTURE_SAUF ou OUVERTURE_SEMAINE.
| Nom du champ | Type | Contenu |
|---|---|---|
| jour | enum | LUNDI, MARDI, MERCREDI, JEUDI, VENDREDI, SAMEDI, DIMANCHE, TOUS |
Fermeture exceptionnelle
| Nom du champ | Type | Contenu |
|---|---|---|
| dateFermeture | date | null si dateSpeciale. Sinon la date de fermeture exceptionnelle au format yyyy-mm-dd |
| dateSpeciale | enum | null si dateFermeture présente. Sinon :PREMIER_JANVIERBERCHTOLDSTAG : (suisse) 2 janvierSAINT_JOSEPH : (suisse) 19 marsVENDREDI_SAINTLUNDI_PAQUESASCENSIONLUNDI_PENTECOTEPREMIER_MAIHUIT_MAIQUATORZE_JUILLETFETE_DIEU (suisse)FETE_NATIONALE_SUISSE : (suisse) 1er aoûtQUINZE_AOUTLUNDI_DU_JEUNE_FEDERAL (suisse)PREMIER_NOVEMBREONZE_NOVEMBREIMMACULEE_CONCEPTION : (suisse) 8 décembreVINGT_CINQ_DECEMBRE |
Pour les dates variant chaque année, voici le détail jusqu’en 2025 :
VENDREDI_SAINT (suisse)
- 3 avril 2015
- 25 mars 2016
- 14 avril 2017
- 30 mars 2018
- 19 avril 2019
- 10 avril 2020
- 2 avril 2021
- 15 avril 2022
- 7 avril 2023
- 29 mars 2024
- 18 avril 2025
LUNDI_PAQUES
- 6 avril 2015
- 28 mars 2016
- 17 avril 2017
- 2 avril 2018
- 22 avril 2019
- 13 avril 2020
- 5 avril 2021
- 18 avril 2022
- 10 avril 2023
- 1 avril 2024
- 21 avril 2025
ASCENSION
- 14 mai 2015
- 5 mai 2016
- 25 mai 2017
- 10 mai 2018
- 30 mai 2019
- 21 mai 2020
- 13 mai 2021
- 26 mai 2022
- 18 mai 2023
- 9 mai 2024
- 29 mai 2025
LUNDI_PENTECOTE
- 25 mai 2015
- 16 mai 2016
- 5 juin 2017
- 21 mai 2018
- 10 juin 2019
- 1 juin 2020
- 24 mai 2021
- 6 juin 2022
- 29 mai 2023
- 20 mai 2024
- 9 juin 2025
FETE_DIEU (suisse)
- 4 juin 2015
- 26 mai 2016
- 15 juin 2017
- 31 mai 2018
- 20 juin 2019
- 11 juin 2020
- 03 juin 2021
- 16 juin 2022
- 08 juin 2023
- 30 mai 2024
- 19 juin 2025
LUNDI_DU_JEUNE_FEDERAL (suisse)
- 21 septembre 2015
- 19 septembre 2016
- 18 septembre 2017
- 17 septembre 2018
- 16 septembre 2019
- 21 septembre 2020
- 20 septembre 2021
- 19 septembre 2022
- 18 septembre 2023
- 16 septembre 2024
- 22 septembre 2025
Ouverture exceptionnelle
L’ouverture exceptionnelle s’applique à une période. Elle permet de spécifier un jour d’ouverture de manière individuelle.
| Nom du champ | Type | Contenu |
|---|---|---|
| dateOuverture | date | la date d’ouverture au format yyyy-mm-dd |