GU plans-reseaux.ch (public)

Actuellement, la Zone preselection API de plans-reseaux permet de faire un lien sur la page d'accueil du portail (la carte) avec une présélection de la zone à commander.

Faire évoluer cette API pour couvrir plus de cas d'usage

Comportement à implémenter

Modifier l'API https://plans-reseaux.ch/api/websearch/bbox/xmin/ymin/xmax/ymax comme suit :

• Supprimer les paramètres du BBOX du chemin de l'URL. Le chemin de l'API serait : https://plans-reseaux.ch/api/websearch
• Pour les appels d'API en allemand : https://plans-reseaux.ch/de/api/websearch. La langue de préférence du navigateur est ignorée (e.g. si fr, lien sur PR en allemand)
• Pour les appels en français, la langue de préférence du navigateur est prise en compte (e.g. si de, lien sur PR en allemand)
• Ajouter un paramètre de requête obligatoire "perimeter" pour sélectionner un périmètre de commande libre (polygone)
  E.g. perimeter=x,y,x,y,x,y,x,y,x,y,x,y,x,y,x,y
  Les coordonnées doivent être en MN95
• Ajouter un paramètre de requête optionnel "bgLayer" pour sélectionner le fond de carte entre adresses ou parcelles
  E.g. bgLayer=addresses ou bgLayer=parcels
  Par défaut : bgLayer=addresses
• Ajouter un paramètre de requête optionnel "showList" pour renvoyer directement sur la liste des plans à commander et non sur la carte
  E.g. showList=true ou showList=false
  Par défaut : showList=false

• Si le périmètre est trop grand (> 0.2 km2) : le paramètre showList est ignoré (la valeur par défaut false est utilisée), l'utilisateur est renvoyé vers la carte avec la zone à commander en rouge et le texte "La surface sélectionnée est trop importante."
• Si le périmètre est invalide (moins de 3 vertex, polygone non fermé) : renvoi sur "page introuvable"

• Tous les appels API écrasent les éventuelles zones à commander disponibles dans la session du navigateur

Documentation openAPI

Maquettes

Exemples d'appels API :

• Uniquement périmètre
  https://plans-reseaux.ch/api/websearch?perimeter=2537629,1151976,2537633,1151974,2537641,1151988,2537656,1151983,2537658,1151987,2537638,1151996,2537629,1151976
  

• Périmètre et showList=true
  https://plans-reseaux.ch/api/websearch?perimeter=2537629,1151976,2537633,1151974,2537641,1151988,2537656,1151983,2537658,1151987,2537638,1151996,2537629,1151976&showList=true
  

• Périmètre trop grand
  https://plans-reseaux.ch/api/websearch?perimeter=2537475,1151788,2538077,151788,2538077,1152162,2537475,1152162,2537475,1151788&showList=true