地理位置查詢包括地理距離查詢(GeoDistanceQuery)、地理長方形範圍查詢(GeoBoundingBoxQuery)和地理多邊形範圍查詢(GeoPolygonQuery)三種方式。
前提條件
已初始化OTSClient。具體操作,請參見初始化OTSClient。
已在資料表上建立多元索引。具體操作,請參見建立多元索引。
地理距離查詢(GeoDistanceQuery)
GeoDistanceQuery根據一個中心點和距離條件查詢表中的資料,當一個地理位置點到指定的中心點的距離不超過指定的值時,滿足查詢條件。
參數
參數
說明
field_name
列名,類型為Geopoint。
center_point
中心地理座標點,是一個經緯度值。
格式為
緯度,經度
,緯度在前,經度在後,且緯度範圍為[-90,+90],經度範圍[-180,+180]。例如35.8,-45.91
。distance
距離中心點的距離,類型為Double。單位為米。
query
多元索引的查詢語句。設定查詢類型為GeoDistanceQuery。
table_name
資料表名稱。
index_name
多元索引名稱。
樣本
以下樣本用於查詢表中Col_GeoPoint列的值距離中心點'32.5,116.5'不超過300000米的資料。
query = GeoDistanceQuery('Col_GeoPoint', '32.5,116.5', 300000) rows, next_token, total_count, is_all_succeed, agg_results, group_by_results = client.search( '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL) ).v1_response()
地理長方形範圍查詢(GeoBoundingBoxQuery)
GeoBoundingBoxQuery根據一個長方形範圍的地理位置邊界條件查詢表中的資料,當一個地理位置點落在給出的長方形範圍內時,滿足查詢條件。
參數
參數
說明
field_name
列名,類型為Geopoint。
top_left
長方形框的左上方的座標。
bottom_right
長方形框的右下角的座標,通過左上方和右下角可以確定一個唯一的長方形。
格式為
緯度,經度
,緯度在前,經度在後,且緯度範圍為[-90,+90],經度範圍[-180,+180]。例如35.8,-45.91
。query
多元索引的查詢語句。設定查詢類型為GeoBoundingBoxQuery。
table_name
資料表名稱。
index_name
多元索引名稱。
樣本
以下樣本用於查詢表中Col_GeoPoint列的值在左上方座標為'30.9,112.0',右下角座標為'30.2,119.0'的長方形範圍內的資料。
query = GeoBoundingBoxQuery('Col_GeoPoint', '30.9,112.0', '30.2,119.0') rows, next_token, total_count, is_all_succeed, agg_results, group_by_results = client.search( '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL) ).v1_response()
地理多邊形範圍查詢(GeoPolygonQuery)
GeoPolygonQuery根據一個多邊形範圍的地理位置邊界條件查詢表中的資料,當一個地理位置點落在指定的多邊形範圍內時,滿足查詢條件。
參數
參數
說明
field_name
列名,類型為Geopoint。
points
組成多邊形範圍的座標,通過多個座標可以確定一個唯一的多邊形。
格式為
緯度,經度
,緯度在前,經度在後,且緯度範圍為[-90,+90],經度範圍[-180,+180]。例如35.8,-45.91
。query
多元索引的查詢語句。設定查詢類型為GeoPolygonQuery。
table_name
資料表名稱。
index_name
多元索引名稱。
樣本
以下樣本用於查詢表中Col_Geopoint列的值在由'30.9,112.0'、'30.5,115.0'、'30.3, 117.0'和'30.2,119.0'座標組成的多邊形範圍內的資料。
query = GeoPolygonQuery('Col_GeoPoint', ['30.9,112.0', '30.5,115.0', '30.3, 117.0', '30.2,119.0']) rows, next_token, total_count, is_all_succeed, agg_results, group_by_results = client.search( '<TABLE_NAME>', '<SEARCH_INDEX_NAME>', SearchQuery(query, limit=100, get_total_count=True), ColumnsToGet(return_type=ColumnReturnType.ALL) ).v1_response()
常見問題
相關文檔
多元索引查詢類型包括精確查詢、多詞精確查詢、全匹配查詢、匹配查詢、短語匹配查詢、首碼查詢、範圍查詢、萬用字元查詢、多條件組合查詢、地理位置查詢、巢狀型別查詢、向量檢索和列存在性查詢,您可以選擇合適的查詢類型進行多維度資料查詢。
如果要對結果集進行排序或者翻頁,您可以使用排序和翻頁功能來實現。具體操作,請參見排序和翻頁。
如果要按照某一列對結果集做摺疊,使對應類型的資料在結果展示中只出現一次,您可以使用摺疊(去重)功能來實現。具體操作,請參見摺疊(去重)。
如果要進行資料分析,例如求最值、求和、統計行數等,您可以使用Search介面的統計彙總功能或者SQL查詢來實現。具體操作,請參見統計彙總和SQL查詢。
如果要快速匯出資料,而不關心整個結果集的順序時,您可以使用ParallelScan介面和ComputeSplits介面實現多並發匯出資料。具體操作,請參見並發匯出資料。