# Geo Polygon Query（地理多边形查询）

原文链接 : [https://www.elastic.co/guide/en/elasticsearch/reference/5.4/query-dsl-geo-polygon-query.html#_lat_lon_as_string_4](https://www.elastic.co/guide/en/elasticsearch/reference/5.4/query-dsl-geo-polygon-query.html#_lat_lon_as_string_4)

译文链接 :[Geo Polygon Query（地理多边形查询）](/pages/viewpage.action?pageId=10029912)

贡献者 : [@yangbin](http://www.apache.wiki/display/~yangbin)，[ApacheCN](/display/~apachecn)，[Apache中文网](/display/~apachechina)

一个查询，允许包含仅在点的多边形内的命中。 这是一个例子： 

```
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**（默认值）时，如果字段未映射，则查询将抛出异常。