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

# Pines y valores en vivo

Coloca pines etiquetados en un Gemelo digital del edificio — muestra lecturas de sensores en vivo con nombre, valor y color.

El color condicional le indica a un operador *que* que algo requiere atención — una zona roja, una unidad ámbar. A veces también necesitan el **número**: no solo "la cámara frigorífica está en incumplimiento", sino "la cámara frigorífica está a 13,4 °C". Un pin de ubicación coloca esa lectura exacta en el modelo, anclada al lugar al que pertenece.

Un pin es un marcador colocado en un punto específico de la escena. Muestra el nombre de la métrica y su valor actual con unidades, y el propio pin adopta el mismo color condicional que la lectura — así que es a la vez una etiqueta y una luz de estado.

## Anclar una métrica

Los pines se crean desde el panel Sensores, sobre una métrica que ya has configurado (véase [Vincular sensores y colores](/kilo-docs-es/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md)).

1. En la barra de herramientas inferior, haz clic en **Sensores** y busca la métrica que quieres fijar.
2. En esa métrica, haz clic en **Fijar en la escena**.
3. El editor entra en el modo de selección y muestra el mensaje **Haz clic en la escena para fijar esta métrica**.
4. Haz clic en el punto del modelo donde debe colocarse el pin — sobre la cámara frigorífica, junto a la bomba, en la plaza de aparcamiento.
5. El pin aparece en ese punto y muestra el nombre de la métrica y el valor actual.

Una métrica fijada ofrece entonces dos controles: **Volver a fijar** para mover el marcador a un nuevo lugar, y **Desfijar** para eliminarlo.

## Qué muestra un pin

Cada pin es un marcador en forma de gota con una etiqueta flotando encima. La etiqueta incluye el nombre de la métrica y su valor actual con unidades — `Cámara frigorífica / Temperatura 13,4 °C`. El marcador y la etiqueta se colorean según las condiciones de la métrica, exactamente igual que se colorean los objetos vinculados: una lectura en la banda de "incumplimiento" hace que el pin sea rojo, una lectura en la banda de "cumplimiento" lo hace verde.

Así que un pin hace dos cosas a la vez: informa del número exacto y muestra el estado mediante el color sin que nadie tenga que leer el número.

## Pines y plantas

Un pin pertenece a la planta en la que se colocó. En un modelo de varias plantas, un pin colocado en la tercera planta se muestra cuando la tercera planta está a la vista y no estorba en las demás — así un edificio alto no termina con los pines de todas las plantas superpuestos. Véase [Plantas y niveles](/kilo-docs-es/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md).

## Mostrar y ocultar pines

El encabezado del panel Sensores tiene un **Mostrar pines de sensores** interruptor. Aparece una vez que al menos una métrica está fijada, y activa o desactiva todos los pines del modelo a la vez.

Desactiva los pines **apagados** para una vista limpia, solo de color — útil para un panel de pared donde la forma y el color transmiten el mensaje. Ponlos **activados** cuando los operadores necesiten las cifras exactas. Sea cual sea la posición del interruptor cuando guardes el widget, así es como lo mostrará el mosaico del panel.

## Cuándo fijar un pin

Para muchos objetos, el color basta — una plaza de aparcamiento no necesita un número; ocupado o libre cuenta toda la historia. Recurre a un pin cuando el valor en sí importe:

* Una cámara frigorífica o un congelador donde la temperatura exacta es el registro de cumplimiento.
* Un tanque o silo donde el porcentaje de llenado determina una decisión de reposición.
* Una bomba en la sala de máquinas donde la presión o el caudal es la lectura sobre la que actúa un ingeniero.
* Cualquier punto en el que "qué tan grave" importa tanto como "hay un problema."

Fija las pocas lecturas que los operadores realmente necesitan como números, y deja el resto al color. Un modelo salpicado de pines es tan difícil de leer como una hoja de cálculo; unos pocos pines bien colocados atraen la mirada exactamente hacia donde debe ir.

## Ver también

* [Vincular sensores y colores](/kilo-docs-es/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md) — Configura la métrica en la que se basa un pin
* [Plantas y niveles](/kilo-docs-es/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Cómo se comportan los pines entre plantas
* [Anclaje GPS](/kilo-docs-es/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md) — Ancla los puntos de la escena a coordenadas del mundo real


---

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