SegControle

Converte latitude e longitude em endereço (rua, número, bairro, cidade, estado), com a fazenda/talhão ou o ponto de interesse do cliente quando houver. Para a posição atual de um veículo use posicao_veiculo, que já traz o endereço.

endereco_da_posicao

Vezes em que os veículos percorreram uma rota em um período: horário de entrada e saída em cada ponto de checagem, tempo real contra o previsto e se o trecho foi feito no prazo, atrasado ou adiantado.

execucoes_rota

Exporta dados completos em arquivo, sem limite de linhas. Formatos: csv, json, geojson e kml (os dois últimos para viagens e pontos, para programas de mapa) e shp (Shapefile em .zip: tipo shape, ou formato shp em viagens/pontos). Entrega: link (padrão), um link temporário para baixar, que vale 30 minutos; ou resposta (entrega = resposta), o conteúdo do arquivo dentro desta resposta, num bloco à parte, até 100 KB (o .zip em base64), para quem não consegue abrir o link, como um ambiente sem acesso ao site do SegControle. Tipos: eventos e apontamentos (até 92 dias), viagens de um veículo com endereços, todos os pontos do percurso de um veículo e shape (até 31 dias), e a lista completa de veículos (de um cliente ou de todos os clientes). shape gera, como a tela Gerar Arquivo Shape, os pontos em que o veículo foi desligado e, com incluir_trajeto, o trajeto inteiro como linha; só para os clientes que têm essa tela. Use quando os dados não cabem numa resposta ou para processar em planilha, script ou programa de mapa.

exportar_dados

Grupos de veículos do cliente, com a quantidade de veículos ativos e inativos e os e-mails que recebem os alertas de cada tipo (velocidade, posição, ignição, sensores, emergência, pânico, manutenção).

listar_grupos

Como fazer as coisas nas telas do SegControle: configurar alertas (velocidade, ignição, motor ocioso, e-mail), cadastrar veículos, grupos, motoristas, usuários, cercas, pontos de interesse e rotas, gerar relatórios, reconhecer alarmes, compartilhar a localização, lembretes de manutenção. Use sempre que o usuário perguntar como ou onde fazer algo no sistema, e responda com os passos devolvidos, sem inventar telas ou campos. Sem assunto, devolve o índice do guia.

guia_do_sistema

Por onde um veículo andou em um período: lista de viagens (de ligar a desligar) com horário, origem e destino com endereço, distância, duração, velocidade máxima, motorista e paradas com o motor ligado, mais os totais do período. Quando o cliente usa atividades, cada viagem traz a atividade (e, no caso raro de a atividade mudar no meio da viagem, a lista dos trechos em atividades). Período máximo: 7 dias, ou 31 com compacto = true (uma linha curta por viagem, sem links nem detalhes das paradas). Viagens paginadas (total real, proxima_pagina); o resumo sempre considera o período inteiro. Para todos os pontos do percurso ou um período longo em arquivo, use exportar_dados.

historico_trajeto

Lembretes cadastrados no Odômetro Digital (troca de óleo, revisão): quilometragem do aviso, odômetro atual e quantos km faltam, do mais próximo ao mais distante.

lembretes_manutencao

Lista os clientes (frotas) que este usuário pode consultar, com o código usado no parâmetro "cliente" das outras ferramentas, a situação do cadastro (ativo/inativo), o plano e quantos veículos ativos e inativos e grupos cada um tem. Paginada: "total" é o total real; percorra as páginas até proxima_pagina vir null. O cadastro não guarda a data de entrada do cliente.

listar_clientes

Lista os veículos da frota com placa, descrição, tipo, grupo, motorista atual, se está ligado, última posição e última velocidade. Por padrão só os ativos; incluir_inativos traz também os desativados (campo ativo). Com com_endereco, traz também o endereço de cada um. Paginada (total real, proxima_pagina). O sistema não guarda histórico de troca de placas.

listar_veiculos

Lista os motoristas cadastrados: nome, CPF, telefones, registro, CNH com vencimento e situação, se está ativo e o veículo que dirige agora. Para saber só quem está com a CNH vencida ou a vencer, use motoristas_cnh.

listar_motoristas

Lista os pontos de interesse (POI) cadastrados pelo cliente, com grupo, nome, coordenada e raio. Use para achar a coordenada de um local conhecido da frota (garagem, cliente, obra).

listar_pontos_interesse

