> 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-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/drop-pins-and-live-values.md). # Pinos e Valores em Tempo Real Coloque pinos etiquetados num Gémeo Digital do Edifício — mostre leituras de sensores em tempo real com nome, valor e cor. A cor condicional diz a um operador *que* algo precisa de atenção — uma zona vermelha, uma unidade âmbar. Às vezes, também precisam do **número**: não apenas "a câmara frigorífica está em incumprimento", mas "a câmara frigorífica está a 13,4 °C." Um pino de ancoragem coloca essa leitura exata no modelo, ancorada ao local a que pertence. Um pino é um marcador colocado num ponto específico da cena. Mostra o nome da métrica e o seu valor atual com unidades, e o próprio pino adota a mesma cor condicional da leitura — por isso, é ao mesmo tempo uma etiqueta e um indicador de estado. ## Fixar uma métrica Os pinos são criados no painel Sensores, numa métrica que já configurou (ver [Associar sensores e cores](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md)). 1. Na barra de ferramentas inferior, clique em **Sensores** e encontre a métrica que quer fixar. 2. Nessa métrica, clique em **Fixar na cena**. 3. O editor entra no modo de seleção e mostra o aviso **Clique na cena para fixar esta métrica**. 4. Clique no ponto do modelo onde o pino deve ficar — sobre a câmara frigorífica, junto à bomba, na baía de estacionamento. 5. O pino aparece nesse ponto, mostrando o nome da métrica e o valor atual. Uma métrica fixada oferece então dois controlos: **Reposicionar** para mover o marcador para um novo local, e **Desafixar** para o remover. ## O que um pino mostra Cada pino é um marcador em forma de gota com uma etiqueta a flutuar acima dele. A etiqueta contém o nome da métrica e o seu valor atual com unidades — `Câmara frigorífica / Temperatura 13,4 °C`. O marcador e a etiqueta são coloridos pelas condições da métrica, exatamente da mesma forma que os objetos vinculados são coloridos: uma leitura na faixa de "incumprimento" torna o pino vermelho, uma leitura na faixa de "conforme" torna-o verde. Assim, um pino faz duas coisas ao mesmo tempo — apresenta o número exato e mostra o estado através da cor, sem que ninguém tenha de ler o número. ## Pinos e pisos Um pino pertence ao piso onde foi colocado. Num modelo com vários pisos, um pino colocado no terceiro piso aparece quando o terceiro piso está em vista e fica fora do caminho nos restantes — assim, um edifício alto não acaba com os pinos de todos os pisos sobrepostos. Ver [Pisos e níveis](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md). ## Mostrar e ocultar pinos O cabeçalho do painel Sensores tem um **Mostrar pinos de sensores** alternador. Aparece assim que pelo menos uma métrica é fixada e liga ou desliga todos os pinos do modelo de uma vez. Ative os pinos **desativados** para uma vista limpa, só com cor — útil para um painel de parede onde a forma e a cor transmitem a mensagem. Ative-os **ligados** quando os operadores precisarem dos valores exatos. A forma como o alternador estiver definido quando guardar o widget é a forma como o mosaico do painel o mostra. ## Quando fixar Só a cor é suficiente para muitos objetos — uma baía de estacionamento não precisa de um número; ocupado ou livre é a história toda. Use um pino quando o próprio valor for importante: * Uma câmara frigorífica ou congelador em que a temperatura exata é o registo de conformidade. * Um tanque ou silo em que a percentagem de enchimento determina a decisão de reabastecimento. * Uma bomba da sala técnica em que a pressão ou o caudal é a leitura sobre a qual um engenheiro atua. * Qualquer ponto em que "o quão grave" importa tanto como "há um problema." Fixe o pequeno conjunto de leituras que os operadores realmente precisam como números e deixe o resto para a cor. Um modelo salpicado de pinos é tão difícil de ler como uma folha de cálculo; alguns pinos bem colocados atraem o olhar exatamente para onde ele deve ir. ## Ver também * [Associar sensores e cores](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/binding-sensors-and-colors.md) — Configure uma métrica na qual um pino se baseia * [Pisos e níveis](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/floors-and-levels.md) — Como os pinos se comportam entre pisos * [Fixação por GPS](/kilo-docs-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/gps-anchoring.md) — Aplique coordenadas do mundo real a pontos da cena --- # 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-pt/kilo-iot-server/dashboards/adding-widgets/digital-building-twin/drop-pins-and-live-values.md?ask=&goal= ``` `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.