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 |