室内地图导览插件


版本号:1.2.14

插件介绍

腾讯位置服务为小程序开发者提供“室内地图导览”插件,旨在为商场、展馆、机场等大规模室内环境,提供精准的室内地图渲染、室内定位获取、室内点位搜索、室内选点功能。该插件仅提供了室内图导览能力,若有室内导航诉求,则按需接入“室内外一体化步导”、“室内AR导航”(注:导航播报能力,需自行接入)。

该插件为高级服务,插件使用需配合室内图采集,如有需求可提交商务合作购买。

接入指引

1、申请key

使用腾讯位置服务微信小程序插件需提前申请key,以作为唯一身份认证标识,开通指南如下:
1)登录腾讯位置服务官网,完成企业账号注册
2)进入“控制台->应用管理->我的应用“,点击”创建应用“,勾选如下信息,并提交

2、接口额度购买

室内地图导览插件,引用了如下高级接口服务,请前往腾讯位置服务官网,进入“控制台->配额管理->key额度“,搜索如下接口,并根据小程序流量情况购买合适的配额。

接口 服务路径
室内搜索 /ws/indoor/v1/search
室内关键词输入提示 /ws/indoor/v1/suggestion
室内地图选点 /ws/indoor/v1/explore
室内导览:室内导览 /ws/native/indoorguide
地点搜索 /ws/place/v1/search

3、插件申请接入

微信公众平台中, “微信小程序官方后台-设置-第三方服务-插件管理” 里点击 “添加插件”,搜索 “室内地图导览” 申请,审核通过后,小程序开发者可在小程序内使用该插件。

4、开通室内权限

完成如上步骤后,开发者请提供key和小程序AppID,由腾讯位置服务团队为其开通室内图权限(室内图制作、采集需额外提交商务合作)。

5、部署定位设备

室内定位依赖蓝牙等设备的安装,开发团队请部署好定位设置后,按照《腾讯室内图&蓝牙供应商合作方案V1.1》要求,提交蓝牙成果数据。

6、引入插件包

在您的小程序app.json中引入相关插件

// app.json
{
  "plugins": {
     //室内saas小程序插件
   "indoorsaas": {
      "version": "1.2.14",//请使用线上最新版本号
      "provider": "小程序AppID"
   }}
}

7、初始化插件

在小程序onLaunch事件中,初始化插件: 以工体中心小程序初始化为例:

const plugin = requirePlugin("indoorsaas")
//app.js
App({
    onLaunch: function(options) {
        plugin.init({
          appId: 'wx0d079afa73512c8a', // 小程序appID
          mapKey: 'AAZBZ-AX2OJ-GOIFB-XXXXX-XXXXX-XXXXX', // 地图Key
          openId: 'oU9gE5Bd0oBu4F1N_uFLojxiGbog', // openId, 外部小程序获取后传入,用于收藏使用
          appName: '工体导航', //
          appDesc: '北京工人体育场导航小程序',
          isSimu: false, // 小程序导航模式-是否模拟导航
          latitude: 39.93099004311471,  // 地图中心点
          longitude: 116.4472766901456,
          scale: 17.5,             // 缩放比例
          buildingId: '1100001008352',   // 建筑ID
          buildingName: '北京工人体育场',
          northeast: { latitude: 39.93373530129992, longitude: 116.44935981234141 }, // 列表视图时地图范围
          southwest: { latitude: 39.926649016204664, longitude: 116.4450920871634 },
          isRecordCarNum: true,  // 列表视图时地图范围
          topFunctionSetting: {  // 地图页功能区设置
            isShowFavorites: true,
            isShowReport: true,
            isShowGuide: false,
          },
          colorPrimary: '#F26A37',
          lightColorPrimary: '#fef0eb',
          navbarSetting: {
            backButtonType: 'arrow-horizontal',
            backgroupImageType: 'sport',
          }
        });
    }
})

8、业务参数设置及插件页跳转应用

参考室内地图导览小程序插件文档根据室内图需求,设置对应参数

效果图

本页内容