{"metadata":{"image":[],"title":"","description":""},"api":{"url":"/activity/list.json","auth":"required","examples":{"codes":[]},"method":"get","params":[{"name":"vehicleName","type":"string","default":"","desc":"Name of the vehicle (Either the vehicle name or the group name is required for the API call)","required":false,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de7"},{"name":"from","type":"string","default":"","desc":"Trip start timestamp in UTC with format mm-dd-yyyy HH:mm:ss","required":true,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de6"},{"name":"to","type":"string","default":"","desc":"Trip end timestamp in UTC with format mm-dd-yyyy HH:mm:ss","required":true,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de5"},{"name":"groupName","type":"string","default":"","desc":"Name of the group (Either the group name or the vehicle name is mandatory)","required":false,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de4"},{"name":"page","type":"int","default":"1","desc":"Page number of the paginated result","required":false,"in":"query","ref":"","_id":"5631b5acbddb091700ad5de3"}],"results":{"codes":[{"status":200,"name":"","code":"{  \n   \"activityResponseVO\":{  \n      \"code\":200,\n      \"message\":\"Success\",\n      \"reason\":\"\",\n      \"generatedAt\":\"Dec-16-2015, 10:10 PM UTC\",\n      \"currentPage\":1,\n      \"totalPages\":1,\n      \"activityReport\":[  \n         {  \n            \"vehicleName\":\"Nathen's car\",\n            \"vehicleId\": \"b0debf38-a8dd-e511-b684-616a28550141\",\n            \"groupName\":\"California\",\n            \"tsTime\":\"Dec-15-2015, 06:40 PM UTC\",\n            \"tsLat\":37.5026018,\n            \"tsLon\":-121.9772597,\n            \"tsAddress\":\"5788-5894 Auto Mall Parkway, Fremont, CA 94538, USA\",\n            \"teTime\":\"Dec-15-2015, 09:40 PM UTC\",\n            \"teLat\":37.5026018,\n            \"teLon\":-121.9772597,\n            \"teAddress\":\"5788-5894 Auto Mall Parkway, Fremont, CA 94538, USA\",\n            \"stopTime\":\"11450 mins\",\n            \"distanceTravelled\":\"12 Miles\",\n            \"tripTime\":\"180 mins\",\n            \"idleTime\":\"1110 mins\",\n            \"hardBrakingCounts\":100,\n            \"hardAccelerationCounts\":140,\n            \"overSpeedEvents\":200,\n            \"overSpeedDuration\":\"120 mins\",\n            \"maxSpeed\":\"93 MPH\",\n            \"averageSpeed\":\"43 MPH\",\n            \"reserved1\":null,\n            \"reserved2\":null,\n            \"reserved3\":null,\n            \"reserved4\":null\n         }\n      ]\n   }\n}","language":"json"}]},"settings":"559288b86bf22f170075b794"},"next":{"description":"","pages":[]},"title":"Trips","type":"endpoint","slug":"activity","excerpt":"This API provides you with granular information about trips taken by your fleet within the time period that is requested for. A trip in Azuga is defined as an ignition ON - Ignition OFF cycle. A trip response contains summarized information that can pertain to vehicle health, driving behavior, fuel consumption, etc.,","body":"[block:callout]\n{\n  \"type\": \"info\",\n  \"title\": \"Sample Request\",\n  \"body\": \"https://api.azuga.com/azuga-ws/v1/activity/list.json?vehicleName=Nathen's car&from=12-15-2015 00:00:00&to=12-15-2015 10:10:59&groupName=California\"\n}\n[/block]\n##API Response explanation\n[block:parameters]\n{\n  \"data\": {\n    \"h-0\": \"Field\",\n    \"h-1\": \"Description\",\n    \"0-0\": \"code\",\n    \"1-0\": \"message\",\n    \"2-0\": \"generatedAt\",\n    \"3-0\": \"reason\",\n    \"4-0\": \"currentPage\",\n    \"5-0\": \"totalPages\",\n    \"0-1\": \"API Status Code\",\n    \"1-1\": \"API Message (Success/Failure)\",\n    \"2-1\": \"API generation timestamp in UTC\",\n    \"3-1\": \"The reason for failure\",\n    \"4-1\": \"The current page\",\n    \"5-1\": \"The total number of pages in the result\",\n    \"6-0\": \"activityReport\",\n    \"7-0\": \"vehicleName\",\n    \"8-0\": \"groupName\",\n    \"9-0\": \"tsTime\",\n    \"10-0\": \"tsLat\",\n    \"11-0\": \"tsLon\",\n    \"6-1\": \"An array of activityreport objects\",\n    \"7-1\": \"Name of the vehicle\",\n    \"8-1\": \"Name of the group associated with vehicle\",\n    \"9-1\": \"Timestamp in UTC when the ignition turned ON\",\n    \"10-1\": \"Latitude coordinate of the location where the ignition turned ON\",\n    \"11-1\": \"Longitude coordinate of the location where the ignition turned ON\",\n    \"12-0\": \"tsAddress\",\n    \"13-0\": \"teTime\",\n    \"14-0\": \"teLat\",\n    \"15-0\": \"teLon\",\n    \"16-0\": \"teAddress\",\n    \"12-1\": \"Address of the location where the ignition turned ON\",\n    \"13-1\": \"Timestamp in UTC when the ignition turned OFF\",\n    \"14-1\": \"Latitude coordinate of the location where the ignition turned OFF\",\n    \"15-1\": \"Longitude coordinate of the location where the ignition turned OFF\",\n    \"16-1\": \"Address of the location where the ignition turned OFF\",\n    \"17-1\": \"Time between an Ignition OFF and the next Ignition ON\",\n    \"17-0\": \"stopTime\",\n    \"18-0\": \"distanceTravelled\",\n    \"19-0\": \"tripTime\",\n    \"20-0\": \"idleTime\",\n    \"18-1\": \"Total distance driven in that trip\",\n    \"19-1\": \"Total time between an Ignition ON and Igntion OFF\",\n    \"20-1\": \"Time period during which the vehicle was in the idle state\",\n    \"21-0\": \"hardBrakingCounts\",\n    \"22-0\": \"hardAccelerationCounts\",\n    \"23-0\": \"overSpeedEvents\",\n    \"24-0\": \"overSpeedDuration\",\n    \"21-1\": \"Number of hard breaking incidents. Hard breaking is the change in speed of 13-16 KMPH in one second (as long as the vehicle is already travelling at a speed of 29 KMPH).\",\n    \"22-1\": \"Number of sudden acceleration incidents. Sudden acceleration is the change in speed of 13-16 KMPH in one second.\",\n    \"23-1\": \"Number of speeding incidents. A speeding incident is counted when the vehicle exceeds the speed limit set in the speeding alert.\",\n    \"24-1\": \"Time during which the vehicle traveled at a speed greater than the one set in the speeding alert.\",\n    \"25-0\": \"maxSpeed\",\n    \"25-1\": \"Maximum speed attained during the trip\",\n    \"26-0\": \"averageSpeed\",\n    \"26-1\": \"Average speed during the trip\",\n    \"30-0\": \"reserved1\",\n    \"31-0\": \"reserved2\",\n    \"32-0\": \"reserved3\",\n    \"33-0\": \"reserved4\",\n    \"30-1\": \"Reserved variable for future use\",\n    \"31-1\": \"Reserved variable for future use\",\n    \"32-1\": \"Reserved variable for future use\",\n    \"33-1\": \"Reserved variable for future use\",\n    \"27-0\": \"userId\",\n    \"27-1\": \"The unique ID of the driver associated with the trip\",\n    \"28-0\": \"userName\",\n    \"28-1\": \"The name of the driver associated with the trip\",\n    \"29-0\": \"occupants\",\n    \"29-1\": \"An array of occupants associated with the trip\"\n  },\n  \"cols\": 2,\n  \"rows\": 34\n}\n[/block]","updates":["5f878574c86e160059a5052f"],"order":2,"isReference":true,"hidden":false,"sync_unique":"","link_url":"","link_external":false,"_id":"5631b5acbddb091700ad5de2","createdAt":"2015-10-29T05:59:08.818Z","editedParams":true,"editedParams2":true,"version":{"version":"1","version_clean":"1.0.0","codename":"","is_stable":true,"is_beta":false,"is_hidden":false,"is_deprecated":false,"categories":["559286c7c39c4b2d00127a72","55928a98c39c4b2d00127a83","5592bd7b9a68220d00f1c3db","5593dcaf0e82e81700334e25","5594342f0c33bd0d000595a3","563081713998420d00a509e4","5630941c7581b80d00c51c86","56309f4ff1c0580d00fac666","567923b8239fac0d00c7df25","573306dea6a9c40e00e13875","577a288fd051530e00f65563","579af3982b865e17005a4357","57ee06aa1e42900e0014a374","5951f49a63f39000159e7ef1","5951f4c563f39000159e7ef2","598951542a9dfc000fcacd40","5b3375cc98cb500003e4b363","5bbcd4e29667280003084100"],"_id":"559286c6c39c4b2d00127a71","createdAt":"2015-06-30T12:08:38.768Z","project":"55926c913735880d005f7c65","releaseDate":"2015-06-30T12:08:38.768Z","__v":18,"forked_from":"559286b6c39c4b2d00127a6e"},"__v":4,"category":{"sync":{"isSync":false,"url":""},"pages":["5592bda06bf22f170075b858","5593dbb99755e117000fbf3d","5593dc7a0e82e81700334e23","5631abc1fc94aa0d00e9b5e6","5631b5acbddb091700ad5de2","5631be58fc94aa0d00e9b5f5","56dfa9429cd22c0e00cab10c"],"title":"REPORTS","slug":"fleet-web","order":2,"from_sync":false,"reference":true,"_id":"5592bd7b9a68220d00f1c3db","createdAt":"2015-06-30T16:02:03.540Z","version":"559286c6c39c4b2d00127a71","__v":7,"project":"55926c913735880d005f7c65"},"project":"55926c913735880d005f7c65","parentDoc":null,"user":"55926c39cf9cdb2100b57022","githubsync":""}

