Geo Bounding Box Query（地理邊框查詢） · my-elasticsearch-cn

# Geo Bounding Box Query（地理邊框查詢）允許使用邊框對基于點位置的點擊進行過濾的查詢。假設以下索引文檔：? | `PUT?``/my_locations` `{` `"mappings"``: {` `"location"``: {` `"properties"``: {` `"pin"``: {` `"properties"``: {` `"location"``: {` `"type"``:?``"geo_point"` `}` `}` `}` `}` `}` `}` `}` `PUT?``/my_locations/location/1` `{` `"pin"`?`: {` `"location"`?`: {` `"lat"`?`: 40.12,` `"lon"`?`: -71.34` `}` `}` `}` | 然后可以使用**?geo_bounding_box**?過濾器執行以下簡單查詢：? | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top_left"`?`: {` `"lat"`?`: 40.73,` `"lon"`?`: -74.1` `},` `"bottom_right"`?`: {` `"lat"`?`: 40.01,` `"lon"`?`: -71.12` `}` `}` `}` `}` `}` `}` `}` | ### Query Options（查詢選項）? | Option（選項） | Description（描述） | | --- | --- | | `_name（名稱）` | 可選名稱字段來標識過濾器。 | | `ignore_malformed（忽略異常）` | [~~5.0.0~~] 設置為**?true**?以接受無效緯度或經度的地理點（默認值為假）。 | | `validation_method（驗證方法）` | 設置為?**IGNORE_MALFORMED**?以接受無效緯度或經度的地理點，設置為?**COERCE**?也嘗試推斷正確的緯度或經度。（默認為?**STRICT**）。 | | `type（類型）` | 設置為索引或內存之一，以定義此過濾器是否將在內存或索引中執行。有關詳細信息，請參閱下面的**[Type](https://www.elastic.co/guide/en/elasticsearch/reference/5.4/query-dsl-geo-bounding-box-query.html#geo-bbox-type "Typeedit")?**默認值是 Memory。 | ### **Accepted Formats（接**受格式）以同樣的方式，**geo_point**?類型可以接受地理點的不同表示，過濾器也可以接受它： ### Lat Lon As Properties（Lat Lon 作為屬性） | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top_left"`?`: {` `"lat"`?`: 40.73,` `"lon"`?`: -74.1` `},` `"bottom_right"`?`: {` `"lat"`?`: 40.01,` `"lon"`?`: -71.12` `}` `}` `}` `}` `}` `}` `}` | ### Lat Lon As Array （Lat Lon 作為排列）? 格式在**?[lon，lat]**?中，注意，這里的**?lon / lat**?的順序是為了符合**?[GeoJSON](http://geojson.org/)。** | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top_left"`?`: [-74.1, 40.73],` `"bottom_right"`?`: [-71.12, 40.01]` `}` `}` `}` `}` `}` `}` | ### Lat Lon As String（Lat Lon 作為字符串）? 格式在?**lat，lon**。? | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top_left"`?`:?``"40.73, -74.1"``,` `"bottom_right"`?`:?``"40.01, -71.12"` `}` `}` `}` `}` `}` | ### Geohash（地理散列）? | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top_left"`?`:?``"dr5r9ydj2y73"``,` `"bottom_right"`?`:?``"drj7teegpus6"` `}` `}` `}` `}` `}` `}` | ### Vertices（頂點）邊框的頂點可以由?**top_left?**和?**bottom_right**?或?**top_rightand bottom_left**?參數設置。更多的名稱?**topLeft，bottomRight，topRight和bottomLeft**?是支持的。而不是成對設置值，可以使用簡單的名稱頂部，左側，底部和右側單獨設置值。 | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top"`?`: 40.73,` `"left"`?`: -74.1,` `"bottom"`?`: 40.01,` `"right"`?`: -71.12` `}` `}` `}` `}` `}` `}` | ### geo_point Type（geo_point類型）過濾器需要在相關字段上設置?**geo_point**?類型。 ### Multi Location Per Document（每個文檔的多個位置）過濾器可以與每個文檔的多個位置/點配合使用。一旦單個位置/點與過濾器匹配，文檔將被包含在過濾器中。 ### Type（類型）默認情況下，邊框執行的類型設置為內存，這意味著在內存中檢查文檔是否在邊框范圍內。在某些情況下，索引選項的執行速度會更快（但是請注意，在這種情況下，**geo_point**?類型必須具有?**lat**?和**?lon**索引）。請注意，使用索引選項時，不支持每個文檔字段的多個位置。這是一個例子： | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_bounding_box"`?`: {` `"pin.location"`?`: {` `"top_left"`?`: {` `"lat"`?`: 40.73,` `"lon"`?`: -74.1` `},` `"bottom_right"`?`: {` `"lat"`?`: 40.10,` `"lon"`?`: -71.12` `}` `},` `"type"`?`:?``"indexed"` `}` `}` `}` `}` `}` | ### Ignore Unmapped（忽略未映射）當設置為?**true**?時，**ignore_unmapped**?選項將忽略未映射字段，并且將不匹配此查詢的任何文檔。當查詢可能具有不同映射的多個索引時，這可能很有用。當設置為?**false**（默認值）時，如果字段未映射，則查詢將拋出異常。