Skip to navigation

Score por motorista

View as Markdown

Período: de dtIni 00:00 até o fim de dtFin, no fuso horário da empresa. Período máximo padrão: 31 dias (pode variar conforme a configuração da empresa).

Resposta 200 (paginada), com duas particularidades:

  • data é um objeto cuja chave é o nome do motorista;
  • a chave events, no nível raiz, lista os eventos considerados na pontuação (id, event, enabled).

Campos de cada item de data:

CampoTipoNuloDescrição
geofence_namesstringsimCercas onde os eventos ocorreram, separadas por vírgula
curveintegernãoCurvas (esquerda + direita)
speed_upstring (numérico)nãoExcesso de velocidade: soma de ocorrências × duração (segundos)
accelerationintegernãoArrancadas bruscas
brakingintegernãoFrenagens bruscas
total_scorestring (numérico)nãoPontuação total: soma ponderada dos eventos listados em events
absintegernãoAcionamentos de ABS
sharp_turnintegernãoCurvas bruscas (esquerda + direita)
mkbestring (numérico)nãoQuilômetros médios entre eventos: distance / total_score
distancestring (numérico)nãoDistância percorrida no período (km)
license_platestringsimPlaca (para motorista: uma das placas dos veículos conduzidos)
group_descrstringsimGrupo do motorista (por motorista) ou do veículo (por veículo)
line_namestringsimLinhas operadas, separadas por vírgula (empresas com integração de linhas)
worker_idintegersimMatrícula do motorista
driverstringsimNome do motorista

Somente eventos ocorridos com motorista identificado entram na pontuação.

Erros: 422 para datas ausentes, inválidas ou período acima do máximo.

Authentication

AuthorizationBearer

Bearer authentication of the form Bearer <token>, where token is your auth token.

Query parameters

dtInistringOptional

Obrigatório. Data inicial, formato YYYY-MM-DD.

dtFinstringOptional

Obrigatório. Data final (inclusiva), formato YYYY-MM-DD.

workerId[]integerOptional

Matrículas dos motoristas (repita o parâmetro para vários valores).

Response

OK
tointeger
dataobject
frominteger
pathstringformat: "uri"
totalinteger
eventslist of objects
per_pageinteger
last_pageinteger
current_pageinteger
last_page_urlstringformat: "uri"
first_page_urlstringformat: "uri"
next_page_urlany or nullOptional
prev_page_urlany or nullOptional

Errors

401
Score Por Motorista Score De Motoristas Request Unauthorized Error
422
Score Por Motorista Score De Motoristas Request Unprocessable Entity Error