1、驾车算路
请求地址
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请求参数
名称 | 类型 | 描述 | 规则 | 是否必填 |
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 |
|