> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.datalbus.com.br/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.datalbus.com.br/_mcp/server. # Carga do veículo GET https://datalbus.com.br:8000/api/v2/reports/vehicle-load 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`. Reference: https://docs.datalbus.com.br/datalbus-api-v-2/relatorios/carga-do-veiculo/carga-do-veículo ## Authentication - `Authorization` header (bearer token, required) — Bearer authentication of the form `Bearer `, where token is your auth token. ## Request ### Query parameters - `date` (string, optional) — Obrigatório. Dia consultado, formato `YYYY-MM-DD`. - `per_page` (integer, optional) — Itens por página (1 a 1000, padrão 10). - `page` (integer, optional) — Número da página (padrão 1). ## Response ### 200 OK - `to` (integer, required) - `data` (list of CargaDoVeiculoCargaDoVeiculoResponseDataItem, required) - `from` (integer, required) - `path` (string, required) - `links` (list of CargaDoVeiculoCargaDoVeiculoResponseLinksItem, required) - `total` (integer, required) - `per_page` (integer, required) - `last_page` (integer, required) - `current_page` (integer, required) - `last_page_url` (string, required) - `first_page_url` (string, required) - `next_page_url` (any, optional, nullable) - `prev_page_url` (any, optional, nullable) ## Errors ### 401 Carga Do Veiculo Carga Do Veiculo Request Unauthorized Error Unauthorized - `message` (string, required) ### 422 Carga Do Veiculo Carga Do Veiculo Request Unprocessable Entity Error Unprocessable Content - `errors` (UnprocessableEntityErrorBodyErrors, required) - `message` (string, required) ## Types ### CargaDoVeiculoCargaDoVeiculoResponseDataItem - `time` (string, required) - `trip_id` (integer, required) - `asset_id` (integer, required) - `coordinates` (string, required) - `geofence_name` (string, required) - `bus_load_features_api` (CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApi, required) ### CargaDoVeiculoCargaDoVeiculoResponseLinksItem - `label` (string, required) - `active` (boolean, required) - `url` (any, optional, nullable) ### UnprocessableEntityErrorBodyErrors - `date` (list of string, required) - `groupBy` (list of string, required) ### CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApi - `samples_sequence` (CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence, required) - `Total_Samples_Load_Vehicle_Max` (integer, required) - `Trip_Idle_Time_Load_Vehicle_Max` (double, required) - `Trip_Distance_Total_Load_Vehicle_Max` (double, required) ### CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence - `1` (CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1, required) ### CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1 - `metrics` (CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1Metrics, required) - `window_summary` (CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1WindowSummary, required) - `vehicle_context` (CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1VehicleContext, required) ### CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1Metrics - `mad_kg` (integer, required) - `std_dev_kg` (double, required) - `slope_kg_per_sec` (integer, required) - `step_events_count` (integer, required) - `w_final_median_kg` (integer, required) - `w_initial_median_kg` (integer, required) - `noise_spikes_detected` (integer, required) - `coefficient_of_variation_pct` (double, required) ### CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1WindowSummary - `trend` (string, required) - `quality_flag` (string, required) - `confidence_r2` (double, required) - `delta_weight_kg` (integer, required) - `sampling_quality_score` (double, required) - `estimated_passenger_change` (integer, required) ### CargaDoVeiculoCargaDoVeiculoResponseDataItemBusLoadFeaturesApiSamplesSequence1VehicleContext - `door_open_ratio` (integer, required) - `road_incline_deg` (integer, required) - `door_sensor_health` (string, required) - `road_incline_class` (string, required) - `door_open_duration_sec` (integer, required) ## Examples **Response** ```json { "to": 1, "data": [ { "time": "2026-10-01 10:00:00", "trip_id": 24539, "asset_id": 1234567, "coordinates": "0101000020E6100000A69BC420B0A248C0F5B9DA8AFD6D39C0", "geofence_name": "Terminal Central", "bus_load_features_api": { "samples_sequence": { "1": { "metrics": { "mad_kg": 150, "std_dev_kg": 172.6, "slope_kg_per_sec": 20, "step_events_count": 0, "w_final_median_kg": 10540, "w_initial_median_kg": 10040, "noise_spikes_detected": 0, "coefficient_of_variation_pct": 1.67 }, "window_summary": { "trend": "EMBARQUE", "quality_flag": "HIGH", "confidence_r2": 0.94, "delta_weight_kg": 500, "sampling_quality_score": 0.87, "estimated_passenger_change": 7 }, "vehicle_context": { "door_open_ratio": 1, "road_incline_deg": 0, "door_sensor_health": "OPTIMAL", "road_incline_class": "PLANO", "door_open_duration_sec": 30 } } }, "Total_Samples_Load_Vehicle_Max": 1, "Trip_Idle_Time_Load_Vehicle_Max": 4.5, "Trip_Distance_Total_Load_Vehicle_Max": 12.845 } } ], "from": 1, "path": "https://datalbus.com.br:8000/api/v2/reports/vehicle-load", "links": [ { "label": "« Previous", "active": false }, { "label": "1", "active": true, "url": "https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01&per_page=10&page=1" }, { "label": "Next »", "active": false } ], "total": 1, "per_page": 10, "last_page": 1, "current_page": 1, "last_page_url": "https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01&per_page=10&page=1", "first_page_url": "https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01&per_page=10&page=1" } ``` **SDK Code** ```python 200 - Sessões de carga import requests url = "https://datalbus.com.br:8000/api/v2/reports/vehicle-load" querystring = {"date":"2026-10-01"} headers = {"Authorization": "Bearer "} response = requests.get(url, headers=headers, params=querystring) print(response.json()) ``` ```javascript 200 - Sessões de carga const url = 'https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01'; const options = {method: 'GET', headers: {Authorization: 'Bearer '}}; try { const response = await fetch(url, options); const data = await response.json(); console.log(data); } catch (error) { console.error(error); } ``` ```go 200 - Sessões de carga package main import ( "fmt" "net/http" "io" ) func main() { url := "https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01" req, _ := http.NewRequest("GET", url, nil) req.Header.Add("Authorization", "Bearer ") res, _ := http.DefaultClient.Do(req) defer res.Body.Close() body, _ := io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` ```ruby 200 - Sessões de carga require 'uri' require 'net/http' url = URI("https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01") http = Net::HTTP.new(url.host, url.port) http.use_ssl = true request = Net::HTTP::Get.new(url) request["Authorization"] = 'Bearer ' response = http.request(request) puts response.read_body ``` ```java 200 - Sessões de carga import com.mashape.unirest.http.HttpResponse; import com.mashape.unirest.http.Unirest; HttpResponse response = Unirest.get("https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01") .header("Authorization", "Bearer ") .asString(); ``` ```php 200 - Sessões de carga request('GET', 'https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01', [ 'headers' => [ 'Authorization' => 'Bearer ', ], ]); echo $response->getBody(); ``` ```csharp 200 - Sessões de carga using RestSharp; var client = new RestClient("https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01"); var request = new RestRequest(Method.GET); request.AddHeader("Authorization", "Bearer "); IRestResponse response = client.Execute(request); ``` ```swift 200 - Sessões de carga import Foundation let headers = ["Authorization": "Bearer "] let request = NSMutableURLRequest(url: NSURL(string: "https://datalbus.com.br:8000/api/v2/reports/vehicle-load?date=2026-10-01")! as URL, cachePolicy: .useProtocolCachePolicy, timeoutInterval: 10.0) request.httpMethod = "GET" request.allHTTPHeaderFields = headers let session = URLSession.shared let dataTask = session.dataTask(with: request as URLRequest, completionHandler: { (data, response, error) -> Void in if (error != nil) { print(error as Any) } else { let httpResponse = response as? HTTPURLResponse print(httpResponse) } }) dataTask.resume() ```