全部產品
Search
文件中心

:地理位置查詢

更新時間:Jul 03, 2024

地理位置查詢包括地理距離查詢(GeoDistanceQuery)、地理長方形範圍查詢(GeoBoundingBoxQuery)和地理多邊形範圍查詢(GeoPolygonQuery)三種方式。

前提條件

地理距離查詢(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()

常見問題

相關文檔