Documentation technique

Règle de tri par date (v1)

Description de l’algorithme de tri par date.

Le tri par date d’ouverture est disponible pour les services et les limitations de types suivantes :

  • sur /api/v001/recherche/ pour les FETE_ET_MANIFESTATION et ACTIVITE
  • sur /api/v001/agenda/ pour les FETE_ET_MANIFESTATION

Le tri par date d’ouverture est réalisé sous les conditions suivantes :

  • La date de début doit être indiquée dans la requête.
  • Cette date doit obligatoirement être dans le futur.

Pour une requête de recherche, les éléments sont triés :

  • par la première date d’ouverture suivant la date de début indiquée (par rapport à la date indiquée, si A ouvre pour la première fois le lendemain, et B le surlendemain, alors A arrive avant B)
  • par la date de fin de la période d’ouverture : les objets qui ouvrent pour la première fois le même jour sont triés de manière à mettre en avant ceux qui ferment le plus vite. Les objets ouvert une journée sont listés avant ceux qui resteront ouverts plusieurs jours
  • par l’horaire d’ouverture : en particulier pour les objets qui ouvrent un seul jour (donc en début de classement), les objets qui ouvrent tôt sont classés avant les objets qui ouvrent tard.
  • Les objets sans horaire d’ouverture sont positionnés à la fin.

Pour une requête agenda, les objets sont déjà triés par date (une occurence par jour d’ouverture). Au sein d’une journée, les tris par date de fin de la période d’ouverture puis par horaire d’ouverture sont réalisés.