Retorna a última posição conhecida de um veículo (endereço, latitude, longitude, data/hora, velocidade, motorista), um link do Google Maps e link_navegador, que abre o mapa do SegControle acompanhando o veículo ao vivo. Quando há um status mais recente que a posição (ex.: Server Check), vem também ultimo_status, com o próprio link para vê-lo como ponto fixo no mapa.

posicao_veiculo

Quilômetros rodados por veículo em um período, pela diferença do odômetro registrado nos eventos (cada vez que o veículo liga ou desliga), mais o odômetro e o horímetro atuais. É uma estimativa rápida para a frota toda; para um veículo com precisão de trajeto use historico_trajeto. Período máximo: 92 dias.

quilometragem_frota

Apontamentos do período, como o Relatório de Apontamentos do sistema: motorista, apontamento, tipo (Produtivo/Improdutivo), início, fim, duração, veículo, km e local (endereço) do início e do fim, mais os totais por tipo, por apontamento e por motorista. Os apontamentos são pareados por motorista e nome, em ordem de tempo; o que não tem início ou fim no período vem com o campo vazio e não soma duração. Período máximo: 31 dias. Paginada (total real, proxima_pagina); os totais consideram todos. Para o arquivo completo, exportar_dados com tipo apontamentos.

relatorio_apontamentos

Uso da frota por atividade, como o Relatório de Atividades do sistema: por linha, atividade, tipo (Produtivo/Improdutivo), veículo e grupo, com tempo total na atividade, tempo com o motor ligado, tempo em movimento, km e o percentual do tempo ligado e dos km no resultado; subtotais do agrupamento e totais do período, inclusive produtivo × improdutivo. agrupar_por: veiculo (veículo × atividade), atividade (atividade × veículo) ou grupo (grupo × atividade). Tempo ligado e km seguem a regra da tela (só conta com o motor ligado); o tempo total é o tempo corrido na atividade, ligado ou desligado; a regra completa vem em regra_de_contagem. Lê o rastreio veículo a veículo: para frotas grandes filtre por grupo ou placa; se o tempo acabar, a resposta vem com parcial = true e os veículos que faltaram. Período máximo: 31 dias. Linhas paginadas (total real, proxima_pagina); subtotais e totais consideram todas.

relatorio_atividades

Utilização da frota em um período de até 92 dias, agrupada por veículo, por motorista ou por grupo: número de viagens, quilômetros, horas com o veículo ligado e dias com uso. Use para comparativos mensais, ranking de motoristas e uso por grupo; para o trajeto detalhado de um veículo use historico_trajeto.

relatorio_utilizacao

Totais de eventos em um período: por tipo, por veículo (top 20) e por motorista (top 20), mais o número de alarmes. Use antes de consultar_eventos para ter a visão geral.

resumo_eventos

Lista as rotas cadastradas: nome, pontos de checagem em ordem (coordenada, raio, tempo previsto desde o ponto anterior e tolerância) e os veículos vinculados a cada rota.

listar_rotas

Histórico de trocas de atividade dos veículos no período: data e hora em que a troca passou a valer, veículo, atividade anterior e nova, a origem (tela Troca de Motoristas e Atividades, com quando foi pedida e o usuário, ou teclado do veículo) e, por veículo, em que atividade terminou o período e desde quando. Lista também os pedidos feitos na tela que não chegaram a valer (o veículo ainda não foi ligado, ou outro pedido veio depois). A troca pedida na tela só vale quando o veículo é ligado de novo. Lê o rastreio veículo a veículo (ver relatorio_atividades). Período máximo: 31 dias. Paginada (total real, proxima_pagina).

trocas_atividade

Usuários da empresa no SegControle: login, nome, e-mail, se está ativo, horário de acesso e os direitos de cada um. Senhas não são informadas.

listar_usuarios

Veículos de todos os clientes que este usuário pode consultar, numa listagem só: cliente, placa, padrão da placa (mercosul, antigo ou fora_do_padrao), descrição, grupo, tipo, se está ativo e a última comunicação. Use para achar uma placa sem saber o cliente, consolidar a frota ou listar placas fora do padrão Mercosul. Paginada (total real, proxima_pagina).

veiculos_todos_clientes

Quais veículos estiveram dentro de um raio em torno de um local em um período, com horário de chegada, saída e permanência de cada visita. O local pode ser uma coordenada (latitude e longitude) ou um endereço escrito; a resposta mostra qual endereço foi encontrado. Para um ponto de interesse cadastrado, pegue a coordenada em listar_pontos_interesse. Período máximo: 3 dias.

veiculos_no_local