# Cercas geográficas

Geocercas são perímetros virtuais que permitem ao sistema monitorar se um objeto cruzou a fronteira da geocerca ("entrada" ou "saída"). Esses eventos são registrados, possibilitando aos usuários gerar relatórios de geocercas e [receber alertas](https://www.navixy.com/docs/user/pt-br/guide/events-and-notifications/movement-monitoring/geofence-entrance-or-exit). Geocercas também podem estar relacionadas a [regras para eventos](https://www.navixy.com/docs/user/pt-br/guide/tracking/map-tools/broken-reference) 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 **Geocercas** ferramenta, clique <img src="https://2540041085-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. Selecionar qualquer uma das geocercas exibirá os objetos atualmente localizados dentro de seus limites.

![Ferramenta de geocercas](https://2540041085-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

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

* Uma **geocerca circular** é uma área geográfica com um determinado centro 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 múltiplos 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 enquadrem em um limite circular simples.
* Uma **geocerca de rota** cria um perímetro virtual entre dois ou mais pontos. Esse tipo de geocerca é adequado para monitorar [aderência às rotas planejadas](https://www.navixy.com/docs/user/pt-br/guide/events-and-notifications/scheduling-and-dispatching/deviation-from-the-route) 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 a margem de desvio permitida em relação ao caminho.

![Exemplo: Uma geocerca de rota é frequentemente usada em regras de desvio de rota](https://2540041085-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

### Criando geocercas

Para criar uma geocerca, siga estes passos:

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

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

{% step %}
**Abra a ferramenta Geocercas**

Clique em <img src="https://2540041085-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 tipo de geocerca**

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

* **Círculo**:
  1. Arraste o círculo pelo 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 **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. 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 o quanto o objeto pode se desviar do caminho 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 %}
**Selecionar cor**

Escolha a cor para melhor visualização no mapa. Isso é especialmente útil ao gerenciar múltiplas 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 tags**

Adicione ou modifique tags para categorizar e organizar as geocercas. Tags como "Central" e "Oeste" ajudam na ordenação e gerenciamento de múltiplas geocercas.
{% endstep %}

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

### Editando geocercas

Para editar uma geocerca, clique <img src="https://2540041085-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 deseja editar na **Geocercas** ferramenta. Ao editar uma geocerca, você pode ajustar os mesmos campos que 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 <img src="https://2540041085-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="image-20250425-104605.png" data-size="line"> no canto superior direito ao lado de **Pesquisa rápida**.

{% hint style="danger" %}
Apenas geocercas que não estejam incluídas em quaisquer **Alerta** regras 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 ⨂ ao lado do nome da geocerca.
{% endhint %}

## Detalhes da geocerca

Para ver detalhes sobre a geocerca selecionada, clique <img src="https://2540041085-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="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, United States of America.”
* **Objetos**: Uma lista de objetos dentro da geocerca.

## Importando geocercas

Quando for necessário 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.

### Importando geocercas circulares do Excel

1. Abra o **Geocercas** .
2. Passe o cursor sobre o ![image-20250425-105021.png](https://2540041085-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 **Importação de geocercas circulares** botão.
3. Faça o download do arquivo de exemplo fornecido.
4. Adicione as informações sobre suas geocercas ao arquivo conforme detalhado no exemplo.
5. Envie o arquivo editado para o serviço de monitoramento.
6. Se seu arquivo tiver cabeçalhos, ative a opção **Usar cabeçalhos do arquivo** .
7. Verifique os campos do cabeçalho e clique **Próximo**.
8. Confira os registros e clique **Prosseguir**.
9. Uma vez concluída a importação, as novas geocercas aparecerão na lista.

### Importando geocercas poligonais de KML

1. Abra o **Geocercas** .
2. Passe o cursor sobre o ![image-20250425-105021.png](https://2540041085-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 **Importação de geocercas a partir 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. Uma vez concluída a importação, as novas geocercas aparecerão na lista. Observe que o raio padrão é usado apenas para geocercas de rota. Para outros tipos, essa etapa pode ser ignorada.

## Exportando geocercas

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

1. Abra o **Geocercas** .
2. Clique em ![Download geofences](https://2540041085-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 de ferramentas.
3. Faça o download do arquivo KML para uso posterior.

{% hint style="danger" %}
Observe que há um limite de 500 pontos por geocerca.
{% endhint %}
