地理长方形范围查询(GeoBoundingBoxQuery)根据一个长方形范围的地理位置边界条件查询表中的数据。当一个地理位置点落在给定的长方形范围内时,表示该地理位置点满足查询条件。
参数
参数 | 说明 |
fieldName | 列名,类型为Geopoint。 |
topLeft | 长方形框的左上角的坐标。 |
bottomRight | 长方形框的右下角的坐标,通过左上角和右下角就可以确定一个唯一的长方形。 格式为纬度,经度,纬度在前,经度在后,且纬度范围为[-90,+90],经度范围[-180,+180]。例如35.8,-45.91。 |
query | 多元索引的查询语句。设置查询类型为GeoBoundingBoxQuery。 |
getTotalCount | 是否返回匹配的总行数,默认为false,表示不返回。 返回匹配的总行数会影响查询性能。 |
tableName | 数据表名称。 |
indexName | 多元索引名称。 |
columnsToGet | 是否返回所有列,包含returnAll和columns设置。 returnAll默认为false,表示不返回所有列,此时可以通过columns指定返回的列;如果未通过columns指定返回的列,则只返回主键列。 当设置returnAll为true时,表示返回所有列。 |
使用方式
您可以使用控制台、命令行工具或者SDK进行地理长方形范围查询。进行地理长方形范围查询之前,您需要完成如下准备工作。
使用控制台
进入索引管理页签。
登录表格存储控制台。
在页面上方,选择资源组和地域。
在概览页面,单击实例名称或在操作列单击实例管理。
在实例详情页签下的数据表列表页签,单击数据表名称或在操作列单击索引管理。
在索引管理页签,单击目标多元索引操作列的搜索。
在查询数据对话框,查询数据。
系统默认返回所有列,如需显示指定属性列,关闭获取所有列并输入需要返回的属性列,多个属性列之间用半角逗号(,)隔开。
根据需要选择逻辑操作符为 And、Or 或者 Not。
当选择逻辑操作符为 And 时,返回满足指定条件的数据。当选择逻辑操作符为 Or 时,如果配置了单个条件,则返回满足指定条件的数据;如果配置了多个条件,则返回满足任意一个条件的数据。当选择逻辑操作符为 Not 时,返回不满足指定条件的数据。
选择Geopoint类型的索引字段,单击添加。
设置索引字段的查询类型为矩形查询(GeoBoundingBoxQuery)以及分别输入矩形左上角和右下角的地理坐标点并选中坐标点。
系统默认关闭排序功能,如需根据指定字段对返回结果进行排序,打开是否排序开关后,根据需要添加要进行排序的字段并配置排序方式。
系统默认关闭统计功能,如需对指定字段进行数据统计,打开是否统计开关后,根据需要添加要进行统计的字段和配置统计信息。
单击确定。
符合查询条件的数据会显示在索引管理页签中。
使用命令行工具
通过命令行工具执行search命令使用多元索引查询数据。更多信息,请参见多元索引。
执行search命令使用search_index多元索引查询表中数据,并返回所有建立索引的列。
search -n search_index --return_all_indexed
根据系统提示输入查询条件,示例如下:
{
"Offset": -1,
"Limit": 10,
"Collapse": null,
"Sort": null,
"GetTotalCount": true,
"Token": null,
"Query": {
"Name": "GeoBoundingBoxQuery",
"Query": {
"FieldName": "col_geopoint",
"TopLeft": "10,0",
"BottomRight": "0,10"
}
}
}
使用SDK
您可以通过Java SDK、Go SDK、Python SDK、Node.js SDK、.NET SDK和PHP SDK使用地理长方形范围查询。此处以Java SDK为例介绍地理长方形范围查询的使用。
以下示例查询 location 字段位于左上角 2,-1、右下角 -1,2 所确定的长方形范围内的数据。
GeoBoundingBoxQuery geoBoundingBoxQuery = new GeoBoundingBoxQuery();
geoBoundingBoxQuery.setFieldName("location");
geoBoundingBoxQuery.setTopLeft("2,-1");
geoBoundingBoxQuery.setBottomRight("-1,2");
SearchQuery searchQuery = new SearchQuery();
searchQuery.setQuery(geoBoundingBoxQuery);
计费说明
使用 VCU 模式(原预留模式)时,使用多元索引查询数据会消耗 VCU 的计算资源。使用 CU 模式(原按量模式)时,使用多元索引查询数据会消耗读吞吐量。更多信息,请参见多元索引计量计费。