阅读 4

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

在进行云开发的数据更新的时候,我们可以进行不同条件的查询,从而提升我们更新的效率。在云开发支持了 Geo Point 等相关数据类型以后,我们可以用云开发实现多种不同地理位置的数据存储和利用,对于我们开发基于地理位置的小程序来说,有很大的帮助。

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

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

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

数据结构需求

如果你想要使用 geoNear,则要求你在数据库中存储的数据对于地理位置的存储是基于 db.Geo.Point 进行的,这样你就可以完成使用 geoNear 进行查询。

数据查询实例

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

如果我们希望查询距离当前位置,1000米 ~ 2000米的数据,则可以执行这样的命令

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 方法获取当前的地址信息,并将其作为参数设置在这里。

minDistance 则是距离中心点的最小距离,单位是米,所以这里将其设置为 1000。类似的,maxDistance 则是距离中心点的最大距离,单位也是米,所以这里将其设置为 2000。

通过这样的方法,我们就可以查询出数据了。

在我们去做一些基于地理位置的应用的时候,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()
复制代码

我们通过 PolygonLineString 构建出了一个正方形,从而实现了查询一个特定的正方形区域内的数据。

如果你希望查询一个其他形状的范围内的数据,只需要传入多个 Point 的数据就可以完成,比如如果你要查询一个五边形内部的数据,也只需在构建 LineString 时,传入 6 个 Point的数据即可。

为什么五边形却是 6 个 Point 呢?

因为在云开发中,如果你要构建一个多边形,则需要使得整个多边形是闭合的,也就是说,你的起始点是一样的,因此,如果你想要构建一个四边形,则需要五个点。如果是构建五边形,则是六个点。

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

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

相比于 geoWithingeoIntersects 对于当前用户的位置数据更为随意,支持 PointLineStringMultiPointMultiLineStringPolygonMultiPolygon 等多种不同的数据结构,在进行查询的时候,更加的方便。

数据结构需求

如果你想要使用 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()
复制代码

我们通过 PolygonLineString 构建出了一个正方形,从而实现了查询一个特定的正方形区域内的数据。

如果你希望查询一个其他形状的范围内的数据,只需要传入多个 Point 的数据就可以完成,比如如果你要查询一个五边形内部的数据,也只需在构建 LineString 时,传入 6 个 Point的数据即可。

当然,在使用时,你可以根据自己的实际情况,设定不同的图形类型,作为数据库查询的对象,完成自己的数据查询需求。

总结

这节课,我们介绍了 geoNeargeoWithingeoIntersects 三个 API,帮助大家理解其各自在什么样的场景下使用,下一节课,我们将介绍 eq、neq、lt、lte、gt、gte 几个命令。

关注下面的标签,发现更多相似文章
评论