# Integração com Aplicativo de Rastreamento - Traccar Client

## Introdução

>[!TIP] Definição - Traccar Client:
>O [Traccar Client](https://www.traccar.org/client/) é uma aplicação móvel de código aberto que permite que dispositivos Android ou iOS tenham funcionalidades de rastreadores GPS. Oferece rastreamento em tempo real com baixo consumo de bateria, configuração simplificada e compatibilidade com diversos servidores. A aplicação permite personalizar o intervalo de atualização e enviar coordenadas via dados móveis ou Wi-Fi. Representa uma solução econômica de rastreamento, sem necessidade de hardware. Ele permite que dispositivos móveis enviem sua localização e outros dados para o sistema a partir de uma integração, possibilitando o monitoramento da geolocalização. Esta aplicação, integrada ao sistema, permite a visualização do trajeto dos técnicos ou veículos cadastrados, promovendo um gerenciamento de frota eficaz.

O cadastro de **integrações de plataforma de rastreamento** permite configurar a conexão entre o sistema e serviços externos de rastreamento de veículos. Esta funcionalidade é essencial para empresas que necessitam monitorar sua frota de veículos. A integração possibilita o gerenciamento eficiente da frota, permitindo o monitoramento preciso da localização dos veículos diretamente pelo sistema.

>[!Nota] **Acesso ao Formulário**
>**Caminho**: Sistema > Frota > Vecíulos

## Entrega de Valor
- Monitoramento da localização dos veículos;
- Maior segurança e controle da frota;
- Otimização de rotas e gestão eficiente de recursos;
- Compatível com dispositivos de sistema operacional Android ou iOS.
  
## Estrutura da funcionalidade
O formulário de cadastro de veículos está organizado em uma guia composta por cinco abas principais, cada uma projetada para atender aspectos específicos relacionados às informações do veículo:

- **Veículos:** Aba principal destinada ao cadastro de informações essenciais do veículo, como modelo, código RENAVAM, placa, opção para ativar o rastreamento, entre outras.
- **Monitoramento:** Focada em detalhes adicionais dos veículos cadastrados, incluindo dados operacionais e informações sobre manutenção.
- **Rastreadores:** Relacionada ao formulário [[veiculos - rastreamento|Veículos - Rastreamento]], onde são registradas todas as coordenadas recebidas por meio da integração com rastreadores.
- **Arquivos:** Permite anexar documentos e arquivos relevantes, como o Certificado de Registro e Licenciamento do Veículo (CRLV), Certificado de Registro do Veículo (CRV), Documento Único de Transferência (DUT) e outros.
- **Histórico de Despesas:** Apresenta um detalhamento completo das despesas associadas ao veículo, exibidas de forma clara na aba de histórico.

## Configuração da Aplicação Traccar Client no Sistema

### Passo 1: Conferência e Liberação de Portas
Nesta etapa, é necessário realizar a conferência do estado das portas necessárias para a comunicação do rastreador com o servidor. Para verificar se as portas estão liberadas, insira os comandos abaixo diretamente na barra de pesquisa do navegador:

#### 1. Validação Inicial do Servidor
Inicialmente, será inserido o IP do seu servidor associado à requisição de validação de rastreamento, conforme a estrutura demonstrada abaixo. Copie a estrutura a seguir e substitua `ipdosistema`pelo IP do seu servidor.

> [!EXAMPLE] Estrutura:
> http://ipdosistema/monitoramento_gps/server.php

Após utilizar esta URL, o navegador irá apresentar as portas disponíveis para cada modelo de rastreador:
- Porta 10001  - Android;
- Porta 10002 - **Android Cliente Traccar**;
- Porta 10000 - GPS TK103a, TK103B

#### 2. Conferência da porta no servidor
Após validar a porta utilizada para cada equipamento, verifique se a porta 10000 está liberada em sua rede inserindo o comando a seguir no navegador, substituindo a estrutura `ip do sistema`pelo IP do servidor de seu sistema.

> [!EXAMPLE] Estrutura:
 http://ipdosistema:10002

- Se a porta estiver aberta, o navegador retornará **OK**.
- Caso contrário, será necessário liberar a porta na configuração da rede.

>[!TIP] **Importante:**  
A porta 10002 é utilizada exclusivamente para a aplicação Traccar Client. Certifique-se de configurá-la corretamente.

### Passo 2: Parametrização do Aplicativo
Nesta etapa, será realizada a configuração do aplicativo para estabelecer a conexão entre o sistema e o **Traccar**. Para realizar esta configuração, siga os passos abaixo:

1. Localize o aplicativo nas lojas de app (android e iOS) e instale-o em seu dispositivo móvel;
2. Configure os campos apresentados no app:
	- **URL do servidor:** insira o IP do seu servidor do sistema IXC Soft com o apontamento para a porta 10002, como na estrutura`http://12.34.5.678:10002`.
	- **Intervalo:** defina o intervalo de tempo que os dados de localização serão atualizados. O recomendado é 30 segundos.
	- **Offline buffering:** desative esta opção para otimizar a sincronização entre as plataformas envolvidas.
	  
3. Localize no app o campo **Identificador do dispositivo** e copie a numeração para as configurações no sistema.

### Passo 3: Configuração do Veículo
Após consultar o IMEI do dispositivo, é necessário vinculá-lo a um veículo cadastrado no sistema.

>[!TIP] Guia instrutivo:
>Para realizar o cadastro de um veículo, acesse o material: [[cadastro de veiculos|Cadastro de Veículos]].

1. Acesse o formulário de **Veículos** através do caminho: Sistema > Frota > aba Veículos;
2. Selecione um veículo específico para realizar a associação do rastreador e clique em **Editar**. Caso necessário, realize o [[veiculos|Veículos]];
3. Acesse aba Veículos e localize a seção **Informações adicionais**, e preencha o campo descrito a seguir:
	- **IMEI do rastreador:** insira o código resgatado através dos comandos enviados ao equipamento.
	  
4. Clique no botão **Salvar** para finalizar a integração com o rastreador.

### Passo 4: Conferência da Comunicação
1. Para confirmar a comunicação entre o sistema e o rastreador, acesse a aba [[veiculos - rastreamento|Rastreadores]] para conferir se as coordenadas estão sendo atualizadas no sistema.
2. Acesse a grid de [[veiculos||Veículos]], selecione o veículo configurado com o rastreador e clique no botão **Mostrar Trajeto** > **Imprimir dia atual** para visualizar a localização no mapa.

## Fluxo de rabalho

```mermaid
graph TD
    A[Iniciar aplicativo Traccar] --> B[Configurar servidor e intervalo de atualização no aplicativo Traccar]
    B --> C[Configuração no sistema]
    C --> D[Iniciar Rastreamento]
    D --> E{Enviar localização}
    E --> F[Servidor recebe dados]
    F --> G{Atualizar mapa}
    G --> E
```

## Considerações Finais
O **Traccar Client** é uma ferramenta versátil e eficaz para rastreamento GPS, transformando dispositivos móveis em rastreadores através de uma aplicação de código aberto. A integração do sistema com a aplicação Traccar proporciona um sistema robusto de rastreamento, permitindo o monitoramento com baixa latência com baixo consumo de bateria. A configuração é simplificada, permitindo a possibilidade de personalizar o intervalo de atualizações, tornando esta solução uma opção econômica e eficiente para monitoramento de localização, sem a necessidade de hardware adicional.

## Etiquetas
#Integracoes #IntegracaoRastreadores #Rastreador #Frota #TraccarClient

## Leia Também
 - [[integracoes|Integrações]]
- [[integracoes plataforma de rastreamento|Integrações Plataforma de Rastreamento]]
- [[integracoes de plataformas de rastreamento - cobli|Integrações Plataforma de Rastreamento - Cobli]]
- [[tarefa - atualizar dados rastreador (cobli)|Tarefa - Atualizar Dados Rastreador (Cobli)]]
- [[integracao com aplicativo de rastreamento - traccar client|Integração com aplicativo de rastreamento - Traccar Client]]
- [[veiculos|Veículos]]
- [[veiculos - rastreamento|Veículos - Rastreamento]]
- [[como anexar documentos no cadastro de veiculo|Como Anexar Documentos no Cadastro de Veículo]]
- [[cadastro de veiculos|Cadastro de Veículos]]