# Geocercas

Geocercas são perímetros virtuais que permitem ao sistema monitorar se um objeto cruzou a borda da geocerca ("entrada" ou "saída"). Esses eventos são registrados, permitindo que os usuários gerem relatórios de geocerca 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 específicos [Regras e alertas](/docs/user/pt-br/guide/events-and-notifications.md) em áreas determinadas, como receber alertas de excesso de velocidade apenas dentro de uma cidade ou ao longo de uma rota.

Para acessar o **Geocercas** ferramenta, clique em <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 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 um 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 encaixem em um limite circular simples.
* Uma **geocerca de rota** cria um perímetro virtual entre dois ou mais pontos. Esse tipo de geocerca é bem adequado para monitorar [a aderência à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 de seu 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 **Busca rápida**.
{% endstep %}

{% step %}
**Abra a ferramenta 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 botão <img src="/files/63ab5a1c409272a95c1915dadb627a230d97fd39" alt="New geofence" data-size="line"> 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á-lo manualmente no menu **Raio** . 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. O sistema construirá a rota.
  2. Adicione mais pontos de rota clicando e arrastando as alças de ajuste ao longo da rota.
  3. Defina o raio. O raio determina até que ponto 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 campo **Rótulo da geocerca** .
{% endstep %}

{% step %}
**Selecione a 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 cor permite definir uma cor específica e visualizar seu código HEX.
{% endstep %}

{% step %}
**Use tags**

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

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

### Editando geocercas

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

### Excluindo geocercas

Para excluir uma geocerca, selecione-a e clique em <img src="/files/921e1b9f0e4e25fc0f88837d55ff02b13d643521" alt="image-20250425-104605.png" data-size="line"> no canto superior direito, ao lado de **Busca rápida**.

{% hint style="danger" %}
Somente geocercas que não estejam 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 guia **Configurações** e clique em ⨂ ao lado do nome da geocerca.
{% endhint %}

## Detalhes da geocerca

Para ver detalhes sobre a geocerca selecionada, clique em <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 fácil identificação e gerenciamento.
* **Localização**: A localização geográfica da geocerca, como “Queens County, New York, Estados Unidos da América.”
* **Objetos**: Uma lista de objetos dentro da geocerca.

## Importando geocercas

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

### Importando geocercas circulares do Excel

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

### Importando geocercas poligonais do KML

1. Abra o **Geocercas** .
2. Passe o cursor sobre o botão ![image-20250425-105021.png](/files/a5ec7995c8422629eace38cdff82ceec4f17d51e) botão e clique em **Importação de geocercas do KML** .
3. Clique em **Procurar** para selecionar o arquivo KML no seu computador.
4. Altere o raio padrão, se necessário.
5. Clique em **Enviar**.
6. Quando a importação for concluída, 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 **Geocercas** .
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: 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.
