在进行云开发的数据更新的时候,我们可以进行不同条件的查询,从而提升我们更新的效率。在云开发支持了 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()
我们通过 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
构建出了一个正方形,从而实现了查询一个特定的正方形区域内的数据。
如果你希望查询一个其他形状的范围内的数据,只需要传入多个 Point
的数据就可以完成,比如如果你要查询一个五边形内部的数据,也只需在构建 LineString 时,传入 6 个 Point的数据即可。
当然,在使用时,你可以根据自己的实际情况,设定不同的图形类型,作为数据库查询的对象,完成自己的数据查询需求。
总结
这节课,我们介绍了 geoNear
、geoWithin
、geoIntersects
三个 API,帮助大家理解其各自在什么样的场景下使用,下一节课,我们将介绍 eq、neq、lt、lte、gt、gte 几个命令。