post https://services.azuga.com/reports/v3/reports/trip
This API allows the user to generate a detailed report on the trips taken by your fleet within the time period that is requested for.
{
"index": 0,
"desc": true,
"sortField": "tsTimeVehicleTimezone",
"filter": {
"orFilter": {
"vehicleId": [
"608f3aac-24a0-11ed-a5d3-174c38121eac"
]
},
"matchFilter": {},
"notEqualFilter": {
"teTime": null
}
},
"startDate": "2022-08-29T18:30:00.000Z",
"endDate": "2022-09-05T18:29:59.345Z",
"reportGroupByFilter": "listing",
"reportFilter": "trips_Default",
"browserTimezone": "America/Chicago",
"size": 100
}
API Response explanation
| Field | Description | Data Type |
|---|---|---|
| generatedAtInMillis | Time at which the API returns the result. The time is in milliseconds | Long |
| id | Unique identifier representing the trip record | String |
| groupName | Name of the group | String |
| groupId | Unique identifier representing the group | String |
| vehicleId | Unique identifier representing the vehicle | String |
| firstName | First name of the driver | String |
| lastName | Last name of the driver | String |
| fullName | Full name of the driver | String |
| tsTime | Trip start time in UTC timezone | String |
| tsTimeVehicleTimezone | Trip start time in vehicle timezone | String |
| customerId | Unique identifier representing the customer | Long |
| deviceId | Unique identifier representing the device | String |
| fuelTypeId | Unique identifier representing the fuel 1 = Gasoline 2 = Diesel 3 = Propane 4 = Hybrid | Byte |
| teTime | Trip end time in UTC timezone | String |
| tsAddress | Trip start address of the vehicle | String |
| teAddress | Trip end address of the vehicle | String |
| tsLocationStoreId | For internal Azuga use | String |
| teLocationStoreId | For internal Azuga use | String |
| teLandmarkName | Landmark name of the trip end location | String |
| tripEndPoint | Location coordinates of the trip end location x = Latitude y = Longitude | GeoJsonPoint |
| coordinates | Location coordinates of the trip end location in [lat,lon] format | Array of strings |
| type | Type of the coordinate of trip end location | String |
| tripStartPoint | Location coordinates of the trip start location x = Latitude y = Longitude | GeoJsonPoint |
| coordinates | Location coordinates of the trip start location in [lat,lon] format | Array of strings |
| type | Type of the coordinate of trip start location | String |
| vehicle | Name of the vehicle | String |
| vehicleTagIdList | Array of tags associated with the vehicle | List |
| tripNumber | Number of trips taken by the device | Integer |
| assetno | Asset number of the vehicle | String |
| tripDistance | Distance covered in the trip in kms | Double |
| maxSpeed | Maximum speed(in Kms) attained by the vehicle for the trip | Integer |
| averageSpeed | Average speed(in Kms) attained by the vehicle for the trip | Integer |
| fuelConsumed | Fuel consumed during this trip | Double |
| overSpeedDuration | Overspeed duration in seconds | String |
| overSpeedingEvent | Number of over speeding events | Integer |
| costPerMile | Cost per mile for the trip | Double |
| consumedAir | For Azuga internal use | Double |
| tripTime | Trip time during the trip in seconds | String |
| stopTime | Stop time during the trip in seconds | String |
| overNightStopTime | Over night stop time during the trip in seconds | long |
| idleTime | Idling time during the trip in seconds | String |
| idleTimeStr | Idling time during the trip in hh:mm:ss format | String |
| seatBeltCompliance | For Azuga internal use | int |
| lastTimezone | Last timezone of the vehicle during the trip | ZoneId |
| tzUpdatedAt | Last timezone updated timestamp | LocalDateTime |
| createDateTime | Trip record registered timestamp in Azuga server | LocalDateTime |
| hardcoreBrakingCount | Count of number of hardcore braking events | Short |
| hardBreakingCounts | Count of number of hard braking events | Integer |
| hardAccelerationCounts | Count of number of hard acceleration events | Integer |
| reverseCount | For Azuga internal use | Integer |
| startWithReverse | For Azuga internal use | boolean |
| startWithReverseStr | For Azuga internal use | String |
| postedSpeedingEvents | Count of number of posted speeding events | Integer |
| postedSpeedingDuration | Posted speeding duration in seconds | String |
| driverSeatBeltPercentage | Seatbelt percentage of the driver during the trip | Integer |
| driver | Name of the driver | String |
| tripStartDate | Trip start date in device's timezone | String |
| trackeeTypeId | Unique identifier representing the vehicle type. The following values are valid: 1- Car, 2- Truck, 3- School Bus, 4- Coach Bus, 5-Limousine, 6- Van, 7- Car(Sedan), 8- Car(Hatchback), 9- Car(LUV), 10- Car(MUV), 11-Car(SUV) | Integer |
| parentGroupId | Unique identifier representing the parent group | String |
| parentGroupName | Name of the parent group | String |
| licensePlateNo | License plate number of the vehicle | String |
| imei | IMEI number of the SIM associated with the device | String |
| initialOdometerSet | Initial odometer set for the vehicle | byte |
| deviceTypeId | Unique identifier representing the device type 1 = Datalogger 6 = Asset Tracker 11 = SafetyCam | Integer |
| seatBeltSupport | Boolean value representing whether the vehicle supports seatbelt data True = Supports seatbelt data False = Doesn't supports seatbelt data | boolean |
| odoSupport | Boolean value representing whether the vehicle supports odometer data True = Supports odometer data False = Doesn't supports odometer data | boolean |
| ioxSupportDevice | For Azuga internal use | boolean |
| pairingTypeId | For Azuga internal use | int |
| firmwareVersion | Firmware version of the device | String |
| simNumber | Sim number of the SIM associated with the device | String |
| driverId | Unique identifier of the driver | String |
| corneringEventCount | Count of number of cornering events | Integer |
| nearestLandmarkType | Name of the nearest landmark type | String |
| driverScore | Meta-data of the driver score | Double |
| speedingScore | Speeding score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| brakingScore | Braking score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| accelerationScore | Acceleration score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| idlingScore | Idling score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| slot | The date for which the driver score is calculated | String |
| score | Aggregated final score of the driver for the slot | Integer |
| driverSeatBeltPercentage | Percentage of time seatbelt worn by the driver | Integer |
| corneringScore | Cornering score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| distractedDrivingScore | Distracted driving score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| seatBeltScore | Seatbelt score of the driver for the trip day(based on slot field) Highest Score : 100 | Double |
| score | For Azuga internal use | Double |
| vin | Vehicle identification number(VIN) of the vehicle | Double |
| vinList | For Azuga internal use | List |
| encodedPolyline | For Azuga internal use | String |
| nextTripStartTime | Next trip time in UTC timezone | String |
| error | Displays the corresponding error message which occurs during API compilation. | List |