微信小程序插件 地图功能 一步拥有

插件介绍

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

接入指引

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 定位授权失败

效果图