Posições da viagem | Datalbus

{
  "to": 1,
  "data": [
    {
      "id": 4400112233,
      "time": "2026-10-25 09:02:15",
      "speed": 23,
      "mileage": 412307.3,
      "trip_id": 98765432,
      "asset_id": 1234567,
      "latitude": -25.4284,
      "direction": 180,
      "longitude": -49.2733,
      "created_at": "2026-10-25T09:02:20Z",
      "updated_at": "2026-10-25T09:02:20Z",
      "coordinates": "0101000020E6100000A69BC420B0A248C0F5B9DA8AFD6D39C0",
      "vehicle_status": 1
    }
  ],
  "from": 1,
  "path": "https://datalbus.com.br:8000/api/v2/trips/98765432/locations",
  "links": [
    {
      "label": "« Previous",
      "active": false
    },
    {
      "label": "1",
      "active": true,
      "url": "https://datalbus.com.br:8000/api/v2/trips/98765432/locations?date=2026-10-25&page=1"
    },
    {
      "label": "Next »",
      "active": false
    }
  ],
  "total": 1,
  "per_page": 1000,
  "last_page": 1,
  "current_page": 1,
  "last_page_url": "https://datalbus.com.br:8000/api/v2/trips/98765432/locations?date=2026-10-25&page=1",
  "first_page_url": "https://datalbus.com.br:8000/api/v2/trips/98765432/locations?date=2026-10-25&page=1"
}

Lista as posições GPS registradas durante uma viagem.

Resposta 200 (paginada). Cada item de data:

Campo	Tipo	Nulo	Descrição
`id`	integer	não	Id da posição
`trip_id`	integer	não	`id` da viagem
`asset_id`	integer	sim	Identificador do veículo na telemetria
`time`	string `YYYY-MM-DD HH:MM:SS`	sim	Horário da posição (UTC)
`latitude`	number	sim	Latitude (WGS-84)
`longitude`	number	sim	Longitude (WGS-84)
`direction`	integer	sim	Direção (graus)
`speed`	number	sim	Velocidade (km/h)
`mileage`	number	sim	Distância informada pelo equipamento na posição
`vehicle_status`	integer	sim	Código de status do veículo informado pelo equipamento
`coordinates`	string	sim	Posição em formato PostGIS (EWKB hexadecimal)
`created_at` / `updated_at`	string (ISO-8601 UTC)	sim	Datas do registro

Erros: 400 para parâmetros inválidos. 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.

Path parameters

idstringRequired

Obrigatório. id da viagem retornado por GET /trips.

Query parameters

datestringOptional

Obrigatório. Dia de início da viagem, em UTC, no formato YYYY-MM-DD (a data do campo date em GET /trips).

per_pageintegerOptional

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

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

400

Posicoes Da Viagem Viagens Request Bad Request Error

401

Posicoes Da Viagem Viagens Request Unauthorized Error