Carga do veículo | Datalbus

Sessões de variação de carga (peso) do veículo em um dia, com a estimativa de embarque e desembarque de passageiros. Requer veículos com sensor de carga.

O dia é considerado no fuso horário da empresa.

Resposta 200 (paginada, ordenada por time). Cada item de data:

Campo	Tipo	Nulo	Descrição
`time`	string `YYYY-MM-DD HH:MM:SS`	sim	Início da sessão (UTC)
`asset_id`	integer	sim	Identificador do veículo na telemetria
`trip_id`	integer	sim	Id da viagem no equipamento (`drive_id` em `GET /trips`)
`coordinates`	string	sim	Posição no início da sessão, em formato PostGIS (EWKB hexadecimal)
`geofence_name`	string	não	Cerca onde a sessão ocorreu (`""` se nenhuma)
`bus_load_features_api`	object	não	Indicadores da sessão (abaixo)

bus_load_features_api:

Campo	Tipo	Descrição
`Trip_Distance_Total_Load_Vehicle_Max`	number	Distância da viagem (km)
`Trip_Idle_Time_Load_Vehicle_Max`	number	Tempo parado (minutos)
`Total_Samples_Load_Vehicle_Max`	integer	Quantidade de janelas de amostragem na sessão
`samples_sequence`	object	Análise de cada janela de amostragem, com chave = número da janela (`"1"`, `"2"`, …)

Cada janela em samples_sequence:

Campo	Tipo	Descrição
`window_summary.trend`	string	`EMBARQUE`, `DESEMBARQUE` ou `ESTAVEL`
`window_summary.delta_weight_kg`	number	Variação de peso na janela (kg)
`window_summary.estimated_passenger_change`	integer	Variação estimada de passageiros (75 kg por passageiro)
`window_summary.confidence_r2`	number (0 a 1)	Confiança da tendência
`window_summary.quality_flag`	string	Qualidade da amostragem: `HIGH`, `MEDIUM` ou `LOW`
`window_summary.sampling_quality_score`	number (0 a 1)	Nota de qualidade da amostragem
`metrics.w_initial_median_kg` / `metrics.w_final_median_kg`	number	Peso inicial e final (mediana, kg)
`metrics.slope_kg_per_sec`	number	Inclinação da tendência de peso
`metrics.std_dev_kg`	number	Desvio padrão (kg)
`metrics.mad_kg`	number	Desvio absoluto mediano (kg)
`metrics.coefficient_of_variation_pct`	number	Coeficiente de variação (%)
`metrics.noise_spikes_detected`	integer	Amostras descartadas como ruído
`metrics.step_events_count`	integer	Saltos de peso acima de 100 kg entre amostras
`vehicle_context.road_incline_deg`	number	Inclinação da via (graus)
`vehicle_context.road_incline_class`	string	`SUBIDA_FORTE`, `SUBIDA_LEVE`, `PLANO`, `DESCIDA_LEVE` ou `DESCIDA_FORTE`
`vehicle_context.door_open_duration_sec`	number	Tempo de porta aberta (segundos)
`vehicle_context.door_open_ratio`	number (0 a 1)	Proporção da janela com porta aberta
`vehicle_context.door_sensor_health`	string	`OPTIMAL` ou `WARNING_OR_CLOSED`

Erros: 422 para parâmetros inválidos (ex.: trip_id sem asset_id). Paginação: resposta no envelope paginado padrão (veja a Introdução). Navegue incrementando page até current_page = last_page.

Authentication

AuthorizationBearer

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

Query parameters

datestringOptional

Obrigatório. Dia consultado, formato YYYY-MM-DD.

per_pageintegerOptional

Itens por página (1 a 1000, padrão 10).

pageintegerOptional

Número da página (padrão 1).

Response

tointeger

datalist of objects

frominteger

pathstringformat: "uri"

linkslist of objects

totalinteger

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

Carga Do Veiculo Carga Do Veiculo Request Unauthorized Error

422

Carga Do Veiculo Carga Do Veiculo Request Unprocessable Entity Error