Enhancement #38026
Mis à jour par Benoît Regamey il y a 11 mois
Faire évoluer l'API Shop select pour permettre un renvoi direct sur le catalogue viageo ou sur la page "sélection des plans à commander" de plans-reseaux.ch. Actuellement, l'API renvoie vers une vue ou l'utilisateur doit choisir le portail entre viageo et plans-reseaux, cette amélioration permettrait un bypass de cette étape. *Comportements à implémenter* Modifier l'API https://viageo.ch/api/shop-select/doc comme suit: * Rajouter un paramètre optionnel "portal" avec les valeurs possibles : "vg" ou "pr" * Si le paramètre n'est pas spécifié, l'API fonctionne comme avant en renvoyant vers l'écran pour sélectionner le portail viageo ou plans-reseaux * Si portal=vg [comportement actuel après avoir choisi le portail viageo] : on arrive directement dans le catalogue viageo avec tous les paramètres de recherche spécifié dans l'API : provider (liste de fournisseurs), orderable (géodonnées commandables uniquement) et downloadable (géodonnées téléchargeables uniquement). * Si portal=pr [comportement actuel après avoir choisi le portail plans-reseaux] : on arrive directement sur la carte de plans-reseaux avec une zone de commande correspondant aux paramètres de BBOX (périmètre (correspond à un périmètre de commande rectangulaire). L'éventuelle zone de commande disponible dans la session du navigateur est écrasée. Tous les autres paramètres de recherche ne sont pas utilisés (inutiles dans plans-reseaux). ** Si la BBOX n'est pas spécifiée, l'API renvoie sur la page d'accueil de plans-reseaux. L'éventuelle zone de commande disponible dans la session du navigateur est utilisée. ** Si la BBOX spécifiée est trop grande pour plans-reseaux (> 0.2 km2), l'API renvoie sur la carte de plans-reseaux sans zone de commande mais avec une localisation optimisée pour la BBOX. L'écran d'accueil est affiché au-dessus de la carte. L'éventuelle zone de commande disponible dans la session du navigateur est écrasée. *Maquettes* Exemples d'appels de l'API * *API sans le paramètre "portal" : "https://viageo.ch/api/shop-select"*. Résultat: !{width:600px}clipboard-202412101535-f4lqh.png! * *API avec "portal=pr" et bbox valide : "https://viageo.ch/api/shop-select/bbox/2554117/1145573/2554274/1145672?portal=pr"* Résultat: !clipboard-202501070907-jmrtw.png! !{width:600px}clipboard-202412101520-crq07.png! * *API avec "portal=pr" et bbox non valide : "https://viageo.ch/api/shop-select/bbox/2000000/1100000/2500000/1140000?portal=pr" ou sans bbox : "https://viageo.ch/api/shop-select?portal=pr"* Résultat: !{width:600px}clipboard-202412101537-yah7a.png!