：地理位置查詢

前提條件

• 已初始化OTSClient。具體操作，請參見初始化OTSClient。

• 已建立資料表並寫入資料。具體操作，請參見建立資料表和寫入資料。

• 已在資料表上建立多元索引。具體操作，請參見建立多元索引。

地理距離查詢（GeoDistanceQuery）

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

• 參數

  參數	說明
  FieldName	列名，類型為Geopoint。
  CenterPoint	中心地理座標點，是一個經緯度值。 格式為“緯度,經度”，緯度在前，經度在後，且緯度範圍為-90～+90，經度範圍-180～+180。例如“35.8,-45.91”。
  DistanceInMeter	距離中心點的距離，類型為Double。單位為米。
  Query	多元索引的查詢語句。設定查詢類型為GeoDistanceQuery。
  TableName	資料表名稱。
  IndexName	多元索引名稱。
  ColumnsToGet	是否返回所有列。包含ReturnAll和Columns以及ReturnAllFromIndex設定。 ReturnAll預設為false，表示不返回所有列。此時可以通過如下任一設定返回所需列。如果未設定Columns和ReturnAllFromIndex，則只返回主鍵列。 設定Columns指定返回的列。 設定ReturnAllFromIndex為true返回多元索引中的所有列。 當設定ReturnAll為true時，表示返回所有列。

• 樣本

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

  /// <summary> 
  ///  查詢表中geo_type_col列的值距離中心點不超過一定距離的資料。
  /// </summary>
  /// <param name="client"></param>
  public static void GeoDistanceQuery(OTSClient client)
  {
      SearchQuery searchQuery = new SearchQuery();
      GeoDistanceQuery geoDistanceQuery = new GeoDistanceQuery();  //設定查詢類型為GeoDistanceQuery。
      geoDistanceQuery.FieldName = Geo_type_col;
      geoDistanceQuery.CenterPoint = "10,11"; //設定中心點。
      geoDistanceQuery.DistanceInMeter = 10000; //設定條件為到中心點的距離不超過10000米。
      searchQuery.Query = geoDistanceQuery;
  
      SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
  
      ColumnsToGet columnsToGet = new ColumnsToGet();
      columnsToGet.Columns = new List<string>() { Geo_type_col };  //設定返回Col_GeoPoint列。
      searchRequest.ColumnsToGet = columnsToGet;
  
      SearchResponse response = client.Search(searchRequest);
      Console.WriteLine(response.TotalCount);
  }
              

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

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

• 參數

  參數	說明
  FieldName	列名，類型為Geopoint。
  TopLeft	長方形框的左上方的座標。
  BottomRight	長方形框的右下角的座標，通過左上方和右下角就可以確定一個唯一的長方形。 格式為“緯度,經度”，緯度在前，經度在後，且緯度範圍為-90～+90，經度範圍-180～+180。例如“35.8,-45.91”。
  Query	多元索引的查詢語句。設定查詢類型為GeoBoundingBoxQuery。
  TableName	資料表名稱。
  IndexName	多元索引名稱。
  ColumnsToGet	是否返回所有列。包含ReturnAll和Columns以及ReturnAllFromIndex設定。 ReturnAll預設為false，表示不返回所有列。此時可以通過如下任一設定返回所需列。如果未設定Columns和ReturnAllFromIndex，則只返回主鍵列。 設定Columns指定返回的列。 設定ReturnAllFromIndex為true返回多元索引中的所有列。 當設定ReturnAll為true時，表示返回所有列。

• 樣本

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

  /// <summary>
  /// geo_type_col是Geopoint類型，查詢表中geo_type_col列的值在左上方為"10,0", 右下角為"0,10"的長方形範圍內的資料。
  /// </summary>
  /// <param name="client"></param>
  public static void GeoBoundingBoxQuery(OTSClient client)
  {
      SearchQuery searchQuery = new SearchQuery();
      GeoBoundingBoxQuery geoBoundingBoxQuery = new GeoBoundingBoxQuery(); //設定查詢類型為GeoBoundingBoxQuery。
      geoBoundingBoxQuery.FieldName = Geo_type_col; //設定列名。
      geoBoundingBoxQuery.TopLeft = "10,0"; //設定長方形左上方。
      geoBoundingBoxQuery.BottomRight = "0,10"; //設定長方形右下角。
      searchQuery.Query = geoBoundingBoxQuery;
  
      SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
  
      var columnsToGet = new ColumnsToGet();
      columnsToGet.Columns = new List<string> { Geo_type_col };  //設定返回Col_GeoPoint列。
      searchRequest.ColumnsToGet = columnsToGet;
  
      SearchResponse response = client.Search(searchRequest);
      Console.WriteLine(response.TotalCount);
  }

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

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

• 參數

  參數	說明
  FieldName	列名，類型為Geopoint。
  Points	組成多邊形的距離座標點。 格式為“緯度,經度”，緯度在前，經度在後，且緯度範圍為-90～+90，經度範圍-180～+180。例如“35.8,-45.91”。
  Query	多元索引的查詢語句。設定查詢類型為GeoPolygonQuery。
  TableName	資料表名稱。
  IndexName	多元索引名稱。
  ColumnsToGet	是否返回所有列。包含ReturnAll和Columns以及ReturnAllFromIndex設定。 ReturnAll預設為false，表示不返回所有列。此時可以通過如下任一設定返回所需列。如果未設定Columns和ReturnAllFromIndex，則只返回主鍵列。 設定Columns指定返回的列。 設定ReturnAllFromIndex為true返回多元索引中的所有列。 當設定ReturnAll為true時，表示返回所有列。

• 樣本

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

  /// <summary>
  /// 查詢表中geo_type_col列的值在一個給定多邊形範圍內的資料。
  /// </summary>
  /// <param name="client"></param>
  public static void GeoPolygonQuery(OTSClient client)
  {
      SearchQuery searchQuery = new SearchQuery();
      GeoPolygonQuery geoPolygonQuery = new GeoPolygonQuery();  //設定查詢類型為GeoPolygonQuery。
      geoPolygonQuery.FieldName = Geo_type_col;
      geoPolygonQuery.Points = new List<string>() { "0,0", "10,0", "10,10" }; //設定多邊形的頂點。
      searchQuery.Query = geoPolygonQuery;
  
      SearchRequest searchRequest = new SearchRequest(TableName, IndexName, searchQuery);
  
      ColumnsToGet columnsToGet = new ColumnsToGet();
      columnsToGet.Columns = new List<string>() { Geo_type_col };  //設定返回Col_GeoPoint列。
      searchRequest.ColumnsToGet = columnsToGet;
  
      SearchResponse response = client.Search(searchRequest);
      Console.WriteLine(response.TotalCount);
  }
              

常見問題

• 使用多元索引Search介面查不到資料

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

相關文檔

• 多元索引查詢類型包括精確查詢、多詞精確查詢、全匹配查詢、匹配查詢、短語匹配查詢、首碼查詢、範圍查詢、萬用字元查詢、多條件組合查詢、地理位置查詢、巢狀型別查詢和列存在性查詢，您可以選擇合適的查詢類型進行多維度資料查詢。

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

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

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

• 如果要快速匯出資料，而不關心整個結果集的順序時，您可以使用ParallelScan介面和ComputeSplits介面實現多並發匯出資料。具體操作，請參見並發匯出資料。