Eventos

No momento da redação desta documentação, havia 9 categorias de eventos suportados pelo Traccar:

• Alarme
• Resultado do comando
• Geofence
• Ignição
• Manutenção
• Movimento
• Excesso de velocidade
• Status
• Mensagem de texto

Configuração

A configuração geral deve ser feita no arquivo de configuração  traccar.xml . Por padrão, todos os manipuladores de eventos estão habilitados.

A categoria de mensagem de texto é ativada somente se o suporte a SMS for ativado.

Alarme

Este tipo de evento gerado quando a nova posição contém o atributo de alarme . Há muitos tipos de alarme suportados pelo traccar, você pode encontrar a lista atual  aqui . Nem todos os protocolos suportam alarmes e alguns protocolos suportam apenas um subconjunto de todos os tipos.

Resultado do comando

O Traccar suporta respostas sobre comandos para alguns protocolos. Tais respostas são armazenadas no atributo de resultado . O servidor gera esse tipo de evento se a posição contiver o atributo de resultado .

Geofence

O Traccar pode gerar eventos quando o dispositivo entra ou sai de uma geofence .

Ignição

Alguns dispositivos podem denunciar o estado da ignição. Traccar gera o evento ON de ignição se a posição anterior contiver a  ignição falso  e a posição atual do atributo contêm a ignição do atributo  true . Traccar gera o evento Ignition OFF se a posição anterior contiver a ignição do atributo a posição  verdadeira  e atual conter a ignição do atributo  falso .

Existem alguns protocolos que não relatam o status da ignição em todas as posições. Neste caso, você pode usar o   parâmetro de configuração processing.copyAttributes para manter o atributo de ignição da posição anterior.

Manutenção

O Traccar pode ajudar a controlar os intervalos de manutenção dos dispositivos. Existem dois atributos para configurar:  maintenance.start e  maintenance.interval . Eles podem ser configurados em atributos de dispositivo, grupo ou servidor. Traccar gera evento sempre que o  atributo totalDistancepassa por  maintenance.start + maintenance.interval * N  valor onde N  é um número natural.

Exemplo:

maintenance.start = 6000000, maintenance.interval = 8000000

Os eventos serão gerados quando a totalDance for superior a 6000 km, 14000 km, 22000 km e assim por diante.

Movimento

O Traccar pode gerar esse evento se o dispositivo for iniciado ou parou de se mover. O servidor analisa a velocidade da posição de entrada e se a velocidade é superior ao  parâmetro de configuração event.motion.speedThreshold (o padrão é 0,01 nós), então considerou que o dispositivo está em movimento e, se a velocidade for menor, esse dispositivo parou.

Excesso de velocidade

O Traccar pode gerar esse evento se o dispositivo exceder o limite de velocidade configurado. O valor limite de velocidade pode ser configurado no dispositivo, grupo ou atributo do servidor speedLimit .

O parâmetro de configuração event.overspeed.notRepeat adicional  especifica o comportamento de repetição. Se for verdade , o evento será gerado uma vez no início do período de excesso de velocidade, se for falso , os eventos serão gerados em cada posição recebida.

Status

O servidor pode gerar esse tipo de evento quando o status do dispositivo mudar (on-line / offline / desconhecido). Online significa que o dispositivo está conectado ao servidor e enviando relatórios. Offline significa que o dispositivo não está conectado ao servidor. Desconhecido significa que o status da conexão é desconhecido e não houve relatórios do dispositivo por período de tempo especificado (10 minutos por padrão).

Mensagem de texto

Este evento é gerado quando a mensagem SMS recebida do dispositivo.