插件介绍

        腾讯位置服务路线规划插件 提供路线规划等功能,根据起终点,多种出行方式智能规划最佳出行路线及详情。开发者可以将路线规划插件嵌入到自建小程序的页面里,实现路线规划功能。

        请扫描二维码,在手机端体验路线规划插件Demo。


接入指引

        1、插件申请接入:

        在腾讯微信公众平台中, “微信小程序官方后台-设置-第三方服务-插件管理” 里点击 “添加插件”,搜索 “腾讯位置服务路线规划” 申请,申请后小程序开发者可在小程序内使用该插件。


        2、引入插件包: 路线规划appId: wx50b5593e81dd937a (点击浏览插件最新版本

// app.json
{
    "plugins": {
        "routePlan": {
        "version": "1.0.18",
        "provider": "wx50b5593e81dd937a"
        }
    }
} 

        3、设置定位授权:

        路线规划插件需要小程序提供定位授权才能够正常使用定位功能:

// app.json
{
    "permission": {
        "scope.userLocation": {
        "desc": "你的位置信息将用于小程序定位"
        }
    }
}

        4、使用插件:

        插件页面调用示例:

let plugin = requirePlugin('routePlan');
let key = '';  //使用在腾讯位置服务申请的key
let referer = '';   //调用插件的app的名称
let endPoint = JSON.stringify({  //终点
    'name': '吉野家(北京西站北口店)',
    'latitude': 39.89631551,
    'longitude': 116.323459711
});
wx.navigateTo({
    url: 'plugin://routePlan/index?key=' + key + '&referer=' + referer + '&endPoint=' + endPoint
});

相关参数说明

        插件页面参数

属性 类型 说明 是否必须传入
key string 调用路线规划插件需要申请腾讯位置服务的服务账号,key是开发者的唯一标识。申请key
referer string 调用来源,一般为您的应用名称,请务必填写!
endPoint string 终点
startPoint string 起点, 如果不传起点参数,则起点默认当前用户的真实定位
mode string 默认出行规划方式,目前支持三种方式:driving(驾车)、transit(公交)、walking(步行),不传则默认发起驾车规划
navigation number 值为1时,开启驾车导航功能;默认不开启此功能
themeColor string 插件主题色,16进制色值,默认是#427CFF

        startPoint, endPoint 说明

属性 类型 说明 是否必须传入
name string 位置名称
latitude number 纬度
longitude number 经度

插件错误处理

     插件页面传递参数错误处理说明:

  • 当必传参数没有传时,插件页面内容不展示
  • 当经纬度超出正确范围时,插件页面内容不展示

     页面错误码列表:

错误码 含义
-1000 网络请求失败
-1001 起终点参数错误
-1002 定位失败
-1003 定位授权失败

效果图

Head Head

这篇文章对您解决问题是否有帮助?

已解决
未解决