地理形状查询
编辑地理形状查询编辑
筛选使用 geo_shape 或 geo_point 类型索引的文档。
geo_shape 查询使用与 geo_shape 或 geo_point 映射相同的 索引 来查找形状与查询形状相关的文档，使用指定的 空间关系：相交、包含、在内部或不相交。
该查询支持两种定义查询形状的方法，一种是提供完整的形状定义，另一种是引用预先索引在另一个索引中的形状的名称。下面将通过示例定义这两种格式。
内联形状定义编辑
与 geo_point 类型类似，geo_shape 查询使用 GeoJSON 来表示形状。
假设有以下索引，其中位置为 geo_shape 字段
response = client.indices.create(
index: 'example',
body: {
mappings: {
properties: {
location: {
type: 'geo_shape'
}
}
}
}
)
puts response
response = client.index(
index: 'example',
refresh: true,
body: {
name: 'Wind & Wetter, Berlin, Germany',
location: {
type: 'point',
coordinates: [
13.400544,
52.530286
]
}
}
)
puts response
PUT /example
{
"mappings": {
"properties": {
"location": {
"type": "geo_shape"
}
}
}
}
POST /example/_doc?refresh
{
"name": "Wind & Wetter, Berlin, Germany",
"location": {
"type": "point",
"coordinates": [ 13.400544, 52.530286 ]
}
}
以下查询将使用 Elasticsearch 的 envelope GeoJSON 扩展名查找该点
response = client.search(
index: 'example',
body: {
query: {
bool: {
must: {
match_all: {}
},
filter: {
geo_shape: {
location: {
shape: {
type: 'envelope',
coordinates: [
[
13,
53
],
[
14,
52
]
]
},
relation: 'within'
}
}
}
}
}
}
)
puts response
GET /example/_search
{
"query": {
"bool": {
"must": {
"match_all": {}
},
"filter": {
"geo_shape": {
"location": {
"shape": {
"type": "envelope",
"coordinates": [ [ 13.0, 53.0 ], [ 14.0, 52.0 ] ]
},
"relation": "within"
}
}
}
}
}
}
同样，可以在 geo_point 字段上查询上述查询。
response = client.indices.create(
index: 'example_points',
body: {
mappings: {
properties: {
location: {
type: 'geo_point'
}
}
}
}
)
puts response
response = client.index(
index: 'example_points',
id: 1,
refresh: true,
body: {
name: 'Wind & Wetter, Berlin, Germany',
location: [
13.400544,
52.530286
]
}
)
puts response
PUT /example_points
{
"mappings": {
"properties": {
"location": {
"type": "geo_point"
}
}
}
}
PUT /example_points/_doc/1?refresh
{
"name": "Wind & Wetter, Berlin, Germany",
"location": [13.400544, 52.530286]
}
使用相同的查询，将返回具有匹配 geo_point 字段的文档。
response = client.search(
index: 'example_points',
body: {
query: {
bool: {
must: {
match_all: {}
},
filter: {
geo_shape: {
location: {
shape: {
type: 'envelope',
coordinates: [
[
13,
53
],
[
14,
52
]
]
},
relation: 'intersects'
}
}
}
}
}
}
)
puts response
GET /example_points/_search
{
"query": {
"bool": {
"must": {
"match_all": {}
},
"filter": {
"geo_shape": {
"location": {
"shape": {
"type": "envelope",
"coordinates": [ [ 13.0, 53.0 ], [ 14.0, 52.0 ] ]
},
"relation": "intersects"
}
}
}
}
}
}
{
"took" : 17,
"timed_out" : false,
"_shards" : {
"total" : 1,
"successful" : 1,
"skipped" : 0,
"failed" : 0
},
"hits" : {
"total" : {
"value" : 1,
"relation" : "eq"
},
"max_score" : 1.0,
"hits" : [
{
"_index" : "example_points",
"_id" : "1",
"_score" : 1.0,
"_source" : {
"name": "Wind & Wetter, Berlin, Germany",
"location": [13.400544, 52.530286]
}
}
]
}
}
预先索引的形状编辑
该查询还支持使用已在另一个索引中索引的形状。当您有一个预定义的形状列表，并且希望使用逻辑名称（例如“新西兰”）而不是每次都提供坐标来引用该列表时，这将特别有用。在这种情况下，只需提供
-
id- 包含预先索引的形状的文档的 ID。 -
index- 预先索引的形状所在的索引的名称。默认为“shapes”。 -
path- 指定为包含预先索引的形状的路径的字段。默认为“shape”。 -
routing- 形状文档的路由（如果需要）。
以下是使用带有预先索引的形状的过滤器的示例
response = client.indices.create(
index: 'shapes',
body: {
mappings: {
properties: {
location: {
type: 'geo_shape'
}
}
}
}
)
puts response
response = client.index(
index: 'shapes',
id: 'deu',
body: {
location: {
type: 'envelope',
coordinates: [
[
13,
53
],
[
14,
52
]
]
}
}
)
puts response
response = client.search(
index: 'example',
body: {
query: {
bool: {
filter: {
geo_shape: {
location: {
indexed_shape: {
index: 'shapes',
id: 'deu',
path: 'location'
}
}
}
}
}
}
}
)
puts response
PUT /shapes
{
"mappings": {
"properties": {
"location": {
"type": "geo_shape"
}
}
}
}
PUT /shapes/_doc/deu
{
"location": {
"type": "envelope",
"coordinates" : [[13.0, 53.0], [14.0, 52.0]]
}
}
GET /example/_search
{
"query": {
"bool": {
"filter": {
"geo_shape": {
"location": {
"indexed_shape": {
"index": "shapes",
"id": "deu",
"path": "location"
}
}
}
}
}
}
}
空间关系编辑
以下是搜索地理字段时可用的空间关系运算符的完整列表
-
INTERSECTS-（默认）返回所有geo_shape或geo_point字段与查询几何图形相交的文档。 -
DISJOINT- 返回所有geo_shape或geo_point字段与查询几何图形没有共同点的文档。 -
WITHIN- 返回所有geo_shape或geo_point字段在查询几何图形内的文档。不支持线几何图形。 -
CONTAINS- 返回所有geo_shape或geo_point字段包含查询几何图形的文档。
忽略未映射编辑
当设置为 true 时，ignore_unmapped 选项将忽略未映射的字段，并且不会匹配此查询的任何文档。当查询可能具有不同映射的多个索引时，这将非常有用。当设置为 false（默认值）时，如果未映射该字段，则查询将引发异常。
注释编辑
- 当数据在
geo_shape字段中索引为形状数组时，这些数组将被视为一个形状。因此，以下请求是等效的。
response = client.index(
index: 'test',
id: 1,
body: {
location: [
{
coordinates: [
46.25,
20.14
],
type: 'point'
},
{
coordinates: [
47.49,
19.04
],
type: 'point'
}
]
}
)
puts response
PUT /test/_doc/1
{
"location": [
{
"coordinates": [46.25,20.14],
"type": "point"
},
{
"coordinates": [47.49,19.04],
"type": "point"
}
]
}
response = client.index(
index: 'test',
id: 1,
body: {
location: {
coordinates: [
[
46.25,
20.14
],
[
47.49,
19.04
]
],
type: 'multipoint'
}
}
)
puts response
PUT /test/_doc/1
{
"location":
{
"coordinates": [[46.25,20.14],[47.49,19.04]],
"type": "multipoint"
}
}
geo_shape查询假定geo_shape字段使用默认的orientation（方向）RIGHT（逆时针）。请参阅 多边形方向。