当前位置： 首页 > news >正文

腾讯位置商业授权微信小程序路线规划

news 2025/8/28 8:18:34

微信小程序JavaScript SDK

开发指南

路线规划

direction(options:Object)

        提供路线规划能力。

        1.驾车（driving）：支持结合实时路况、少收费、不走高速等多种偏好，精准预估到达时间（ETA）；

        2.步行（walking）：基于步行路线规划。

        3.骑行（bicycling）：基于自行车的骑行路线；

        4.公交（transit）：支持公共汽车、地铁等多种公共交通工具的换乘方案计算；

        注：坐标系采用gcj02坐标系

        路线规划功能仅适用于 jssdkv1.2 请前往首页下载最新版本SDK

options属性说明

属性类型必填说明
驾车，步行，骑行，公交路线规划公共参数：
modeString否路线规划选择，可选值：‘driving’（驾车）、‘walking’（步行）、‘bicycling’（骑行）、‘transit’（公交），默认：‘driving’
fromString是位置坐标，①String格式：String格式：lat<纬度>,lng<经度>（例：from: ‘39.984060,116.307520’）
②Object格式：
{
  latitude: 纬度,
  longitude: 经度
}
（例：from: {
  latitude: 39.984060,
  longitude: 116.307520
}）
默认是当前位置
toString是位置坐标，
①String格式：lat<纬度>,lng<经度>（例：location: ‘39.984060,116.307520’）
②Object格式：
{
  latitude: 纬度,
  longitude: 经度
}
（例：to: {
  latitude: 39.984060,
  longitude: 116.307520
}）
sigString否签名校验
开启WebServiceAPI签名校验的必传参数，只需要传入生成的SK字符串即可，不需要进行MD5加密操作
driving其他参数：
from_poiNumber否起点POI ID，传入后，优先级高于from（坐标）
示例:from_poi:4077524088693206111
headingNumber否[from辅助参数]在起点位置时的车头方向，数值型，取值范围0至360（0度代表正北，顺时针一周360度）
传入车头方向，对于车辆所在道路的判断非常重要，直接影响路线计算的效果
示例：heading:175
speedNumber否[from辅助参数]速度，单位：米/秒，默认3。 当速度低于1.39米/秒时，heading将被忽略
示例：speed:5
accuracyNumber否[from辅助参数]定位精度，单位：米，取>0数值，默认5。 当定位精度>30米时heading参数将被忽略
示例：accuracy:30
road_typeNumber否[from辅助参数] 起点道路类型，可选值：
0 [默认]不考虑起点道路类型
1 在桥上；2 在桥下；3 在主路；4 在辅路；5 在对面；6 桥下主路；7 桥下辅路
from_trackString否起点轨迹：
在真实的场景中，易受各种环境及设备精度影响，导致定位点产生误差，传入起点前段轨迹，可有效提升准确度。
优先级： 高于from参数
轨迹中的每个定位点包含以下信息：
1.纬度
2.经度
3.速度：GPS速度，单位 米/秒，取不到传-1
4.精度：GPS精度, 单位毫米，取不到传-1
5.运动方向： gps方向，正北为0, 顺时针夹角，[0-360)，获取不到时传-1
6.设备方向：正北为0, 顺时针夹角，[0-360)，取不到传-1
7.时间：定位获取该点的时间，Unix时间戳，取不到传0
参数格式：
1.轨迹中最多支持传入50个点。
2.每个点之间英文分号分隔，时间顺序由旧到新（第一个点最早获取，最后一个点最新得到）
3.每个点中的信息用英文逗号分隔，并按以下顺序传入：
纬度,经度,速度,精度,运动方向,设备方向,时间;第2个点;第3个点……
示例：
from_track:‘40.037029,116.316633,16,500,160,-1,1529491290;40.036634,116.317170,16,500,161,-1,
1529491300;40.035977,116.317663,16,500,159,-1,1529491310;40.035706,116.318328,16,500,160,-1,1529491320;
40.035090,116.319058,16,500,160,-1,1529491330;40.034852,116.319820,16,500,160,-1,1529491340’
to_poiNumber否终点POI ID（可通过腾讯位置服务地点搜索服务得到），当目的地为较大园区、小区时，会以引导点做为终点（如出入口等），体验更优。
该参数优先级高于to（坐标），但是当目的地无引导点数据或POI ID失效时，仍会使用to（坐标）作为终点
示例：to_poi:5371594408805356897
waypointsString否途经点，格式：lat1,lng1;lat2,lng2;… 最大支持30个
示例：waypoints:39.951004,116.571980
policyString否一、策略参数（以下三选一）
LEAST_TIME：[默认]参考实时路况，时间最短
PICKUP：网约车场景 – 接乘客
TRIP：网约车场景 – 送乘客
二、单项偏好参数
（可与策略参数并用，可多选，逗号分隔）
REAL_TRAFFIC：参考实时路况
LEAST_FEE：少收费
AVOID_HIGHWAY：不走高速
NAV_POINT_FIRST： 该策略会通过终点坐标查找所在地点（如小区/大厦等），并使用地点出入口做为目的地，使路径更为合理
示例：policy:'LEAST_TIME’或者policy:‘LEAST_TIME,AVOID_HIGHWAY’
plate_numberString否车牌号，填入后，路线引擎会根据车牌对限行区域进行避让，不填则不不考虑限行问题
示例：plate_number:京X309KX
transit其他参数：
departure_timeNumber否出发时间，默认使用当前时间，用于过滤掉非运营时段的线路
示例：departure_time:1509357129
policyString否1) 排序策略，以下三选一：
policy=LEAST_TIME：时间短（默认）
policy=LEAST_TRANSFER：少换乘
policy=LEAST_WALKING：少步行
policy=RECOMMEND：推荐策略，结合步行、换乘、耗时等多方面综合排序结果（与腾讯地图APP默认策略一致）
2) 额外限制条件
（可与排序策略配合使用，如：policy=LEAST_TRANSFER,NO_SUBWAY）：
NO_SUBWAY ，不坐地铁
ONLY_SUBWAY：只坐地铁
SUBWAY_FIRST：地铁优先
示例：policy:‘LEAST_TIME’ 或者 policy:‘LEAST_TIME,AVOID_HIGHWAY’

