在本文中，我们将了解 Elasticsearch 的地理查询、如何设置映射和索引，并提供一些示例来说明如何查询数据。

Elasticsearch 允许你以两种方式表示 GeoData：geo_shape 和 geo_point。

Geo Point 允许你将数据存储为纬度和经度坐标对。 当你要针对点之间的距离过滤数据、在边界框内搜索或使用聚合时，请使用此字段类型。 你可以指定许多超出本文范围的功能和选项。 我们将在这里介绍几个，但你可以在 Elasticsearch 的文档中查看地理边界框、地理距离和地理聚合的选项。

当你拥有表示形状的 GeoData 时，或者当你想要查询形状内的点时，请使用 Geo-Shape。 geo_shape 数据必须以 GeoJSON 格式编码，该格式被转换为表示 Geohash 单元格网格上的长/纬度坐标对的字符串。 由于 Elasticsearch 将形状作为术语进行索引，因此很容易确定形状之间的关系，这些关系可以使用相交、不相交、包含或在查询空间关系运算符中进行查询。更多关于 geohash 的学习，请参阅 “Elasticsearch：理解 Elastic Maps 中的 geohash 及其聚合”。

遗憾的是 geo-point 和 geo-shape 不能一起查询。 例如，如果要获取指定多边形内的所有城市，则不能使用以地理点为索引的城市。 它们必须使用 GeoJSON 中的 “type": "point" 进行索引，并作为 geo-shape 进行索引。

geo_point 类型的字段接受经纬度对，可以使用：

我们可以使用如下的方式来定义一个带有 geo_point 数据类型的索引：

我们可以用五种不同的方式存储 Geo Point。

对象可以与 lat 和 lon 等属性一起使用。

一个纯字符串，可以使用 “,” 分隔，格式为 lat, lon 。

哈希值用于表示 lat 和 lon 。 有一个在线网站可以这样做：

坐标可以用数组 [lon, lat] 的形式表示，值为 double 。

坐标可以用函数 POINT(lon lat) 的形式表示。

注意：无论地理点以何种格式保存，我们也可以查询其他格式。 但要小心正确定义格式。 不要替换为 lat 和 lon 值。 这可以给出未预先确定的值。

geo_shape 数据类型有助于对任意地理形状（例如矩形和多边形）进行索引和搜索。 当被索引的数据或被执行的查询包含形状而不仅仅是点时，应该使用它。

你可以使用 geo_shape 查询使用此类型查询文档。

我们有如下的几种方式来存储 geo_shape 数据。

单个地理坐标。 注意：Elasticsearch 仅使用 WGS-84 坐标。

给定两个或多个点的任意线。

一个封闭的多边形，其首点和末点必须匹配，因此需要 n + 1 个顶点来创建 n 边多边形，并且最少需要 4 个顶点。

一组单独的多边形：

一组未连接但可能相关的点:

一组单独的线字符串：

GeoJSON 形状类似于 multi* 形状，只是多种类型可以共存（例如，Point 和 LineString）。

边界矩形或信封，通过仅指定左上角和右下角点来指定。

通过使用 geo_point 或 geo_shape，Elasticsearch 将自动查找坐标，根据需要的格式对其进行验证，并对其进行索引。

如果你还没有安装好自己的 Elasticsearch 及 Kibana 的话，请参考我之前的文章 “Elasticsearch：如何在 Docker 上运行 Elasticsearch 8.x 进行本地开发”。我们采用 docker-compose 来进行安装。为了方便测试，我们将不使用安全配置。你也可以参考文章 “Elastic Stack 8.0 安装 - 保护你的 Elastic Stack 现在比以往任何时候都简单” 中的 “如何配置 Elasticsearch 不带安全性” 章节来进行安装。在我们今天测试中，我们将使用最新的 Elastic Stack 8.6.2 来进行测试。

我们将在本演练中使用的数据取自华盛顿州交通部 (WSDOT) 地理数据目录。 下载 “City Points” 和 “WSDOT Regions 24k” 的 shapefile。 City Points 将为我们提供华盛顿的城市，而 WSDOT Regions 将为我们提供 WSDOT 指定的区域。 你可以在下载前单击下载链接旁边的查看来查看数据。 我已将 shapefile 转换为 GeoJSON 格式。

我创建了一个 nodejs 应用程序来创建索引和加载数据。 请按照 Github 链接中的步骤操作，并按照 README 文件加载数据。我们使用如下的命令来下载代码：

