开发 地图小程序OPENAPI 开发指南 开放生态 驾车计算到达时间

驾车计算到达时间 最后更新时间: 2024年08月30日

1、驾车算路

请求地址

请求URL

https://restwia.amap.com/api/v1/wia/map/direction/driving/route/plan

请求方式

POST

请求类型ContenType

application/json

url请求参数

名称

类型

描述

规则

是否必填

key

String

高德key

用户在高德地图官网申请Web服务API类型Key

是

openId

String

当前操作人

高德用户的开放id

是

bizToken

String

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

是

province

String

车牌号(省)

车牌号(省)。用汉字填入车牌省份缩写,用于判断是否限行,例如:京

是

number

String

车牌号(数字+字母)

number 填入除省份及标点之外,车牌的字母(需大写)和数字。用于判断限行相关,例如:NH1N11,支持6位传统车牌和7位新能源车牌

是

bizSign

String

业务签名

签名参数 province,number(参考签名规则)

是

sig

String

数字签名

请参考数字签名获取和使用方法

否

body请求参数

名称

类型

描述

规则

是否必填

origin

String

出发点

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

必填

destination

String

目的地

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

必填

routeOption

Number

算路偏好

1:高德推荐;2:躲避拥堵;3:高速优先;4:不走高速;5:少收费;6:大路优先;7:速度最快;8:躲避拥堵+高速优先;9:躲避拥堵+不走高速;10:躲避拥堵+少收费;11:少收费+不走高速;12:躲避拥堵+少收费+不走高速;13:躲避拥堵+大路优先;14:躲避拥堵+速度最快

必填

subPoints

String

途经点

经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔,最大数目:16个坐标点。如果输入多个途径点,则按照用户输入的顺序进行路径规划

cartype

Number

车辆类型

0:普通汽车(默认值)1:纯电动车2:插电混动车

必填

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
    String requestUrl = "https://restwia.amap.com/api/v1/wia/map/direction/driving/route/plan";
    //url 参数
    Map<String, Object> param1 = new HashMap<>();
    param1.put("key", "在高德开放平台申请的key");
    param1.put("bizToken", "在高德开放平台申请的bizToken");
    param1.put("openId", "当前操作人openId");
    param1.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", new String[]{"province", "number"}));
    param1.put("province", "车牌号(省)");
    param1.put("number", "车牌号(数字+字母)");
    Map<String, Object> param2 = new HashMap<>();
    param2.put("origin", "出发点");
    param2.put("destination", "目的地");
    param2.put("routeOption", "算路偏好");
    //途经点的经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔
    param2.put("subPoints", "途经点");
    param2.put("cartype", "车辆类型");//车辆类型 0:普通汽车(默认值)1:纯电动车2:插电混动车
    String s = MyHttpUtils.attachParamsToUrl(requestUrl, param1);
    String s1 = MyHttpUtils.postApplicationJson(s, JSONObject.toJSONString(param2));
    System.out.println("s1 = " + s1);
}

返回参数

名称

类型

描述

规则说明

code

Number

返回结果状态

data

Object

返回结果数据

totalTime

Number

预计行驶时间(终点)单位:秒

totalDistance

Number

行驶距离(终点)单位:米

subPointList

Array

途经点集合

arriveDistance

Number

行驶距离(途经点)单位:米

arriveTime

Number

预计行驶时间(途经点)单位:秒

lat

Double

经度

lon

Double

纬度

message

String

返回状态说明

成功时返回Successful,否则返回错误原因

result

Boolean

返回结果状态

true或false

version

String

版本

timestamp

Long

时间戳

requestId

String

请求id

2、货车接口

请求地址

请求URL

https://restwia.amap.com/api/v1/wia/map/direction/truck/route/plan

请求方式

POST

请求类型ContenType

application/json

url请求参数

名称

类型

描述

规则

是否必填

key

String

高德key

用户在高德地图官网申请Web服务API类型Key

是

openId

String

当前操作人

高德用户的开放id

是

bizToken

String

工作地图身份token

用户申请的工作地图身份token,一个企业一个token

是

province

String

车牌号(省)

车牌号(省)。用汉字填入车牌省份缩写,用于判断是否限行,例如:京

是

number

String

车牌号(数字+字母)

number 填入除省份及标点之外,车牌的字母(需大写)和数字。用于判断限行相关,例如:NH1N11,支持6位传统车牌和7位新能源车牌

是

bizSign

String

