Location:

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,
g02: National Survey Office (gcj02) coordinates
g84: coordinates acquired by the GPS device
gbd: Baidu coordinates

outGb

string

Coordinate system corresponding to output coordinates

No

g02

Default g02
g02: National Survey Office (gcj02) coordinates
gbd: Baidu coordinates

policy

int

driving strategy

No

0

0: default (road condition + time + mileage comprehensive consideration)
1: avoiding congestion
2: Do not take the high speed
3: High speed priority
4: Less charge
5: Avoid congestion & not go high speed
6: Avoid congestion & high speed priority
7: Dodge Congestion & Avoid Charges

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
(for the license plate limit line field)

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

Parameter Value Type Meaning Required Remarks

ak

your ak

string

Developer Key

Yes

Click to apply

guid

string

device id

No

orig

string

Starting point latitude and longitude

Yes

Example: 116.30815, 40.056878

dest

string

End point latitude and longitude

Yes

Example: 116.30815,40.156878

mid

String

Tour point coordinate string

No

Format: Lon1, lat1; lon2, lat2; ..., up to 12

policy

int

Driving Strategy

No

0: Default (road condition + time + mileage comprehensive consideration)
1: avoiding congestion
2: not taking high speed
3: high speed priority
4: Less Charges
5: Avoid Congestion & Do Not Take High Speeds
6: Avoid Congestion & High Speed ​​Priority
7: Avoid Congestion & Avoid Charges

soc

double

current remaining power

Yes

Unit: kW

ca

double

How much is the charging pile? Battery

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

Value range: 1<=num<=3. If you enter a number, it will return the corresponding number of digits. For example, if you enter 2, you will return 2 lines.

stime

string

Departure time

No

Default current time, Beijing time

adpy

string

Avoid area

No

Supports 32 escaping areas, each of which can have up to 16 Vertices, separated by ";", 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 name

No

Multiple roads, separated by: Example: Beiqing Road; Yongfeng Road

pnum

string

the license plate number used to determine if it is restricted.

No

Do not fill in the limit line, please enter the new energy license plate


                        

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,
g02: National Survey Office (gcj02) coordinates
g84: coordinates acquired by GPS device
gbd: Baidu coordinates

outGb

string

The coordinate system corresponding to the output coordinates

No

g02

Default: g02
g02: National Bureau of Surveying (gcj02) Coordinates gbd: Baidu Coordinates

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

Parameter Value Type Meaning Required Remarks

ak

your ak

string

Developer Key

Yes

Click to apply

guid

string

Device id

No

lonlat

string

center point coordinates

Yes

Format: Longitude, Latitude

soc

double

Current Remaining Power

Yes

Unit: kW

inGb

string

Enter the coordinate system corresponding to the coordinates

No

g02: National Bureau of Surveying (gcj02) Coordinates
g84: Coordinates acquired by GPS device
gbd: Baidu Coordinates

outGb

string

The coordinate system corresponding to the output coordinates

No

g02: National Bureau of Surveying (gcj02) Coordinates gbd: Baidu Coordinates


                        

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
ch: Chinese
en: English

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
g02: National Survey Office (gcj02) Coordinates
g84: GPS device acquisition coordinates
gbd: Baidu coordinates

outGb

string

target coordinate system

No

g02

Default: g02
g02: National Bureau of Statistics (gcj02) coordinates
gbd: Baidu coordinates

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

Parameter Value Type Meaning Required Remarks

ak

your ak

string

Developer Key

Yes

Click to 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 ch: Chinese en:English

inGb

string

Enter the coordinate system

No

Default: g02
g02: National Survey Office (gcj02) coordinates
g84: GPS device acquisition coordinates
gbd: Baidu coordinates

outGb

string

Target Coordinate System

No

Default: g02
g02: National Survey Bureau (gcj02) Coordinates gbd: Baidu Coordinates


                        
TOP