> 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-de/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/drop-pins-and-live-values.md).

# Pins und Live-Werte setzen

Setzen Sie beschriftete Pins in einen Digitalen Gebäudezwilling — zeigen Sie Live-Sensorwerte mit Name, Wert und Farbe an.

Bedingte Farbe sagt einem Bediener *dass* etwas Aufmerksamkeit erfordert — eine rote Zone, eine bernsteinfarbene Einheit. Manchmal brauchen sie auch die **Zahl**: nicht nur „der Kühlraum verstößt gegen die Vorgaben“, sondern „der Kühlraum hat 13,4 °C.“ Ein Drop-Pin setzt diesen exakten Messwert im Modell fest, verankert an der Stelle, zu der er gehört.

Ein Pin ist ein Marker, der an einem bestimmten Punkt in der Szene platziert wird. Er zeigt den Namen der Kennzahl und ihren aktuellen Wert mit Einheiten an, und der Pin selbst erhält dieselbe bedingte Farbe wie der Messwert — er ist also zugleich Beschriftung und Statusanzeige.

## Eine Kennzahl anpinnen

Pins werden im Bereich „Sensoren“ für eine Kennzahl erstellt, die Sie bereits eingerichtet haben (siehe [Sensoren und Farben binden](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md)).

1. Klicken Sie in der unteren Symbolleiste auf **Sensoren** und suchen Sie die Kennzahl, die Sie anpinnen möchten.
2. Klicken Sie bei dieser Kennzahl auf **An Szene anpinnen**.
3. Der Editor wechselt in den Auswahlmodus und zeigt die Aufforderung **Klicken Sie auf die Szene, um diese Kennzahl anzupinnen**.
4. Klicken Sie im Modell auf den Punkt, an dem der Pin sitzen soll — über dem Kühlraum, neben der Pumpe, auf der Parkbucht.
5. Der Pin erscheint an diesem Punkt und zeigt den Namen der Kennzahl und den aktuellen Wert an.

Eine angepinnte Kennzahl bietet dann zwei Steuerelemente: **Erneut anpinnen** um den Marker an eine neue Stelle zu verschieben, und **Lösen** um ihn zu entfernen.

## Was ein Pin anzeigt

Jeder Pin ist ein tropfenförmiger Marker mit einer Beschriftung darüber. Die Beschriftung enthält den Namen der Kennzahl und ihren aktuellen Wert mit Einheiten — `Kühlraum / Temperatur 13,4 °C`. Marker und Beschriftung werden nach den Bedingungen der Kennzahl eingefärbt, genau wie gebundene Objekte eingefärbt werden: Ein Messwert im Bereich „Verstoß“ macht den Pin rot, ein Messwert im Bereich „konform“ macht ihn grün.

So erfüllt ein Pin gleichzeitig zwei Aufgaben — er gibt die genaue Zahl an und zeigt den Status über die Farbe, ohne dass jemand die Zahl überhaupt lesen muss.

## Pins und Etagen

Ein Pin gehört zu der Etage, auf der er platziert wurde. In einem Modell mit mehreren Etagen wird ein auf der dritten Etage platzierter Pin angezeigt, wenn die dritte Etage im Blick ist, und bleibt auf den anderen aus dem Weg — damit sich in einem hohen Gebäude nicht die Pins aller Etagen überlagern. Siehe [Etagen und Ebenen](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md).

## Pins ein- und ausblenden

Die Kopfzeile des Bereichs „Sensoren“ hat einen **Sensor-Pins anzeigen** Umschalter. Er erscheint, sobald mindestens eine Kennzahl angepinnt ist, und schaltet alle Pins im Modell gleichzeitig ein oder aus.

Pins ausschalten **aus** für eine saubere Ansicht nur mit Farben — nützlich für ein Dashboard auf einer Wandanzeige, bei dem Form und Farbe die Botschaft tragen. Schalten Sie sie **ein** ein, wenn Bediener die genauen Werte benötigen. Wie auch immer der Umschalter eingestellt ist, wenn Sie das Widget speichern, so wird es auf der Kachel des Dashboards angezeigt.

## Wann man einen Pin setzt

Farbe allein reicht für viele Objekte — eine Parkbucht braucht keine Zahl, belegt oder frei erzählt die ganze Geschichte. Greifen Sie zu einem Pin, wenn der Wert selbst wichtig ist:

* Ein Kühlraum oder Gefrierschrank, bei dem die genaue Temperatur der Compliance-Nachweis ist.
* Ein Tank oder Silo, bei dem der Füllstand in Prozent eine Nachfüllentscheidung auslöst.
* Eine Pumpe im Technikraum, bei der Druck oder Durchfluss der Messwert ist, auf den ein Techniker reagiert.
* Jeder Punkt, an dem „wie schlimm“ genauso wichtig ist wie „es gibt ein Problem“.

Pinnen Sie die wenigen Messwerte an, die Bediener wirklich als Zahlen brauchen, und überlassen Sie den Rest der Farbe. Ein mit Pins übersätes Modell ist so schwer zu lesen wie eine Tabelle; ein paar gut platzierte Pins lenken den Blick genau dorthin, wo er hingehen soll.

## Siehe auch

* [Sensoren und Farben binden](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md) — Richten Sie die Kennzahl ein, auf der ein Pin basiert
* [Etagen und Ebenen](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Wie sich Pins über Etagen hinweg verhalten
* [GPS-Verankerung](/kilo-docs-de/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md) — Verankern Sie Punkte in der Szene an realen Koordinaten


---

# 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-de/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.