调用结果

        通过属性success, fail, complete的回调参数来接收调用结果

        success的回调参数可以有2个，第1个参数接收调用结果，第2个参数控制返回处理后的数据（非必须参数）,示例：success:function(res,data)

driving返回结果

名称类型必填说明
statusnumber是状态码，正常为0
messagestring是状态说明
resultobject是搜索结果
routesarray是路线方案
modestring是方案交通方式，固定值：“DRIVING”
tagsarray否方案标签，用于表明方案特点
示例：tags:[“LEAST_LIGHT”]
取值：
EXPERIENCE 经验路线
RECOMMEND 推荐路线
LEAST_LIGHT 红绿灯少
LEAST_TIME 时间最短
LEAST_DISTANCE 距离最短
distancenumber是方案总距离
durationnumber是方案估算时间（含路况）
restrictionobject否限行信息
statusnumber是限行状态码：
0 途经没有限行城市，或路线方案未涉及限行区域
1 途经包含有限行的城市
3 [设置车牌] 已避让限行
4 [设置车牌] 无法避开限行区域（本方案包含限行路段）
polylinearray是方案路线坐标点串（该点串经过压缩，解压请参考：polyline 坐标解压）
waypointsarray否途经点，顺序与输入waypoints一致 （输入waypoints时才会有此结点返回）
titlestring否途经点路名
locationobject否途经点坐标
latnumber否纬度
lngnumber否经度
taxi_fareobject否预估打车费
farenumber否预估打车费用，单位：元
stepsarray是路线步骤
instructionstring是阶段路线描述
polyline_idxarray是阶段路线坐标点串在方案路线坐标点串的位置
road_namestring否阶段路线路名
dir_descstring否阶段路线方向
distancenumber是阶段路线距离
act_descstring否阶段路线末尾动作：如：左转调头
accessorial_descstring否末尾辅助动作：如：到达终点

walking返回结果

名称类型必填说明
statusnumber是状态码，正常为0
messagestring是状态说明
resultobject是搜索结果
routesarray是路线方案
modestring是方案交通方式，固定值：“WALKING”
distancenumber是方案整体距离（米）
durationnumber是方案估算时间（分钟）
directionstring是方案整体方向
polylinearray是方案路线坐标点串（该点串经过压缩，解压请参考：polyline 坐标解压）
stepsarray是路线步骤
instructionstring是阶段路线描述
polyline_idxarray是阶段路线坐标点串在方案路线坐标点串的位置
road_namestring否阶段路线路名
act_descstring否阶段路线方向
distancenumber是阶段路线距离
act_descstring否阶段路线末尾动作

