# 开发 \| 谁说 LBS 小程序开发难？前端女王大人手把手教你

- 作者：知晓程序
- 发布时间：2017-08-25 20:00
- 原文：https://www.ifanr.com/minapp/898135

![](https://s3.ifanr.com/wp-content/uploads/2017/07/minapp-dev-final-feature.jpg)

文 \| 祝莎莎

了解小程序的人都知道， 小程序带有一个地图（`map`）组件。

利用它，你可以在小程序中调用一个功能完整的地图，让小程序里所展示的地点更直观、更精确。

那么，**小程序应该如何正确地使用地图组件呢？**

今天，知晓程序（微信号 zxcx0101）特意邀请了爱范儿前端女王大人。接下来，她会以「TIT 智慧园区」小程序为例，向你介绍小程序 `map` 组件的使用心得。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/zss.jpeg)

关注「知晓程序」微信公众号，在后台回复「**开发**」，获取小程序全套开发教程。

### 诞生背景

爱范儿所在的 T.I.T 创意园，前身是建于 1956 年的广州纺织机械厂，园区占地面积九万多平方米，园内绿树成荫、鸟语花香，良好的环境吸引了诸多企业的入驻，包括：微信总部、Mo&amp;Co、铂涛孵化器等近百家企业，和许多特色商铺。

TIT 园区的内部环境，有两大特点：

- 面积广：在园区内走一圈，需要半小时。
- 小路多：园内小径交错，难以辨识。

这两大特点，**让对园区环境不熟悉、甚至来往多次的人，依然难以摸清道路。**

爱范儿作为首批小程序内测机构，在小程序开发方面积累大量实战经验。**自然地，我们就与所在园区的合作，推出了「TIT 智慧园区」小程序。**

这种基于商圈的 LBS 地理展示及导航功能的小程序，有着广泛的应用场景，如：城市商圈、高校、科技园区等等，会为用户带来极大便利，也为小程序开发者带来更多机会。

### 主要功能

1. 信息展示：按照企业分类，查看分类下的企业，并且会在地图上标记出相应企业的位置。
2. 步行导航：用户可导航到自己想去的目的地，彻底解决再进入园区后兜圈子的问题。
3. 停车找车：开车的访客，可以在停好车后记录停车点，取车时打开小程序就可以看到自己上次的停车位置，并导航到停车地点。

### 开发设计

从小程序前端开发角度来说：

- WXML 是微信官方提供的一套标记语言
- WXSS 为 CSS 子集
- 至于脚本逻辑语言，则是前端工程师熟知的 JavaScript

即便在小程序中 JavaScript DOM API 无法使用，但整体而言，开发小程序前端部分所需的技术栈还是我们所熟知的那套东西。

后端则接入了知晓云 BaaS 服务，步入快速开发小程序模式。

#### 1. 数据表设计

**使用知晓云后台数据模块，可以轻松创建业务所需的数据表。**

这里重点列出两张数据表，以及表内关键字段。在后台成功创建数据表后，下载最新版知晓云 SDK ，**使用获取到的 `tableID`，就可以对数据表执行操作。**

关注「知晓程序」微信公众号，在后台回复「**LBS**」，获取知晓云 SDK 下载地址。

首先是商户信息表 `merchant`，它的 `tableID` 为 `12`。

该表关键字段如下:

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-sheets-1.png)

然后就是停车记录表 `parking_ticket`，它的 `tableID` 为 `13`。

关键字段如下：

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-sheets-2.png)

#### 2. 前端设计

**布局设计**

合理布局解决地图组件层级高于 WebView 层级问题：我们尝试使用 Android 设备，开启开发者选项中 Show layout bounds（显示布局格子）选项，再进入智慧园区小程序。

我们所看到的界面如下图所示。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-layout.jpg)

Android 开发者选项中 show layout bounds 是一个很常用的功能，开启后可以知道界面上哪部分是用 Native 实现、哪部分是用 Hybrid web 实现。

从截图中可以得出，**小程序的 `map` 组件是使用 Native 来实现的，它并不是一个 WebView 容器**，而原生组件的特性是它总会覆盖在 WebView 组件之上。

所以对于导航页的布局，我们按照如下代码来设计：

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-layout-2.jpg)

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-layout-codes.jpg)

利用 `page` 页面**对 `map` 组件采用绝对定位、高度自适应的方法**，实现 WebView 组件不被地图组件遮盖、地图组件又可随 WebView 组件尺寸，动态改变高度。

此外，**当用户点击地图上标记的停车位置时，需求是要以弹窗形式询问用户下一步操作**。

由于开发上无法实现在原生的 map 组件上弹出 WebView 蒙层，**结合产品特点，我们当时选用了一种比较简单可操作的实现**。

即，当需要在 map 组件之上弹出蒙层时：

- 隐藏 map 组件和相关的不需要的 WebView 元素（比如顶部的分类条和地步的商户列表）。
- 使用一张以园区中心点定位的地图图片来作为背景元素。
- 在该背景图片上覆盖 WebView 弹窗。

等用户操作结束后再隐藏图片，恢复 map 和相关组件的展示。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-carparking.jpg)

其实，**解决该问题的更好的办法，是通过使用小程序的画布 Canvas 组件来实现**，因为画布也是使用 Native 组件来实现的。

具体方式是：先使用 Canvas 绘制一个蒙层，再在 Canvas 蒙层上绘制 Canvas 弹窗。

需要注意的是，**弹窗中的小车图标，无法使用网络图片绘制，请将该图片放在本地资源文件夹中。**感兴趣的同学可以 clone 本项目，自己动手实验。

