> For the complete documentation index, see [llms.txt](https://docs.kiloiot.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/drop-pins-and-live-values.md).

# Repères à déposer et valeurs en direct

Déposez des repères étiquetés dans un jumeau numérique du bâtiment — affichez les relevés de capteurs en direct avec nom, valeur et couleur.

La couleur conditionnelle indique à un opérateur *que* qu’une chose nécessite une attention particulière — une zone rouge, une unité ambre. Parfois, ils ont aussi besoin du **nombre**: pas seulement « la chambre froide est en infraction », mais « la chambre froide est à 13,4 °C ». Une épingle de repère place cette mesure exacte dans le modèle, ancrée à l’endroit auquel elle appartient.

Une épingle est un marqueur placé à un point précis de la scène. Elle affiche le nom de la métrique et sa valeur actuelle avec les unités, et l’épingle elle-même prend la même couleur conditionnelle que la mesure — c’est donc à la fois une étiquette et un voyant d’état.

## Épingler une métrique

Les épingles sont créées depuis le panneau Capteurs, sur une métrique que vous avez déjà configurée (voir [Associer des capteurs et des couleurs](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md)).

1. Dans la barre d’outils du bas, cliquez sur **Capteurs** et trouvez la métrique que vous souhaitez épingler.
2. Sur cette métrique, cliquez sur **Épingler à la scène**.
3. L’éditeur passe en mode de sélection et affiche l’invite **Cliquez sur la scène pour épingler cette métrique**.
4. Cliquez sur le point du modèle où l’épingle doit se placer — au-dessus de la chambre froide, à côté de la pompe, sur la place de stationnement.
5. L’épingle apparaît à cet endroit, affichant le nom de la métrique et sa valeur actuelle.

Une métrique épinglée offre alors deux commandes : **Réépingler** pour déplacer le marqueur vers un nouvel emplacement, et **Désépingler** pour le supprimer.

## Ce qu’affiche une épingle

Chaque épingle est un marqueur en forme de goutte d’eau avec une étiquette flottant au-dessus. L’étiquette indique le nom de la métrique et sa valeur actuelle avec les unités — `Chambre froide / Température 13,4 °C`. Le marqueur et l’étiquette sont colorés selon les conditions de la métrique, exactement comme le sont les objets liés : une mesure dans la plage « infraction » rend l’épingle rouge, une mesure dans la plage « conforme » la rend verte.

Ainsi, une épingle remplit deux fonctions à la fois — elle indique le nombre précis et elle affiche l’état par la couleur sans que personne ait besoin de lire le nombre du tout.

## Épingles et étages

Une épingle appartient à l’étage sur lequel elle a été placée. Dans un modèle à plusieurs étages, une épingle placée au troisième étage s’affiche lorsque le troisième étage est visible et ne s’affiche pas sur les autres — ainsi, dans un immeuble élevé, les épingles de chaque étage ne finissent pas par se chevaucher. Voir [Étages et niveaux](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md).

## Afficher et masquer les épingles

L’en-tête du panneau Capteurs comporte un **Afficher les épingles des capteurs** interrupteur. Il apparaît dès qu’au moins une métrique est épinglée et active ou désactive toutes les épingles du modèle d’un coup.

Activez les épingles **off** pour une vue épurée, uniquement en couleur — utile pour un tableau de bord mural où la forme et la couleur portent le message. Désactivez-les **on** lorsque les opérateurs ont besoin des chiffres exacts. Quelle que soit la position de l’interrupteur au moment où vous enregistrez le widget, c’est ainsi que la tuile du tableau de bord l’affiche.

## Quand épingler

La couleur seule suffit pour de nombreux objets — une place de stationnement n’a pas besoin d’un nombre, occupée ou libre résume toute l’histoire. Utilisez une épingle lorsque la valeur elle-même compte :

* Une chambre froide ou un congélateur où la température exacte constitue la preuve de conformité.
* Une cuve ou un silo où le pourcentage de remplissage détermine une décision de remplissage.
* Une pompe de local technique où la pression ou le débit est la mesure sur laquelle un ingénieur agit.
* Tout point où « à quel point c’est grave » compte autant que « il y a un problème ».

Épinglez la poignée de mesures dont les opérateurs ont réellement besoin sous forme de nombres, et laissez la couleur pour le reste. Un modèle parsemé d’épingles est aussi difficile à lire qu’un tableur ; quelques épingles bien placées attirent le regard exactement là où il faut.

## Voir aussi

* [Associer des capteurs et des couleurs](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md) — Configurer la métrique sur laquelle une épingle est basée
* [Étages et niveaux](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Comment les épingles se comportent d’un étage à l’autre
* [Ancrage GPS](/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md) — Ancrer les points de la scène à des coordonnées du monde réel


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.kiloiot.io/kilo-docs-fr/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/drop-pins-and-live-values.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.