bicycling返回结果

名称类型必填说明
statusnumber是状态码，正常为0
messagestring是状态说明
resultobject是搜索结果
routesarray是路线方案
modestring是方案交通方式，固定值：“BICYCLING”
distancenumber是方案整体距离（米）
durationnumber是方案估算时间（分钟）
directionstring是方案整体方向
polylinearray是方案路线坐标点串（该点串经过压缩，解压请参考：polyline 坐标解压）
stepsarray是路线步骤
instructionstring是阶段路线描述
polyline_idxarray是阶段路线坐标点串在方案路线坐标点串的位置
road_namestring否阶段路线路名
act_descstring否阶段路线方向
distancenumber是阶段路线距离
act_descstring否阶段路线末尾动作

transit返回结果：

a.公交同城路线说明：

      路线根据交通工具的不同划分路段，如下图：

响应结果示例

 {"status":0,                                     //状态码，正常为0"message":"query ok",                           //状态说明"result":                                       //搜索结果{"routes":[                                  //路线方案//方案1*******************************************{"distance": 20123,                  //方案整体距离（米）"duration": 75,                     //方案估算时间（分钟）"duration_1m":75,"bounds": "40.014309000000004,116.285706,40.15301,116.318099",  //路线bounds，用于显示地图时使用"steps": [                          //具体方案，按交通工具的换乘分段{"mode": "WALKING",          //阶段路线交通方式（WALKING）"tag": "INTERNAL",    //返回值仅支持INTERNAL，代表站内换乘"distance": 760,            //阶段路线距离"duration": 11,             //阶段路线估算时间"direction": "东",          //阶段路线方向"polyline": [40.014634, 116.312869, -135, 160, -90, 100, -40, 80,... ...], //阶段路线点串(该点串经过压缩，解压请参考：polyline 坐标解压)"steps":                    //分段[{"instruction": "步行454米,左转进入中关村北大街",  //阶段路线描述"polyline_idx": [0, 31],//在polyline位置"road_name": "",        //路名"dir_desc": "东南",     //方向"distance": 454,        //距离"act_desc": "左转"      //末尾动作},{... ...}]},{"mode": "TRANSIT","lines": [                  //lines指同一段路，三种出行方式{"vehicle": "BUS",   //交通工具：公交车（BUS）"id": "7225403257131337003","title": "717",     //公交名"station_count": 7, //途径站数"price": 2,         //票价"destination":{"id":"5047847604295657152","title":"地铁西二旗站"     //终点站},"start_time":"05:30",         //首班车时间"end_time":"22:00",           //末班车时间"distance": 4560,             //距离"duration": 26,               //估算时间"polyline": [40.016124, 116.317759, 423, -241, 321, -214, 410, -323, 378, ... ...], //阶段路线坐标点串(该点串经过压缩，解压请参考：polyline 坐标解压)"geton": {                    //上车站"id": "10640224892745223512","title": "圆明园东门",     //上车站名"location": {             //上车站坐标"lat": 40.016124,     //纬度"lng": 116.317759     //经度}},"getoff": {                   //下车站"id": "5047847604295657152","title": "地铁西二旗站",  //下车站名"location": {             //下车站坐标"lat": 40.053226,     //纬度"lng": 116.304718     //经度}},"stations": [                        //途经站{"id": "17005795237013591570","title": "北京体育大学",      //途经站名"location": {                //途经站坐标"lat": 40.021902,        //纬度"lng": 116.314189        //经度}},{... ...}]}]},{"mode": "WALKING",                      //阶段路线交通方式（WALKING）"distance": 170,                        //阶段路线距离"duration": 3,                          //阶段路线估算时间"direction": "东",                      //阶段路线方向"polyline": [40.053263, 116.304691, 66, 158, 10, 50, 0, 50,... ...], //阶段路线点串(该点串经过压缩，解压请参考：polyline 坐标解压)"steps":                                //分段[{"instruction": "步行28米,左后转",    //阶段路线描述"polyline_idx": [0, 9],             //在polyline位置"road_name": "",                    //路名"dir_desc": "东北",                 //方向"distance": 28,                     //距离"act_desc": "左后转"                //末尾动作},{... ...}]},{"mode":"TRANSIT","lines":[{"vehicle": "SUBWAY",             //交通工具：地铁（SUBWAY）"id": "6754388447601197938","title": "地铁昌平线",            //地铁名"station_count": 4,              //经停站数"price": 5,                      //阶段路线所花费用"destination":{                  //地铁终点站（用于指示方向）"id":"5906130352814166149","title":"昌平西山口"},"start_time":"05:50",            //末班车时间"end_time":"23:05",              //末班车时间"distance":13569,"duration":27,                   //阶段路线估算时间"polyline": [40.052861, 116.306361, 1204, -672, 4714, -2712, 2866, -1811,  ... ...], //阶段路线坐标点串(该点串经过压缩，解压请参考：polyline 坐标解压)"geton": {                       //阶段路线上车站"id": "7710841192752225287","title": "西二旗",           //阶段路线上车站名"location": {                //阶段路线上车车站坐标"lat": 40.052861,        //纬度"lng": 116.306361        //经度},"exit":{"id":5331673106458131000,"title":"A1口(北口)"}},"getoff": {                         //阶段路线下车站"id": "5906130352814166149","title": "沙河",                //阶段路线下车站名"location": {                   //阶段路线下车站坐标"lat": 40.148216,           //纬度"lng": 116.288868           //经度},"exit":{"id":1125299843369869000,"title":"B1口(东口)"}},"stations":                         //经停站[{"id": "16352832121503765012","title": "生命科学园",       //经停站名"location": {               //经停站坐标"lat": 40.094756,       //纬度"lng": 116.294197       //经度}}{... ...}]}]}... ...]},//方案2******************************************{"distance":20009,"duration":85,"bounds":"40.014309000000004,116.285706,40.152254,116.318099","steps":... ...},//方案3*******************************************************************{"distance":22707,"duration":90,"bounds":"40.014309000000004,116.262268,40.15301,116.341639","steps":... ...}... ...]}
}

