> 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

Geocercas são perímetros virtuais que permitem ao sistema monitorar se um objeto cruzou a borda da geocerca ("in" ou "out"). Esses eventos são registrados, permitindo que os usuários gerem relatórios de geocercas e [recebam alertas](/docs/user/pt-br/guide/events-and-notifications/movement-monitoring/geofence-entrance-or-exit.md). As geocercas também podem estar relacionadas a eventos específicos [Regras e alertas](/docs/user/pt-br/guide/events-and-notifications.md) dentro de áreas específicas, como receber alertas de excesso de velocidade apenas dentro de uma cidade ou ao longo de uma rota.

Para acessar a **Geofences** ferramenta, clique <img src="/files/55425f83ba1eb200e905910c861376e1520114cb" alt="image-20250425-083834.png" data-size="line"> no canto superior direito do mapa. Ao selecionar qualquer uma das geocercas, serão exibidos os objetos atualmente localizados dentro de seus limites.

![Ferramenta de geocercas](/files/a254e1971b3a73661018da540ffaa364f81cba77)

## Tipos de geocercas

Três tipos de geocercas estão disponíveis:

* Uma **geocerca circular** é uma área geográfica com um centro definido e formato circular, com raio mínimo de 50 metros. Os usuários podem definir o raio e o centro do círculo.
* Uma **geocerca poligonal** é uma área definida por um polígono arbitrário com vários vértices (até 500), permitindo a criação de formas complexas. Esse tipo de geocerca é particularmente útil para definir com precisão áreas de formato irregular, como bairros, parques ou quaisquer zonas específicas que não se encaixam em um limite circular simples.
* Uma **geocerca de rota** cria um perímetro virtual entre dois ou mais pontos. Esse tipo de geocerca é muito adequado para monitorar [a adesão às 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 é definida por uma série de pontos que criam uma rota contínua, com um raio especificado que determina o desvio permitido em relação ao trajeto.

![Exemplo: uma geocerca de rota é frequentemente usada em regras de desvio de rota](/files/f8536bdc6c9a4f41e5bd5ab594dcf26ace4ff104)

## Criando, editando e excluindo geocercas

### Criando geocercas

Para criar uma geocerca, siga estas etapas:

{% stepper %}
{% step %}
**Localize a área desejada no mapa**

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

{% step %}
**Abra a ferramenta de geocercas**

Clique em <img src="/files/55425f83ba1eb200e905910c861376e1520114cb" alt="image-20250425-083834.png" data-size="line"> no canto superior direito do mapa.
{% endstep %}

{% step %}
**Selecione o tipo de geocerca**

Passe o cursor sobre o <img src="/files/63ab5a1c409272a95c1915dadb627a230d97fd39" alt="New geofence" data-size="line"> botão e selecione a geocerca que deseja criar:

* **Círculo**:
  1. Arraste o círculo sobre o mapa para definir sua localização.
  2. Use a alça de redimensionamento em sua borda para ajustar seu tamanho. Você também pode ajustá-la 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 os vértices ou adicionando novos.
* **Rota**:
  1. Selecione os pontos de início e fim. O sistema criará 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 o quanto 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**

Insira o nome da geocerca no **Rótulo da geocerca** campo.
{% endstep %}

{% step %}
**Selecione a cor**

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

{% step %}
**Usar tags**

Adicione ou modifique tags para categorizar e organizar geocercas. Tags como "Central" e "West" ajudam na classificação e no gerenciamento de várias geocercas.
{% endstep %}

{% step %}
Salve a geocerca
{% endstep %}
{% endstepper %}

### Editando geocercas

Para editar uma geocerca, clique <img src="/files/514c70bbd5b8d896f3c3e441d2194b87b74d3c44" alt="Untitled-20250425-103233.png" data-size="line"> ao lado da geocerca que deseja editar na **Geofences** ferramenta. Ao editar uma geocerca, você pode ajustar os mesmos campos usados durante a criação.\
Para a descrição desses campos, consulte [Criando geocercas](#creating-geofence).

### Excluindo geocercas

Para excluir uma geocerca, selecione-a e clique <img src="/files/921e1b9f0e4e25fc0f88837d55ff02b13d643521" alt="image-20250425-104605.png" data-size="line"> no canto superior direito, ao lado de **Pesquisa 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 <img src="/files/f8772f4a2a2b7b5386acced879ccc4157589eef0" alt="Untitled-20250416-090916.png" data-size="line"> ao lado dela.

* **Tags**: Tags associadas à geocerca, como “Central”, ajudam a categorizar e organizar geocercas para facilitar a identificação e o 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 precisar 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 do Excel ou KML.

### Importando geocercas circulares do Excel

1. Abra o **Geofences** ferramenta.
2. Passe o cursor sobre o ![image-20250425-105021.png](/files/a5ec7995c8422629eace38cdff82ceec4f17d51e) botão e clique em **Importação de geocercas circulares** botão.
3. Baixe o arquivo de exemplo fornecido.
4. Adicione ao arquivo as informações sobre suas geocercas conforme detalhado no exemplo.
5. Envie o arquivo editado para o serviço de monitoramento.
6. Se o seu arquivo tiver cabeçalhos, habilite a opção **Usar cabeçalhos do arquivo** opção.
7. Verifique os campos do cabeçalho e clique em **Avançar**.
8. Verifique os registros e clique em **Prosseguir**.
9. Após a conclusão da importação, as novas geocercas aparecerão na lista.

### Importando geocercas poligonais de KML

1. Abra o **Geofences** ferramenta.
2. Passe o cursor sobre o ![image-20250425-105021.png](/files/a5ec7995c8422629eace38cdff82ceec4f17d51e) botão e clique em **Importação de geocercas de KML** botão.
3. Clique em **Procurar** para selecionar o arquivo KML em seu computador.
4. Altere o raio padrão, se necessário.
5. Clique em **Enviar**.
6. Após a conclusão da importação, as novas geocercas aparecerão na lista. Observe que o raio padrão é usado apenas para geocercas de rota. Para outros tipos, esta etapa pode ser ignorada.

## Exportando geocercas

Você pode exportar suas geocercas para um arquivo KML para uso posterior. Para fazer isso:

1. Abra o **Geofences** ferramenta.
2. Clique em ![Download geofences](/files/c7d8bbca48c4c434a14fd03a18d9bddb043542d8) no painel da ferramenta.
3. Baixe o arquivo KML para uso posterior.

{% hint style="danger" %}
Observe que há um limite de 500 pontos por geocerca.
{% 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 dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

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

The question should be specific, self-contained, and written in natural language.
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.
