【开源社区】使用 ES 实现多种地理位置检索

1、地理位置检索常用的两种数据类型

1.1 geo_point：

概念：经纬度坐标，只支持WGS84坐标系，坐标范围Lat值为[-90,90]，Lon为[-180,180]

• latitude：维度 缩写：lat
• longitude：经度 缩写：lon
• ignore_malformed：则忽略格式错误的地理位置。如果 false（默认）

五种存储方式

1.2 geo_shape

概念：ES的特殊类型之一，用来描述复杂的几何图形的类型，比如点、线、面，多边形等二维几何模型。

• GeoJSON：GeoJSON是一种用于编码各种地理数据结构的格式，支持以下几种几何类型：
  • Point：点
  • LineString：线段
  • Polygon：多边形
  • MultiPoint：多点
  • MultiLineString：多线段
  • MultiPolygon：多边形集合
  • Feature：具有其他属性的对象
• WKT（Well-Known Text）：POINT(125.6 10.1)

GeoJSON（OGC）和WKT到Elasticsearch类型的映射关系

2、Geo_point Based Request

2.1 矩形查询（geo_bounding box）

概念：在同一个平面内，两个点确定一个矩形，搜索矩形内的坐标。

• top_left：矩形左上点坐标
• bottom_right：矩形右上角表

2.2 半径查询（geo_distance）

概念：以某个点为圆心查找指定半径的圆内的坐标。

• distance：距离单位，默认是米，支持以下选项
  • Mile（英里）：mi 或者 miles
  • Yard（码）：yd 或者 yards
  • Feet（英尺）：ft 或者 feet
  • Inch（英寸）：in 或者 inch
  • Kilometer（公里）：km 或者 kilometers
  • Meter（米）：m 或者 meters
  • Centimeter（厘米）：cm 或者 centimeters
  • Millimeter（毫米）： mm 或者 millimeters
  • Nautical mile（海里）： NM , nmi , 或者 nauticalmiles
• distance_type：计算距离的方式
• arc（默认值）：更准确，但是速度慢
• plane：（更快，但在长距离和极点附近不准确）

2.3 多边形（geo_polygon）

概念：查找给定多个点连成的多边形内的坐标。

3、Geo_shape Based Request

概念：支持指定几何图形相交、包含或是不相交等图形检索

3.1 地理几何分类（geo_shape type）

• 点（point）
• 矩形（envelope）
• 多边形 （polygon）
• 圆形（circle）

3.2 地理几何存储

注：圆形处理精度解释

表示圆的多边形的精度定义为error_distance。这种差异越小，多边形越接近理想圆。下表是旨在帮助捕获在给定不同输入的情况下圆的半径如何影响多边形的边数的表格。最小边数为4，最大为1000。

3.3 地理几何检索

• Inline Shape Definition：内联形状
• Pre-Indexed Shape：预定义形状
  • id- 包含预索引形状的文档ID。
  • index- 索引的名称，其中预索引形状为：默认形状。
  • routing- 非必须。
  • path- 包含预索引形状的指定路径，默认形状。
• Spatial Relations：空间关系
  • INTERSECTS- (default) Return all documents whose shape field intersects the query geometry。
  • DISJOINT - Return all documents whose shape field has nothing in common with the query geometry
  • WITHIN - Return all documents whose shape field is within the query geometry。
  • CONTAINS- Return all documents whose shape field contains the query geometry。