PHP SDK實現地理位置查詢 -

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

前提條件

已初始化OTSClient。具體操作，請參見初始化OTSClient。
已建立資料表並寫入資料。具體操作，請參見建立資料表和寫入資料。
已在資料表上建立多元索引。具體操作，請參見建立多元索引。

地理距離查詢（GeoDistanceQuery）

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

參數

參數	說明
table_name	資料表名稱。
index_name	多元索引名稱。
query	多元索引的查詢語句。設定查詢類型為QueryTypeConst::GEO_DISTANCE_QUERY。
field_name	列名，類型為Geopoint。
center_point	中心地理座標點，是一個經緯度值。格式為`緯度,經度`，緯度在前，經度在後，且緯度範圍為[-90,+90]，經度範圍[-180,+180]。例如`35.8,-45.91`。
distance	距離中心點的距離，類型為Double。單位為米。

樣本

以下樣本用於查詢表中geo列的值距離中心點30.001,120.001不超過1000米的資料。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 2,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::GEO_DISTANCE_QUERY,
            'query' => array(
                'field_name' => 'geo',
                'center_point' => '30.001,120.001',
                'distance' => 1000
            )
        ),
        'sort' => array(
            array(
                'geo_distance_sort' => array(
                    'field_name' => 'geo',
                    'order' => SortOrderConst::SORT_ORDER_ASC,
                    'distance_type' => GeoDistanceTypeConst::GEO_DISTANCE_PLANE,
                    'points' => array('30,120')
                )
            ),
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('geo')
    )
);
$response = $otsClient->search($request);

地理長方形範圍查詢（GeoBoundingBoxQuery）

GeoBoundingBoxQuery根據一個長方形範圍的地理位置邊界條件查詢表中的資料，當一個地理位置點落在給出的長方形範圍內時，滿足查詢條件。

參數

參數	說明
table_name	資料表名稱。
index_name	多元索引名稱。
query	多元索引的查詢語句。設定查詢類型為QueryTypeConst::GEO_BOUNDING_BOX_QUERY。
field_name	列名，類型為Geopoint。
top_left	長方形框的左上方的座標。
bottom_right	長方形框的右下角的座標，通過左上方和右下角的座標可以確定一個唯一的長方形。格式為`緯度,經度`，緯度在前，經度在後，且緯度範圍為[-90,+90]，經度範圍[-180,+180]。例如`35.8,-45.91`。

樣本

以下樣本用於查詢表中geo列的值在左上方座標為31,119，右下角座標為29,121的長方形範圍內的資料。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 2,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::GEO_BOUNDING_BOX_QUERY,
            'query' => array(
                'field_name' => 'geo',
                'top_left' => '31,119',
                'bottom_right' => '29,121'
            )
        ),
        'sort' => array(
            array(
                'geo_distance_sort' => array(
                    'field_name' => 'geo',
                    'order' => SortOrderConst::SORT_ORDER_ASC,
                    'distance_type' => GeoDistanceTypeConst::GEO_DISTANCE_PLANE,
                    'points' => array('30,120')
                )
            ),
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('geo')
    )
);
$response = $otsClient->search($request);

地理多邊形範圍查詢（GeoPolygonQuery）

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

參數

參數	說明
table_name	資料表名稱。
index_name	多元索引名稱。
query	多元索引的查詢語句。設定查詢類型為QueryTypeConst::GEO_POLYGON_QUERY。
field_name	列名，類型為Geopoint。
points	組成多邊形範圍的座標，通過多個座標可以確定一個唯一的多邊形。格式為`緯度,經度`，緯度在前，經度在後，且緯度範圍為[-90,+90]，經度範圍[-180,+180]。例如`35.8,-45.91`。

樣本

以下樣本用於查詢表中geo列的值在由31,120、29,121和29,119座標組成的多邊形範圍內的資料。

$request = array(
    'table_name' => 'php_sdk_test',
    'index_name' => 'php_sdk_test_search_index',
    'search_query' => array(
        'offset' => 0,
        'limit' => 2,
        'get_total_count' => true,
        'query' => array(
            'query_type' => QueryTypeConst::GEO_POLYGON_QUERY,
            'query' => array(
                'field_name' => 'geo',
                'points' => array(
                    "31,120",
                    "29,121",
                    "29,119"
                )
            )
        ),
        'sort' => array(
            array(
                'geo_distance_sort' => array(
                    'field_name' => 'geo',
                    'order' => SortOrderConst::SORT_ORDER_ASC,
                    'distance_type' => GeoDistanceTypeConst::GEO_DISTANCE_PLANE,
                    'points' => array('30,120')
                )
            ),
        )
    ),
    'columns_to_get' => array(
        'return_type' => ColumnReturnTypeConst::RETURN_SPECIFIED,
        'return_names' => array('geo')
    )
);
$response = $otsClient->search($request);

：地理位置查詢

前提條件

地理距離查詢（GeoDistanceQuery）

地理長方形範圍查詢（GeoBoundingBoxQuery）

地理多邊形範圍查詢（GeoPolygonQuery）

常見問題

相關文檔