> For the complete documentation index, see [llms.txt](https://charlie-solutions.gitbook.io/guide-charlie-solutions/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://charlie-solutions.gitbook.io/guide-charlie-solutions/gestion-de-carte/clusters.md).
# Clusters
## Qu'est ce qu'un cluster ?
Un **cluster** représente un **regroupement de plusieurs éléments géolocalisés** (zones, sites ou matériels) situés **au même endroit ou très proches** sur la carte.
Sur la carte de **Charlie Solutions**, les clusters permettent de :
* Regrouper automatiquement plusieurs éléments sur un même point,
* Faciliter la lecture de la carte,
* Éviter l’encombrement visuel lorsqu’un grand nombre d’objets sont concentrés dans une zone.
:right: *Exemple : sur un chantier dense, plusieurs matériels et zones de stockage peuvent être détectés au même emplacement.*\
*Plutôt que d’afficher 15 icônes distinctes, la carte les regroupe dans un **cluster** unique.*
{% hint style="info" %}
Lorsqu’un cluster est présent, un **icône spécial** apparaît, indiquant le **nombre d’éléments** regroupés en un même point.
{% endhint %}
***
## Comment utiliser un cluster ?
{% stepper %}
{% step %}
**Repérez le cluster sur la carte**
Cherchez un icône violet avec un chiffre (ex : 4, 16, 25…).
.png?alt=media\&token=b958f65a-22f0-43ff-a620-479eb43df9f7)Icône de ***Cluster*** sur la carte
{% endstep %}
{% step %}
**Cliquez sur le cluster**
Cela ouvre une **fenêtre latérale** avec trois onglets pour Matériels / Zones / Sites et le nombre associé à chaque éléments.
{% endstep %}
{% step %}
Explorez les trois onglets disponibles :
* **Matériels** : affiche tous les matériels regroupés dans ce cluster.
* **Zones** : liste les zones de stockage associées.
* **Sites** : présente les sites rattachés à cette position.
Chaque onglet affiche le **nombre d’éléments** correspondant pour une lecture rapide.
{% endstep %}
{% step %}
Vous pouvez aussi **exporter les données** (au format CSV) ou passer à une **vue tableau** pour une vue plus détaillée.
{% endstep %}
{% endstepper %}
***
## Que pouvez-vous faire depuis un cluster ?
Une fois le cluster ouvert, plusieurs actions sont disponibles :
* **Rechercher un élément spécifique** via la barre de recherche interne au cluster.
* **Consulter les informations clés** de chaque élément (type, nom, statut, conformité) sans quitter la carte.
* **Basculer entre les onglets** *Matériels*, *Zones* et *Sites* pour obtenir une vue d’ensemble complète.
* **Exporter les données** du cluster au format **CSV** pour une analyse ou un suivi hors ligne.
* **Passer à la vue “Tableau”** pour une visualisation plus détaillée des éléments regroupés.
***
## Exemple d’utilisation
**Exemple :**\
Sur un site logistique, un cluster “8” apparaît.\
En cliquant dessus, vous découvrez qu’il regroupe :
* 3 zones de stockage,
* 4 matériels,
* 1 site.
Vous pouvez alors exporter la liste complète au format CSV pour préparer votre inventaire ou vérifier l’état de conformité de ces éléments.
