my.calculateroute(object object)
基础库 或更高版本; 且 支付宝客户端 10.1.75 或更高版本; 若版本较低,建议采取 兼容处理 。
支小宝客户端 支持
安诊儿客户端 支持
主体: 企业支付宝小程序 、 个人支付宝小程序
计算路径。
根据起点和终点的地理位置,智能规划最佳出行路线,并计算不同出行方式下的行动距离和所需时间。
object object
查看示例
属性 | 类型 | 默认值 | 必填 | 描述 | ||||||||||||||||||||||||||||||||||
---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
searchtype | string | walk | 否 | 指定出行方式 |
||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||
startlat | number | - | 是 | 起点纬度 |
||||||||||||||||||||||||||||||||||
startlng | number | - | 是 | 起点经度 |
||||||||||||||||||||||||||||||||||
endlat | number | - | 是 | 终点纬度 |
||||||||||||||||||||||||||||||||||
endlng | number | - | 是 | 终点经度 |
||||||||||||||||||||||||||||||||||
throughpoints | array | - | 否 | 途径点,仅驾车规划有效 |
||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||
mode | number | - | 否 | 指定出行模式,仅在驾车模式和公交模式支持 |
||||||||||||||||||||||||||||||||||
|
||||||||||||||||||||||||||||||||||||||
city | string | - | 否 | 公交模式下必填。传参可填写城市中文名称或城市名称拼音。例如: |
||||||||||||||||||||||||||||||||||
destinationcity | string | - | 否 | 目的城市名称,公交跨城模式下必填。接受中文或汉语拼音,例如: |
||||||||||||||||||||||||||||||||||
success | function | - | 否 | 调用成功的回调函数 |
||||||||||||||||||||||||||||||||||
fail | function | - | 否 | 调用失败的回调函数 |
||||||||||||||||||||||||||||||||||
complete | function | - | 否 | 调用结束的回调函数(调用成功、失败都会执行) |
success 回调函数
参数
object res
查看示例
属性 | 类型 | 描述 |
---|---|---|
distance | number | 距离,单位为米 |
duration | number | 时间,单位为秒 |
success 回调的参数为 object,errorcode 属性为错误码。
错误码的详细信息请查看:
\
my.calculateroute({
searchtype: "bus", // 搜索类型:"walk", "bus", "drive", "ride", 默认值为walk
startlat: 30.257839, // 起点纬度
startlng: 120.062726, // 起点经度
endlat: 31.231706, // 终点纬度
endlng: 121.472644, // 终点经度
mode: 0, // 只有驾车模式和公交模式支持,可选,具体值见 mode 参数列表
city: 'hangzhou', // 公交模式下必填
destinationcity: 'shanghai', // 公交跨城模式下必填
success: (res) => {
console.log(res);
},
fail: (err) => {
console.log(err);
}
});
{
"distance": 2528365,
"duration": 95556,
"success": true
}
{
"errorcode": 3000,
"success": false
}
-
tip目前步行最多支持 100 公里的规划路线。