全部產品
Search
文件中心

:地理位置查詢

更新時間:Jul 03, 2024

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

前提條件

地理距離查詢(GeoDistanceQuery)

GeoDistanceQuery根據一個中心點和距離條件查詢表中的資料,當一個地理位置點到指定的中心點的距離不超過指定的值時,滿足查詢條件。

  • 參數

    參數

    說明

    fieldName

    列名,類型為Geopoint。

    centerPoint

    中心地理座標點,是一個經緯度值。

    格式為緯度,經度,緯度在前,經度在後,且緯度範圍為[-90,+90],經度範圍為[-180,+180]。例如35.8,-45.91

    distanceInMeter

    距離中心點的距離。類型為Double。單位為米。

    getTotalCount

    是否返回匹配的總行數,預設為false,表示不返回。

    返回匹配的總行數會影響查詢效能。

    query

    多元索引的查詢語句。設定查詢類型為GeoDistanceQuery。

    tableName

    資料表名稱。

    indexName

    多元索引名稱。

    columnsToGet

    是否返回所有列,包含returnAll和columns設定。

    returnAll預設為false,表示不返回所有列,此時可以通過columns指定返回的列;如果未通過columns指定返回的列,則只返回主鍵列。

    當設定returnAll為true時,表示返回所有列。

  • 樣本

    以下樣本用於查詢表中Col_GeoPoint列的值距離中心點不超過一定距離的資料。

    public static void geoDistanceQuery(SyncClient client) {
        SearchQuery searchQuery = new SearchQuery();
        GeoDistanceQuery geoDistanceQuery = new GeoDistanceQuery();  //設定查詢類型為GeoDistanceQuery。
        geoDistanceQuery.setFieldName("Col_GeoPoint");
        geoDistanceQuery.setCenterPoint("5,5"); //設定中心點。
        geoDistanceQuery.setDistanceInMeter(10000); //設定條件為到中心點的距離不超過10000米。
        searchQuery.setQuery(geoDistanceQuery);
        //searchQuery.setGetTotalCount(true); //設定返回匹配的總行數。
    
        SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
        //通過設定columnsToGet參數可以指定返回的列或返回所有列,如果不設定此參數,則預設只返回主鍵列。
        //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
        //columnsToGet.setReturnAll(true); //設定為返回所有列。
        //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); //設定為返回指定列。
        //searchRequest.setColumnsToGet(columnsToGet);
    
        SearchResponse resp = client.search(searchRequest);
        //System.out.println("TotalCount: " + resp.getTotalCount()); //列印匹配到的總行數,非返回行數。
        System.out.println("Row: " + resp.getRows());
    }

地理長方形範圍查詢(GeoBoundingBoxQuery)

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時,表示返回所有列。

  • 樣本

    以下樣本用於查詢表中Col_GeoPoint列的值在左上方為"10,0", 右下角為"0,10"的長方形範圍內的資料。

    public static void geoBoundingBoxQuery(SyncClient client) {
        SearchQuery searchQuery = new SearchQuery();
        GeoBoundingBoxQuery geoBoundingBoxQuery = new GeoBoundingBoxQuery(); //設定查詢類型為GeoBoundingBoxQuery。
        geoBoundingBoxQuery.setFieldName("Col_GeoPoint"); //設定列名。
        geoBoundingBoxQuery.setTopLeft("10,0"); //設定長方形左上方。
        geoBoundingBoxQuery.setBottomRight("0,10"); //設定長方形右下角。
        searchQuery.setQuery(geoBoundingBoxQuery);
        //searchQuery.setGetTotalCount(true); //設定返回匹配的總行數。
    
        SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
        //通過設定columnsToGet參數可以指定返回的列或返回所有列,如果不設定此參數,則預設只返回主鍵列。
        //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
        //columnsToGet.setReturnAll(true); //設定為返回所有列。
        //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); //設定為返回指定列。
        //searchRequest.setColumnsToGet(columnsToGet);
    
        SearchResponse resp = client.search(searchRequest);
        //System.out.println("TotalCount: " + resp.getTotalCount()); //列印匹配到的總行數,非返回行數。
        System.out.println("Row: " + resp.getRows());
    }

地理多邊形範圍查詢(GeoPolygonQuery)

GeoPolygonQuery根據一個多邊形範圍條件查詢表中的資料,當一個地理位置點落在指定的多邊形範圍內時滿足查詢條件。

  • 參數

    參數

    說明

    fieldName

    列名,類型為Geopoint。

    points

    組成多邊形的距離座標點。

    格式為緯度,經度,緯度在前,經度在後,且緯度範圍為[-90,+90],經度範圍為[-180,+180]。例如35.8,-45.91

    query

    多元索引的查詢語句。設定查詢類型為GeoPolygonQuery。

    getTotalCount

    是否返回匹配的總行數,預設為false,表示不返回。

    返回匹配的總行數會影響查詢效能。

    tableName

    資料表名稱。

    indexName

    多元索引名稱。

    columnsToGet

    是否返回所有列,包含returnAll和columns設定。

    returnAll預設為false,表示不返回所有列,此時可以通過columns指定返回的列;如果未通過columns指定返回的列,則只返回主鍵列。

    當設定returnAll為true時,表示返回所有列。

  • 樣本

    以下樣本用於查詢表中Col_GeoPoint列的值在一個給定多邊形範圍內的資料。

    public static void geoPolygonQuery(SyncClient client) {
        SearchQuery searchQuery = new SearchQuery();
        GeoPolygonQuery geoPolygonQuery = new GeoPolygonQuery();  //設定查詢類型為GeoPolygonQuery。
        geoPolygonQuery.setFieldName("Col_GeoPoint");
        geoPolygonQuery.setPoints(Arrays.asList("0,0","5,5","5,0")); //設定多邊形的頂點。
        searchQuery.setQuery(geoPolygonQuery);
        //searchQuery.setGetTotalCount(true); //設定返回匹配的總行數。
    
        SearchRequest searchRequest = new SearchRequest("<TABLE_NAME>", "<SEARCH_INDEX_NAME>", searchQuery);
        //通過設定columnsToGet參數可以指定返回的列或返回所有列,如果不設定此參數,則預設只返回主鍵列。
        //SearchRequest.ColumnsToGet columnsToGet = new SearchRequest.ColumnsToGet();
        //columnsToGet.setReturnAll(true); //設定為返回所有列。
        //columnsToGet.setColumns(Arrays.asList("ColName1","ColName2")); //設定為返回指定列。
        //searchRequest.setColumnsToGet(columnsToGet);
    
        SearchResponse resp = client.search(searchRequest);
        //System.out.println("TotalCount: " + resp.getTotalCount()); //列印匹配到的總行數,非返回行數。
        System.out.println("Row: " + resp.getRows());
    }

常見問題

相關文檔