b.跨城说明：

      路线跨城支持城市间的铁路路线规划，如图（A城火车站）b - c（B城火车站） 路线规划方案； 市内路线（如图a - b或c - d）需要使用mode = TRANSIT_FOLDER节点进行二次查询得到。

响应结果示例

{"status":0,                                                         //状态码，正常为0"message":"query ok",                                               //状态说明"result":                                                           //搜索结果{"routes":[                                                      //路线方案//方案1*******************************************{"distance": 1337851,                                    //方案整体距离（米）"duration":288,                                         //方案估算时间（分钟）"bounds": "31.194238,116.378922,39.871814,121.320876",  //路线bounds，用于显示地图时使用"steps": [                                              //具体方案，按交通工具的换乘分段{"mode": "TRANSIT_FOLDER",                       //TRANSIT_FOLDER跨城公交，起点、途经、终点、市内部分，不会给出具体方案，需要通过此节点属性，进行二次查询得到；"distance": 4,                                  //阶段路线距离"direction": "北",                              //阶段路线方向"origin":{                                      //起点"location":{                                //起点坐标lat:"39.864989",                        //纬度lng:"116.379009"                        //经度}}"destination":{                                 //终点"location":{                                //终点坐标lat:"39.865021",                        //纬度lng:"116.379019"                        //经度}}},{"mode": "TRANSIT","lines": [                                      //lines指同一段路，三种出行方式{"vehicle": "RAIL",                      //交通工具：铁路（RAIL）"id": "13995286317411406868","station_count": 2,                     //经过站数"destination":{                         //目的地"id":"13136947784159182883","title":"上海虹桥"},"distance": 1318000,                    //距离"duration": 288,                        //估算时间"polyline": [39.865021, 116.379019, 58, -97, 1676, 3233, 5059, 37384, -1061, ... ...], //阶段路线坐标点串(该点串经过压缩，解压请参考：polyline 坐标解压)"geton": {                              //本段上车站"id": "17252417566629421518","title": "北京南",                   //上车站名"location": {                       //上车站坐标"lat": 39.865021,               //纬度"lng": 116.379019               //经度}},"getoff": {                             //本段下车站"id": "13136947784159182883","title": "上海虹桥",                 //下车站名"location": {                       //下车站坐标"lat": 31.194238,               //纬度"lng": 121.320876               //经度}},"stations": [                           //途经站（无途经站信息时可能为空数组）{"id": "17403057985479983304","title": "德州东站",             //途经站名"location": {                   //途经站坐标"lat": 37.409700,           //纬度"lng": 116.462110           //经度}},{... ...}}]}]},... ...]},//方案2******************************************{"distance":1337851,"duration":288,"bounds":"31.194238,116.378922,39.871814,121.320876","steps":... ...},//方案3*******************************************************************{"distance":1337851,"duration":295,"bounds":"31.194238,116.378922,39.871814,121.320876","steps":... ...}... ...]}
}

