Timeline

The group timeline service provides a group's score history and statistics. It is presented as a vector of chronologically sorted data. Two time scales are available:

  • weekly and

  • monthly.

The data are obtained by averaging scores and aggregating trip data over a week or a month.

Timeline data is updated every 10 minutes.

If you have your admin API key, you can try the API via this link.

Timeline of group's scores

GET https://service.drivequant.com/v3/drivekit/admin/group/timeline

Get monthly and weekly averages of DriveQuant scores for a specific group:

Query Parameters

NameTypeDescription

label

string

Group label

Headers

NameTypeDescription

DriveKit-Admin-API-Key

string

Admin API Key

{
  "month": {
    "allContext": {
      "date": [
        "2021-07-01T12:00:00.000+0000",
        "2021-08-01T12:00:00.000+0000",
        "2021-09-01T12:00:00.000+0000",
        "2021-10-01T12:00:00.000+0000",
        "2021-11-01T12:00:00.000+0000",
        "2021-12-01T12:00:00.000+0000"
      ],
      "numberTripScored": [
        419,
        685,
        468,
        508,
        242,
        47
      ],
      "numberTripTotal": [
        544,
        865,
        607,
        735,
        312,
        71
      ],
      "distance": [
        10923.536299999998,
        21035.54370000003,
        7933.5418,
        10293.3118,
        2668.419099999999,
        687.4485
      ],
      "duration": [
        10911,
        19099,
        10645,
        11509,
        3863,
        706
      ],
      "efficiency": [
        7.866348448687346,
        7.7759124087591305,
        7.683974358974359,
        7.8635826771653505,
        7.684710743801657,
        7.514893617021275
      ],
      "safety": [
        8.865632458233886,
        8.965401459854014,
        8.747863247863265,
        8.85433070866142,
        8.943801652892569,
        9.106382978723406
      ],
      "acceleration": [
        361,
        427,
        441,
        477,
        162,
        11
      ],
      "braking": [
        1090,
        1678,
        955,
        918,
        306,
        57
      ],
      "adherence": [
        684,
        1103,
        677,
        774,
        322,
        46
      ],
      "co2Mass": [
        2128.4804061800005,
        3845.9109304799995,
        1449.8143545500004,
        1862.7658354000007,
        412.74580925000015,
        105.8644746
      ],
      "fuelVolume": [
        879.1910826606382,
        1580.5434558919308,
        582.6431984232269,
        781.3331171646059,
        169.96053270657129,
        43.87404004098896
      ],
      "phoneDistraction": [
        8.485832887039656,
        8.164364821796283,
        8.23345619699329,
        8.427299072851467,
        8.482145686597088,
        9.827785657595904
      ],
      "speeding": [
        6.933663041508757,
        6.874082909914464,
        6.699330932330055,
        6.651361548521506,
        6.306394039413145,
        7.182816901408451
      ],
      "unlock": [
        324,
        732,
        435,
        274,
        654,
        345
      ],
      "lock": [
        355,
        725,
        434,
        289,
        634,
        353
      ],
      "callAuthorized": [
        25,
        45,
        37,
        13,
        76,
        35
      ],
      "callForbidden": [
        11,
        32,
        20,
        26,
        39,
        23
      ],
      "callAuthorizedDuration": [
        5098,
        902,
        728,
        273,
        1528,
        745
      ],
      "callForbiddenDuration": [
        252,
        698,
        472,
        427,
        1136,
        522
      ]
    },
    "roadContexts": [
      {
        "date": [
          "2021-07-01T12:00:00.000+0000",
          "2021-08-01T12:00:00.000+0000",
          "2021-09-01T12:00:00.000+0000",
          "2021-10-01T12:00:00.000+0000",
          "2021-11-01T12:00:00.000+0000",
          "2021-12-01T12:00:00.000+0000"
        ],
        "numberTripScored": [
          11,
          14,
          17,
          9,
          7,
          0
        ],
        "numberTripTotal": [
          39,
          86,
          70,
          88,
          23,
          19
        ],
        "distance": [
          181.6830000000001,
          343.89400000000023,
          262.14799999999974,
          218.23899999999998,
          109.01599999999996,
          12.101
        ],
        "duration": [
          395,
          776,
          573,
          437,
          292,
          23
        ],
        "efficiency": [
          8.463636363636363,
          8.742857142857142,
          8.211764705882352,
          8.733333333333333,
          8.585714285714285,
          0
        ],
        "safety": [
          10,
          9.842857142857143,
          10.023529411764706,
          10.11111111111111,
          9.542857142857143,
          0
        ],
        "acceleration": [
          5,
          2,
          9,
          6,
          3,
          0
        ],
        "braking": [
          7,
          15,
          17,
          11,
          4,
          0
        ],
        "adherence": [
          18,
          29,
          32,
          25,
          20,
          2
        ],
        "co2Mass": [
          27.73929700000002,
          64.3916869999999,
          49.571131999999956,
          38.81020200000002,
          18.083602999999993,
          1.6385539999999996
        ],
        "fuelVolume": [
          11.681617116135321,
          26.2769042696812,
          20.18799860117111,
          16.0444938272609,
          7.601661376057252,
          0.6911179668184776
        ],
        "roadContext": "HEAVY_URBAN_TRAFFIC"
      },
      {
        "date": [
          "2021-07-01T12:00:00.000+0000",
          "2021-08-01T12:00:00.000+0000",
          "2021-09-01T12:00:00.000+0000",
          "2021-10-01T12:00:00.000+0000",
          "2021-11-01T12:00:00.000+0000",
          "2021-12-01T12:00:00.000+0000"
        ],
        "numberTripScored": [
          213,
          347,
          273,
          269,
          114,
          10
        ],
        "numberTripTotal": [
          291,
          449,
          355,
          404,
          160,
          15
        ],
        "distance": [
          1967.5609999999976,
          3177.4249999999997,
          1967.5050000000026,
          1926.3029999999972,
          731.5820000000002,
          116.84700000000004
        ],
        "duration": [
          3081,
          4835,
          3275,
          3176,
          1182,
          174
        ],
        "efficiency": [
          7.223943661971827,
          7.255619596541785,
          7.223443223443225,
          7.1918215613382825,
          7.036842105263156,
          6.890000000000001
        ],
        "safety": [
          8.57558685446011,
          8.643804034582143,
          8.293040293040296,
          8.300000000000004,
          8.58947368421052,
          8.929999999999998
        ],
        "acceleration": [
          224,
          262,
          335,
          355,
          117,
          7
        ],
        "braking": [
          584,
          933,
          603,
          564,
          181,
          28
        ],
        "adherence": [
          331,
          515,
          371,
          408,
          167,
          18
        ],
        "co2Mass": [
          313.2843310000002,
          455.7898239999999,
          303.06641100000024,
          289.92569299999985,
          105.09890700000004,
          16.644641000000004
        ],
        "fuelVolume": [
          132.131307986337,
          191.41603333279102,
          124.54967988776845,
          120.56554151594007,
          43.54910132400784,
          6.566683905335072
        ],
        "roadContext": "CITY"
      },
      {
        "date": [
          "2021-07-01T12:00:00.000+0000",
          "2021-08-01T12:00:00.000+0000",
          "2021-09-01T12:00:00.000+0000",
          "2021-10-01T12:00:00.000+0000",
          "2021-11-01T12:00:00.000+0000",
          "2021-12-01T12:00:00.000+0000"
        ],
        "numberTripScored": [
          113,
          211,
          124,
          142,
          80,
          28
        ],
        "numberTripTotal": [
          121,
          217,
          128,
          154,
          88,
          28
        ],
        "distance": [
          2267.7180000000017,
          4573.747,
          2218.388,
          2185.8519999999994,
          806.7309999999997,
          197.05700000000002
        ],
        "duration": [
          1910,
          3850,
          1881,
          1794,
          644,
          154
        ],
        "efficiency": [
          7.871681415929205,
          7.744075829383888,
          7.544354838709675,
          7.83169014084507,
          7.494999999999997,
          7.478571428571428
        ],
        "safety": [
          9.046902654867262,
          9.20189573459716,
          9.185483870967733,
          9.418309859154919,
          9.141250000000001,
          8.59642857142857
        ],
        "acceleration": [
          58,
          78,
          38,
          39,
          22,
          3
        ],
        "braking": [
          343,
          518,
          212,
          212,
          84,
          20
        ],
        "adherence": [
          130,
          197,
          78,
          92,
          59,
          14
        ],
        "co2Mass": [
          336.84577899999977,
          641.368706,
          334.6347719999998,
          314.93241699999993,
          104.88945299999997,
          27.954677
        ],
        "fuelVolume": [
          140.96994281717622,
          268.07102252765134,
          135.08108545217954,
          129.43151797657777,
          42.757278396226404,
          11.140481831489915
        ],
        "roadContext": "SUBURBAN"
      },
      {
        "date": [
          "2021-07-01T12:00:00.000+0000",
          "2021-08-01T12:00:00.000+0000",
          "2021-09-01T12:00:00.000+0000",
          "2021-10-01T12:00:00.000+0000",
          "2021-11-01T12:00:00.000+0000",
          "2021-12-01T12:00:00.000+0000"
        ],
        "numberTripScored": [
          82,
          113,
          54,
          88,
          41,
          9
        ],
        "numberTripTotal": [
          93,
          113,
          54,
          89,
          41,
          9
        ],
        "distance": [
          6308.032,
          12640.087999999998,
          3183.501000000001,
          5664.685000000001,
          910.8650000000004,
          343.577
        ],
        "duration": [
          3279,
          6450,
          1708,
          2899,
          497,
          180
        ],
        "efficiency": [
          8.793902439024391,
          9.051327433628316,
          8.446296296296296,
          9.073863636363638,
          8.717073170731707,
          8.822222222222223
        ],
        "safety": [
          9.297560975609757,
          9.572566371681411,
          9.535185185185187,
          9.706818181818182,
          9.473170731707318,
          9.744444444444445
        ],
        "acceleration": [
          55,
          72,
          29,
          32,
          14,
          0
        ],
        "braking": [
          137,
          183,
          77,
          89,
          25,
          6
        ],
        "adherence": [
          57,
          91,
          32,
          33,
          20,
          0
        ],
        "co2Mass": [
          1402.1347589999998,
          2605.033806000001,
          676.0954240000001,
          1149.3255900000008,
          159.27898699999986,
          56.64612400000001
        ],
        "fuelVolume": [
          574.1469587849707,
          1062.2589925764476,
          267.8366977716331,
          486.27898807905035,
          65.54292332140534,
          24.256905216330512
        ],
        "roadContext": "EXPRESSWAYS"
      }
    ]
  },
  "week": {
    "allContext": {
      "date": [
        "2021-06-28T12:00:00.000+0000",
        "2021-07-05T12:00:00.000+0000",
        "2021-07-12T12:00:00.000+0000",
        "2021-07-19T12:00:00.000+0000",
        "2021-07-26T12:00:00.000+0000",
        "2021-08-02T12:00:00.000+0000",
        "2021-08-09T12:00:00.000+0000",
        "2021-08-16T12:00:00.000+0000",
        "2021-08-23T12:00:00.000+0000",
        "2021-08-30T12:00:00.000+0000",
        "2021-09-06T12:00:00.000+0000",
        "2021-09-13T12:00:00.000+0000",
        "2021-09-20T12:00:00.000+0000",
        "2021-09-27T12:00:00.000+0000",
        "2021-10-04T12:00:00.000+0000",
        "2021-10-11T12:00:00.000+0000",
        "2021-10-18T12:00:00.000+0000",
        "2021-10-25T12:00:00.000+0000",
        "2021-11-01T12:00:00.000+0000",
        "2021-11-08T12:00:00.000+0000",
        "2021-11-15T12:00:00.000+0000",
        "2021-11-22T12:00:00.000+0000",
        "2021-11-29T12:00:00.000+0000",
        "2021-12-06T12:00:00.000+0000",
        "2021-12-13T12:00:00.000+0000"
      ],
      "numberTripScored": [
        0,
        51,
        109,
        136,
        156,
        164,
        232,
        132,
        94,
        113,
        131,
        106,
        105,
        98,
        79,
        112,
        113,
        149,
        136,
        42,
        29,
        27,
        27,
        20,
        8
      ],
      "numberTripTotal": [
        1,
        71,
        134,
        196,
        179,
        203,
        282,
        167,
        128,
        153,
        161,
        143,
        137,
        133,
        124,
        176,
        170,
        193,
        171,
        59,
        35,
        33,
        33,
        26,
        26
      ],
      "distance": [
        0.194,
        1078.518,
        2179.415,
        3207.1530000000016,
        6477.729299999998,
        4751.320799999998,
        7956.255900000002,
        3062.659400000001,
        2685.3299999999986,
        1751.5096000000003,
        3708.6576000000005,
        1115.3652000000002,
        1668.6825,
        1160.1313999999995,
        630.1827999999998,
        1499.1985000000002,
        2882.165500000001,
        4371.465100000001,
        1823.903099999999,
        431.48799999999994,
        239.14899999999997,
        129.122,
        161.8745,
        501.874,
        68.457
      ],
      "duration": [
        0,
        1271,
        2391,
        3295,
        5420,
        4248,
        7136,
        2975,
        2474,
        2651,
        3968,
        1875,
        2282,
        1900,
        1436,
        2192,
        2772,
        3878,
        2589,
        655,
        368,
        184,
        205,
        439,
        129
      ],
      "efficiency": [
        0,
        7.992156862745097,
        8.066055045871558,
        7.586764705882351,
        7.99423076923076,
        7.828048780487801,
        7.826724137931032,
        7.592424242424246,
        7.626595744680852,
        7.818584070796464,
        7.77862595419847,
        7.6113207547169806,
        7.642857142857143,
        7.76224489795918,
        7.491139240506328,
        7.839285714285713,
        7.974336283185841,
        7.956375838926174,
        7.710294117647059,
        7.423809523809522,
        7.555172413793104,
        7.703703703703703,
        7.933333333333333,
        7.725,
        7.0875
      ],
      "safety": [
        0,
        8.709803921568623,
        9.073394495412847,
        8.899264705882347,
        8.855769230769225,
        8.88231707317073,
        9.215086206896558,
        8.899242424242429,
        8.492553191489364,
        8.876991150442464,
        8.826717557251904,
        8.666037735849057,
        8.642857142857142,
        8.772448979591834,
        8.634177215189874,
        8.675000000000002,
        9.003539823008856,
        8.987248322147636,
        8.883823529411771,
        8.533333333333335,
        9.106896551724137,
        9.448148148148151,
        9.381481481481481,
        9.274999999999999,
        8.475
      ],
      "acceleration": [
        0,
        33,
        57,
        155,
        131,
        90,
        117,
        49,
        109,
        108,
        102,
        109,
        119,
        113,
        79,
        128,
        97,
        110,
        69,
        80,
        13,
        0,
        0,
        6,
        5
      ],
      "braking": [
        0,
        127,
        198,
        341,
        519,
        540,
        522,
        271,
        188,
        259,
        342,
        161,
        205,
        165,
        104,
        174,
        227,
        298,
        225,
        42,
        20,
        17,
        15,
        21,
        23
      ],
      "adherence": [
        0,
        94,
        132,
        228,
        274,
        299,
        335,
        172,
        185,
        176,
        193,
        145,
        160,
        173,
        149,
        171,
        138,
        214,
        213,
        77,
        22,
        9,
        15,
        22,
        10
      ],
      "co2Mass": [
        0.035502,
        202.37062700000007,
        367.675554,
        582.6147730000001,
        1375.7575751800005,
        857.4656207400004,
        1528.6994544399993,
        516.49674331,
        453.6870479999999,
        266.44257799,
        804.2188114599998,
        158.90049557,
        262.41791565999995,
        195.90260358999993,
        91.63034651999999,
        214.31428719999994,
        622.5501054500003,
        785.7914854999999,
        280.61663115000005,
        72.60372709999997,
        33.98811800000001,
        19.156135000000006,
        25.066039599999996,
        77.44295799999999,
        9.736675000000002
      ],
      "fuelVolume": [
        0.015302586206896554,
        85.08297415582308,
        149.33328287410538,
        245.6576343217306,
        571.5043132917373,
        357.13285753038394,
        627.3997317681849,
        209.08374744619385,
        178.27289566688358,
        108.74240639830836,
        316.995229687248,
        64.82921923266103,
        109.14648668692257,
        82.35944793571892,
        37.359642598633684,
        88.13479212166555,
        262.2184066060507,
        330.4424832319452,
        118.0835514993494,
        28.146136957059202,
        13.59009660540013,
        7.450558142485362,
        9.75598810214704,
        32.9591889785296,
        3.8490524625894604
      ],
      "phoneDistraction": [
        10,
        8.41033579103454,
        8.04382179255646,
        8.807671456888372,
        8.525465407362317,
        8.30271721294451,
        7.973494124486188,
        7.916284330001075,
        8.534523452470832,
        7.952293323024484,
        7.896362766784659,
        8.42516537642556,
        8.569962227467972,
        8.56662926477711,
        8.088236146746727,
        8.791363579578816,
        8.122860320991798,
        8.534145686411192,
        8.522843942927585,
        8.95596969320417,
        8.029945581924617,