# Geo Bounding Box Query（地理边框查询）

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

译文链接 : [Geo Bounding Box Query（地理边框查询）](/pages/viewpage.action?pageId=5505153)

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

允许使用边框对基于点位置的点击进行过滤的查询。 假设以下索引文档： 

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