插件介绍
腾讯位置服务路线规划插件 提供路线规划等功能,根据起终点,多种出行方式智能规划最佳出行路线及详情。开发者可以将路线规划插件嵌入到自建小程序的页面里,实现路线规划功能。
请扫描二维码,在手机端体验路线规划插件Demo。
接入指引
1、插件申请接入:
在腾讯公众平台中, “微信小程序官方后台-设置-第三方服务-插件管理” 里点击 “添加插件”,搜索 “腾讯位置服务路线规划” 申请,审核通过后,小程序开发者可在小程序内使用该插件。
2、引入插件包: 路线规划appId: wx50b5593e81dd937a (点击浏览插件最新版本)
3、设置定位授权:
路线规划插件需要小程序提供定位授权才能够正常使用定位功能:
4、使用插件:
插件页面调用示例:
相关参数说明
插件页面参数
属性 | 类型 | 说明 | 是否必须传入 |
---|---|---|---|
key | string | 调用路线规划插件需要申请腾讯位置服务的服务账号,key是开发者的唯一标识。申请key | 是 |
referer | string | 调用来源,一般为您的应用名称,请务必填写! | 是 |
endPoint | string | 终点 | 是 |
startPoint | string | 起点, 如果不传起点参数,则起点默认当前用户的真实定位 | 否 |
navigation | number | 值为1时,开启驾车导航功能;默认不开启此功能 | 否 |
startPoint, endPoint 说明
属性 | 类型 | 说明 | 是否必须传入 |
---|---|---|---|
name | string | 位置名称 | 是 |
latitude | number | 纬度 | 是 |
longitude | number | 经度 | 是 |
插件错误处理
插件页面传递参数错误处理说明:
- 当必传参数没有传时,插件页面内容不展示
- 当经纬度超出正确范围时,插件页面内容不展示
页面错误码列表:
错误码 | 含义 |
---|---|
-1000 | 网络请求失败 |
-1001 | 起终点参数错误 |
-1002 | 定位失败 |
-1003 | 定位授权失败 |