Step 2: Extract the Driver Performance Events

The driver performance events API returns driver performance events as reported by the data collected via the Motive Vehicle Gateway and Motive AI Dashcams (if installed in the vehicle).

This endpoint lists all the driver performance events. It includes events such as:

  • hard_accel, hard_brake, hard_corner, crash
  • seat_belt_violation, tailgating, cell_phone, stop_sign_violation, distraction, unsafe_lane_change, drowsiness, road_facing_cam_obstruction, driver_facing_cam_obstruction, forward_collision_warning

For AI Dashcam alerts you can download the videos of the event with the S3 bucket link provided in the "downloadable_videos” object

{
  "driver_performance_events": [
    {
      "driver_performance_event": {
        "id": 265430,
        "acceleration": 0.283157775512516,
        "duration": 1,
        "end_bearing": 256.29,
        "end_speed": 23,
        "end_time": "2020-01-27T11:25:51Z",
        "lat": 31.5346741,
        "lon": 74.3442315,
        "m_gps_heading": [
          275.17,
          271.65,
          270.15,
          269.04,
          267.01,
          262.74,
          258.94,
          259.95,
          258.26,
          256.8,
          256.29,
          255.27,
          257.37,
          255.72,
          257.38,
          256.51,
          260.87,
          257.16,
          257.85,
          259.28,
          266.18
        ],
        "m_gps_lat": [
          31.5347566,
          31.534758,
          31.5347578,
          31.5347565,
          31.5347534,
          31.5347467,
          31.5347258,
          31.5347137,
          31.534691,
          31.5346741,
          31.5346616,
          31.5346492,
          31.5346372,
          31.5346217,
          31.5346076,
          31.5345951,
          31.5345859,
          31.5345725,
          31.5345592,
          31.5345514,
          31.5345458
        ],
        "m_gps_lon": [
          74.3453154,
          74.3451793,
          74.3450673,
          74.344965,
          74.3448361,
          74.3447039,
          74.3445724,
          74.3444785,
          74.3443291,
          74.3442315,
          74.3441565,
          74.344088,
          74.3440219,
          74.3439522,
          74.3438819,
          74.3438156,
          74.3437561,
          74.343687,
          74.3436131,
          74.3435652,
          74.343499
        ],
        "m_veh_odo": null,
        "m_veh_spd": [
          39,
          38,
          37,
          38,
          40,
          40,
          40,
          40,
          38,
          33,
          23,
          22,
          21,
          20,
          21,
          22,
          22,
          21,
          21,
          21,
          21
        ],
        "start_bearing": 256.8,
        "start_speed": 33,
        "start_time": "2020-01-27T11:25:50Z",
        "type": "cell_phone",
        "driver": {
          "id": 10828,
          "first_name": "Afsheen",
          "last_name": "Ad5",
          "username": null,
          "email": null,
          "driver_company_id": "abcdef",
          "mcleod_id": null,
          "status": "deactivated",
          "role": "driver"
        },
        "vehicle": {
          "id": 10573,
          "number": "celd_01134453",
          "year": "",
          "make": "Testing long name text 12344",
          "model": "",
          "vin": "",
          "metric_units": false,
          "mcleod_id": null
        },
        "eld_device": {
          "id": 50840,
          "identifier": "01134453",
          "model": "lbb-3.55ca"
        },
        "camera_media": {
          "id": 2298628,
          "available": true,
          "cam_positions": [
            "front_facing",
            "driver_facing"
          ],
          "cam_type": "dc54",
          "uploaded_at": "2022-05-13T15:56:24Z",
          "start_time": "2022-05-13T15:53:00Z",
          "duration": 19,
          "downloadable_videos": {
            "front_facing_enhanced_url": null,
            "front_facing_enhanced_ai_viz_url": null,
            "dual_facing_enhanced_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/camera_media/media/2436118/mp4-dual_facing-enhanced-7fa92a01-d7d1a59b",
            "dual_facing_enhanced_ai_viz_url": null,
            "front_facing_plain_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/camera_media/media/2436118/mp4-front_facing-7fa92a01-38c6-493b-ba3e27aa",
            "driver_facing_plain_url": "https://keep-truckin-preview.s3.amazonaws.com/uploads/camera_media/media/2436118/mp4-driver_facing-7fa92a01-38c6-493b-ba0b-5f3468c90c4a1de1f81e527bbaea69176acd25cce16c0968310"
          },
          "auto_transcode_status": "success",
          "downloadable_images": {
            "front_facing_jpg_url": null,
            "driver_facing_jpg_url": null
          }
        },
        "edited_by_fm": false,
        "m_gps_spd": [
          39,
          38,
          37,
          38,
          40,
          40,
          40,
          40,
          38,
          33,
          23,
          22,
          21,
          20,
          21,
          22,
          22,
          21,
          21,
          21,
          21
        ],
        "location": "Lahore, PK",
        "intensity": null,
        "coaching_status": "pending_review",
        "coached_at": null,
        "coachable_behaviors": [
          "hard_brake"
        ],
        "coached_behaviors": null,
        "primary_behavior": [
          "cell_phone"
        ],
        "secondary_behaviors": [
          "in_progress"
        ],
        "max_speed": 41.1192,
        "min_speed": 20.628,
        "event_intensity": {
          "name": "Distracted time",
          "value": 1,
          "unit_type": "s"
        },
        "metadata": {
          "additional_context": {
            "slope": [
              "na"
            ],
            "Lighting": [
              "na"
            ],
            "Road_type": [
              "na"
            ],
            "Lane_spacing": [
              "na"
            ],
            "Tpv_behavior": [
              "na"
            ],
            "Road_geometry": [
              "na"
            ],
            "Vehicle_speed": [
              "na"
            ],
            "Sensitive_zone": [
              "na"
            ],
            "Road_conditions": [
              "na"
            ],
            "road_visibility": [
              "na"
            ],
            "Traffic_density": [
              "na"
            ],
            "Driving_visibility": [
              "na"
            ],
            "Traffic_conditions": [
              "na"
            ],
            "Traffic_violations": [
              "no"
            ]
          },
          "annotation_tags": [
            "delayed_response",
            "seat_belt_violation"
          ],
          "severity": null,
          "trigger": null
        }
      }
    }
  ],
  "per_page": 25,
  "page_no": 1,
  "total": 1
}