EV Routing
EV Routing
Service Introduction
Plan the eligible tram travel route plan based on the starting and ending coordinates and the current remaining power.
Interface address
https://lbs.navinfo.com/open-api/ev/v1/evdrive
Request method
GET
Request parameters
Please refer to the following table for the description of the request parameters of [Turbo Navigation Service]:
Parameter | Type | Meaning | Required | Default | Remarks |
---|---|---|---|---|---|
ak |
string |
Developer Key |
Yes |
Your ak |
If there is no key, please apply |
guid |
string |
device id |
No |
||
orig |
string |
starting latitude and longitude |
Yes |
Example: 116.30815, 40.056878 |
|
dest |
string |
End point latitude and longitude |
Yes |
Example: 116.30815, 40.056878 |
|
mid |
string |
Point coordinate string |
No |
Format: lon1, Lat1;lon2,lat2;......, support up to 12 |
|
inGb |
string |
Enter the coordinate system corresponding to the coordinates |
No |
g02 |
Default g02, |
outGb |
string |
Coordinate system corresponding to output coordinates |
No |
g02 |
Default g02 |
policy |
int |
driving strategy |
No |
0 |
0: default (road condition + time + mileage comprehensive consideration) |
soc |
double |
current remaining power |
is |
Unit: kW |
|
ca |
double |
How much charge is charged to the charging post |
Yes |
Unit: kW (the input value is less than the rated power of the car manufacturer) |
|
num |
int |
Return the number of recommended routes |
No |
1 |
Value range: 1<=num<=3, input The number will return the corresponding number of digits. For example, if 2 is entered, 2 lines will be returned. |
stime |
string |
Departure time |
No |
Current time |
Beijing time |
gpsdir |
int |
The head direction of the starting point |
No |
The direction of the front In order to form an angle with the north direction, this parameter is used to assist in judging the forward and reverse lanes where the starting point is located. This direction is adopted when sp>1.5 m/s and gpsdir is present. Gpsdir does not mean that you need to fill in the direction obtained from gps, you can fill in the corrected direction. |
|
radius |
int |
Location accuracy of the starting point |
No |
With gpsdir Field Usage |
|
sp |
double |
The speed of the starting vehicle |
No |
Use with the gpsdir field. When sp>1.5m/s and gpsdir exists, use the direction of gpsdir. |
|
adpy |
string |
Rescue area |
No |
Support 32 avoidances Areas, each area can have up to 16 vertices, and the coordinate points are separated by ";", and the areas are separated by "|". If it is a quadrilateral, there are four coordinate points, and if it is a pentagon, there are five coordinate points; the avoidance area cannot exceed 81 square kilometers, otherwise the avoidance area will fail. |
|
adroad |
string |
Avoid road names |
No |
Multiple Road, use; separation, example: Beiqing Road; Yongfeng Road |
|
pnum |
string |
License plate number used to determine whether to limit the line |
No |
Do not fill in the limit line, please enter the new energy license plate |
Response data
The description of the return parameters of the [Turbo Navigation Service] can be found in the following table:
Return Value | Type | Meaning | Remarks | ||||
---|---|---|---|---|---|---|---|
status |
int |
Return status |
See status code table for details |
||||
msg |
string |
Back to status description |
See status code table for details. |
||||
data |
object |
Return to driving route planning information |
|||||
orig |
string |
starting point coordinates |
|||||
dest |
String |
Endpoint coordinates |
|||||
total |
int |
number of programs |
|||||
routes |
array |
Drive and Transfer Program Set |
|||||
rid |
int |
Several paths Planning Plan |
|||||
dis |
int |
Travel Distance |
Unit: Meter |
||||
dur |
int |
Expected line consumption Time |
unit: second |
||||
rtoll |
int |
Toll Fees |
Units: yuan, -1:unknown |
||||
tlight |
int |
Number of traffic lights |
Unit: one |
||||
nms |
string |
Set of road names through driving |
The road names are separated by a number. |
||||
restr |
int |
Limited results |
0: represents that the limit line has been circumvented or unrestricted, ie The route has
no restricted road segment<1>: it means that there is no circumvention in the restricted
line, that is, the limited line of the line |
||||
steps |
array |
Driving route segmentation |
|||||
sid |
int |
Several subsections |
|||||
legid |
int |
the waypoint Serial number |
The path number is an integer starting from 0 and is used to identify the path to which the step belongs. For example, if the step belongs to the road from the starting point to the first waypoint, the legid is 0 |
||||
rinfo |
string |
Travel Description |
Example: “Take southwest for 44 meters and turn right into the main road” |
||||
nm |
string |
Road Name |
|||||
dis |
int |
this distance |
|||||
lonlats |
string |
The latitude and longitude string of this section |
is the coordinate point string of this section, in the format, such as: 116.481247, 39.990704; 116.481270, 39.990726 |
||||
ttype |
string |
Travel Direction |
Example: “Turn right and turn straight, go straight”, see Steering Action List |
||||
tmc |
array |
Segmented traffic details |
|||||
status |
int |
road condition index |
0 no road condition; 1 unblocked; 2 slow down; 3 congested; 4 very congested |
||||
dis |
int |
the length of this section |
Unit: Meter |
||||
ilonlat |
string |
The latitude and longitude of this section |
is: x, y, the value of lonlat is the starting and ending index of the array divided by semicolon. Example: 1,7 |
||||
charger |
object |
Segmented charging station information |
|||||
cid |
string |
charging station unique identifier |
|||||
nm |
string |
Charging station name |
|||||
Addr |
string |
Charging station address |
|||||
brand |
string |
Charging station Brand |
|||||
lonlat |
string |
Charging station latitude and longitude, longitude and latitude separated by "," |
Steering Action List:
Main Action List | |
---|---|
Go straight |
Left |
Right turn |
Left front |
Right front |
Left rear |
Right rear |
Keep left |
Keep right |
Go straight and lean left |
Go straight and turn right |
Left turn left and left |
Left turn and right |
turn right and lean left |
turn right and lean right |
Tune |
Service example
Vehicle Driving Range
Service Introduction
Displays the vehicle's range of travel in real time based on the remaining battery capacity and location of the current car.
Interface address
https://lbs.navinfo.com/open-api/ev/v1/evrange
Request method
GET
Request parameters
Please refer to the following table for the description of the request parameters for [Vehicle Range Service]:
Parameter | Type | Meaning | Required | Default | Remarks |
---|---|---|---|---|---|
ak |
string |
Developer Key |
Yes |
Your ak |
If there is no key, please apply |
guid |
string |
device id |
No |
||
lonlat |
string |
center point coordinates |
Yes |
Format: Longitude, Latitude |
|
soc |
double |
current remaining power |
Yes |
The unit is kilowatts and must be entered with a number greater than 0 |
|
inGb |
string |
Enter the coordinate system corresponding to the coordinates |
No |
g02 |
Default: g02, |
outGb |
string |
The coordinate system corresponding to the output coordinates |
No |
g02 |
Default: g02 |
Response data
Please refer to the following table for the return parameters of [Vehicle Range Service]:
Return Value | Type | Meaning | Remarks | |
---|---|---|---|---|
status |
int |
Return status |
Refer to the status code table |
|
msg |
string |
Back status description |
Refer to the status code table |
|
data |
object |
Return driving route planning information |
||
lonlats |
string |
coordinates |
116.37703,39.89826;116.37899,39.89847 |
Service example
Vehicle Driving Range V2.0
Service Introduction
Query the charging pile within the driving range of the tram according to the latitude and longitude and the remaining capacity of the train.
Interface address
https://lbs.navinfo.com/open-api/ev/v2/evrange
Request method
GET/POST
Request parameters
[Vehicle Driving Range V2.0] Please refer to the following table for the description of the request parameters:
Parameter | Type | Meaning | Required | Default | Remarks |
---|---|---|---|---|---|
ak |
string |
Developer Key |
Yes |
Your ak |
If there is no key, please apply |
guid |
string |
device id |
No |
||
lonlat |
string |
latitude and longitude |
Yes |
Format: XX.XXXX, XX.XXXX |
|
soc |
double |
remaining power |
Yes |
Unit: kw, must be greater than 0 |
|
kw |
string |
Charging Keys |
No |
||
language |
string |
Language Type |
No |
Value range: default ch |
|
psize |
int |
Number of records per page |
No |
15 |
Default 15, less than 1 by 1 processing, greater than 15 by 15 processing |
pnum |
int |
Current page |
No |
The first page is returned by default, less than 1 is processed by 1 and greater than the maximum page is processed by maximum page |
|
inGb |
string |
Input Coordinate System |
No |
g02 |
Default: g02 |
outGb |
string |
target coordinate system |
No |
g02 |
Default: g02 |
Response data
[Vehicle Driving Range V2.0] Please refer to the following table for returning results:
Return Value | Type | Meaning | Remarks | ||
---|---|---|---|---|---|
status |
int |
Return status |
See status code table for details. |
||
msg |
string |
return status Description |
See status code table for details. |
||
data |
object |
return results |
|||
total |
int |
Total number of results returned |
|||
provs |
object |
Return to province distribution |
temporarily return to space |
||
pois |
array |
return the charging pile information list |
|||
pid |
string |
POI unique identifier |
National unique |
||
nm |
string |
Name |
Return to English or Chinese according to the language field in the request parameter |
||
cpnm |
string |
Third-party data sources |
|||
cpid |
string |
Third-party unique identifier |
|||
dis |
double |
distance |
|||
addr |
string |
address |
Return to English or Chinese according to the language field in the request parameter |
||
tnm |
string |
Charging pile brand name |
Example: "State Grid" |
||
phone |
string |
Phone |
Multiple phone numbers are separated by "|": between area code and number Split with "-" |
||
lonlat |
string |
latitude and longitude |
|||
open24H |
string |
Open 24 hours |
0: Not investigated1: Yes |
Service example