> For the complete documentation index, see [llms.txt](https://navixy.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://navixy.com/docs/user/pt-br/guide/tracking/map-tools/geofences.md).

# Geocercas

Crie geocercas circulares, poligonais ou de rota, importe-as de arquivos Excel ou KML e vincule-as a regras de alerta para monitoramento de entrada e saída.

Geocercas são perímetros virtuais que permitem à plataforma Navixy monitorar se um objeto cruzou a borda da geocerca ("entrada" ou "saída"). A plataforma Navixy registra esses eventos, para que você possa gerar relatórios de geocercas e [receber alertas](/docs/user/pt-br/guide/events-and-notifications/movement-monitoring/geofence-entrance-or-exit.md). Você também pode vincular geocercas específicas a [Regras e alertas](/docs/user/pt-br/guide/events-and-notifications.md) áreas específicas. Por exemplo, você pode receber alertas de excesso de velocidade apenas dentro de uma cidade ou ao longo de uma rota.

Para acessar a **Geocercas** ferramenta, clique <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-e31a4909ec4c36387fb7598ca9683acfb53be057%2Fimage-20250425-083834.png?alt=media" alt="image-20250425-083834.png" data-size="line"> no canto superior direito do mapa. Ao selecionar qualquer uma das geocercas, são exibidos os objetos atualmente localizados dentro de seus limites.

![Ferramenta de geocercas](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-7894eb759fb4b13d3a654766b9c9900dbb1cded3%2Fimage-20240807-002528.png?alt=media)

## Tipos de geocercas

Estão disponíveis três tipos de geocercas:

* comando do dispositivo **geocerca circular** é uma área geográfica com um centro determinado e formato circular, com raio mínimo de 50 metros. Os usuários podem definir o raio e o centro do círculo.
* comando do dispositivo **geocerca poligonal** é uma área definida por um polígono arbitrário com até 500 vértices. Os vários vértices permitem criar formas complexas. Esse tipo é útil para definir com precisão áreas de formato irregular. Exemplos incluem bairros, parques e quaisquer zonas que não se encaixam em um limite circular simples.
* comando do dispositivo **geocerca de rota** cria um perímetro virtual entre dois ou mais pontos. Esse tipo de geocerca é adequado para monitorar [a aderência a rotas planejadas](/docs/user/pt-br/guide/events-and-notifications/scheduling-and-dispatching/deviation-from-the-route.md) e garantir que os veículos não se desviem do trajeto pretendido. A geocerca de rota usa uma série de pontos para criar uma rota contínua. Um raio especificado determina o desvio permitido em relação ao trajeto.

![Exemplo: Uma geocerca de rota é frequentemente usada em regras de desvio de rota](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-67bad59a4709f2d8e40ca93f5baf866707656720%2Fimage-20240806-235506.png?alt=media)

## Criando, editando e excluindo geocercas

### Como criar uma geocerca

Para criar uma geocerca, siga estas etapas:

{% stepper %}
{% step %}

#### Localize a área desejada no mapa

Use **Busca rápida**.
{% endstep %}

{% step %}

#### Abra a ferramenta Geocercas

Salvar <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-e31a4909ec4c36387fb7598ca9683acfb53be057%2Fimage-20250425-083834.png?alt=media" alt="image-20250425-083834.png" data-size="line"> no canto superior direito do mapa.
{% endstep %}

{% step %}

#### Selecionar o tipo de geocerca

Passe o cursor sobre o <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-bf66c98defd20c1749f63031f1897bf6faa4b2a5%2Fimage-20250325-150554.png?alt=media" alt="New geofence" data-size="line"> botão e selecione a geocerca que você deseja criar:

* **Círculo**:
  1. Arraste o círculo pelo mapa para definir sua localização.
  2. Use a alça de redimensionamento na borda para ajustar o tamanho. Você também pode ajustá-lo manualmente no **Raio** menu. A lista suspensa contém várias opções comuns para seleção rápida.
* **Polígono**:
  1. Comece com um pentágono.
  2. Ajuste-o arrastando vértices ou adicionando novos.
* **Rota**:
  1. Selecione os pontos inicial e final. A plataforma Navixy monta a rota.
  2. Adicione mais pontos da rota clicando e arrastando as alças de ajuste ao longo da rota.
  3. Defina o raio. O raio determina até onde o objeto pode se desviar do trajeto antes que o desvio de rota seja detectado. A lista suspensa contém várias opções comuns para seleção rápida.
  4. Se necessário, ative o modo manual para ajustar os pontos manualmente e obter controle preciso sobre o trajeto.
     {% endstep %}

{% step %}

#### Nomeie sua nova geocerca

Digite o nome da geocerca no **rótulo da geocerca** campo.
{% endstep %}

{% step %}

#### Selecionar cor

Escolha a cor para uma melhor visualização no mapa. Isso é particularmente útil ao gerenciar várias geocercas, pois cores diferentes podem diferenciar rapidamente várias zonas. A ferramenta de seleção de cores permite definir uma cor específica e visualizar seu código HEX.
{% endstep %}

{% step %}

#### Usar etiquetas

Adicione ou modifique etiquetas para categorizar e organizar geocercas. Etiquetas como "Central" e "Oeste" ajudam a classificar e gerenciar várias geocercas.
{% endstep %}

{% step %}

#### Salve a geocerca

{% endstep %}
{% endstepper %}

### Como editar uma geocerca

Para editar uma geocerca, clique em <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-c74b4671ecb7f8c4b116ccce008860713f161424%2FUntitled-20250425-103233.png?alt=media" alt="Untitled-20250425-103233.png" data-size="line"> ao lado da geocerca que você deseja editar na **Geocercas** ferramenta. Ao editar uma geocerca, você pode ajustar os mesmos campos que na criação.\
Para a descrição desses campos, consulte [Criando geocercas](#creating-geofence).

### Como excluir uma geocerca

Para excluir uma geocerca, selecione-a e clique em <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-3138d85bdcd004e511b7e7946fea783ff3e6a622%2Fimage-20250425-104605.png?alt=media" alt="Trash can icon" data-size="line"> no canto superior direito, ao lado de **Busca rápida**.

{% hint style="danger" %}
Somente geocercas não incluídas em nenhuma **Alerta** regra podem ser excluídas. Para remover a geocerca de uma **Alerta** regra, vá para **Alertas** → **Definir regras** e selecione a regra que contém a geocerca. Abra a **Configurações** aba e clique em ⨂ ao lado do nome da geocerca.
{% endhint %}

## Detalhes da geocerca

Para ver detalhes sobre a geocerca selecionada, clique em <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-bd2e8649ff5e643bdf4ed5253caf8512ef5c54e3%2FUntitled-20250416-090916.png?alt=media" alt="Information icon" data-size="line"> ao lado dela.

* **Etiquetas**: Etiquetas associadas à geocerca, como "Central", ajudam a categorizar e organizar geocercas para fácil identificação e gerenciamento.
* **Localização**: A localização geográfica da geocerca, como "Queens County, New York, United States of America."
* **Objetos**: Uma lista de objetos dentro da geocerca.

## Importando geocercas

Quando você precisa adicionar um grande número de geocercas, é mais rápido importá-las de um arquivo do que criá-las manualmente. Você pode importar geocercas de arquivos Excel ou KML.

### Como importar geocercas circulares do Excel

1. Abra o **Geocercas** ferramenta.
2. Enviar ![Up arrow](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ee0cc4f0478065a931c6ec18d7b62bb51710e3c7%2Fimage-20250425-105021.png?alt=media) (**Importação de geocercas circulares)** botão.
3. Baixe o modelo Excel fornecido e preencha-o ou crie um arquivo com os campos listados na janela de diálogo (obrigatórios e opcionais). Os nomes das colunas no modelo mudam conforme as configurações de idioma no seu [perfil](/docs/user/pt-br/guide/account/profile.md).
4. Salve seu arquivo.
5. Salvar **Procurar,** vá até o seu arquivo e faça o upload dele.
6. Salvar **Continuar,** visualize sua lista e altere os nomes das colunas, se necessário.
7. Salvar **Continuar** para prosseguir. A plataforma Navixy validará sua tabela e exibirá quaisquer erros. Você também pode visualizar os erros em formato CSV clicando em **Baixar linhas com erro.**
8. Se seu arquivo estiver correto, você verá uma mensagem de sucesso. Clique em **Concluir importação**, e suas geocercas aparecerão na lista.

### Como importar geocercas poligonais do KML

1. Abra o **Geocercas** ferramenta.
2. Passe o cursor sobre o ![image-20250425-105021.png](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-ee0cc4f0478065a931c6ec18d7b62bb51710e3c7%2Fimage-20250425-105021.png?alt=media) botão e clique no <img src="https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2FU2DXSzGtfoO7DtXCeblT%2F%7BE5CAE5A6-4E23-4E40-BD54-AFFD76032B23%7D.png?alt=media&amp;token=9d72fcec-ebfb-4e5e-840b-2366a041da30" alt="" data-size="line"> (**Importação de geocercas de KML**) botão.
3. Salvar **Procurar** para selecionar o arquivo KML no seu computador.
4. Altere o raio padrão, se necessário.
5. Salvar **Enviar**.
6. Após a conclusão da importação, as novas geocercas aparecem na lista. Observe que o raio padrão é usado apenas para geocercas de rota. Para outros tipos, esta etapa pode ser ignorada.

## Exportando geocercas

Para exportar suas geocercas para um arquivo KML para uso posterior, siga estas etapas:

1. Abra o **Geocercas** ferramenta.
2. Salvar ![Down arrow icon](https://1308974401-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F446mKak1zDrGv70ahuYZ%2Fuploads%2Fgit-blob-edc15742e3dedf957a67f1aab4e8e88936462733%2Fimage-20250425-132255.png?alt=media) no painel da ferramenta.
3. Baixe o arquivo KML para uso posterior.

{% hint style="danger" %}
Cada geocerca tem um limite de 500 pontos.
{% endhint %}


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://navixy.com/docs/user/pt-br/guide/tracking/map-tools/geofences.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
