L’ensemble des informations permettant de déduire les jours et horaires d’ouverture pour un objet touristique sont complexes et amenées à évoluer pour couvrir de nouveaux usages. Pour cette raison, il est important de mettre à profit les informations simplifiées fournies.
Champs datesOuverture, periodeEnClair, recherche par date
Les informations présentes dans le champ ouverture sont assez nombreuses et peuvent être relativement complexes dans leur interprétation. De plus, leur format peut être amené à évoluer de manière à couvrir de nouveaux usage.
De manière à pérenniser vos développements, nous vous conseillons d’être vigilant sur les demandes de vos clients de manière à choisir les bons champs et le bon niveau d’information en fonction de leurs exigences fonctionnelles et de leurs possibilités budgétaire.
Pour les besoins les plus simples, la plate-forme Apidae vous offre les possibilités suivantes :
- Disponibilité d’un champ datesOuverture sur les objets (hors TERRITOIRE et ENTITE_JURIDIQUE – non concernés par le champ ouverture) lors d’une requête API sur une méthode de recherche avec une date de début et une date de fin, ou dans les exports si activation de l’option correspondante. Il s’agit de la liste de dates pour lesquelles l’objet est considéré « ouvert ». Dans les API, la sortie est limitée à 60 dates. Dans les exports, il y a suffisamment de date pour offrir une visibilité à 1 an (exemple : l’objet est exporté avec 1 an et 1 mois de dates d’ouverture ; il sera réexporté au bout d’un mois pour que vous conserviez 1 an de visibilité).
- Les API permettent de faire des recherches avec une date de début et une date de fin (visibilité limité à 2 ans dans le futur, seules les dates dans le futur sont prises en compte).
- Le champ ouverture.periodeEnClair offre une vision globale des périodes d’ouverture pour une lecture humaine. Des mécanismes de génération automatique assure un taux de remplissage correct.
Prérequis à l’utilisation du champ datesOuverture :
– disponible sur les services v002/recherche/list-objets-touristiques/, v002/agenda/simple/list-objets-touristiques/, v002/agenda/detaille/list-objets-touristiques/
– préciser une date de début supérieure ou égale à la date du jour (dateDebut) ET une date de fin au plus loin 700 jours après la date du jour (dateFin) dans la requête
– dans la construction de la requête, ajouter le paramètre datesOuverture à la liste des responseFields
Fonctionnalités avancées
Toutefois, ces éléments ne suffisent pas à tous les usages. Si vous êtes confrontés à d’autres besoins (voir exemples qui suivent), nous soulignons l’effort significatif supplémentaire à mettre en oeuvre en terme de développement et de maintenance (le format détaillé des périodes étant amené à évoluer).
Les fonctionnalités suivantes vous réclameront des efforts significatifs de développement. De plus, le format des périodes d’ouverture pouvant être amené à évoluer, cela vous demandera plus d’efforts en termes de maintenance.
- Affichage d’un libellé contextualisé en fonction d’une recherche par date (affichage de l’horaire contextualisé par rapport au jour de la recherche).
- Prise en compte des critères fermé le lundi midi, …
- Recherche par horaire.