Agrémenter la documentation Cartographie avancée / Map styles

[gbvt]

La documentation sur la gestion avancée des styles de carte Leaflet est assez difficile à suivre, notamment pour la gestion des couches. Il s'agit de cette page là : https://geotrek.readthedocs.io/en/master/install/advanced-configuration.html

Plusieurs questions sur cette documentation, notamment sur le :

• dans MAPENTITY_CONFIG['MAP_STYLES'], à quels objets / quelles interfaces correspondent chacune des clés possible de cet objet de configuration ?
• dans COLORS_POOL, à quoi correspondent ces clés, et pourquoi y a-t-il différentes couleurs ? Pourquoi 5 maximum pour les listes de couleurs ?

En testant ce paramètres, j'ai pu noter que :

• les couches de type points (signalétique, évènement, POI...) ont un type unique qui est "others"
• le type "detail" est lorsque l'on clique sur un objet points, et que l'on affiche ses détails

Toutefois par exemple, je ne comprends pas où est géré le style des Signalétiques quand on les affiche en sur-couche dans la page d'une autre thématique, comme dans une carte des tronçons ou des aménagements.

Tout cela pourrait être ajouté dans la documentation pour permettre une meilleure compréhension de ces aspects visuels.

[camillemonchicourt]

Oui ça mériterait d'être précisé et clarifié.

Dans le fichier de configuration par défaut, on peut y voir (un peu) plus clair.

Les pools de couleurs par défaut pour différents groupes d'objets : https://github.com/GeotrekCE/Geotrek-admin/blob/master/geotrek/settings/base.py#L492-L501

Ils permettent d'attribuer une couleur automatiquement à chaque type de statut sans les connaitre par avance. Exemple des statuts fonciers :

Tu peux en ajouter d'autres ou modifier ces pools de couleurs. En plus des pools de couleurs pour chaque catégorie de statuts, il y a aussi un pool de couleurs pour les zonages, comme on voit ici :

Bien vu pour les MAP_STYLES des autres objets, les valeurs par défaut sont ici : https://github.com/GeotrekCE/Geotrek-admin/blob/master/geotrek/settings/base.py#L395-L417

Je ne suis pas certain que l'on puisse actuellement customiser la couleur des objets des autres modules quand on les affiche dans un autre module. Il me semble qu'ils sont tout le temps en bleu. Mais ça serait en effet intéressant de pouvoir customiser la couleurs des objets des autres modules.

[gbvt]

Merci Camille pour ces précisions ! En effet, dans nos premiers essais de personnalisation des couleurs de carte, nous avons déjà modifié les signalétiques affichées en jaune, qui sortent très mal sur les fond OSM ou IGN. Pour cela, nous avons pu identifier et modifier le custom.py en ajoutant ces quelques lignes à titre d'exemple. C'est en mettant des couleurs distinctes dans chaque clé du MAP_STYLES que nous avons pu comprendre quelles sont les couches impactées.

Mettre des exemples illustrés dans la documentation seraient d'une grande aide je pense.

# Ponctuels plus petit et en bleu sombre, dans l'affichage d'une liste
MAPENTITY_CONFIG['MAP_STYLES']['others'] = {'radius': 5, 'opacity': 1.0, 'color': '#14109E'}

# Ponctuel agrandi et en violet, dans l'affichage des détails d'un tel élément
MAPENTITY_CONFIG['MAP_STYLES']['detail'] = {'radius': 8, 'opacity': 1.0, 'color': '#674EA7'}