我们运行如下的命令来写入索引 geo_cities_point:

我们运行如下的命令来写入索引 geo_cities_shapes：

我们通过如下的命令来查看最新写入的索引：

我们可以通过如下的命令来查看两个索引的 mapping：

 上面显示 loclation 字段为 geo_point 类型。我们通过如下的命令来查看 geo_cities_shapes 的 mapping：

上面表明 location 字段为一个 geo_shape 的类型。

Elasticsearch 使用术语查询和过滤器。 查询依赖于 “评分”，或者文档是否与查询匹配以及匹配的程度如何。 另一方面，过滤是 “非评分” 的，它确定文档是否与查询匹配。 根据 Elasticsearch，从 2.x 开始，查询和过滤已成为同义词，因为你可以同时拥有评分和非评分查询。 使用评分或非评分查询有各种性能优势和缺点，但经验法则是当相关性分数很重要时使用评分查询，而对其他一切使用非评分查询。

由于我们的索引中有一些数据，是时候开始查询了。 我们将了解一些可用于 geo_point 和 geo_shape 的基本查询。

要获得任意两点之间的距离，我们的数据必须使用 geo_point 类型存储。 该文档提供了各种数据格式作为示例。 在 GeoPoint 的给定距离内匹配 geo_point 和 geo_shape 值。 以下查询列出了 10 英里距离内的位置。

适用于 geo_point 字段的多桶聚合，在概念上与范围聚合非常相似。 用户可以定义一个原点和一组距离范围桶。 聚合评估每个文档值与原点的距离，并根据范围确定其所属的桶（如果文档与原点之间的距离在桶的距离范围内，则文档属于该桶）。

有时我们需要知道一个范围内的坐标数。 这是一个用于列出结果的聚合函数。 现在我们将尝试找到直到 10 MI 、从 10 MI 到 50 MI 、从 50 MI 到 100 MI 和从 100 MI 的坐标。 这应该返回范围内匹配的文档数。

上述命令的返回值为：

我们也可以返回仅落在多边形点内的命中的查询：

上面的查询返回结果：

匹配与边界框相交的 geo_point 和 geo_shape 值。 当 GeoHashes 用于指定边界框边缘的边界时，GeoHashes 被视为矩形。 边界框的定义方式是，其左上角对应于 top_left 参数中指定的 GeoHash 的左上角，其右下角定义为 bottom_right 参数中指定的 GeoHash 的右下角。

地理点（geo_point）的精度有限，并且在索引时间内始终向下舍入。 在查询期间，边界框的上边界向下舍入，而下边界向上舍入。 因此，由于舍入误差，下边界上的点（边界框的底部和左边缘）可能无法进入边界框。 同时，查询可能会选择上边界（顶部和右边缘）旁边的点，即使它们稍微位于边缘之外。 纬度上的舍入误差应小于 4.20e-8 度，经度上的舍入误差应小于 8.39e-8 度，这意味着即使在赤道上也小于 1 厘米的误差。

所有 geo-shape 查询都需要使用 geo_shape 映射来映射你的数据。 使用 geo-shapes，我们可以找到与查询形状相交的文档。

过滤使用 geo_shape 或 geo_point 类型索引的文档。需要 geo_shape 映射或 geo_point 映射。

geo_shape 查询使用与 geo_shape 映射相同的网格正方形表示来查找具有与查询形状相交的形状的文档。 它还将使用为字段映射定义的相同前缀树配置。 查询支持两种定义查询形状的方法，通过提供整个形状定义或通过引用在另一个索引中预索引的形状的名称。 这两种格式都在下面通过示例进行了定义。

geo_shape 策略映射参数确定在搜索时可以使用哪些空间关系运算符。以下是搜索地理字段时可用的空间关系运算符的完整列表：

比如：

该查询还支持使用已在另一个索引中编制索引的形状。 当你有一个预定义的形状列表并且你希望使用逻辑名称（例如 New Zealand）而不是每次都提供坐标来引用该列表时，这特别有用。 在这种情况下，只需提供：

我们可以做如下的搜索：

在上面，我们的 shape 信息是从 shapes 这个索引里得到的。

更多阅读：

Elasticsearch：使用 Point 和 Shape 字段类型

Elasticsearch：使用 Elasticsearch 进行地理位置搜索