> For the complete documentation index, see [llms.txt](https://docs.solarvis.co/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.solarvis.co/documentation/pt/project-design/create-a-project/roof-drawing.md).

# Desenho do Telhado

## Finalidade Desta Página <a href="#purpose-of-this-page" id="purpose-of-this-page"></a>

A página **Desenho do Telhado** é a base de todo o fluxo de trabalho de projeto e viabilidade no solarVis.

Os usuários começam desenhando um **contorno do telhado em 2D**, podendo dividi-lo opcionalmente usando arestas internas, e então atribuindo **inclinações** para converter o desenho em um **modelo de telhado em 3D**.

{% hint style="info" %}
Este modelo 3D é posteriormente utilizado para:

* Posicionamento de módulos
* Análise de sombreamento
* Cálculos de energia e viabilidade
  {% endhint %}

## O Que Você Pode Fazer Aqui <a href="#what-you-can-do-here" id="what-you-can-do-here"></a>

Nesta página, você pode:

* Alternar entre **Modo de Visualização** e **Modo de Desenho**
* Desenhar e editar o contorno do telhado em 2D
* Detectar automaticamente o contorno do telhado com a **Detecção de Telhado por IA** (Apenas para Áreas de Alta Cobertura da Google Solar API)
* Construir um modelo real de telhado 3D a partir de dados de elevação LiDAR com **Ajustar ao LiDAR** (Apenas para Áreas de Alta Cobertura da Google Solar API)
* Utilizar guias de alinhamento e ângulo para precisão
* Usar o Detector de Arestas Internas para criar divisões internas
* Adicionar e gerenciar obstáculos e platibandas no telhado
* Atribuir inclinações para converter a geometria 2D em faces de telhado 3D
* Ajustar a altura do edifício e propriedades das faces do telhado
* Separar faces e vértices selecionados do telhado principal
* Alterar o provedor de mapas ou carregar imagens personalizadas
* Navegar e rotacionar a cena 3D

{% hint style="info" %}
Nesta página, as alterações são salvas automaticamente após serem feitas.
{% endhint %}

{% embed url="<https://app.arcade.software/share/MSHbtxFt4DZQT1q5cmR6?language=pt>" %}

## Modos <a href="#modes" id="modes"></a>

Explica os modos de interação disponíveis para visualizar, desenhar e modificar a geometria do telhado.

### Modo de Visualização <a href="#view-mode" id="view-mode"></a>

O Modo de Visualização é utilizado para **inspecionar** o modelo do telhado sem modificar sua geometria.

No Modo de Visualização, você pode:

* Rotacionar, mover e dar zoom na cena
* Acessar e revisar a altura do edifício
* Selecionar faces do telhado para inspecionar propriedades técnicas como inclinação, azimute e informações de área
* Selecionar o edifício para editar ou mover o telhado e nivelar as faces
* Voltar ao Modo de Desenho quando forem necessárias alterações na geometria

Este modo é recomendado para verificações de qualidade e validação.

### Modo de Desenho <a href="#draw-mode" id="draw-mode"></a>

O Modo de Desenho é utilizado para **criar e editar o contorno do telhado em 2D**.

#### Desenhando o Contorno

* Clique para posicionar vértices
* Continue clicando para definir as arestas
* Feche o polígono para completar o contorno
* Guias laranja mostram alinhamento perpendicular e paralelo
* Os vértices se encaixam automaticamente para criar um contorno limpo do telhado
* Os comprimentos das arestas são exibidos automaticamente
* Botões de desfazer e refazer estão sempre disponíveis

{% hint style="info" %}
O contorno ainda está em 2D nesta etapa. É necessário atribuir inclinação para convertê-lo em 3D.
{% endhint %}

Ao subdividir ou dividir o telhado, use a **tecla Escape (Esc)** para concluir o desenho da linha atual.

### Convertendo de 2D para 3D <a href="#converting-from-2d-to-3d" id="converting-from-2d-to-3d"></a>

Após completar o contorno do telhado, as inclinações são atribuídas às faces do telhado.

#### Atribuição de Inclinação

* Selecione uma face ou aresta
* Ajuste o valor da inclinação no painel à direita
* Ou arraste a seta de inclinação diretamente no modelo
* Cada inclinação transforma aquela face em um plano 3D

> A altura do edifício também pode ser ajustada numericamente ou visualmente.

> Cada inclinação transforma uma face plana em um plano 3D com orientação definida. Além disso, diferentes faces podem ter inclinações diferentes.

{% hint style="info" %}
Para locais suportados, o **Ajustar ao LiDAR** pode definir todas as alturas e inclinações automaticamente a partir dos dados de elevação LiDAR (descrito na seção Ajustar ao LiDAR nesta página).
{% endhint %}

## Detecção de Telhado por IA <a href="#ai-roof-detection" id="ai-roof-detection"></a>

A **Detecção de Telhado por IA** desenha o telhado para você: analisa a imagem de satélite e cria automaticamente o contorno do telhado, arestas internas e faces do telhado como um wireframe 2D.

Para usar, clique no botão **Detecção de Telhado por IA** (ícone de brilhos) na barra de ferramentas superior.

{% hint style="info" %}
Enquanto a análise é executada, uma notificação de progresso mostra **Detectando telhado...**; ao finalizar, o telhado detectado aparece no mapa.
{% endhint %}

* A substituição é uma única ação que pode ser desfeita; um **Desfazer** restaura seu desenho anterior
* Após a detecção, revise o resultado e corrija quaisquer arestas ou faces ausentes com as ferramentas normais de desenho
* O telhado detectado ainda está em 2D; atribua inclinações manualmente ou use o **Ajustar ao LiDAR** para construir o modelo 3D

{% hint style="info" %}
A Detecção de Telhado por IA está disponível quando dados de telhado em alta resolução cobrem o local do projeto. Se o botão não estiver visível, não há cobertura para este endereço.

Por favor, verifique: <https://developers.google.com/maps/documentation/solar/coverage>
{% endhint %}

{% embed url="<https://app.arcade.software/share/IZnYM1BhDZ13aiQZCuSh?language=pt>" %}

## Ajustar ao LiDAR <a href="#fit-to-lidar" id="fit-to-lidar"></a>

O **Ajustar ao LiDAR** constrói um modelo 3D real do telhado desenhado a partir de dados de elevação baseados em LiDAR: define a altura de cada ponto e a inclinação de cada face do telhado automaticamente; você apenas confirma quais pontos são paredes.

* Funciona em todos os edifícios desenhados no projeto de uma só vez
* Utiliza dados de elevação de alta resolução do Google
* Substitui a atribuição manual de inclinação para locais suportados

{% hint style="info" %}
O Ajustar ao LiDAR está disponível quando dados de telhado em alta resolução cobrem o local do projeto, e requer o provedor de mapas **Google Maps HD**. Com outro provedor selecionado, o botão fica desabilitado com um lembrete para mudar para o **Google Maps HD**.

Por favor, verifique: <https://developers.google.com/maps/documentation/solar/coverage>
{% endhint %}

### Ajustando o Telhado ao LiDAR <a href="#fitting-the-roof-to-lidar" id="fitting-the-roof-to-lidar"></a>

1. Desenhe o contorno do telhado ou use a **Detecção de Telhado por IA** se possível
2. Clique em **Ajustar ao LiDAR** na barra de botões inferior esquerda; uma notificação de progresso mostra **Ajustando ao LiDAR...**
3. No painel **Selecione as paredes**, os pontos de parede sugeridos estão pré-selecionados (amarelo). Clique nos pontos para adicionar ou remover marcações de parede, depois confirme com **Aplicar** ou a tecla **Enter**; **Cancelar** ou a tecla **Esc** aborta e restaura o telhado
4. Eleva cada ponto para sua altura real e aplica a inclinação correta a cada face do telhado
5. Revise o resultado 3D: pressione **Aprovar** para aceitar, ou **Editar** para corrigir o esqueleto do telhado primeiro

### Editando o Esqueleto do Telhado <a href="#editing-the-roof-skeleton" id="editing-the-roof-skeleton"></a>

Ao pressionar **Editar** na barra de resultados, retorna-se à visualização superior com o painel **Editar o esqueleto do telhado**:

* **Selecionar, Mover & Excluir**: Arraste pontos e linhas para movê-los, ou selecione os incorretos e remova-os com as teclas **Delete** / **Backspace**
* **Desenhar Linha**: Complete o esqueleto do telhado redesenhando linhas de telhado ausentes ou incorretas
* **Definir Paredes**: Clique nos pontos para alternar sua propriedade de parede; pontos não podem ser movidos neste modo
* **Ocultar Esqueleto** / **Mostrar Esqueleto**: Alterna a visibilidade do wireframe ao comparar com a imagem

Clique em **Aplicar alterações** para elevar o telhado novamente com o esqueleto atualizado, ou **Cancelar** para descartar as edições e retornar ao resultado anterior.

{% hint style="info" %}
Todo o fluxo do Ajustar ao LiDAR é registrado como uma única ação: um **Desfazer** retorna o telhado ao estado anterior ao início do fluxo.
{% endhint %}

## Detector de Arestas Internas <a href="#inner-edge-detector" id="inner-edge-detector"></a>

O **Detector de Arestas Internas** auxilia os usuários a dividir rapidamente formas complexas de telhado em faces menores.

### Como Funciona <a href="#how-it-works" id="how-it-works"></a>

* Analisa os ângulos do contorno do telhado
* Gera uma linha interna ao longo da bissetriz
* Sugere essas linhas como possíveis divisões internas

### O Que os Usuários Podem Fazer <a href="#what-users-can-do" id="what-users-can-do"></a>

* Aceitar as arestas internas sugeridas
* Ajustá-las ou reposicioná-las
* Remover arestas desnecessárias
* Adicionar manualmente as arestas internas ausentes

> As arestas internas definem apenas a geometria; não atribuem inclinações automaticamente.

## Obstáculos <a href="#obstacles" id="obstacles"></a>

Obstáculos representam objetos físicos no telhado onde não é possível instalar módulos solares.

{% hint style="info" %}
Obstáculos afetam os cálculos de sombreamento.
{% endhint %}

### Adicionando Obstáculos <a href="#adding-obstacles" id="adding-obstacles"></a>

Você pode adicionar obstáculos como:

* Retângulos
* Círculos
* Polígonos

Cada obstáculo pode ser redimensionado, movido e posicionado com precisão.

{% hint style="info" %}
Você também pode duplicar obstáculos para modelar rapidamente elementos repetitivos no telhado, ou ajustar manualmente sua altura acima da superfície do telhado.
{% endhint %}

### Funcionalidades dos Obstáculos <a href="#obstacle-features" id="obstacle-features"></a>

* Desenhar obstáculos retangulares
* Redimensionar arrastando os cantos
* Mover obstáculos livremente sobre o telhado
* Definir a altura do obstáculo para cálculos de sombreamento

{% hint style="info" %}
Os obstáculos podem ser alinhados diretamente à superfície do telhado usando a opção **Flush**.
{% endhint %}

#### Exemplos Comuns de Obstáculos

* Chaminés
* Claraboias
* Antenas parabólicas

## Águas-Furtadas <a href="#roof-dormers" id="roof-dormers"></a>

Águas-furtadas são elementos estruturais do telhado que se projetam verticalmente a partir da superfície principal do telhado e criam faces adicionais.

<div align="left"><figure><img src="/files/OrDyXzeECNtjaNlRGf6S" alt=""><figcaption></figcaption></figure></div>

No solarVis, águas-furtadas são modeladas como parte da geometria do telhado, não como simples obstáculos. Isso permite que as faces das águas-furtadas participem da lógica de inclinação e posicionamento de módulos.

Águas-furtadas são comuns em edifícios residenciais e do tipo hotel e devem ser definidas com precisão para evitar layouts incorretos de módulos e resultados de sombreamento inadequados.

### Adicionando uma Água-Furtada <a href="#adding-a-dormer" id="adding-a-dormer"></a>

Águas-furtadas podem ser adicionadas enquanto se trabalha no modo de desenho.

Para adicionar uma água-furtada:

* Mude para o modo de desenho
* Selecione a ferramenta Água-Furtada na barra de ferramentas superior
* Escolha um tipo de água-furtada
* Clique na face do telhado desejada para posicionar a água-furtada

Uma vez posicionada, a água-furtada passa a fazer parte da estrutura do telhado.

### Tipos de Água-Furtada <a href="#dormer-types" id="dormer-types"></a>

O SolarVis suporta múltiplas geometrias de águas-furtadas para refletir estruturas reais de telhados.

Os tipos disponíveis incluem:

* **Água-Furtada de Uma Água (Shed Dormer)**

  Água-furtada de uma única inclinação com um plano de telhado.
* **Água-Furtada de Duas Águas (Gable Dormer)**

  Água-furtada com duas faces inclinadas formando um espigão.
* **Água-Furtada de Quatro Águas (Hip Dormer)**

  Água-furtada com múltiplas faces inclinadas convergindo no topo.

Cada tipo de água-furtada gera automaticamente suas próprias faces de telhado.

### Propriedades das Faces das Águas-Furtadas <a href="#dormer-roof-faces-properties" id="dormer-roof-faces-properties"></a>

Quando uma água-furtada é selecionada, suas propriedades são exibidas no painel à direita.

Você pode ajustar os seguintes parâmetros:

* **Largura**

  Define o tamanho horizontal da água-furtada.
* **Comprimento**

  Define o quanto a água-furtada se estende ao longo da superfície do telhado.
* **Inclinação**

  Define o ângulo de inclinação das faces da água-furtada.

Todos os valores são inseridos numericamente e atualizam o modelo em tempo real. As faces das águas-furtadas são tratadas da mesma forma que as faces principais do telhado nos cálculos de posicionamento de módulos e sombreamento.

### Editando Água-Furtada <a href="#editing-dormer" id="editing-dormer"></a>

Águas-furtadas podem ser editadas após serem posicionadas.

Você pode:

* Redimensionar a água-furtada alterando a largura e o comprimento
* Ajustar a inclinação para corresponder aos desenhos arquitetônicos
* Mover a água-furtada pela face do telhado
* Reposicioná-la para evitar conflitos com módulos ou obstáculos

As edições são aplicadas instantaneamente a todas as faces da água-furtada.

### Duplicando uma Água-Furtada <a href="#duplicating-a-dormer" id="duplicating-a-dormer"></a>

Águas-furtadas podem ser duplicadas para recriar rapidamente estruturas repetitivas no telhado.

**Como Funciona a Duplicação**

* Selecione uma água-furtada existente
* Clique na ação **Duplicar** na barra de ferramentas ou no menu de contexto
* Uma cópia da água-furtada é criada com os mesmos:
  * Tipo de água-furtada
  * Dimensões
  * Valores de inclinação

A água-furtada duplicada pode então ser movida e ajustada independentemente.

{% hint style="info" %}
**Águas-Furtadas vs Obstáculos**

Águas-furtadas não são obstáculos.

Principais diferenças:

* Águas-furtadas criam nova geometria de telhado
* Obstáculos apenas bloqueiam o posicionamento de módulos

Use águas-furtadas quando a estrutura faz parte do telhado.

Use obstáculos para objetos sobre o telhado, como chaminés ou dutos, na superfície do telhado.
{% endhint %}

## Dividir Região <a href="#split-region" id="split-region"></a>

A função Dividir Região permite separar faces e vértices selecionados do telhado principal e posicioná-los em uma altura diferente. O recurso pode ser usado para desenhar telhados em níveis, extensões, garagens mais baixas e alas laterais.

{% hint style="info" %}
As alterações de Dividir Região são salvas automaticamente e suportam Desfazer e Refazer.
{% endhint %}

{% embed url="<https://app.arcade.software/share/zsBBfDw76JhS5zQC4OBJ?language=pt>" %}

### Dividindo uma Região do Telhado <a href="#splitting-a-roof-region" id="splitting-a-roof-region"></a>

* Mude para o modo de visualização e selecione o edifício
* Selecione ‘Dividir Região’ na barra de ferramentas superior
* Clique nas faces do telhado que deseja separar
* Clique nos pontos de canto compartilhados para definir quais arestas serão destacadas
* Selecione Aplicar Destacar para destacar a parte
* Arraste a seção separada para cima ou para baixo para ajustar sua altura

{% hint style="info" %}
A aresta conectada se move com ambas as seções, enquanto as demais faces do telhado se ajustam automaticamente.
{% endhint %}

### Cores de Cantos e Arestas <a href="#corner-and-edge-colors" id="corner-and-edge-colors"></a>

* Canto cinza: ainda não selecionável (sua face não está selecionada)
* Canto branco: selecionável
* Canto roxo: selecionado
* Aresta roxa: será destacada

### Atalhos <a href="#shortcuts" id="shortcuts"></a>

* Clique em uma face: Seleciona apenas a face mantendo seu contorno ancorado
* Ctrl + Clique em uma face: Seleciona a face e todos os seus vértices para deslocamento total
* Clique em um vértice: Alterna o vértice como não articulado
* Shift + Clique: Remove a face ou vértice selecionado da seleção
* Enter: Aplica a divisão
* Esc: Cancela

### Desfazer Divisão <a href="#unsplit" id="unsplit"></a>

Para unir novamente a seção ao telhado principal, selecione a seção dividida do edifício e clique em ‘Desfazer Divisão’ no painel do Edifício.

## Platibandas <a href="#parapet-walls" id="parapet-walls"></a>

Platibandas são paredes baixas que percorrem as bordas de um telhado. No solarVis, as platibandas são modeladas como parte do edifício: acompanham a inclinação do telhado, projetam sombras reais na análise de sombreamento e bloqueiam o posicionamento de módulos ao longo das bordas que cobrem.

{% hint style="info" %}
Platibandas afetam os resultados de sombreamento e posicionamento de módulos, portanto, modele-as antes de executar a análise de sombreamento.
{% endhint %}

### Adicionando uma Platibanda <a href="#adding-a-parapet" id="adding-a-parapet"></a>

Para adicionar uma platibanda:

1. Mude para o **Modo de Visualização** e clique no corpo do edifício
2. No painel do Edifício, ative o interruptor **Platibanda** para exibir os controles de platibanda
3. Defina a **Altura da parede** e **Espessura da parede**
4. Posicione a parede com um dos dois botões de posicionamento:
   * **Perímetro inteiro**: Envolve todo o contorno do edifício com uma única parede conectada em um clique
   * **Arestas selecionadas**: Alterna para a visualização superior onde você clica nas arestas do edifício que devem receber a parede, depois confirme com **Aplicar** ou a tecla **Enter**; **Cancelar** ou a tecla **Esc** sai sem adicionar a parede

{% hint style="info" %}
Adicionar uma platibanda de **Perímetro inteiro** substitui quaisquer platibandas existentes naquele edifício por uma única parede conectada na altura e espessura escolhidas.
{% endhint %}

A parede cresce para dentro a partir da borda do edifício conforme sua espessura, e seu topo mantém altura constante acima do telhado, acompanhando a inclinação ao longo de cada aresta.

A **altura da parede** pode ser definida entre 0,1 m e 3 m (padrão 1 m), e a **espessura da parede** entre 0,05 m e 1 m (padrão 0,2 m).

### Editando uma Platibanda <a href="#editing-a-parapet" id="editing-a-parapet"></a>

Clique em uma platibanda no **Modo de Visualização** para abrir seu painel.

Você pode:

* Ajustar a **altura da parede** e **espessura da parede**
* Usar **Explodir em arestas** para dividir uma platibanda conectada em paredes independentes por aresta, permitindo ajustar ou excluir cada aresta individualmente
* Usar **Editar arestas** para alterar quais arestas do edifício recebem a parede
* Excluir a platibanda com o botão **Excluir** no painel ou a tecla **Delete**

{% hint style="info" %}
**Editar arestas** está disponível para paredes criadas com **Arestas selecionadas**. Para remodelar uma parede de **Perímetro inteiro**, divida-a primeiro com **Explodir em arestas**.
{% endhint %}

{% hint style="info" %}
As platibandas acompanham o edifício automaticamente: mover, redimensionar ou editar o telhado atualiza as paredes, e excluir o edifício remove suas platibandas. O desfazer restaura o edifício junto com suas platibandas.
{% endhint %}

## Botões Desfazer & Refazer & Excluir <a href="#undo-and-redo-and-delete-buttons" id="undo-and-redo-and-delete-buttons"></a>

#### **Desfazer**

Reverte o último desenho ou edição feita no layout do telhado.

#### **Refazer**

Restaura o último desenho ou edição que foi desfeita.

#### **Excluir**

Remove tudo o que você fez, como obstáculos ou desenhos do telhado.

## Atalhos de Teclado <a href="#keyboard-shortcuts" id="keyboard-shortcuts"></a>

Os atalhos de teclado permitem trabalhar mais rápido e com mais precisão ao desenhar e editar telhados no solarVis.

#### Estados de Visualização

* **1:** Vista Superior
* **2:** Vista Frontal
* **3:** Vista Lateral
* **4:** Vista em Perspectiva
* **5:** Vista Isométrica
* **N**: Redefinir Norte

Os atalhos de visualização alteram a visão da câmera sem modificar a geometria.

#### Ferramentas de Projeto

* **E:** Modo de Edição
* **C**: Modo de Desenho
* **V:** Modo de Visualização
* **M:** Modo de Movimento
* **I:** Ferramenta de Aresta Interna

Esses atalhos alternam entre ferramentas de desenho e edição.

#### Controles de Visibilidade

* **L:** Mostrar ou Ocultar Dimensões
* **G:** Mostrar ou Ocultar Imagem de Satélite

Os atalhos de visibilidade reduzem a poluição visual durante a edição.

#### Ações

* **Ctrl + Z:** Desfazer
* **Ctrl + Shift + Z:** Refazer
* **Delete ou Backspace:** Excluir
* **Ctrl + C:** Duplicar

Os atalhos de ação gerenciam o histórico de edição e objetos.

#### Adição Rápida de Obstáculos

* **Alt + C:** Adicionar Obstáculo Circular
* **Alt + R:** Adicionar Obstáculo Retangular
* **Alt + P:** Adicionar Obstáculo Poligonal

Os atalhos de adição rápida criam instantaneamente obstáculos para áreas de sombreamento e zonas proibidas.

## Edição do Edifício <a href="#building-editing" id="building-editing"></a>

Permite gerenciar a estrutura geral do modelo do telhado após o contorno 2D ter sido convertido em 3D.

As edições em nível de edifício afetam todas as faces do telhado conectadas e são críticas para cálculos precisos de sombreamento, produção e viabilidade.

{% hint style="info" %}
O telhado desenhado pode ser facilmente duplicado em vez de ser criado novamente do zero.
{% endhint %}

### Acessando a Edição do Edifício <a href="#accessing-building-editing" id="accessing-building-editing"></a>

Para acessar as ferramentas de edição do edifício:

* Mude do modo de desenho para o modo de visualização
* Clique no corpo do edifício
* O painel do Edifício será aberto no lado direito

Este painel contém ações que se aplicam ao edifício inteiro ou às faces do telhado selecionadas.

### Ações do Painel do Edifício <a href="#building-panel-actions" id="building-panel-actions"></a>

Neste painel, você pode:

* Editar a geometria do telhado e inclinações numericamente

{% hint style="info" %}
Você pode redimensionar o edifício horizontalmente arrastando uma aresta horizontal para fora ou para dentro. Isso irá estender a aresta desenhada e ajustar o tamanho do edifício de acordo.
{% endhint %}

{% hint style="info" %}
Ao arrastar as arestas para cima, você pode definir a inclinação desejada do telhado
{% endhint %}

* Mover todo o telhado desenhado

{% hint style="info" %}
O movimento não altera a geometria, inclinações ou dimensões.
{% endhint %}

* Nivelar faces do telhado selecionadas

{% hint style="info" %}
Nivelar é útil para redefinir atribuições de inclinação incorretas ou arestas internas.
{% endhint %}

* Ajustar a altura do edifício numericamente ou visualmente na cena

{% hint style="info" %}
A altura do edifício afeta os cálculos de sombreamento e o comportamento de telhados em múltiplos níveis.
{% endhint %}

* Adicionar platibandas a partir da seção **Platibanda** (descrita na seção Platibandas nesta página)

### Seleção de Face do Telhado <a href="#roof-face-selection" id="roof-face-selection"></a>

Faces individuais do telhado podem ser selecionadas para inspeção detalhada ou edição.

Para selecionar uma face do telhado:

* Clique duas vezes na face
* O painel de Informações da Face do Telhado será aberto

Isso permite controle em nível de face sem afetar todo o edifício.

#### **Informações da Face do Telhado**

Quando uma face do telhado é selecionada, os seguintes dados são exibidos:

* **Inclinação** representa a inclinação da face do telhado.
* **Azimute** representa a orientação da face do telhado em relação à bússola
* **Área** representa a superfície utilizável da face do telhado.

Isso permite controle preciso sobre estruturas de telhado complexas ou em múltiplos níveis.

{% hint style="info" %}
**🧷 Boas Práticas para Edição de Edifícios**

* Sempre valide a inclinação e o azimute da face do telhado antes do posicionamento dos módulos
* Use Nivelar Faces para corrigir erros iniciais em vez de redesenhar
* Inspecione cada face do telhado individualmente em telhados complexos

A edição precisa do edifício garante resultados confiáveis em todos os módulos subsequentes.
{% endhint %}

## Provedor de Mapas e Controles de Imagem <a href="#map-provider-and-imagery-controls" id="map-provider-and-imagery-controls"></a>

A seleção de mapas e imagens é um passo crítico para o desenho preciso do telhado.

Esses controles estão localizados no canto inferior esquerdo da tela.

### Visibilidade de Satélite <a href="#satellite-visibility" id="satellite-visibility"></a>

Você pode alternar a imagem de satélite para:

* Reduzir a poluição visual
* Focar na geometria e medições
* Melhorar a precisão do desenho

### Visibilidade das Dimensões <a href="#dimension-visibility" id="dimension-visibility"></a>

Você pode mostrar ou ocultar as dimensões para:

* Validar comprimentos das arestas
* Reduzir ruído visual durante a edição

{% hint style="info" %}
Os rótulos de dimensão permanecem legíveis ao dar zoom in e out.
{% endhint %}

### Seleção do Provedor de Mapas <a href="#map-provider-selection" id="map-provider-selection"></a>

Você pode escolher entre diferentes provedores de mapas dependendo da disponibilidade e resolução:

* Google Maps
* Google Maps HD (Google Solar API)
* Azure Maps

{% hint style="info" %}
Alternar provedores pode melhorar a clareza da imagem, visibilidade das arestas ou precisão de alinhamento para locais específicos.
{% endhint %}

{% hint style="info" %}
A disponibilidade de dados solares e de telhado para o Google Maps HD depende da cobertura da Google Maps Solar API. Por favor, verifique o mapa de cobertura no site abaixo para confirmar se há dados disponíveis para sua localização.

[Verifique o site](https://developers.google.com/maps/documentation/solar/coverage)
{% endhint %}

{% hint style="info" %}
Às vezes, as configurações padrão do navegador podem não suportar “**WebGL**”. Por favor, verifique se seu navegador suporta WebGL [usando o link](https://get.webgl.org/).

Se você visualizar o erro **“WebGL não é suportado”**, o mecanismo gráfico utilizado para o desenho do telhado pode não funcionar corretamente. Para evitar esse problema, certifique-se de que o WebGL está ativado nas configurações do seu navegador.

Você pode seguir os passos no [link](https://www.youtube.com/watch?v=uhcrK0nl_SM) para atualizar suas configurações.
{% endhint %}

### Imagens Personalizadas <a href="#custom-images" id="custom-images"></a>

Além dos provedores de mapas, você pode carregar imagens personalizadas.

Casos de uso comuns incluem:

* Plantas arquitetônicas de telhados
* Imagens de drones
* Fotos de alta resolução do local

As imagens carregadas podem ser alinhadas ao sistema de coordenadas e usadas como referência para desenho.

Isso é especialmente útil quando a imagem de satélite está desatualizada ou pouco clara.

#### **Alinhamento de Imagem (Ajuste Inicial)** <a href="#image-alignment-initial-adjustment" id="image-alignment-initial-adjustment"></a>

Ao carregar uma imagem personalizada, será solicitado que você a alinhe com o mapa base.

<figure><img src="/files/YR6GsbDwkO8tTBUNdWON" alt=""><figcaption></figcaption></figure>

Para garantir o alinhamento preciso:

* Identifique os mesmos pontos de referência em ambas as imagens
* Coloque dois pontos correspondentes em ambas as imagens
* Use elementos claros e fixos, como cantos ou arestas do telhado
* Clique no botão ‘Ajustar’ para encaixar a imagem sobre a imagem de satélite

{% hint style="info" %}
A imagem à esquerda mostra a imagem de satélite (por exemplo, Google Maps), e a imagem à direita mostra a imagem personalizada carregada, como uma imagem de drone.
{% endhint %}

## Câmera e Navegação <a href="#camera-and-navigation" id="camera-and-navigation"></a>

<figure><img src="/files/rbnBVVB843uDnXjMiloX" alt=""><figcaption></figcaption></figure>

As ferramentas de câmera localizadas no canto inferior direito afetam apenas a visualização do modelo.

> Elas não alteram a geometria.

#### Bússola de Navegação

A bússola permite:

* Saltar para visualizações predefinidas, como superior ou lateral
* Validar a orientação do telhado
* Rotacionar a visualização ao redor do edifício

{% hint style="info" %}
Pode ser rotacionada para visualizar ao redor do edifício clicando com o botão direito e arrastando o mouse
{% endhint %}

#### Ferramentas de Câmera

Você pode:

* Mover a visualização
* Dar zoom in
* Dar zoom out

Essas ferramentas ajudam a inspecionar detalhes sem modificar o modelo.

{% hint style="info" %}
O mapa pode ser movido pressionando e arrastando a roda do mouse.
{% endhint %}

***

## Páginas Relacionadas <a href="#related-articles" id="related-articles"></a>

* [Página de Posicionamento de Módulos e Seleção de Inverter](/documentation/pt/project-design/create-a-project/panel-placement-and-inverter-selection.md)
* [Página de Consumo de Energia](/documentation/pt/project-design/create-a-project/consumption/energy-consumption.md)

Se você encontrar algum problema, [sinta-se à vontade para nos contatar.](https://www.solarvis.co/en/company/contact)


---

# 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.solarvis.co/documentation/pt/project-design/create-a-project/roof-drawing.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.