Driver Risk Profile (weekly)

Description

Driver risk profile according to road safety statistics and his/her driving patterns.

The API returns weekly statistics per driver for given week and year including his/her global score and details about contributory factors.

In the response, the *_activated fields count how many times each contributory factor was triggered and *_contribution fields give each factor contribution to the final score (%) taking into account the contributory factor weight and the type of road on which it was activated.

API documentation

This documentation is valid for release > release-01-07-19.1. See version property of response for verification.

  • URL

    URL

  • Method

    GET

  • HEADERS: None

  • Data Params

    • Required

      • token: your API token (TOKEN)
      • week: week number, between 1 and 52
      • year: year, e.g.: 2019
    • Optional

      • source: fleetname, e.g.: fleet-name-1
  • Success Response

    • Code: 200
    • Content: csv
  • Error Response

  • Response properties

    • source=[text]: trips source (fleet...);

    • year=[number] : trips start year;

    • week=[number] : trips start week;

    • device_id=[text] : device identifier (defined by customer);

    • risk_function_result=[number] : average risk score;

    • risk_device_normalized=[number] : average normalized risk score;

    • distance_km=[number] : total driven distance;

    • dist_urban_km=[number] : total driven distance on urban roads;

    • dist_rural_km=[number] : total driven distance on rural roads;

    • dist_motorway_km=[number] : total driven distance on motorways;

    • trip_count=[number] : number of trips;

    • duration_ms=[number] : total trip duration;

    • active_time=[number] : number of active days;

    The following are counts for each kind of events:

    • swerved_alarm_activated=[number] : aggresive changes of the car orientation;

    • roadlayout_alarm_activated=[number] : driving on not urban roads that are category C or lower;

    • lossofcontrol_alarm_activated=[number] : exceeding speed on curves or swerving at high speed;

    • suddenbraking_alarm_activated=[number] : aggressive braking event;

    • animalcrossing_alarm_activated=[number] : driving on a link with animal crossing traffic sign;

    • fatiguedriving_alarm_activated=[number] : driving more than 2h without stops;

    • aggressivedriving_alarm_activated=[number] : succession of high acceleration and high braking events;

    • disobeyedproprity_alarm_activated=[number] : no deceleration when approaching a YIELD or STOP sign;

    • junctionovershoot_alarm_activated=[number] : no deceleratation at a YIELD or STOP sign. Usage of intersection information;

    • excedingspeedlimit_alarm_activated=[number] : exceeding legal speed limit;

    • poorturnormanoeuvre_alarm_activated=[number] : taking an illegal turn or U-turn OR driving in a non overtaking road link with high acceleration event;

    • disobeyeddoublelines_alarm_activated=[number] : driving on a non overtaking road link with high acceleration event;

    • failedtolookproperly_alarm_activated=[number] : inattentive event such as a aggressive braking event on traffic signs or no deceleration at junctions or roundabouts;

    • illegalturnordirection_alarm_activated=[number] : driving in a wrong direction or taking an illegal turn;

    • drivercarelessorinahurry_alarm_activated=[number] : exceeding traffic speed or swerving at high speed;

    • travellingtoofastforconditions_alarm_activated=[number] : exceeding traffic speed but below the legal speed limit;

    • disobeyedpedestriancrossingfacility_alarm_activated=[number] : acceleration when approaching a pedestrian crossing sign;

    • visionaffectedbyweather_alarm_activated=[number] : vision affected by rain, sleet, snow or fog and the stopping sight distance is greater than the visibility distance;

    • dazzlingsun_alarm_activated=[number] : driving under dazzling sun conditions, ie sunny weather, low sun and driving towards the sun;

    • poorroadsurface_alarm_activated=[number] : poor road roughness (based on the International Roughness Index (IRI));

    • slipperyroad_alarm_activated=[number] : driving under weather conditions that might cause skidding;

    • acceleration_alarm_activated=[number] : number of high acceleration event;

    • braking_alarm_activated=[number] : number of high braking alarm;

    • steering_alarm_activated=[number] : number of steering alarm;

    • speeding_alarm_activated=[number] : number of high speed alarm;

    • avg_speeding=[number] : average overspeeding during this week;

    • max_speeding=[number] : max overspeeding during this week;

    The following are relative contribution of each contributory factors:

    • swerved_alarm_contribution=[number] : "swerved" contributory factor contribution to final score (%);
    • roadlayout_alarm_contribution=[number] : "road layout" contributory factor contribution to final score (%);
    • lossofcontrol_alarm_contribution=[number] : "loss of control" contributory factor contribution to final score (%);
    • suddenbraking_alarm_contribution=[number] : "sudden braking" contributory factor contribution to final score (%);
    • animalcrossing_alarm_contribution=[number] : "animal crossing" contributory factor contribution to final score (%);
    • fatiguedriving_alarm_contribution=[number] : "fatigue driving" contributory factor contribution to final score (%);
    • aggressivedriving_alarm_contribution=[number] : "aggressive driving" contributory factor contribution to final score (%);
    • disobeyedproprity_alarm_contribution=[number] : "disobeyed priority" contributory factor contribution to final score (%);
    • junctionovershoot_alarm_contribution=[number] : "junction overshoot" contributory factor contribution to final score (%);
    • excedingspeedlimit_alarm_contribution=[number] : "exceeding speed limit" contributory factor contribution to final score (%);
    • poorturnormanoeuvre_alarm_contribution=[number] : "poor turn or manoeuvre" contributory factor contribution to final score (%);
    • disobeyeddoublelines_alarm_contribution=[number] : "disobeyed double lines" contributory factor contribution to final score (%);
    • failedtolookproperly_alarm_contribution=[number] : "failed to look properly" contributory factor contribution to final score (%);
    • illegalturnordirection_alarm_contribution=[number] : "illegal turn or direction" contributory factor contribution to final score (%);
    • drivercarelessorinahurry_alarm_contribution=[number] : "driver careless or in a hurry" contributory factor contribution to final score (%);
    • travellingtoofastforconditions_alarm_contribution=[number] : "travelling too fast for conditions" contributory factor contribution to final score (%);
    • disobeyedpedestriancrossingfacility_alarm_contribution=[number] : "disobeyed pedestrian crossing facility" contributory factor contribution to final score (%);
    • visionaffectedbyweather_alarm_contribution=[number] : "vision affected by weather" contributory factor contribution to final score (%);
    • dazzlingsun_alarm_contribution=[number] : "dazzling sun" contributory factor contribution to final score (%);
    • poorroadsurface_alarm_contribution=[number] : "poor road surface" contributory factor contribution to final score (%);
    • slipperyroad_alarm_contribution=[number] : "slippery road" contributory factor contribution to final score (%).
  • Sample request

            https://analytics.motion-s.com/externalApiv1/load/<YOUR_ENDPOINT>?token=<YOUR_TOKEN>&contentType=text/csv&references=<WEEK_NUMBER>,<YEAR>
    

    For instance:

      WEEK_NUMBER=21
      YEAR=2019
    
  • Sample response

