# 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（查询选项）
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) 类型。
## Ignore Unmapped（忽略未映射）
当设置为**true**时，**ignore\_unmapped**选项将忽略未映射字段，并且将不会匹配此查询的任何文档。 当查询可能具有不同映射的多个索引时，这可能很有用。 当设置为**false**（默认值）时，如果字段未映射，则查询将抛出异常。