# Geo Polygon Query（地理多邊形查詢） 一個查詢，允許包含僅在點的多邊形內的命中。 這是一個例子：? | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_polygon"`?`: {` `"person.location"`?`: {` `"points"`?`: [` `{``"lat"`?`: 40,?``"lon"`?`: -70},` `{``"lat"`?`: 30,?``"lon"`?`: -80},` `{``"lat"`?`: 20,?``"lon"`?`: -90}` `]` `}` `}` `}` `}` `}` `}` | ### Query Options（查詢選項）? | Option（選項） | Description（描述） | | --- | --- | | `_name（名稱）` | 可選名稱字段來標識過濾器 | | `ignore_malformed（忽略格式錯誤）` | ~~[5.0.0]~~?設置為**?true**?以接受無效緯度或經度的地理點（默認值為假）。 | | `validation_method（驗證方法）` | 設置為**?IGNORE_MALFORMED**?以接受無效緯度或經度的地理點，**COERCE?**嘗試推斷正確的緯度或經度，或?**STRICT**（默認為?**STRICT**）。 | ### Allowed Formats（允許格式） ### Lat Long as Array（Lat Long 作為陣列） 格式在**?[lon，lat]**?中，注意，這里的?**lon / lat**?的順序是為了符合?**[GeoJSON](http://geojson.org/).?** | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_polygon"`?`: {` `"person.location"`?`: {` `"points"`?`: [` `[-70, 40],` `[-80, 30],` `[-90, 20]` `]` `}` `}` `}` `}` `}` `}` | ### Lat Lon as String（Lat Lon 作為字符串）? 格式在?**lat，lon。 ?** | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_polygon"`?`: {` `"person.location"`?`: {` `"points"`?`: [` `"40, -70"``,` `"30, -80"``,` `"20, -90"` `]` `}` `}` `}` `}` `}` `}` | ### Geohash（地理散列）? | `GET?``/_search` `{` `"query"``: {` `"bool"`?`: {` `"must"`?`: {` `"match_all"`?`: {}` `},` `"filter"`?`: {` `"geo_polygon"`?`: {` `"person.location"`?`: {` `"points"`?`: [` `"drn5x1g8cu2y"``,` `"30, -80"``,` `"20, -90"` `]` `}` `}` `}` `}` `}` `}` | ### geo_point Type（geo_point類型） 該查詢需要在相關字段上設置**?[`geo_point`](https://www.elastic.co/guide/en/elasticsearch/reference/5.4/geo-point.html "Geo-point datatype")**?類型。 ### Ignore Unmapped（忽略未映射） 當設置為**?true**?時，**ignore_unmapped**?選項將忽略未映射字段，并且將不會匹配此查詢的任何文檔。 當查詢可能具有不同映射的多個索引時，這可能很有用。 當設置為**?false**（默認值）時，如果字段未映射，則查詢將拋出異常。