云开发数据库命令之地理位置查询

时间 2019-11-06

原文原文链接

在进行云开发的数据更新的时候，咱们能够进行不一样条件的查询，从而提高咱们更新的效率。在云开发支持了 Geo Point 等相关数据类型之后，咱们能够用云开发实现多种不一样地理位置的数据存储和利用，对于咱们开发基于地理位置的小程序来讲，有很大的帮助。数据库

今天的课程中，咱们来介绍小程序数据更新命令中的「地理位置查询」命令。小程序

geoNear：查询特定点附近的数据

查询特定点附近的数据能够说是咱们在进行应用开发时，最为经常使用的功能，它能够应用于诸如查询当前用户坐标周围的店铺、查询距离我最近的公交站等场景，这个时候，咱们须要使用 geoNear 来进行数据库查询。数据结构

数据结构需求

若是你想要使用 geoNear，则要求你在数据库中存储的数据对于地理位置的存储是基于 db.Geo.Point 进行的，这样你就能够完成使用 geoNear 进行查询。spa

数据查询实例

假设咱们当前数据库内数据的结构是这样的，每个数据下有一个 point 属性，这个属性是经过 db.Geo.Point 添加的。3d

若是咱们但愿查询距离当前位置，1000米～ 2000米的数据，则能够执行这样的命令code

const db = wx.cloud.database()
const _ = db.command
db.collection('items').where({
  location: _.geoNear({
    geometry: db.Geo.Point(113.323809, 23.097732),
    minDistance: 1000,
    maxDistance: 2000,
  })
}).get()
复制代码

这里的 geometry 中的 Point 的数据是获取到的当前地理位置信息,它必须是 db.Geo.Point 类型的，你能够经过小程序的 wx.getLocation 方法获取当前的地址信息，并将其做为参数设置在这里。cdn

minDistance 则是距离中心点的最小距离，单位是米，因此这里将其设置为 1000。相似的，maxDistance 则是距离中心点的最大距离，单位也是米，因此这里将其设置为 2000。对象

经过这样的方法，咱们就能够查询出数据了。blog

在咱们去作一些基于地理位置的应用的时候，db.command.geoNear 能够很大程度上简化咱们的开发。开发

geoWithin：查询特定区域内的数据

在开发地理位置应用时，除了基于某一个点的位置进行查询之外，咱们还会查询某一个区域内的数据，好比查询北京市昌平区内的全部的酒吧、查询深圳南山区内全部的博物馆，这样的需求也是切实存在，而且十分常见的需求。这个时候，咱们能够考虑，使用 geoWithin 来进行数据查询。

数据结构需求

若是你想要使用 geoWithin，则要求你在数据库中存储的数据对于地理位置的存储是基于 db.Geo.Point 进行的，这样你就能够完成使用 geoWithin 进行查询。

数据查询实例

假设咱们当前数据库内数据的结构是这样的，每个数据下有一个 point 属性，这个属性是经过 db.Geo.Point 添加的。

若是咱们但愿查询在东经 112 度～东经 114 度，北纬 22 度到北纬 24 度范围内的数据，则能够执行这样的数据查询

const db = wx.cloud.database()
const _ = db.command
const { Point, LineString, Polygon } = db.Geo
db.collection('items').where({
  location: _.geoWithin({
    geometry: Polygon([
      LineString([
        Point(112, 22),
        Point(112, 24),
        Point(114, 24),
        Point(114, 22),
        Point(112,22)
      ])
    ]),
  })
}).get()
复制代码

咱们经过 Polygon 和 LineString 构建出了一个正方形，从而实现了查询一个特定的正方形区域内的数据。

若是你但愿查询一个其余形状的范围内的数据，只须要传入多个 Point 的数据就能够完成，好比若是你要查询一个五边形内部的数据，也只需在构建 LineString 时，传入 6 个 Point的数据便可。

为何五边形倒是 6 个 Point 呢？

由于在云开发中，若是你要构建一个多边形，则须要使得整个多边形是闭合的，也就是说，你的起始点是同样的，所以，若是你想要构建一个四边形，则须要五个点。若是是构建五边形，则是六个点。

geoIntersects：查询与特定区域相交的数据

geoIntersects 是用于查询全部数据中和给定数据相交的数据，咱们能够将其用做判断某一些特定的点、线、面是否在一个特定区域内。举个例子，假设你已经有了用户当前的活动范围，好比某一条街道，那么你能够基于 geoIntersects 来构建一条线，并基于这条线查询，全部数据中，是否有数据与这个线相交，若是相交，则说明对应的数据点是在用户所在的街道上。你就能够将这个数据告诉用户，让用户去找这些点。

相比于 geoWithin，geoIntersects 对于当前用户的位置数据更为随意，支持 Point、LineString、MultiPoint、 MultiLineString、 Polygon、 MultiPolygon 等多种不一样的数据结构，在进行查询的时候，更加的方便。

数据结构需求

若是你想要使用 geoIntersects，则要求你在数据库中存储的数据对于地理位置的存储是基于 db.Geo.Point 进行的，这样你就能够完成使用 geoIntersects 进行查询。

数据查询实例

假设咱们当前数据库内数据的结构是这样的，每个数据下有一个 point 属性，这个属性是经过 db.Geo.Point 添加的。

若是咱们但愿查询在东经 112 度～东经 114 度，北纬 22 度到北纬 24 度范围内的数据，则能够执行这样的数据查询

const db = wx.cloud.database()
const _ = db.command
const { Point, LineString, Polygon } = db.Geo
db.collection('items').where({
  location: _.geoIntersects({
    geometry: Polygon([
      LineString([
        Point(112, 22),
        Point(112, 24),
        Point(114, 24),
        Point(114, 22),
        Point(112,22)
      ])
    ]),
  })
}).get()
复制代码

咱们经过 Polygon 和 LineString 构建出了一个正方形，从而实现了查询一个特定的正方形区域内的数据。

固然，在使用时，你能够根据本身的实际状况，设定不一样的图形类型，做为数据库查询的对象，完成本身的数据查询需求。

总结

这节课，咱们介绍了 geoNear、geoWithin、geoIntersects 三个 API，帮助你们理解其各自在什么样的场景下使用，下一节课，咱们将介绍 eq、neq、lt、lte、gt、gte 几个命令。