polyline 坐标解压

        导航路线点串coors（注：coors为polyline的坐标串）使用前向差分进行压缩，使用时解压方法如下：

var coors=[127.496637,50.243916,-345,-1828,19867,-26154];
for (var i = 2; i < coors.length ; i++)
{coors[i] = coors[i-2] + coors[i]/1000000}

注意事项

        起点、终点、途经点若不在道路上，会自动吸附到附近的道路上：

    示例（以驾车路线规划为例）

WXML 模板文件中添加组件：

<!--地图容器--><mapid="myMap"style="width: 100%; height: 300px;"longitude="{{longitude}}" latitude="{{latitude}}"scale='16'polyline="{{polyline}}"show-location></map><form bindsubmit="formSubmit"><!--输入起点和目的地经纬度坐标，格式为string格式--><!--起点输入框,同终点，不填默认当前位置--><label>起点坐标：<input style="border:1px solid #000;" name="start"></input></label><!--终点输入框,例：39.984060,116.307520--><label>终点坐标：<input style="border:1px solid #000;" name="dest"></input></label> <!--提交表单数据--><button form-type="submit">路线规划</button></form>

Javascript 关键代码片段(驾车、步行、骑行路线规划)：

// 引入SDK核心类
var QQMapWX = require('xxx/qqmap-wx.js');// 实例化API核心类
var qqmapsdk = new QQMapWX({key: '开发密钥（key）' // 必填
});//在Page({})中使用下列代码
Page({data: {polyline:[], // 声明polyline，存储路线数据// 展示地图当前位置latitude: 39.908764,longitude: 116.397524},//触发表单提交事件，调用接口formSubmit(e) {var _this = this;//调用距离计算接口qqmapsdk.direction({mode: 'driving',//可选值：'driving'（驾车）、'walking'（步行）、'bicycling'（骑行），不填默认：'driving',可不填//from参数不填默认当前地址from: e.detail.value.start,to: e.detail.value.dest, success: function (res) {console.log(res);var ret = res;var coors = ret.result.routes[0].polyline, pl = [];//坐标解压（返回的点串坐标，通过前向差分进行压缩）var kr = 1000000;for (var i = 2; i < coors.length; i++) {coors[i] = Number(coors[i - 2]) + Number(coors[i]) / kr;}//将解压后的坐标放入点串数组pl中for (var i = 0; i < coors.length; i += 2) {pl.push({ latitude: coors[i], longitude: coors[i + 1] })}console.log(pl)//设置polyline属性，将路线显示出来,将解压坐标第一个数据作为起点_this.setData({// 将路线起点展示在当前位置latitude:pl[0].latitude,longitude:pl[0].longitude,polyline: [{points: pl,color: '#FF0000DD',width: 4}]})},fail: function (error) {console.error(error);},complete: function (res) {console.log(res);}});}
})

Javascript 关键代码片段(公交路线规划，取第一条路线为示例)：

// 引入SDK核心类
var QQMapWX = require('xxx/qqmap-wx.js');// 实例化API核心类
var qqmapsdk = new QQMapWX({key: '开发密钥（key）' // 必填
});//在Page({})中使用下列代码
Page({data: {polyline:[], // 声明polyline，存储路线数据// 地图展示位置latitude: 39.908764,longitude: 116.397524},//触发表单提交事件，调用接口formSubmit(e) {var _this = this;//调用距离计算接口qqmapsdk.direction({mode: 'transit',//'transit'(公交路线规划)//from参数不填默认当前地址from: e.detail.value.start,to: e.detail.value.dest, success: function (res) {console.log(res);var ret = res.result.routes[0];var count = ret.steps.length;var pl = [];var coors = [];//获取各个步骤的polylinefor(var i = 0; i < count; i++) {if (ret.steps[i].mode == 'WALKING' && ret.steps[i].polyline) {coors.push(ret.steps[i].polyline);}if (ret.steps[i].mode == 'TRANSIT' && ret.steps[i].lines[0].polyline) {coors.push(ret.steps[i].lines[0].polyline);}}       //坐标解压（返回的点串坐标，通过前向差分进行压缩）var kr = 1000000;for (var i = 0 ; i < coors.length; i++){for (var j = 2; j < coors[i].length; j++) {coors[i][j] = Number(coors[i][j - 2]) + Number(coors[i][j]) / kr;}}//定义新数组，将coors中的数组合并为一个数组var coorsArr = [];for (var i = 0 ; i < coors.length; i ++){coorsArr = coorsArr.concat(coors[i]);}//将解压后的坐标放入点串数组pl中for (var i = 0; i < coorsArr.length; i += 2) {pl.push({ latitude: coorsArr[i], longitude: coorsArr[i + 1] })}//设置polyline属性，将路线显示出来,将解压坐标第一个数据作为起点_this.setData({latitude:pl[0].latitude,longitude:pl[0].longitude,polyline: [{points: pl,color: '#FF0000DD',width: 4}]})},fail: function (error) {console.error(error);},complete: function (res) {console.log(res);}});}
})

接口调用说明

    路线规划调用接口服务如下：

  • /ws/direction/v1/driving 路线规划:驾车
  • /ws/direction/v1/walking 路线规划:步行
  • /ws/direction/v1/transit 路线规划:公交
  • /ws/direction/v1/bicycling 路线规划:自行车

注：微信小程序JavaScript SDK通过对腾讯位置服务WebServiceAPI接口进行封装而形成，因此和直接调用WebSerivceAPI的限制是等同的，
具体可参考：腾讯位置服务WebServiceAPI配额及使用限制

文章来源：腾讯位置商业授权微信小程序路线规划-腾讯地图代理商

http://www.xdnf.cn/news/1374985.html

相关文章：

  • 【开源工具】基于Flask与Socket.IO的跨平台屏幕监控系统实战（附完整源码）
  • 前端性能优化：从指标监控到全链路落地（2024最新实战指南）
  • 论文阅读：Gorilla: Large Language Model Connected with Massive APIs
  • 深度学习入门：神经网络基础知识
  • lesson47：Linux常用软件使用指南：远程连接、远程拷贝、Vim与Nginx
  • VESA时序检测模块设计verilog实现
  • Ubuntu 24 Server 如何设置无线网络
  • imx6ull-驱动开发篇45——Linux 下 SPI 驱动框架简介
  • d435i相机读取镜头内参和相对之间的外参
  • 艾体宝新闻 | 98%好评率！KnowBe4 连续5年蝉联第一，现开放免费钓鱼测试等你解锁
  • 内网应用如何实现外网访问？外地通过公网地址访问内网服务器的设置方法
  • 遗传算法：模拟自然选择的优化智慧
  • Spring Boot项目集成日志系统使用完整指南
  • 欧洲数字化养殖平台 Herdwatch 借力 Iceberg + StarRocks 提升分析能力
  • 嵌入式开发学习 C++：day01
  • 动态规划：硬币兑换（有趣）
  • LeetCode - 739. 每日温度
  • 线性回归原理推导与应用（十一）：多重共线性
  • 获取服务器指标的信息
  • bin log 和 redo log有什么区别
  • Mybatis总结
  • 【如何解决Java中的ClassCastException类转换异常问题】
  • 基于Matlab结合肤色检测与卷积神经网络的人脸识别方法研究
  • 基于MATLAB/Simulink的单机带负荷仿真系统搭建
  • 分布式2PC理论
  • 使用 html2canvas + jspdf 实现页面元素下载为pdf文件
  • UE5 查找组件
  • 云原生安全架构设计与零信任实践
  • 预测模型及超参数：1.传统机器学习：SVR与KNN
  • 工业网络安全：保护制造系统和数据