Powered by Redocly

Fleet - Configuration

Configuration list

VisionMax events have various types and configurable pre-recorded and post-recorded event video length.

This API can retrieve the current configuration list

Event video duration

Category Event range of pre event (second) range of post event (second)
Sensor Harsh Acceleration 6~15 2~30
Harsh Braking 6~15 2~30
Harsh Cornering 6~15 2~30
Impact Driving 6~15 2~30
Impact Parking n/a 2~30
AI_ADAS FCW 4~15 0-30
Tailgating 4~15 0-30
LDW 4~15 0-30
Stop and Go 4~15 0-30
AI_DMS Distraction 4~15 0-30
Phoning 4~15 0-30
Speed Camera Violation 4~15 0-30
Rolling Stop 4~15 0-30

Video format and resolution

Model Camera Default format Options
K145 series embedded(front and incabin) Side-By-Side Side-Bye-Side(2560x720)/Separate(1280x720)
UVC Single Single(1280x720)
K245 series embedded(front and incabin) Side-By-Side Side-Bye-Side(2560x720)/Separate(1280x720)
UVC Single Single(1280x720)
K220 series embedded(front and incabin) Side-By-Side Side-Bye-Side(2560x720)/Separate(1280x720)
UVC Single Single(1280x720)
K165 series embedded(front and incabin) Side-By-Side Side-Bye-Side(2560x720)/Separate(1280x720)
UVC Single Single(1280x720)
4TVI Grid Grid(2560x1440)
2TVI Side-By-Side Single(2560x720)
K265 series embedded(front and incabin) Side-By-Side Side-Bye-Side(2560x720)/Separate(1280x720)
UVC Single Single(1280x720)
4TVI Grid Grid(2560x1440)
2TVI Side-By-Side Single(2560x720)
Securityapi key and Authorization
Responses
200

OK

get/V2/configuration
Response samples
application/json
{
  • "current": {
    },
  • "default": {
    }
}

Update the configuration by vehicle types.

This API can be used to modify the configuration based on vehicle types.

This configuration relies on dynamic JSON input, thus enabling partial updates and simultaneous updates for multiple VehicleType entries.

Securityapi key and Authorization
Request
Request Body schema:
object

Dynamic JSON properties are captured here, with each being a ConfigSet object.

property name*
additional property
any
Responses
200

OK

post/V2/configuration
Request samples
{
  • "DynamicKey": {
    },
  • "property1": null,
  • "property2": null
}

Configuration list of a single device.

Securityapi key and Authorization
Request
path Parameters
cid
required
string
Responses
200

OK

get/V2/configuration/{cid}
Response samples
application/json
{
  • "current": {
    },
  • "default": {
    },
  • "custom": {
    }
}

Update the configuration of a single device

This API can be used to modify the configuration of a single device, ensuring that each modification will overwrite the previous settings

This configuration relies on dynamic JSON input.

Securityapi key and Authorization
Request
path Parameters
cid
required
string
Request Body schema:
object (AiEventDetection)

The AI config is used to control events such as ADAS (Advanced Driver Assistance Systems) and DMS (Driver Monitoring Systems)

object (DeviceConfig)

The device config is used to control the behavior of the Camera app.

object (Score)

The score config will influence how the system calculates the driver's safety score.

Driver's Safety Score

Start with a safety score of 100.

System starts calculating the new score after the driver has driven more than 5000 km.

Safety score is calculated using a mix of sensor events (including impact and harsh driving), AI-detected events (including ADAS, DMS) and speeding events that are differently weighted.

Safety score will be subtracted if an event is triggered. The more events are triggered by the driver, the lower the safety score the driver has.

Only events that were triggered in the last 5000 km of trips are count.

Equation

Safety Score = (1- (∑ Trip score) / 5000) * 100 *

Trip score = TRUNCATE ((Event Score * 70 / 100) + (Overspeed Score * 30 / 100),2)

Event Score = Event Score x Weight

Overspeed Score = (Cumulative distance of Overspeed / Trip distance) * 100

object (Sensor)

The Sensor config is used to control the behavior of events related to sensors.

object (Speeding)

The Speeding config is deprecated and has been replaced by Safety camera violation detection.

The options of MMF map feature are available.

object (TrafficAndSign)
Responses
200

OK

post/V2/configuration/{cid}
Request samples
{
  • "aiEventDetection": {
    },
  • "device": {
    },
  • "score": {
    },
  • "sensor": {
    },
  • "speeding": {
    },
  • "trafficAndSign": {
    }
}

Patch the configuration of a single device

This API can be used to modify the configuration of a single device.
This configuration relies on dynamic JSON input.

Securityapi key and Authorization
Request
path Parameters
cid
required
string
Request Body schema:
object (AiEventDetection)

The AI config is used to control events such as ADAS (Advanced Driver Assistance Systems) and DMS (Driver Monitoring Systems)

object (DeviceConfig)

The device config is used to control the behavior of the Camera app.

object (Score)

The score config will influence how the system calculates the driver's safety score.

Driver's Safety Score

Start with a safety score of 100.

System starts calculating the new score after the driver has driven more than 5000 km.

Safety score is calculated using a mix of sensor events (including impact and harsh driving), AI-detected events (including ADAS, DMS) and speeding events that are differently weighted.

Safety score will be subtracted if an event is triggered. The more events are triggered by the driver, the lower the safety score the driver has.

Only events that were triggered in the last 5000 km of trips are count.

Equation

Safety Score = (1- (∑ Trip score) / 5000) * 100 *

Trip score = TRUNCATE ((Event Score * 70 / 100) + (Overspeed Score * 30 / 100),2)

Event Score = Event Score x Weight

Overspeed Score = (Cumulative distance of Overspeed / Trip distance) * 100

object (Sensor)

The Sensor config is used to control the behavior of events related to sensors.

object (Speeding)

The Speeding config is deprecated and has been replaced by Safety camera violation detection.

The options of MMF map feature are available.

object (TrafficAndSign)
Responses
200

OK

patch/V2/configuration/{cid}
Request samples
{
  • "aiEventDetection": {
    },
  • "device": {
    },
  • "score": {
    },
  • "sensor": {
    },
  • "speeding": {
    },
  • "trafficAndSign": {
    }
}

Restore the configuration of a single device.

This endpoint will remove any custom setting of specific device, therefor it will aligment with the setting of its vehicle type

Securityapi key and Authorization
Request
path Parameters
cid
required
string
Responses
200

OK

post/V2/configuration/{cid}/restore
➔ Next to Fleet - Dashboard