Tile38命令-【Search】

1.INTERSECTS

用于搜索与指定边界区域相交的数据对象。

语法

INTERSECTS key [CURSOR start] [BUFFER meters] [LIMIT count] [MATCH pattern] [WHERE field min max ...] [WHEREIN field count value [value...] ...] [WHEREEVAL script numargs arg [arg...] ...] [WHEREEVALSHA sha1 numargs arg [arg...] ...] [CLIP] [NOFIELDS] [FENCE] [DETECT what] [COMMANDS which] [COUNT|IDS|OBJECTS|POINTS|BOUNDS|(HASHES precision)] (GET key id)|(BOUNDS minlat minlon maxlat maxlon)|(OBJECT geojson)|(CIRCLE lat lon meters)|(TILE x y z)|(QUADKEY quadkey)|(HASH geohash)|(SECTOR lat lon meters bearing1 bearing2)

描述

INTERSECTS 在集合中搜索与指定边界区域相交的对象。

WITHIN 和 INTERSECTS 具有相同的语法。两者之间的唯一区别是，WITHIN 返回包含在区域内的对象，而 INTERSECTS 返回包含在或与区域相交的对象。通过上图也可以明显看出结果的区别。

示例

# 此命令有很多选项，但最简单的情况下
INTERSECTS fleet BOUNDS 33.462 -112.268 33.491 -112.245

上面是围绕矩形的搜索，西南点为33.462，-112.268，东北点为33.491，-112.245。返回与矩形相交的 fleet 中所有对象的列表。

这个命令还支持多种选项，例如 FENCE 用于开启地理围栏，DETECT 用于在地理围栏中过滤通知类型，WHERE 允许基于字段值和对象属性过滤结果，WHEREIN 允许基于字段值列表过滤结果，CURSOR 用于迭代搜索结果中的多个对象，NOFIELDS 告诉服务器不要返回字段值，CLIP 告诉服务器将相交对象剪切到搜索区域的边界框内，LIMIT 用于限制单个搜索请求返回的对象数量，默认为100，BUFFER 可以在 WITHIN 和 INTERSECTS 搜索中通过增加米数来扩大搜索区域。

搜索选项

下面是完整的搜索选项列表。这些选项由NEARBY、WITHIN、INTERSECTS和SCAN命令共享。

FENCE

FENCE 用于开启地理围栏。参考这里。

DETECT

当指定FENCE选项时，DETECT可用。它允许根据类型过滤地理围栏通知。有关更多信息，请参阅这里。

WHERE

WHERE允许根据字段值和对象属性过滤结果。

Field values

NEARBY fleet WHERE speed 70 +inf POINT 33.462 -112.268 6000

上面是将仅返回 fleet 集合中半径在6公里范围内且速度字段大于70的对象。

多个 WHERE 连接为 and 子句。WHERE speed 70 +inf WHERE age -inf 24 将被解释为速度超过70而且年龄小于24。

字段的默认值始终为0。因此，如果你在字段速度上做了一个WHERE，而一个对象没有设置该字段，服务器将假装该对象设置了该字段，并且该值为零。

从1.30.0开始，Tile38支持更复杂的过滤表达式。

SET fleet truck2 FIELD info '{"speed":61,"name":"Tom"}' POINT -112 33
>> {"ok":true}

SCAN fleet WHERE 'info.speed > 45' COUNT
>> {"ok":true,"count":1,"cursor":0}

Object attributes

使用gjson，从1.30.0开始，Tile38对象可以按对象属性进行过滤。

# add a complex object
SET fleet truck OBJECT '{"type":"Feature","geometry":{"type":"Point","coordinates":[-112,33]},"properties":{"speed":50},"asdf":"Adsf"}'
>> {"ok":true}

# scan fleet collection and filter
SCAN fleet WHERE properties.speed > 49 IDS
>> {"ok":true,"ids":["truck"],"count":1,"cursor":0}

WHEREIN

WHEREIN类似于WHERE，但是它检查对象的字段值是否在给定的列表中。例如 nearby fleet WHEREIN wheels 3 14 18 22 point 33.462 -112.268 6000，将仅返回 fleet 集合中半径6公里内且具有14、18或22个车轮字段的物体。(为什么不是3、14、18或者22呢？看下面的粗体注意)

