开发 地图小程序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

业务签名

签名参数 provincenumber参考签名规则

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

业务签名

签名参数 provincenumber参考签名规则

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

返回顶部 示例中心 常见问题 智能客服 公众号
二维码