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

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

译文链接 : Geo Bounding Box Query（地理边框查询）

贡献者 : @yangbin，ApacheCN，Apache中文网

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

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（查询选项）

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。

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