source,year,week,device_id,risk_function_result,risk_device_normalized,distance_km,dist_urban_km,dist_rural_km,dist_motorway_km,trip_count,duration_ms,active_time,swerved_alarm_activated,roadlayout_alarm_activated,lossofcontrol_alarm_activated,suddenbraking_alarm_activated,animalcrossing_alarm_activated,fatiguedriving_alarm_activated,aggressivedriving_alarm_activated,disobeyedproprity_alarm_activated,junctionovershoot_alarm_activated,excedingspeedlimit_alarm_activated,poorturnormanoeuvre_alarm_activated,disobeyeddoublelines_alarm_activated,failedtolookproperly_alarm_activated,illegalturnordirection_alarm_activated,drivercarelessorinahurry_alarm_activated,travellingtoofastforconditions_alarm_activated,disobeyedpedestriancrossingfacility_alarm_activated,visionaffectedbyweather_alarm_activated,dazzlingsun_alarm_activated,poorroadsurface_alarm_activated,slipperyroad_alarm_activated,acceleration_alarm_activated,braking_alarm_activated,steering_alarm_activated,speeding_alarm_activated,aggressivedriving_alarm_activated,avg_speeding,max_speeding,swerved_alarm_contribution,roadlayout_alarm_contribution,lossofcontrol_alarm_contribution,suddenbraking_alarm_contribution,animalcrossing_alarm_contribution,fatiguedriving_alarm_contribution,aggressivedriving_alarm_contribution,disobeyedproprity_alarm_contribution,junctionovershoot_alarm_contribution,excedingspeedlimit_alarm_contribution,poorturnormanoeuvre_alarm_contribution,disobeyeddoublelines_alarm_contribution,failedtolookproperly_alarm_contribution,illegalturnordirection_alarm_contribution,drivercarelessorinahurry_alarm_contribution,travellingtoofastforconditions_alarm_contribution,disobeyedpedestriancrossingfacility_alarm_contribution,visionaffectedbyweather_alarm_contribution,dazzlingsun_alarm_contribution,poorroadsurface_alarm_contribution,slipperyroad_alarm_contribution
source1,2019,23,devID1,1.01729452686976430050,93.2773643411484660,68,68,0,0,20,19366000,3,20,1,1,2,0,0,20,0,0,2,3,0,0,3,0,0,0,0,0,15,4,0,2,20,2,20,0.07547987649532208700,0.22333333333333336,0.30144926443392708164,0.00942880616578221212,0.07994839672369507720,0.01201222832548607076,null,null,0.37300022531945219163,null,null,0.07991817319532070148,0.11344450907989886211,null,null,0.00908166155980353981,null,null,null,null,null,0.02171673519663426325,0
source1,2019,23,12555,2.2456857170844070,88.1072484226750133,466,85,248,133,10,73672000,2,10,5,0,3,5,5,10,0,0,3,1,0,1,1,0,0,4,0,0,1,2,0,3,10,3,10,0.09910112431777726200,0.1397334682861,0.20896538838002239624,0.06536072151619023616,null,0.02498072067342747719,0.01667012451497018384,0.07798076628496002903,0.25856469444727842267,null,null,0.16619843606262132129,0.05242667937058004988,null,0.11257016498435207945,0.00419695375835784391,null,null,0.00873999545941174963,null,null,0.00334535454782821073,0
source1,2019,23,devID2,4.18754712082749107,76.8618584078461903,312,255,57,0,33,65515000,3,32,13,9,26,8,0,32,0,0,20,1,0,4,1,3,3,1,0,0,17,14,0,26,32,20,32,0.19913822002300025121,0.3652836879432621,0.13877485742225210501,0.03255476258440024624,0.20702788576156524234,0.04493073360164311869,0.00553535245887003301,null,0.17171398040853581625,null,null,0.21844682254991563668,0.01088024823628807509,null,0.09344794320251858617,0.00087100497829317915,0.04769695867846033452,0.02187101715904276399,null,null,null,0.00624843295821486288,0
source1,2019,23,devID3,1.88710577548466059,89.2604642194932187,44,44,0,0,16,11910000,2,16,0,0,5,0,0,16,0,0,7,1,0,1,1,0,0,0,0,0,13,0,1,5,16,7,16,0.12549774634711416063,0.3353846153846154,0.24050759493192743578,null,null,0.02994940282240532640,null,null,0.29759365068980406327,null,null,0.27895758353933791061,0.03771262870204033924,null,0.08097626792217953003,0.00301903841076385353,null,null,null,null,null,0.03128383298154154113,null
source1,2019,23,12479,3.89053457606758515,80.7896830648259557,173,73,95,6,9,15081000,2,9,3,3,0,0,0,9,1,1,5,1,0,1,1,0,0,1,0,0,5,3,0,0,9,5,9,0.23413772789765252222,0.5874662162162163,0.14856145294441767588,0.03097828410474057731,0.26266996095572755175,null,null,null,0.18382348859304893638,0.00489075005504153481,0.00431931915536004532,0.21880888478411817808,0.04141347001011084763,null,0.08892268607476971137,0.00331530473972972391,null,null,0.00172599878626858383,null,null,0.01057039979666663374,0
source1,2019,23,devID4,1.09959693112924178,92.8243440205071510,184,180,3,0,42,35919000,3,42,2,2,14,0,0,42,2,2,21,2,0,0,2,0,0,1,0,0,30,13,2,14,42,21,42,0.13131838519676238562,0.4159477124183006,0.23782194351708095938,0.00708443310985549363,0.06007007237932972557,0.03158930123451655784,null,null,0.29427054228962812342,0.00335540130352103466,0.00296335919053532330,0.31524865896316912697,0.02841257674004669689,null,null,0.00227453411441286746,null,null,0.00059207877239109351,null,null,0.01631709838551299738,0
source1,2019,23,devID4,1.8467603329116774,87.4196342204619224,133,75,37,21,23,30572000,2,23,9,6,0,1,0,23,3,3,11,2,0,0,2,0,0,4,0,0,6,5,0,0,23,11,23,0.13909079916875476478,0.29807407407407466,0.18197814027421566629,0.04454575978653313273,0.25180721101939727574,null,0.00126236768136641121,null,0.22517184592558553732,0.00703273868853551722,0.00621103973627112062,0.23073601680834765620,0.03970081064442353545,null,null,0.00317819988685892119,null,null,0.00330923977002768838,null,null,0.00506662977843753764,0
source1,2019,23,devID5,1.90673002990231589,88.9234373546068885,431,140,269,22,33,55928000,3,29,10,2,19,6,0,29,0,0,10,1,1,2,0,0,0,3,0,0,8,10,1,19,29,10,29,0.11248618881033099785,0.384463768115942,0.22064234091267629367,0.04759521944617609017,0.08071353720778365836,0.05760415491419417949,0.00728344072170517226,null,0.27301324828237696473,null,null,0.20170756106816415898,0.01908837029024365962,0.00190251110823345976,0.08197280539804515162,null,null,null,0.00238665129568438692,null,null,0.00609015935471682442,0
source1,2019,23,devID6,4.8110710209670952,74.5233269457413467,32,7,26,0,3,2188000,1,2,0,0,0,0,0,2,0,0,2,0,0,1,0,0,0,0,0,0,0,0,0,0,2,2,2,0.08893483954256146000,0.10150684931506837,0.13189131156771002984,null,null,null,null,null,0.16319657977874013588,null,null,0.34966125064592979957,null,null,0.35525085800762003471,null,null,null,null,null,null,null,null

Usage examples

https://analytics.motion-s.com/externalApiv1/load/YOUR_ENDPOINT?token=YOUR_TOKEN&contentType=text/csv&references=WEEK_NUMBER,YEAR