Geo Distance Query(地理距离查询)

过滤仅包含距离地理位置特定距离内的命中的文档。 假设以下映射和索引文档:

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_distance 过滤器执行以下简单查询:

GET /my_locations/location/_search
{
    "query": {
        "bool" : {
            "must" : {
                "match_all" : {}
            },
            "filter" : {
                "geo_distance" : {
                    "distance" : "200km",
                    "pin.location" : {
                        "lat" : 40,
                        "lon" : -70
                    }
                }
            }
        }
    }
}

Accepted Formats (接受格式)

以同样的方式,geo_point类型可以接受地理点的不同表示,过滤器也可以接受它:

Lat Lon As Properties (Lat Lon作为属性)

GET /my_locations/location/_search
{
    "query": {
        "bool" : {
            "must" : {
                "match_all" : {}
            },
            "filter" : {
                "geo_distance" : {
                    "distance" : "12km",
                    "pin.location" : {
                        "lat" : 40,
                        "lon" : -70
                    }
                }
            }
        }
    }
}

Lat Lon As Array (Lat Lon作为阵列)

Format in[lon, lat], note, the order of lon/lat here in order to conform with GeoJSON.

GET /my_locations/location/_search
{
    "query": {
        "bool" : {
            "must" : {
                "match_all" : {}
            },
            "filter" : {
                "geo_distance" : {
                    "distance" : "12km",
                    "pin.location" : [-70, 40]
                }
            }
        }
    }
}

Lat Lon As String(Lat Lon作为字符串)

Format in lat,lon.

GET /my_locations/location/_search
{
    "query": {
        "bool" : {
            "must" : {
                "match_all" : {}
            },
            "filter" : {
                "geo_distance" : {
                    "distance" : "12km",
                    "pin.location" : "40,-70"
                }
            }
        }
    }
}

Geohash(地理散列)

GET /my_locations/location/_search
{
    "query": {
        "bool" : {
            "must" : {
                "match_all" : {}
            },
            "filter" : {
                "geo_distance" : {
                    "distance" : "12km",
                    "pin.location" : "drm3btev3e86"
                }
            }
        }
    }
}

Options(选项)

以下是过滤器上允许的选项:

distance(距离)

以指定位置为中心的圆的半径。 落入此圈子的点被认为是匹配的。 距离可以用各种单位指定。 看 the section called “Distance Unitsedit”.

distance_type(距离类型)

如何计算距离。 可以是弧(默认)或平面(更快,但长距离不准确,靠近极点)。

optimize_bbox(优化bbox)

是否在距离检查之前首先运行边框检查使用优化。 默认在内存检查中执行的内存。 也可以使用索引值来使用索引值检查(在这种情况下确保geo_pointtype索引lat lon),否则禁用边界框优化。[2.2]

_name(名称)

可选名称字段来标识查询。

ignore_malformed(忽略格式错误)

[5.0.0] 设置为true以接受无效纬度或经度的地理点(默认值为假)。

validation_method(验证方法)

设置为IGNORE_MALFORMED以接受无效纬度或经度的地理点,设置为COERCE以额外尝试推断正确的坐标(默认为STRICT)。

geo_point Type(geo_point类型)

过滤器需要在相关字段上设置geo_point类型。

Multi Location Per Document(每个文档的多个位置)

geo_distance过滤器可以处理每个文档的多个位置/点。 一旦单个位置/点与过滤器匹配,文档将被包含在过滤器中。

Ignore Unmapped(忽略未映射)

当设置为true时,ignore_unmapped 选项将忽略未映射字段,并且将不会匹配此查询的任何文档。 当查询可能具有不同映射的多个索引时,可能很有用。 当设置为false(默认值)时,如果字段未映射,则查询将抛出异常。

Last updated