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 2030 :
VENDREDI_SAINT (suisse)
- 29 mars 2024
- 18 avril 2025
- 3 avril 2026
- 26 mars 2027
- 14 avril 2028
- 30 mars 2029
- 19 avril 2030
LUNDI_PAQUES
- 1 avril 2024
- 21 avril 2025
- 6 avril 2026
- 29 mars 2027
- 17 avril 2028
- 2 avril 2029
- 22 avril 2030
ASCENSION
- 9 mai 2024
- 29 mai 2025
- 14 mai 2026
- 6 mai 2027
- 25 mai 2028
- 10 mai 2029
- 30 mai 2030
LUNDI_PENTECOTE
- 20 mai 2024
- 9 juin 2025
- 25 mai 2026
- 17 mai 2027
- 5 juin 2028
- 21 mai 2029
- 10 juin 2030
FETE_DIEU (suisse)
- 30 mai 2024
- 19 juin 2025
- 4 juin 2026
- 27 mai 2027
- 15 juin 2028
- 31 mai 2029
- 20 juin 2030
LUNDI_DU_JEUNE_FEDERAL (suisse)
- 16 septembre 2024
- 22 septembre 2025
- 21 septembre 2026
- 20 septembre 2027
- 18 septembre 2028
- 17 septembre 2029
- 16 septembre 2030
MARDI_GRAS
- 13 février 2024
- 4 mars 2025
- 17 février 2026
- 9 février 2027
- 29 février 2028
- 13 février 2029
- 5 mars 2030
MERCREDI_DES_CENDRES
- 14 février 2024
- 5 mars 2025
- 18 février 2026
- 10 février 2027
- 1er mars 2028
- 14 février 2029
- 6 mars 2030
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 |