业务签名

签名参数 province,number(参考签名规则)

是

sig

String

数字签名

请参考数字签名获取和使用方法

否

body请求参数

名称

类型

描述

规则

是否必填

origin

String

出发点

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

必填

destination

String

目的地

经度在前,纬度在后,经度和纬度用","分割,经纬度小数点后不得超过6位

必填

routeOption

Number

算路偏好

1:高德推荐;2:躲避拥堵;3:高速优先;4:不走高速;5:少收费;6:大路优先;7:速度最快;8:躲避拥堵+高速优先;9:躲避拥堵+不走高速;10:躲避拥堵+少收费;11:少收费+不走高速;12:躲避拥堵+少收费+不走高速;13:躲避拥堵+大路优先;14:躲避拥堵+速度最快

必填

subPoints

String

途经点

经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔,最大数目:16个坐标点。如果输入多个途径点,则按照用户输入的顺序进行路径规划

cartype

Number

车辆类型

0:普通汽车(默认值)1:纯电动车2:插电混动车

必填

size

String

车辆大小。1:微型车,2:轻型车(默认值),3:中型车,4:重型车

height

String

车辆高度。单位:米

取值[0 – 25.5]米,默认 1.6 米

width

String

车辆宽度。单位:米

取值[0 – 25.5]米,默认 2.5 米

load

String

车辆总重。单位:吨

取值[0 – 6553.5]吨,默认 5 吨

weight

String

货车核定载重。单位:吨

取值[0 – 6553.5]吨,默认 10 吨

axis

String

车辆轴数。单位:个

取值[0 –255]个,默认 2个轴

示例代码(以java为例)

import com.amap.wia.openapi.test.lib.MyHttpUtils;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/demo-lib
import com.amap.wia.openapi.test.lib.SignatureHelper;//见 https://lbs.amap.com/api/wia-openapi/guide/tools/biz-token-sign
/*
 * 通用 import 内容等暂略
 */
public static void main(String[] args) {
    String requestUrl = "https://restwia.amap.com/api/v1/wia/map/direction/truck/route/plan";
    //url 参数
    Map<String, Object> param1 = new HashMap<>();
    param1.put("key", "在高德开放平台申请的key");
    param1.put("bizToken", "在高德开放平台申请的bizToken");
    param1.put("openId", "当前操作人openId");
    param1.put("bizSign", SignatureHelper.calcSign("在高德开放平台申请的bizSecret", new String[]{"province", "number"}));
    param1.put("province", "车牌号(省)");
    param1.put("number", "车牌号(数字+字母)");
    Map<String, Object> param2 = new HashMap<>();
    //body参数
    param2.put("origin", "出发点");
    param2.put("destination", "目的地");
    param2.put("routeOption", "算路偏好");
   //途经点的经度和纬度用","分割,经度在前,纬度在后,小数点后不超过6位,坐标点之间用";"分隔
    param2.put("subPoints", "途经点");
    param2.put("cartype", "车辆类型");//0:普通汽车(默认值)1:纯电动车2:插电混动车
    param2.put("size", "车辆大小");//1:微型车,2:轻型车(默认值),3:中型车,4:重型车
    param2.put("height", "车辆高度。单位:米");
    param2.put("width", "车辆宽度。单位:米");
    param2.put("load", "车辆总重。单位:吨");
    param2.put("weight", "货车核定载重。单位:吨");
    param2.put("axis", "车辆轴数。单位:个");
    String s = MyHttpUtils.attachParamsToUrl(requestUrl, param1);
    String s1 = MyHttpUtils.postApplicationJson(s, JSONObject.toJSONString(param2));
    System.out.println("s1 = " + s1);
}

返回参数

名称

类型

描述

规则说明

code

Number

返回结果状态

data

Object

返回结果数据

totalTime

Number

预计行驶时间(终点)单位:秒

totalDistance

Number

行驶距离(终点)单位:米

subPointList

Array

途经点集合

arriveDistance

Number

行驶距离(途经点)单位:米

arriveTime

Number

预计行驶时间(途经点)单位:秒

lat

Double

经度

lon

Double

纬度

message

String

返回状态说明

成功时返回Successful,否则返回错误原因

result

Boolean

返回结果状态

true或false

version

String

版本

timestamp

Long

时间戳

requestId

String

请求id

返回顶部 示例中心 常见问题 智能客服 公众号 高德开放平台公众号二维码 开放平台 扫码关注官方公众号