地理空间查询

基于地理数据的查询

Redis Stack 的地理空间功能允许您查询与地理位置相关的数据。您可以查询特定半径内的位置，也可以基于几何形状（如多边形）查询位置。例如，多边形形状可以表示湖泊或建筑物的布局。

本文中的示例使用以下架构：

字段名称 字段类型
store_location GEO
pickup_zone GEOSHAPE
注意：
需要 Redis Stack 版本 7.2.0 或更高版本才能使用GEOSHAPE字段类型。

半径

您可以通过将中心坐标（经度、纬度）、半径和距离单位传递给 FT 来构造半径查询。SEARCH 命令。

FT.SEARCH index "@geo_field:[lon lat radius unit]"

允许的单位数为m,km,mi和ft.

以下查询查找伦敦周围 20 英里半径内的所有自行车商店：

Shape

The only supported shapes are points and polygons. You can query for polygons or points that either contain or are within a given geometric shape.

FT.SEARCH index "@geo_shape_field:[{WITHIN|CONTAINS|INTERSECTS|DISJOINT} $shape] PARAMS 2 shape "shape_as_wkt" DIALECT 3

Here is a more detailed explanation of this query:

  1. Field name: you need to replace geo_shape_field with the GEOSHAPE field's name on which you want to query.
  2. Spatial operator: spatial operators define the relationship between the shapes in the database and the shape you are searching for. You can either use WITHIN, CONTAINS, INTERSECTS, or DISJOINT. WITHIN finds any shape in the database that is inside the given shape. CONTAINS queries for any shape that surrounds the given shape. INTERSECTS finds any shape that has coordinates in common with the provided shape. DISJOINT finds any shapes that have nothing in common with the provided shape. INTERSECTS and DISJOINT were introduced in v2.10.
  3. Parameter: the query refers to a parameter named shape. You can use any parameter name here. You need to use the PARAMS clause to set the parameter value. The value follows the well-known text representation of a geometry. Supported types are POINT(x y) and POLYGON((x1 y1, x2 y2, ...)).
  4. Dialect: Shape-based queries have been available since version three of the query dialect.

The following example query verifies if a bicycle is within a pickup zone:

If you want to find all pickup zones that are approximately within Europe, then you can use the following query:

RATE THIS PAGE
Back to top ↑