View Positions

Menampilkan kumpulan data posisi beberapa object

GET /objects/:object_id/positions?from=2026-01-01 00:00:00&to=2026-02-06 23:59:59

Headers

Authorization string required

Otentikasi API Key melalui header dengan prefix Bearer

Path Parameters

object_id string required

id object yang didapat dari View Objects

Query Parameters

from string required

Rentang waktu awal pengambilan data posisi

to string required

Rentang waktu akhir pengambilan data posisi

limit number

Batas jumlah data per-request

Response

200 application/json

• statusCode number

• result object

{
  "statusCode": 200,
  "result": [
    {
      "id": "1",
      "latitude": -6.305435,
      "longitude": 107.285788,
      "altitude": 5,
      "angle": 136,
      "speed": 6,
      "params": "{\"batteryCurrent\":0,\"batteryLevel\":0,\"batteryVoltage\":0,\"channelId\":1,\"codecId\":1,\"deviceId\":1,\"deviceName\":\"B 1234 A\",\"deviceTypeId\":1,\"din\":1,\"din1\":true,\"dout\":0,\"dout1\":false,\"ecoDrivingEventsNumber\":0,\"engineIgnitionStatus\":true,\"eventPriorityEnum\":0,\"externalPowersourceVoltage\":11.84,\"gnssStateEnum\":1,\"gnssStatus\":true,\"gpsFuelRate\":0.47,\"gpsFuelUsed\":67.5,\"gsmMcc\":510,\"gsmMnc\":11,\"gsmNetworkModeEnum\":5,\"gsmOperatorCode\":\"12345\",\"gsmSignalLevel\":80,\"ident\":\"123456789\",\"movementStatus\":true,\"peer\":\"127.0.0.1:12345\",\"positionAltitude\":5,\"positionDirection\":136,\"positionHdop\":0.6,\"positionLatitude\":-6.305435,\"positionLongitude\":107.285788,\"positionPdop\":0.7,\"positionSatellites\":5,\"positionSpeed\":6,\"positionValid\":true,\"protocolId\":1,\"segmentVehicleMileage\":0,\"serverTimestamp\":1768290127.822736,\"sleepModeEnum\":0,\"timestamp\":1768290121,\"vehicleMileage\":14802.342}",
      "time_server": "2026-01-13T07:42:07.822Z",
      "time_device": "2026-01-13T07:42:01.000Z",
      "timestamp": "2026-01-13T07:42:07.822Z",
      "object_id": null,
      "ignition": true,
      "is_moving": true,
      "hdop": 0.6,
      "satellites": 5,
      "pdop": 0.7,
      "gsm_level": 80,
      "power_voltage": 11.84,
      "valid": true
    }
  ]
}

---

400 application/json

• statusCode number

• errorCode string

• message string

• internalMessage string

• titleMessage string

• timestamp string

• path string

• errors object[]

{
  "statusCode": 400,
  "errorCode": "PUBLIC.400_001",
  "message": "Enter From Time, because is required.",
  "internalMessage": "from should not be empty",
  "titleMessage": "",
  "timestamp": "2026-02-09T14:49:17.735Z",
  "path": "/v1/objects/1/positions",
  "errors": [
    {
      "property": "from",
      "target": {},
      "contexts": {
        "isNotEmpty": {
          "validation": {
            "code": "PUBLIC.400_001",
            "message": "Enter From Time, because is required.",
            "internalMessage": "from should not be empty",
            "titleMessage": ""
          }
        }
      },
      "children": [],
      "constraints": {
        "isNotEmpty": "from should not be empty"
      }
    },
    {
      "property": "to",
      "target": {},
      "contexts": {
        "isNotEmpty": {
          "validation": {
            "code": "PUBLIC.400_002",
            "message": "Enter To Time, because is required.",
            "internalMessage": "to should not be empty",
            "titleMessage": ""
          }
        }
      },
      "children": [],
      "constraints": {
        "isNotEmpty": "to should not be empty"
      }
    }
  ]
}

---

429 application/json

• statusCode number

• errorCode string

• message string

• internalMessage string

• titleMessage string

• timestamp string

• path string

• errors object[]

{
  "statusCode": 429,
  "errorCode": "ERR999",
  "message": "ThrottlerException: Too Many Requests",
  "internalMessage": "ThrottlerException: Too Many Requests",
  "titleMessage": "",
  "timestamp": "2026-02-09T13:28:55.196Z",
  "path": "/v1/objects/1/positions?from=2026-01-01 00:00:00&to=2026-02-06 23:59:59",
  "errors": []
}