前提條件

• 已初始化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);

常見問題

• 使用多元索引Search接口查不到數據

• 為什么使用多元索引翻頁查詢時Token失效了？

相關文檔

• 多元索引查詢類型包括精確查詢、多詞精確查詢、全匹配查詢、匹配查詢、短語匹配查詢、前綴查詢、范圍查詢、通配符查詢、多條件組合查詢、地理位置查詢、嵌套類型查詢和列存在性查詢，您可以選擇合適的查詢類型進行多維度數據查詢。

  如果要對結果集進行排序或者翻頁，您可以使用排序和翻頁功能來實現。具體操作，請參見排序和翻頁。

  如果要按照某一列對結果集做折疊，使對應類型的數據在結果展示中只出現一次，您可以使用折疊（去重）功能來實現。具體操作，請參見折疊（去重）。

• 如果要進行數據分析，例如求最值、求和、統計行數等，您可以使用Search接口的統計聚合功能或者SQL查詢來實現。具體操作，請參見統計聚合和SQL查詢。

• 如果要快速導出數據，而不關心整個結果集的順序時，您可以使用ParallelScan接口和ComputeSplits接口實現多并發導出數據。具體操作，請參見并發導出數據。