getTrips

This API provides you with granular information about trips taken by your fleet within the time period that is requested for. A trip in Azuga is defined as an ignition ON - Ignition OFF cycle. A trip response contains summarized information that can pertain to vehicle health, driving behavior, fuel consumption, etc.,

Definition

{{ api_url }}{{ page_api_url }}

Parameters

Query Params

vehicleName:
string
Name of the vehicle (Either the vehicle name or the group name is required for the API call)
from:
required
string
Trip start timestamp in UTC with format mm-dd-yyyy HH:mm:ss
to:
required
string
Trip end timestamp in UTC with format mm-dd-yyyy HH:mm:ss
groupName:
string
Name of the group (Either the group name or the vehicle name is mandatory)
page:
integer1
Page number of the paginated result

Result Format


Documentation

[block:callout] { "type": "info", "title": "Sample Request", "body": "https://api.azuga.com/azuga-ws/v1/activity/list.json?vehicleName=Nathen's car&from=12-15-2015 00:00:00&to=12-15-2015 10:10:59&groupName=California" } [/block] ##API Response explanation [block:parameters] { "data": { "h-0": "Field", "h-1": "Description", "0-0": "code", "1-0": "message", "2-0": "generatedAt", "3-0": "reason", "4-0": "currentPage", "5-0": "totalPages", "0-1": "API Status Code", "1-1": "API Message (Success/Failure)", "2-1": "API generation timestamp in UTC", "3-1": "The reason for failure", "4-1": "The current page", "5-1": "The total number of pages in the result", "6-0": "activityReport", "7-0": "vehicleName", "8-0": "groupName", "9-0": "tsTime", "10-0": "tsLat", "11-0": "tsLon", "6-1": "An array of activityreport objects", "7-1": "Name of the vehicle", "8-1": "Name of the group associated with vehicle", "9-1": "Timestamp in UTC when the ignition turned ON", "10-1": "Latitude coordinate of the location where the ignition turned ON", "11-1": "Longitude coordinate of the location where the ignition turned ON", "12-0": "tsAddress", "13-0": "teTime", "14-0": "teLat", "15-0": "teLon", "16-0": "teAddress", "12-1": "Address of the location where the ignition turned ON", "13-1": "Timestamp in UTC when the ignition turned OFF", "14-1": "Latitude coordinate of the location where the ignition turned OFF", "15-1": "Longitude coordinate of the location where the ignition turned OFF", "16-1": "Address of the location where the ignition turned OFF", "17-1": "Time between an Ignition OFF and the next Ignition ON", "17-0": "stopTime", "18-0": "distanceTravelled", "19-0": "tripTime", "20-0": "idleTime", "18-1": "Total distance driven in that trip", "19-1": "Total time between an Ignition ON and Igntion OFF", "20-1": "Time period during which the vehicle was in the idle state", "21-0": "hardBrakingCounts", "22-0": "hardAccelerationCounts", "23-0": "overSpeedEvents", "24-0": "overSpeedDuration", "21-1": "Number of hard breaking incidents. Hard breaking is the change in speed of 13-16 KMPH in one second (as long as the vehicle is already travelling at a speed of 29 KMPH).", "22-1": "Number of sudden acceleration incidents. Sudden acceleration is the change in speed of 13-16 KMPH in one second.", "23-1": "Number of speeding incidents. A speeding incident is counted when the vehicle exceeds the speed limit set in the speeding alert.", "24-1": "Time during which the vehicle traveled at a speed greater than the one set in the speeding alert.", "25-0": "maxSpeed", "25-1": "Maximum speed attained during the trip", "26-0": "averageSpeed", "26-1": "Average speed during the trip", "30-0": "reserved1", "31-0": "reserved2", "32-0": "reserved3", "33-0": "reserved4", "30-1": "Reserved variable for future use", "31-1": "Reserved variable for future use", "32-1": "Reserved variable for future use", "33-1": "Reserved variable for future use", "27-0": "userId", "27-1": "The unique ID of the driver associated with the trip", "28-0": "userName", "28-1": "The name of the driver associated with the trip", "29-0": "occupants", "29-1": "An array of occupants associated with the trip" }, "cols": 2, "rows": 34 } [/block]

User Information

Try It Out

get
{{ tryResults.results }}
Method{{ tryResults.method }}
Request Headers
{{ tryResults.requestHeaders }}
URL{{ tryResults.url }}
Request Data
{{ tryResults.data }}
Status
Response Headers
{{ tryResults.responseHeaders }}