Push Data

Introduction
The transfer of data collected by the SDK as well as driving indicators to a client server is a common need for users of the DriveQuant platform.
The information provided can be used for additional data processing, for archiving in databases or to display information on websites.
This is why DriveQuant offers the possibility to retrieve all the driving data collected by the mobile SDKs as well as all the driving indicators that result from our analyses. This is the purpose of the Push Data service.
Principle
The Push Data service sends the trip results right after it is completed and analyzed. The process is described below.
When the trip recording's started (manually or automatically), DriveQuant's mobile SDK saves GPS data locally on the user's phone.
When the driver has finished his trip, the SDK automatically stops recording and requests the trip analysis service hosted on the DriveQuant's platform.
At the end of the processing, which takes about 2 seconds, the results are returned to the SDK and can be displayed in the driver's mobile application.
At the same time, the push data can be enabled to transmit the results to your server.
Configuration
Trip data are sent as a POST request to a client URL. The URL must be provided to DriveQuant in order to set up and activate the push data service.
The body of the request is a JSON object with a set of fields that contain the driving scores organized by categories and the raw data collected on the user smartphone stored in tables. An example of data in JSON format is given at the end of this section.
It is mandatory to configure a response code. If the post is accepted, we expect a status code of 200 (OK). In case of failure, for any answer other than 200, the service will attempt to post the data again. The retry strategy is described below.
If the service returns a 200 HTTP code while the data has not been accepted by the client server, then, there will be no further attempt to send the data.
Security
The trip results may include driver’s private information (location, username, email). For this reason, the two following security measures are mandatory:
The URL provided must be HTTPS.
You must set up a BasicAuth header on every request. To do so, you can send us the credentials that need to be added to each request.
Optionally, we can provide IP addresses from which requests are performed in case you need to secure your endpoint with IP whitelisting.
Automatic Retry
DriveQuant will retry to push the trip data in case of a HTTP error. In order to avoid too many consecutive retries, the push data replay will be performed one time per day from the day after a fail, this until the trip has been accepted.
Sample Message
The data included in a message posted by the push data service can be configured. The data available in this stream depends on the analytics services you subscribe to.
For security and user privacy reasons, we may delete or hash sensitive data.
The example below gives an exhaustive overview of the data resulting from DriveQuant's trip analysis. Definition of all these variables can be found in the related section.
The Push Data API specification can be downloaded here in OpenAPI YAML format.
{
  "itinId": "5f580dad8e3669512e220434",
  "firstname": "Fistname",
  "lastname": "Lastname",
  "itineraryStatistics": {
    "tripDuration": 1175,
    "drivingDuration": 1061,
    "idlingDuration": 114,
    "drivingPercentage": 90.3,
    "idlingPercentage": 9.7,
    "distance": 8427.1,
    "speedMean": 25.8,
    "subdispNb": 44,
    "meteo": 1,
    "day": false,
    "weekDay": true,
    "transportationMode": 1
  },
  "ecoDriving": {
    "score": 8.9,
    "scoreAccel": 0.4,
    "scoreMain": 2,
    "scoreDecel": 0.6,
    "stdDevAccel": 2.294588,
    "stdDevMain": 1.1349647,
    "stdDevDecel": 3.270192,
    "energyClass": 0
  },
  "fuelEstimation": {
    "co2Mass": 10.314,
    "co2Emission": 1223.9,
    "fuelVolume": 3.839,
    "fuelConsumption": 45.555,
    "idleFuelVolume": 0.035,
    "idleFuelPercentage": 0.9,
    "idleFuelConsumption": 0.619,
    "idleCo2Emission": 1.7,
    "idleCo2Mass": 0.093,
    "engineTempStatus": true,
    "coldFuelVolume": 0
  },
  "safety": {
    "safetyScore": 8.6,
    "nbAdh": 0,
    "nbAccel": 2,
    "nbDecel": 4,
    "nbAdhCrit": 0,
    "nbAccelCrit": 0,
    "nbDecelCrit": 0
  },
  "advancedEcoDriving": {
    "ecoDrivingContext": [
      {
        "contextId": 0,
        "distance": 13.1,
        "duration": 37.5,
        "efficiencyScore": 11,
        "scoreAccel": 6,
        "scoreMain": 6,
        "scoreDecel": 6
      },
      {
        "contextId": 1,
        "distance": 9.2,
        "duration": 9.7,
        "efficiencyScore": 7.9,
        "scoreAccel": -0.2,
        "scoreMain": 2.7,
        "scoreDecel": 2.5
      },
      {
        "contextId": 2,
        "distance": 48.1,
        "duration": 39.6,
        "efficiencyScore": 9.3,
        "scoreAccel": 0,
        "scoreMain": 1.8,
        "scoreDecel": -0.8
      },
      {
        "contextId": 3,
        "distance": 29.7,
        "duration": 13.2,
        "efficiencyScore": 9.6,
        "scoreAccel": 1.2,
        "scoreMain": 1.4,
        "scoreDecel": 0.1
      },
      {
        "contextId": 4,
        "distance": 0,
        "duration": 0,
        "efficiencyScore": 11,
        "scoreAccel": 6,
        "scoreMain": 6,
        "scoreDecel": 6
      }
    ]
  },
  "advancedFuelEstimation": {
    "fuelEstimationContext": [
      {
        "contextId": 0,
        "distance": 13.1,
        "duration": 37.5,
        "co2Mass": 0,
        "co2Emission": 0,
        "fuelVolume": 0,
        "fuelConsumption": 0
      },
      {
        "contextId": 1,
        "distance": 9.2,
        "duration": 9.7,
        "co2Mass": 1.421,
        "co2Emission": 1840,
        "fuelVolume": 0.529,
        "fuelConsumption": 68.501
      },
      {
        "contextId": 2,
        "distance": 48.1,
        "duration": 39.6,
        "co2Mass": 4.732,
        "co2Emission": 1168,
        "fuelVolume": 1.761,
        "fuelConsumption": 43.466
      },
      {
        "contextId": 3,
        "distance": 29.7,
        "duration": 13.2,
        "co2Mass": 1.78,
        "co2Emission": 712,
        "fuelVolume": 0.663,
        "fuelConsumption": 26.504
      },
      {
        "contextId": 4,
        "distance": 0,
        "duration": 0,
        "co2Mass": 0,
        "co2Emission": 0,
        "fuelVolume": 0,
        "fuelConsumption": 0
      }
    ]
  },
  "advancedSafety": {
    "safetyContext": [
      {
        "contextId": 0,
        "distance": 13.1,
        "duration": 37.5,
        "nbAdh": 0,
        "nbAccel": 0,
        "nbDecel": 0,
        "nbAdhCrit": 0,
        "nbAccelCrit": 0,
        "nbDecelCrit": 0,
        "safetyScore": 11
      },
      {
        "contextId": 1,
        "distance": 9.2,
        "duration": 9.7,
        "nbAdh": 0,
        "nbAccel": 0,
        "nbDecel": 0,
        "nbAdhCrit": 0,
        "nbAccelCrit": 0,
        "nbDecelCrit": 0,
        "safetyScore": 11
      },
      {
        "contextId": 2,
        "distance": 48.1,
        "duration": 39.6,
        "nbAdh": 0,
        "nbAccel": 1,
        "nbDecel": 4,
        "nbAdhCrit": 0,
        "nbAccelCrit": 0,
        "nbDecelCrit": 0,
        "safetyScore": 8.1
      },
      {
        "contextId": 3,
        "distance": 29.7,
        "duration": 13.2,
        "nbAdh": 0,
        "nbAccel": 0,
        "nbDecel": 0,
        "nbAdhCrit": 0,
        "nbAccelCrit": 0,
        "nbDecelCrit": 0,
        "safetyScore": 10
      },
      {
        "contextId": 4,
        "distance": 0,
        "duration": 0,
        "nbAdh": 0,
        "nbAccel": 0,
        "nbDecel": 0,
        "nbAdhCrit": 0,
        "nbAccelCrit": 0,
        "nbDecelCrit": 0,
        "safetyScore": 11
      }
    ]
  },
  "tireWear": {
    "frontTireWear": 10847489,
    "rearTireWear": 6401268,
    "frontTireDistance": 2734,
    "rearTireDistance": 2734,
    "frontTireAutonomy": -1736,
    "rearTireAutonomy": -1155,
    "frontTireTotalWear": 273.97262798554533,
    "rearTireTotalWear": 173.08066308135625,
    "frontTireWearRate": 74.81017223623715,
    "rearTireWearRate": 46.94054225232605
  },
  "brakeWear": {
    "frontBrakePadWear": 12815959,
    "rearBrakePadWear": 9697077,
    "frontBrakeDistance": 2734,
    "rearBrakeDistance": 2734,
    "frontBrakeAutonomy": -1359,
    "rearBrakeAutonomy": -940,
    "frontBrakeTotalWear": 198.83528461330664,
    "rearBrakeTotalWear": 152.35945132858296,
    "frontBrakeWearRate": 62.634054809561576,
    "rearBrakeWearRate": 48.033887108109056
  },
  "safetyEvents": [
    {
      "time": 128,
      "longitude": 2.3450100421905518,
      "latitude": 48.897178649902344,
      "velocity": 29.519999313354493,
      "heading": -30.28284737723216,
      "elevation": 100.90441603887649,
      "distance": 542,
      "type": 3,
      "level": 1,
      "value": -2.2110000133514403
    },
    {
      "time": 178,
      "longitude": 2.3447699546813965,
      "latitude": 48.8974609375,
      "velocity": 21.959999656677248,
      "heading": -30.94285888671874,
      "elevation": 104.43676176525298,
      "distance": 562,
      "type": 2,
      "level": 1,
      "value": 2.0650000095367433
    },
    {
      "time": 373,
      "longitude": 2.3112900257110596,
      "latitude": 48.897300720214844,
      "velocity": 27.215999794006347,
      "heading": -120.17142508370532,
      "elevation": 80.04945300874256,
      "distance": 3389,
      "type": 3,
      "level": 1,
      "value": -2.029999923706055
    },
    {
      "time": 609,
      "longitude": 2.298949956893921,
      "latitude": 48.910831451416016,
      "velocity": 27.215999794006347,
      "heading": -13.371426827566935,
      "elevation": 73.20441255115327,
      "distance": 5106,
      "type": 3,
      "level": 1,
      "value": -1.9809999942779544
    },
    {
      "time": 700,
      "longitude": 2.298409938812256,
      "latitude": 48.91122055053711,
      "velocity": 17.603999519348143,
      "heading": -113.43142569405691,
      "elevation": 79.89168875558036,
      "distance": 5173,
      "type": 2,
      "level": 1,
      "value": 2.0009999632835385
    },
    {
      "time": 1065,
      "longitude": 2.2791600227355957,
      "latitude": 48.914581298828125,
      "velocity": 13.535999965667724,
      "heading": -56.05143345424102,
      "elevation": 72.77231852213542,
      "distance": 7445,
      "type": 3,
      "level": 1,
      "value": -1.9549999833106995
    }
  ],
  "endDate": "2020-09-08T22:59:08.000+0000",
  "itineraryData": {
    "endDate": "2020-09-08T22:59:08.000+0000",
    "startDate": "2020-09-08T22:39:33.000+0000",
    "departureCity": "Paris",
    "arrivalCity": "Bois-Colombes",
    "departureAddress": "66 Rue du Mont-Cenis, 75018 Paris, France\n",
    "arrivalAddress": "12 Rue Jean Jaures, 92270 Bois-Colombes, France\n"
  },
  "tripAdviceData": {
    "id": "5da5b749e3f4d636f1f3376e",
    "title": "Conseil de sécurité",
    "message": "<br>Soit par surprise ou à cause d'un <b>dépassement de votre vitesse</b>, vous avez freiné fort à plusieurs reprises. En respectant bien les <b>distances de sécurité</b>, vous freinerez naturellement beaucoup plus progressivement et éviterez ainsi tous risques de collisions.<br>",
    "theme": 0,
    "adviceEvaluation": null
  },
  "tripAdvicesData": [
    {
      "id": "5da5b749e3f4d636f1f3376e",
      "title": "Conseil de sécurité",
      "message": "<br>Soit par surprise ou à cause d'un <b>dépassement de votre vitesse</b>, vous avez freiné fort à plusieurs reprises. En respectant bien les <b>distances de sécurité</b>, vous freinerez naturellement beaucoup plus progressivement et éviterez ainsi tous risques de collisions.<br>",
      "messageId": "sfty-urban-day-dry-D030-brk-v01",
      "theme": "SAFETY"
    },
    {
      "id": "5da5b8c4e3f4d6370219ab95",
      "title": "Conseil d'éco-conduite",
      "message": "Vous pouvez progresser en adaptant votre conduite.<br>Votre accélération est un peu trop molle.<br>Eco-conduire ne signifie pas qu’il faut rouler moins vite ou ne pas accélérer. Au contraire, il est préférable d’avoir une accélération franche (mais pas brutale) pour atteindre rapidement une vitesse stabilisée. Pendant la phase d’accélération, il faut veiller à changer de rapport au bon moment pour ne pas atteindre des régimes moteur trop élevés.",
      "messageId": "eco-xurban000-accW-v01",
      "theme": "ECODRIVING"
    }
  ],
  "driverDistraction": {
    "nbUnlock": 3,
    "durationUnlock": 833,
    "durationPercentUnlock": 70.8936170212766,
    "distanceUnlock": 6310.60433282341,
    "distancePercentUnlock": 74.88464991305918,
    "score": 3.368998776822478
  },
  "distractionEvents": [
    {
      "time": 17,
      "latitude": 48.89249,
      "longitude": 2.34428,
      "velocity": 29.807999038696288,
      "heading": 1.1748559221958554,
      "elevation": 81.0330083937872,
      "distance": 35.009999454021454,
      "type": 1,
      "duration": 14
    },
    {
      "time": 31,
      "latitude": 48.8938,
      "longitude": 2.34507,
      "velocity": 35.460001373291014,
      "heading": 1.2568863922839444,
      "elevation": 99.13689604259673,
      "distance": 169.09000033140182,
      "type": 2,
      "duration": 29
    },
    {
      "time": 60,
      "latitude": 48.89558,
      "longitude": 2.34601,
      "velocity": 2.412000060081482,
      "heading": 0.8721659547898213,
      "elevation": 92.2051507859003,
      "distance": 379.22000074386597,
      "type": 1,
      "duration": 335
    },
    {
      "time": 395,
      "latitude": 48.89726,
      "longitude": 2.31117,
      "velocity": 3.203999948501587,
      "heading": 3.7993822803898816,
      "elevation": 77.79001290457589,
      "distance": 3557.960003912449,
      "type": 2,
      "duration": 296
    },
    {
      "time": 691,
      "latitude": 48.91127,
      "longitude": 2.29856,
      "velocity": 0,
      "heading": 1.8622665249308366,
      "elevation": 74.61759730747768,
      "distance": 5430.260011166334,
      "type": 1,
      "duration": 484
    }
  ],
  "vehicle": {
    "typeIndex": 201,
    "engineIndex": 2,
    "power": 239,
    "mass": 30000,
    "engineDisplacement": 6700,
    "gearboxIndex": 6,
    "consumption": 34,
    "autoGearboxNumber": 9,
    "vehicleId": "dq_5ee2853af5f3c800065dad1b",
    "declaredCarConsumption": -1,
    "carPassengers": 1,
    "dqIndex": "VO2016P0239T26N001",
    "frontTyreSize": "315/70/22.5",
    "rearTyreSize": "315/70/22.5",
    "length": 12,
    "width": 2.55,
    "height": 4,
    "engineCylinderNb": 6,
    "driveWheels": 6,
    "extraData": {
      "ptacTrailerTruck": "30000"
    },
    "statistics": {
      "distance": 12734.303399999995,
      "analyzedDistance": 2734.3033999999993,
      "estimatedYearDistance": 4672.413199999999
    }
  },
  "username": "firstname.lastname@drivequant.com",
  "sampledRoute": {
    "time": [
      0,
      2,
      3,
      4,
      5,
      6,
      7,
      8,
      9,
      10
    ],
    "latitude": [
      45.62335723672843,
      45.623368139493365,
      45.62336867322538,
      45.62337362297759,
      45.62337408573989,
      45.62337332628951,
      45.62336343500278,
      45.62335789767825,
      45.623347049167776,
      45.623343116556505
    ],
    "longitude": [
      9.036436987276641,
      9.036554626931467,
      9.036618892882325,
      9.036684940562326,
      9.036737078298932,
      9.03678237185695,
      9.036821983298651,
      9.03687064232028,
      9.036921295835153,
      9.036964849620116
    ],
    "velocity": [
      13.367696285247803,
      11.722453308105468,
      14.880634260177613,
      14.081130409240721,
      12.069839715957642,
      11.30790181159973,
      11.510074710845949,
      12.710905265808107,
      12.265743970870972,
      10.574239110946655
    ],
    "heading": [
      88.6883544921875,
      85.8247549874442,
      85.3304460797991,
      84.79776829310826,
      95.6096906389509,
      99.67218649727957,
      104.18837367466519,
      99.61619873046875,
      99.94925515311105,
      92.49613102504186
    ],
    "distance": [
      0,
      6.512474060058594,
      10.645983576774597,
      14.557408690452576,
      17.910141944885254,
      21.051225781440735,
      24.24846875667572,
      27.77927577495575,
      31.186426877975464,
      34.12371551990509
    ],
    "elevation": [
      261.07865067503315,
      263.16170145980067,
      264.46876375182165,
      265.17482192392066,
      265.6011230187922,
      265.8552860877242,
      266.14479973913876,
      266.4055992554478,
      266.9584649365664,
      267.1664905549506
    ]
  },
  "vehicleStops": [
    {
      "time": 1463.0009999275208,
      "latitude": 44.49311885374985,
      "longitude": 11.04536212606087,
      "heading": 141.82142291947196,
      "elevation": 129.91178960616958,
      "distance": 17762.39660484922,
      "stopDuration": 66
    }
  ],
  "smartphoneData": {
    "phoneModel": "Google Pixel 2 XL",
    "appBuildNumber": "355",
    "osVersion": "30",
    "osType": "Android",
    "sdkVersion": "1.6.0",
    "uid": null,
    "gpsDate": "2020-09-08T22:59:08.000+0000",
    "phoneDate": "2020-09-08T22:59:07.604+0000",
    "startMode": 1,
    "batteryPercent": 5,
    "tripCut": false,
    "bluetoothEnabled": true
  },
  "speedingStatistics": {
    "distance": 8426,
    "duration": 961,
    "speedingDistance": 848,
    "speedingDuration": 71,
    "score": 6.06,
    "speedLimitContexts": [
      {
        "speedLimit": 30,
        "distance": 2848,
        "duration": 372,
        "speedingDistance": 832,
        "speedingDuration": 70,
        "score": 0.06
      },
      {
        "speedLimit": 50,
        "distance": 3526,
        "duration": 476,
        "speedingDistance": 16,
        "speedingDuration": 1,
        "score": 8.12
      },
      {
        "speedLimit": 70,
        "distance": 2052,
        "duration": 113,
        "speedingDistance": 0,
        "speedingDuration": 0,
        "score": 10
      }
    ]
  },
  "metaData" : {
		"customerStringData" : "<CUSTOMER STRING DATA>",
		"customerJsonData" : "{\"customerTestNumber\" : 1, \"customerTestString\" : \"<CUSTOMER TEXT>\"}"
  }
} 
Android
Next - REST SERVICES
Driver
Last updated 2 months ago