Elasticsearch权威指南：地理形状查询详解

Elasticsearch权威指南：地理形状查询详解

elasticsearch-definitive-guide The Definitive Guide to Elasticsearch 项目地址: https://gitcode.com/gh_mirrors/el/elasticsearch-definitive-guide

地理形状查询概述

在Elasticsearch中，geo_shape查询是一种强大的地理空间查询方式，它允许我们使用形状（而不仅仅是点）来进行查询和过滤。这与传统的geo_distance查询形成鲜明对比，后者只能基于点与点之间的距离进行查询。

基本查询结构

geo_shape查询的基本语法结构如下：

{
  "query": {
    "geo_shape": {
      "字段名": {
        "shape": {
          "type": "形状类型",
          "radius": "半径(仅圆形需要)",
          "coordinates": [坐标数组]
        }
      }
    }
  }
}

圆形区域查询示例

假设我们需要查询阿姆斯特丹中央火车站周边1公里范围内的所有地标，可以使用以下查询：

GET /attractions/landmark/_search
{
  "query": {
    "geo_shape": {
      "location": {
        "shape": {
          "type": "circle",
          "radius": "1km",
          "coordinates": [4.89994, 52.37815]
        }
      }
    }
  }
}

这个查询中：

• location是包含地理形状的字段
• 查询形状是一个圆形(circle)
• 半径设置为1公里
• 圆心坐标位于阿姆斯特丹中央火车站入口处

关系参数(relation)详解

geo_shape查询默认查找与查询形状相交的索引形状，但可以通过relation参数改变匹配逻辑：

1. intersects(默认)：匹配与查询形状相交的索引形状
2. disjoint：匹配不与查询形状相交的索引形状
3. within：匹配完全包含在查询形状内的索引形状

多边形区域查询示例

要查找阿姆斯特丹市中心区域内的所有地标，可以使用within关系和多边形查询：

GET /attractions/landmark/_search
{
  "query": {
    "geo_shape": {
      "location": {
        "relation": "within",
        "shape": {
          "type": "polygon",
          "coordinates": [[
            [4.88330,52.38617],
            [4.87463,52.37254],
            [4.87875,52.36369],
            [4.88939,52.35850],
            [4.89840,52.35755],
            [4.91909,52.36217],
            [4.92656,52.36594],
            [4.93368,52.36615],
            [4.93342,52.37275],
            [4.92690,52.37632],
            [4.88330,52.38617]
          ]]
        }
      }
    }
  }
}

这个查询中：

• 使用within关系确保只返回完全位于查询多边形内的地标
• 多边形坐标定义了阿姆斯特丹市中心区域的边界

实际应用场景

地理形状查询在实际应用中有广泛用途：

1. 商业选址分析：查找特定商业区域内的潜在客户
2. 城市规划：分析特定规划区域内的设施分布
3. 物流配送：确定配送区域内的所有收货点
4. 地理围栏：监控进入或离开特定区域的移动设备

性能优化建议

1. 对于复杂形状，考虑使用预索引形状
2. 合理设置形状精度，过高的精度会影响查询性能
3. 对于静态查询形状，可以使用过滤器(filter)代替查询(query)以提高性能
4. 考虑使用空间分层技术优化大规模地理数据查询

通过掌握geo_shape查询，开发者可以在Elasticsearch中实现复杂的地理空间分析功能，满足各种基于地理位置的高级查询需求。

elasticsearch-definitive-guide The Definitive Guide to Elasticsearch 项目地址: https://gitcode.com/gh_mirrors/el/elasticsearch-definitive-guide