Vehicle Travel Detail With Distance

It gives the travel details of the vehicle including the distance and also the direction of the vehicle.

GEThttps://yourdomain.com/webservice?token=getVehicleTravelDetailWithDistance&username=XX&password=XX&vehicle_no=XX&from_date=dd-MM-yyyy HH:mm:ss&to_date=dd-MM-yyyy HH:mm:ss

Request Parameters

Parameter	Type	Value	Description
username	String		It is mandatory
password	String		User's password.It is mandatory
from_date	String		from date from which user want to get details of the vehicle.
to_date	String	dd-MM-yyyy HH:mm:ss	Date up to which user want to get data.It is Mandatory.
vehicle_no	String	dd-MM-yyyy HH:mm:ss	vehicle number which user want to get details.It is Mandatory

Description

Request

Acceptance Criteria

Licence must not be expired.
You can not request a data for duration of more then 3 hour.

Response

Key	Format	Mandatory	Description
plateNumber	String	yes	Vehicle number
serverTimeStamp	Date and time	yes	Server timestamp
eventTimeStamp	Date and time	yes	Event timestamp
speed	int	yes	Vehicle speed
Latitude	double	yes	Latitude of Vehicle location
Longitude	double	yes	Longitude of vehicle location
direction	angle	yes	Vehicle direction
status	string	yes	Stopped / running
engine	string	yes	on/off
deviceImeiNo	String	yes	Vehicle number
distance	String	yes	Total distance covered

Error Code	Status
0	FAIL
1	SUCCESS

Sample Response

SUCCESS

{
  "result": 1,
  "data": {
    "plateNumber": "XXXXXXX",
    "serverTimeStamp": "2020-08-2500: 53: 37.851379",
    "eventTimeStamp": "2020-08-2500: 53: 37.851379",
    "Speed": 20,
    "Latitude": 53.4627667596,
    "Longitude": 10.049567988756,
    "direction": 35,
    "status": "running",
    "engine": "ON",
    "deviceImeiNo": "4785237865472356",
    "distance": "50"
  }
}

FAIL

{
"result":0,
   "message":"Incorrect username or password"
}

FAIL

{
"result":0,
   "message":"License is expired for user"
}

FAIL

{
"result":0,
   "message":"Vehicle not found"
}

FAIL

{
"result":0,
   "message":"You do not have rights of this vehicle"
}

FAIL

{
"result":0,
 "message":"Vehicle license is expired"
}

FAIL

{
"result":0,
   "message":"You can not request data for duration of more than 3 hour."
}

FAIL

{
    "result": 0,
    "message": "Invalid parameter"
}

Response codes

Code	Description

Error codes

Code	Name	Description