PID Object

PID Value Updated Event

When a user subscribes to receive a PID data stream, the backend sends the app the corresponding PID object on a best effort basis as it receives data from the devices. Essentially, it is similar to the real-time event notification, except for the fact the data undergoes minimal transformation and processing on its way from the device to the app.

Description

The value of the PID(s)/sensors being monitored is updated.

Scopes

scopes:vehicle:stream required. scopes:vehicle necessary to get full information.

Trigger

Whenever the value of a PID subscribed to is updated. The update frequency could vary from 5 Hz to 1/60 Hz. This event will return a values for the PID (Parameter ID) and sensors that the user has subscribed to using the streaming API.

When first subscribed, the latest available value for the PID is sent.

Example PID Updated Event Notification

{
  "id": "f61ba3d5-a68e-43eb-a731-0db871b4d3a3",
  "user": {
    "id": "U_ffd955ba63db5c25",
    "url": "https://api.VehicleMind.com/user/U_ffd955ba63db5c25/"
  },
  "type": "pid:speed",
  "value": 70,
  "updated_at": "2015-04-12T17:45:18.123Z",
  "time_zone": "America/Los_Angeles",
  "vehicle": {
    "id": "C_507d6f1bd6d9b855",
    "url": "https://api.VehicleMind.com/vehicle/C_507d6f1bd6d9b855/"
  },
  "device": {
    "id": "021ac91c826b12eca99e685c"
  }
}