svc=unit/update_drive_rank_settings¶ms={"itemId":<long>, "driveRank": { "acceleration":[ { "flags":<uint>, "min_value":<double>, "max_value":<double>, "min_speed":<uint>, "max_speed":<uint>, "min_duration":<uint>, "max_duration":<uint>, "validator_id":<long>, "name":<text>, "penalties":<uint> }, ... ], "brake":[ { "flags":<uint>, "min_value":<double>, "max_value":<double>, "min_speed":<uint>, "max_speed":<uint>, "min_duration":<uint>, "max_duration":<uint>, "validator_id":<long>, "name":<text>, "penalties":<uint> }, ... ], "turn":[ { "flags":<uint>, "min_value":<double>, "max_value":<double>, "min_speed":<uint>, "max_speed":<uint>, "min_duration":<uint>, "max_duration":<uint>, "validator_id":<long>, "name":<text>, "penalties":<uint> }, ... ], "sensor":[ { "flags":<uint>, "min_value":<double>, "max_value":<double>, "min_speed":<uint>, "max_speed":<uint>, "min_duration":<uint>, "max_duration":<uint>, "validator_id":<long>, "sensor_id":<long>, "name":<text>, "penalties":<uint> }, ... ], "speeding":[ { "flags":<uint>, "min_value":<double>, "max_value":<double>, "min_speed":<uint>, "max_speed":<uint>, "min_duration":<uint>, "max_duration":<uint>, "validator_id":<long>, "name":<text>, "penalties":<uint> }, ... ], "harsh":[ { "flags":<uint>, "min_value":<double>, "max_value":<double>, "min_speed":<uint>, "max_speed":<uint>, "min_duration":<uint>, "max_duration":<uint>, "validator_id":<long>, "name":<text>, "penalties":<uint> }, ... ], "global": { "accel_mode":<uint> } } }
Parameters
It is optional to set evaluation criteria. DriveRank may contain empty object {}.
| Params | Description |
|---|---|
| accel_mode | Penalties calculating method 0 – combined, 1 – by speed in messages, 2 – by по accelerometer values |
| itemId | item ID |
| driveRank | drive rank criteria parameters object |
| Evaluation criteria | |
| acceleration | acceleration |
| brake | brake |
| turn | turn |
| sensor | sensor |
| speeding | speeding |
| harsh | harsh driving |
| global | global criteria |
| Criteria settings | |
| flags | flags: 1 – penalties averaging by time; 2 – by mileage; 4 – validator=multiplier; 8 – skip missing values |
| min_value | min value |
| max_value | max value (excluded) |
| min_speed | min speed |
| max_speed | max speed (excluded) |
| min_duration | min duration |
| max_duration | max duration (included) |
| validator_id | validator sensor id |
| sensor_id | sensor id (for sensor evaluation criterion only) |
| name | any criterion name |
| penalties | penalties |
| accel_mode | calculate acceleration by: 0 – GPS+accelerometer; 1 – GPS; 2 – accelerometer. |
Response
Returns empty object {} if settings saved successfully.