Enhancement #38026
Mis à jour par Benoît Regamey il y a 12 mois
Faire évoluer l'API Shop select pour permettre de renvoyer directement 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 viageo ou plans-reseaux
* Si portal=vg, 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, on arrive directement sur la page "sélection des plans à commander" sur plans-reseaux avec les paramètres de BBOX si présents (correspond à un périmètre de commande rectangulaire). 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
** Si la BBOX spécifiée est trop grande pour plans-reseaux (> 0.2 km2), l'API renvoie sur la page d'accueil de plans-reseaux
* [comportement technique] Faire évoluer l'API "Zone preselection API" utilisée par Shop select pour plans-reseaux : https://plans-reseaux.ch/api/websearch/bbox/xmin/ymin/xmax/ymax
Celle-ci ne doit plus renvoyer sur la carte mais sur la page "sélection des plans à commander"
*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: Résultat
!{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: Résultat
!{width:600px}clipboard-202412101537-yah7a.png!