【elasticsearch-8】地理位置

原创
09/10 14:47
阅读数 27

1. 地理位置

参考文档:https://www.elastic.co/guide/cn/elasticsearch/guide/current/geoloc.html

2. 地理坐标点

2.1. 设置索引属性

  • geo_point: 地理坐标类型
  • lat_lon: 设置为 true 时,latlon 字段将被分别索引。它们可以被用于检索,但是不会在检索结果中返回。
{
  "mappings": {
    "<index_name>": {
      "properties": {
        "<field>": {
          "type": "geo_point",
          "lat_lon": true
        }
      }
    }
  }
}

2.2. 经纬度格式

格式一:字符串,格式 "lat,lon"

{
  "location": "40.715, -74.011"
}

格式二:

{
  "location": {
    "lat":     40.722,
    "lon":    -73.989
  }
}

格式三:数组,格式 [lon,lat]

{
  "location": [ -73.983, 40.719 ]
}

3. 过滤查找

3.1. geo_bounding_box

地理坐标盒模型过滤器,找出落在指定矩形框中的点

  • 地理坐标盒模型过滤器不需要把所有坐标点都加载到内存里。 因为它要做的只是简单判断 latlon 坐标数值是否在给定的范围内,可以用倒排索引做一个 range 过滤来实现目标
  • 设置 type 参数为 indexed (替代默认值 memory )来明确告诉 Elasticsearch 对这个过滤器使用倒排索引。
{
    "query": {
        "filtered": {
            "filter": {
                "geo_bounding_box": {
                    "type": "indexed",
                    "location": {
                        "top_left": {
                            "lat": 40.8,
                            "lon": -74.0
                        },
                        "bottom_right": {
                            "lat": 40.7,
                            "lon": -73.0
                        }
                    }
                }
            }
        }
    }
}

3.2. geo_distance

地理距离过滤器,找出与指定位置在给定距离内的点

常用距离单位: mi(英里), yd(码), in(英寸), km(千米), m(米), cm(厘米), mm(毫秒)

{
    "query": {
        "filtered": {
            "filter": {
                "geo_distance": {
                    "distance": "1km",
                    "location": {
                        "lat": 40.715,
                        "lon": -73.988
                    }
                }
            }
        }
    }
}

3.3. geo_distance_range

地理距离区间过滤器, 找出与指定点距离在给定最小距离和最大距离之间的点

  • 匹配那些距离中心点大于等于 1km 而小于 2km 的位置
{
    "query": {
        "filtered": {
            "filter": {
                "geo_distance_range": {
                    "gte": "1km",
                    "lt": "2km",
                    "location": {
                        "lat": 40.715,
                        "lon": -73.988
                    }
                }
            }
        }
    }
}

3.4. geo_polygon

找出落在多边形中的点。 这个过滤器使用代价很大。当你觉得自己需要使用它,最好先看看

3.5. 按距离排序

  • 计算每个文档中 location 字段与指定的 lat/lon 点间的距离
  • 将距离以 km 为单位写入到每个返回结果的 sort 键中
  • 使用快速但精度略差的 plane 计算方式
{
    "query": {
        "filtered": {
            "filter": {
                "geo_bounding_box": {
                    "type": "indexed",
                    "location": {
                        "top_left": {
                            "lat": 40.8,
                            "lon": -74.0
                        },
                        "bottom_right": {
                            "lat": 40.4,
                            "lon": -73.0
                        }
                    }
                }
            }
        }
    },
    "sort": [
        {
            "_geo_distance": {
                "location": {
                    "lat": 40.715,
                    "lon": -73.998
                },
                "order": "asc",
                "unit": "km",
                "distance_type": "plane"
            }
        }
    ]
}
展开阅读全文
打赏
0
0 收藏
分享
加载中
更多评论
打赏
0 评论
0 收藏
0
分享
返回顶部
顶部