Sensor readings¶

API call to get last values for all metering sensors and state values. Includes CAN, OBD, and fuel.

Described getting data from sensors in our guides.

API actions¶

API base path: /tracker/readings.

list¶

Gets last values for all metering sensors, state values and counters.

parameters¶

name	description	type	format
tracker_id	ID of the tracker (aka "object_id"). Tracker must belong to authorized user and not be blocked.	int	999199
sensor_type	Optional. If specified, state values and counters will be omitted. Used to filter sensors by type.	string metering sensor type or virtual sensor type	"fuel"
include_components	Optional. Default is `true`. If set to `false`, parts of composite sensors will be excluded.	boolean	true

examples¶

cURL

curl -X POST 'https://api.navixy.com/v2/tracker/readings/list' \
    -H 'Content-Type: application/json' \
    -d '{"hash": "a6aa75587e5c59c32d347da438505fc3", "tracker_id": 265489}'

HTTP GET

https://api.navixy.com/v2/tracker/readings/list?hash=a6aa75587e5c59c32d347da438505fc3&tracker_id=265489

response¶

{
  "success": true,
  "inputs": [
    {
      "value": 5.66,
      "label": "label",
      "units": "litres",
      "name": "fuel_level",
      "type": "fuel",
      "units_type": "custom",
      "update_time": "2023-06-28 06:05:59"
    }
  ],
  "states": [
    {
      "field": "obd_mil_status",
      "value": 12345.23,
      "update_time": "2023-06-28 06:05:59"
    }
  ],
  "virtual_sensors": [
    {
      "label": "Virtual Ignition",
      "value": "On",
      "type": "virtual_ignition",
      "update_time": "2023-06-28 06:05:59"
    },
    {
      "label": "Hood state",
      "value": "Closed",
      "type": "state",
      "update_time": "2023-06-28 06:05:59"
    }
  ],
  "counters": [
    {
      "type": "odometer",
      "value": 3232.9923342688653,
      "update_time": "2023-06-28 06:05:59"
    }
  ]
}

inputs - an array of JSON objects containing information about the tracker sensors readings.
- value - float. The value of the sensor.
- label - string. The label of the sensor.
- units - string. The units in which the sensor value is measured.
- name - string. The name of the sensor.
- type - metering sensor type. The type of the sensor.
- units_type - string. The type of the units in which the sensor value is measured.
- update_time - date/time. The time when the sensor value was updated.
states - an array of JSON objects containing information about the tracker state readings.
- field - string. The field name of the state.
- value - can be string, int, float, boolean, or null. The value of the field.
- update_time - date/time. The time when the field value was updated.
virtualSensors - an array of JSON objects containing information about the tracker virtual sensors readings.
- value - float. The value of the virtual sensor.
- label - string. The label of the virtual sensor.
- type - virtual sensor type. The type of the virtual sensor.
- update_time - date/time. The time when the virtual sensor value was updated.
counters - an array of JSON objects containing information about the tracker counter readings.
- type - string. The type of the counter.
- value - float. The value of the counter.
- update_time - date/time. The time when the counter value was updated.

errors¶

204 – Entity not found - if there is no tracker with such ID belonging to authorized user.
208 – Device blocked - if tracker exists but was blocked due to tariff restrictions or some other reason.

batch_list¶

Gets last values for all metering sensors, state values and counters on multiple trackers.