多个 WHEREN 连接为 and 子句。WHEREIN doors 2 2 5 WHEREIN wheels 3 14 18 22 将被解释为门是2或5，轮子是14或18或22。(为什么不是2、2、5 以及 3、14、18或者22呢？看下面的粗体注意)

字段的默认值始终为0。因此，如果你在场轮上执行WHEREIN，而一个对象没有设置该场，服务器将假装该对象设置了该场，并且该值为零。

注意：紧随WHEREIN标记之后的必须是一个整数，指定此子句中指定的值的数量。

WHEREEVAL

与WHERE类似，只是匹配决定是由Lua脚本做出的。
nearby fleet whereeval "return FIELDS.wheels > ARGV[1] or (FIELDS.length * FIELDS.width) > ARGV[2]" 2 8 120 point 33.462 -112.268 6000 将仅返回fleet集合中半径在6km以内、名为wheels的字段大于8或长度和宽度乘积大于120的对象。

多个WHEEVAL连接为and子句。

MATCH

MATCH类似于WHERE，但是它适用于对象id而不是字段。

nearby fleet match truck* point 33.462 -112.268 6000 将仅返回“fleet”集合中半径在6公里范围内且对象id以’truck’开头的对象。一次搜索中可以有多个MATCH选项。MATCH值是一个简单的glob模式。

CURSOR

CURSOR用于迭代搜索结果中的许多对象。当CURSOR设置为零或未包含在请求中时，迭代开始，当服务器返回的游标为零时，迭代结束。

NOFIELDS

NOFIELDS告诉服务器您不希望随搜索结果返回字段值。

CLIP

CLIP告诉服务器通过搜索的边界框区域剪裁相交对象。它只能与以下区域格式一起使用：边界、瓷砖、四边形、HASH。

LIMIT

LIMIT可用于限制单个搜索请求返回的对象数量。如果不提供，默认值为100。

BUFFER

在区域格式周围应用缓冲区，以便在内部和交叉搜索中将搜索区域增加x米。

输出格式

下面是输出格式的完整列表。这些格式由NEARBY、WITHIN、INTERSECTS和SCAN命令共享。

• COUNT：响应中发送的对象总数。当提供LIMIT或CURSOR时，COUNT返回否则将作为对象发送的结果数量。当未指定LIMIT时，COUNT将从提供的CURSOR位置开始计算所有项目的总和（如果省略光标，则为零）。LIMIT和CURSOR选项被忽略
• IDS：属于key的一个ID集合，不会返回具体对象。
• OBJECTS：GeoJSON对象列表。
• POINTS：标准纬度、经度点列表。
• BOUNDS：最小边界矩形列表。
• HASHES：Geohash列表。要求精度为1到22。

区域格式

下面是区域格式的完整列表。这些格式由WITHIN和INTERSECTS命令共享。

• GET：数据库中已存在的任何对象。例如，WITHIN poi GET cities tempe，可用于搜索poi键中属于关键城市的对象tempe内的所有对象。当然，cities/tempe对象必须存在于数据库中。
• BOUNDS：最小边界矩形。
• OBJECT：GeoJSON对象。
• CIRCLE：具有指定中心和半径的圆。
• TILE： An XYZ Tile.
• QUADKEY：A QuadKey.
• HASH：A Geohash.
• SECTOR：A Sector。

Fields

对象字段值在每个对象的列表中分组在一起。由于Tile38组织字段内存的方式，可以看到尚未设置的字段的零值。建议将所有不存在或省略的字段视为值为零。

2.NEARBY

用于搜索指定点位置附近的对象。这个命令可以返回给定中心点一定距离内的所有对象，或者根据指定的地理区域返回相交的对象。

语法

NEARBY key [CURSOR start] [LIMIT count] [MATCH pattern] [DISTANCE] [WHERE field min max ...] [WHEREIN field count value [value...] ...] [WHEREEVAL script numargs arg [arg...] ...] [WHEREEVALSHA sha1 numargs arg [arg...] ...] [NOFIELDS] [FENCE] [DETECT what] [COMMANDS which] [COUNT|IDS|OBJECTS|POINTS|BOUNDS|(HASHES precision)] (POINT lat lon meters)|(ROAM key pattern meters)

这个命令很多选项：

