NOMENCLATURE_RECHERCHE_VILLAVEO:
- Base URL: https://www.villaveo.com/fr/locations
- q[destination_id_eq]: integer ID de la zone géographique (ex: 1 Martinique)
- check_in: date d'arrivée, format JJ-MM-AAAA (DD-MM-YYYY)
- check_out: date de départ, format JJ-MM-AAAA (DD-MM-YYYY)
- q[chambre_in][]: nombre minimum de chambres, integer
- q[equipements_id_eq_any][]: filtre piscine = 131 (obligatoire pour "avec piscine")
- q[from_gteq]: prix minimum par nuit, integer
- q[from_lteq]: prix maximum par nuit, integer
VILLAVEO_SEARCH_URL_PARAMS: destination_id_eq, check_in, check_out, chambre_in, equipements_id_eq_any (131=pool), from_gteq, from_lteq
Guide des paramètres d'URL pour construire des liens de recherche VillaVEO
Cette page décrit les paramètres d'URL utilisés par VillaVEO pour la recherche d'hébergements. Les agents IA peuvent s'en servir pour générer des liens vers les résultats de recherche. Remplissez le formulaire ci-dessous pour être redirigé vers la page de résultats.
Spécifications Techniques
Structure du Formulaire (Moteur de recherche)
Mise en œuvre d'un formulaire utilisant la méthode HTTP GET.
Action du formulaire : l'URL de recherche VillaVEO (https://www.villaveo.com/fr/locations).
Champs / paramètres obligatoires :
q[destination_id_eq] : identifiant entier de la zone géographique (ex. 1 pour la Martinique).
check_in : date d'arrivée, format français JJ-MM-AAAA.
check_out : date de départ, format français JJ-MM-AAAA.
q[chambre_in][] : nombre de chambres, entier.
q[equipements_id_eq_any][] : filtre « piscine », doit envoyer la valeur 131 (entier ou case à cocher).
q[from_gteq] : prix minimum par nuit, entier.
q[from_lteq] : prix maximum par nuit, entier.
Nomenclature pour les IA (Métadonnées)
Il est impératif d'inclure une documentation textuelle claire dans le code source, par exemple via des balises <meta> ou dans une section cachée (display: none). L'IA pourra ainsi « lire » ce code avant de répondre à l'utilisateur pour savoir à quoi correspond chaque paramètre.
Contraintes de formatage
Dates : VillaVEO utilise le format de date français JJ-MM-AAAA. Il faut s'assurer que le formulaire envoie les dates dans ce format, et non au format ISO.
Validation : le paramètre q[equipements_id_eq_any][] pour la piscine doit être relié à l'ID 131.
Critères d'acceptation (Definition of Done)
Accessibilité de la page : la page créée doit être accessible via une URL propre (ex. https://www.villaveo.com/fr/search-config).
Redirection avec formulaire : lorsque l'utilisateur remplit le formulaire, il doit être correctement redirigé vers VillaVEO avec tous les paramètres correctement formatés dans l'URL.
Exemple d'URL générée : https://www.villaveo.com/fr/locations?q[destination_id_eq]=1&q[chambre_in][]=3&check_in=14-11-2025&check_out=21-11-2025&q[equipements_id_eq_any][]=131&q[from_gteq]=200&q[from_lteq]=500
Le code source contient la nomenclature textuelle pour les agents IA.