关注「知晓程序」微信公众号，回复「LBS」，获取本项目源代码下载地址。

解决 `controls` 布局垂直方向高度问题：`controls` 是 `map` 组件的属性，它允许开发者在 `map` 组件上使用本地资源图片来渲染地图控件。

下图中使用红色选中框选中的三个按钮即为 `controls`，分别代表：

- 用户位置：点击后触发更新用户位置，将用户位置设置为 map longitude 和 latitude 值。
- T.I.T 动态：点击后跳转到动态页。
- 停车找车：点击后显示弹窗，询问用户是记录停车还是导航到停车地点。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/marked-controls.png)

`controls` 属性列表（部分引自官方文档）：

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-sheets-3.png)

`position` 有 4 个属性，分别为 `left<span style="font-family: Georgia, 'Times New Roman', 'Bitstream Charter', Times, serif;">,</span>` `top<span style="font-family: Georgia, 'Times New Roman', 'Bitstream Charter', Times, serif;">,</span>` `width<span style="font-family: Georgia, 'Times New Roman', 'Bitstream Charter', Times, serif;">,</span>` `height`。

也就是说，**开发者要想在界面上安排一个控件的位置，只能通过设置这 4 个属性来实现。而这 4 个属性的单位都是像素（px）**。

我们的做法是，以 iPhone 6（逻辑像素 375×667）作为基准设备，来进行不同尺寸屏幕适配。

代码如下图所示，可以实现在不同设备上都有比较好的展示。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-parking-code.jpg)

**数据获取**

商户信息获取：数据获取部分主要介绍商户经地理位置的采集。商户经纬度采集我们采用了高德开放平台，输入商户名，获取其坐标点。

例如，在输入框输入「爱范儿科技」的结果如下图:

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-ifanr-location.jpg)

商户的其他信息，也是**交由商户完善，再使用 CSV 格式，导入到前述 `merchant` 数据表中**。

用户位置获取：用户进入导航页后会请求获取用户地理位置。获得用户授权后，会使用 `wx.getLocation` API 获取用户位置。

注意，该 API 默认 `type` 取值为 `WGS84`。**为了在地图上显示在正确的位置，则 `type` 需要设为 `gcj02` ，也就是我们平常所说的「火星坐标系」**（官方称「地形图非线性保密处理算法」）。

关于 WGS-84 和 GCJ-02，我们需要了解的是：GPS 全球定位系统的经纬度坐标使用标准 WGS-84，换到使用 GCJ-02 的中国网路图上时，会造成距离在 500m 左右不等的显著偏移。

更多信息，可以在网络上搜寻有关「中华人民共和国测绘限制」的资料。

两点间距离获取：**两点间距离使用腾讯地图的距离计算 API 得出**。调用距离获取和线路导航功能接口，都需要事先获取调用 key 才可以使用。

导航路线点获取：由于商户的地理位置信息是使用高德地图采集到的。同时，高德地图也推出了自己的微信小程序 SDK，所以路线规划我们引入了高德地图的小程序版 SDK 来求取。

将获取到的路线数组，设置为 `map` 组件 `polyline` 的数据源即可。

#### 3. 地图组件其余重要属性

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-sheets-4.png)

#### 4. 路由规划

在小程序中，所有页面的路由全部由框架进行管理。

而小程序有 5 层页面栈的限制，即**如果在页面切换过程中，页面栈内页面数量超过 5，小程序将无法再进行跳转，或者发生一些意外行为**。

所以**我们在开发小程序时，一定要规划好小程序的页面栈，或结合产品进行跳转优化，或者从根源上精简需求**，以期开发出更实用更健壮的小程序。

下图展示了这个小程序的页面栈的流动。红色标线代表的路径为 BECG，经过 G 到达 6 – 导航页时，页面栈达到可容纳的最大页面数。

此时，在地图页只允许进行两种操作：

- 第一种是按左上角，上一层「商户详情」页面，在详情页则只能继续返回上一层或者再次进入导航页，不会出现爆栈的情况。
- 第二种方法，是通过判断页面栈中是否存在地图页。存在的话，则返导航页显示回到地图控件，用户点击后将直接调用 `wx.navigateBack` 加 `delta` 参数，直接跳回多级到地图页。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-dev-tit-flow.jpg)

另需注意的是，并不是所有导航 API 都可以携带参数，设计路由时也要同时考虑参数传递问题。

要了解更多，请参考小程序官方文档中的「页面路由」部分及「导航 API」部分。

### 最后的话

本文剥离业务实现，从使用知晓云 BasS 服务入手，介绍了数据表设计、小程序页面栈设计及注意事项，以及导航页面设计过程，和地图使用中常见问题和重点属性介绍。

希望能对开发者带来实质的帮助，感谢您的阅读。

另外，后期知晓云将会为大家带来有关 Canvas 组件的深度解析文章，敬请关注知晓程序（微信号 zxcx0101），获取更多开发技巧。

![](https://s3.ifanr.com/wp-content/uploads/2017/08/minapp-card-tit.png)

「TIT 智慧园区」小程序使用链接  
<https://minapp.com/miniapp/2963/>

**关注「知晓程序」公众号 👇**

- 在微信后台回复「**开发**」，获取小程序全套开发经验。
- 在微信后台回复「**LBS**」，进群学习 LBS 小程序实战技巧。

![zxcx&#95;0208](https://s3.ifanr.com/wp-content/uploads/2017/02/zxcx_0208.png)