• COUNT count：限制返回结果的数量。
• FENCE：开启地理围栏功能。
• WHERE field min max …：基于字段值过滤结果。
• CLIP：将返回的对象剪切到搜索区域的边界。
• NOFIELDS：不返回对象的字段信息。
• FEET|KM|MILES：指定半径的单位，可以是英尺、公里或英里。

描述

NEARBY命令在集合中搜索靠近指定点的对象。使用KNN算法代替标准的重叠+Haversine算法，按距离该点的距离升序（即最近的第一个）对结果进行排序。

示例

# 这个命令有很多选项，但最简单的可能是如下，以找到最接近给定点的对象。
NEARBY fleet LIMIT 1 POINT 33.462 -112.268
# 如果给定半径：那么搜索将受到该半径的限制，在这种情况下为6000米。
NEARBY fleet POINT 33.462 -112.268 6000

搜索选项

参考上面的 INTERSECTS 命令。

输出格式

参考上面的 INTERSECTS 命令。

3.SCAN

用于增量地迭代一个键（key）下的所有对象。

语法

SCAN key [CURSOR start] [LIMIT count] [MATCH pattern] [ASC|DESC] [WHERE field min max ...] [WHEREIN field count value [value...] ...] [WHEREEVAL script numargs arg [arg...] ...] [WHEREEVALSHA sha1 numargs arg [arg...] ...] [NOFIELDS] [COUNT|IDS|OBJECTS|POINTS|BOUNDS|(HASHES precision)]

描述

SCAN递增地迭代一个键。

示例

此命令有很多选项，但最简单的情况下，它可能看起来像。

SCAN fleet

上面是对 fleet 中所有对象的扫描。

搜索选项

参考上面的 INTERSECTS 命令。

输出格式

参考上面的 INTERSECTS 命令。

4.SEARCH

在键中搜索字符串值。用于迭代一个键（key）下的所有字符串值。

语法

SEARCH key [CURSOR start] [LIMIT count] [MATCH pattern] [ASC|DESC] [WHERE field min max ...] [WHEREIN field count value [value...] ...] [WHEREEVAL script numargs arg [arg...] ...] [WHEREEVALSHA sha1 numargs arg [arg...] ...] [NOFIELDS] [COUNT|IDS]

描述

SEARCH迭代键的字符串值。

示例

此命令有很多选项，但最简单的情况下，它可能看起来像。

SEARCH names

上面是对names键中所有字符串的扫描。

也可以使用MATCH关键字过滤值，并使用ASC和DESC对结果进行排序。例如：

SEARCH names MATCH J* DESC

上述命令将搜索 names 键中以J开头的所有值，并按降序返回结果。

请注意，此命令仅包含STRING值。像POINT和OBJECT这样的地理值需要使用SCAN命令。

5.WITHIN

搜索完全在该区域内的ID。

语法

WITHIN key [CURSOR start] [LIMIT count] [MATCH pattern] [WHERE field min max ...] [WHEREIN field count value [value...] ...] [WHEREEVAL script numargs arg [arg...] ...] [WHEREEVALSHA sha1 numargs arg [arg...] ...] [NOFIELDS] [FENCE] [DETECT what] [COMMANDS which] [COUNT|IDS|OBJECTS|POINTS|BOUNDS|(HASHES precision)] (GET key id)|(BOUNDS minlat minlon maxlat maxlon)|(OBJECT geojson)|(CIRCLE lat lon meters)|(TILE x y z)|(QUADKEY quadkey)|(HASH geohash)|(SECTOR lat lon meters bearing1 bearing2)

描述

WITHIN在集合中搜索完全包含在指定边界区域内的对象。

WITHIN和INTERSECTS具有相同的语法。两者之间的唯一区别是，WITHIN返回包含在区域内的对象，而interview返回包含在或与区域相交的对象。

示例

此命令有很多选项，但最简单的情况下，它可能看起来像。

WITHIN fleet BOUNDS 33.462 -112.268 33.491 -112.245

上面是围绕矩形的搜索，西南点为33.462，-112.268，东北点为33.491，-112.245。返回矩形内完全包含的所有对象的列表。

搜索选项

参考上面的 INTERSECTS 命令。

输出格式

参考上面的 INTERSECTS 命令。

区域格式

参考上面的 INTERSECTS 命令。