地理多边形查询 #

地理多边形查询返回包含指定多边形内地理点的文档。如果一个文档包含多个地理点，只要至少有一个地理点匹配查询，该文档就匹配查询。

多边形通过坐标形式的顶点列表指定。与为地理形状字段指定多边形不同，多边形不需要闭合（指定第一个和最后一个点相同是不必要的）。尽管点不需要遵循顺时针或逆时针顺序，但建议您按照这两种顺序之一列出它们。这将确保正确捕获多边形。

搜索的文档字段必须映射为 geo_point 。

参考样例 #

创建一个映射，将 point 字段映射为 geo_point ：

PUT /testindex1
{
  "mappings": {
    "properties": {
      "point": {
        "type": "geo_point"
      }
    }
  }
}

索引一个地理点，指定其纬度和经度：

PUT testindex1/_doc/1
{
  "point": {
    "lat": 73.71,
    "lon": 41.32
  }
}

搜索包含指定 geo_polygon 的 point 对象的文档：

GET /testindex1/_search
{
  "query": {
    "bool": {
      "must": {
        "match_all": {}
      },
      "filter": {
        "geo_polygon": {
          "point": {
            "points": [
              { "lat": 74.5627, "lon": 41.8645 },
              { "lat": 73.7562, "lon": 42.6526 },
              { "lat": 73.3245, "lon": 41.6189 },
              { "lat": 74.0060, "lon": 40.7128 }
           ]
          }
        }
      }
    }
  }
}

前一个请求中指定的地理位置形成一个四边形。匹配的文档位于此四边形内。四边形的顶点坐标以 (latitude, longitude) 格式指定。

返回内容包含匹配的文档：

{
  "took": 6,
  "timed_out": false,
  "_shards": {
    "total": 1,
    "successful": 1,
    "skipped": 0,
    "failed": 0
  },
  "hits": {
    "total": {
      "value": 1,
      "relation": "eq"
    },
    "max_score": 1,
    "hits": [
      {
        "_index": "testindex1",
        "_id": "1",
        "_score": 1,
        "_source": {
          "point": {
            "lat": 73.71,
            "lon": 41.32
          }
        }
      }
    ]
  }
}

在先前的搜索请求中，您指定了多边形的顶点按顺时针顺序：

"geo_polygon": {
    "point": {
    "points": [
        { "lat": 74.5627, "lon": 41.8645 },
        { "lat": 73.7562, "lon": 42.6526 },
        { "lat": 73.3245, "lon": 41.6189 },
        { "lat": 74.0060, "lon": 40.7128 }
    ]
    }
}

或者，您也可以按逆时针顺序指定顶点：

"geo_polygon": {
    "point": {
    "points": [
        { "lat": 74.5627, "lon": 41.8645 },
        { "lat": 74.0060, "lon": 40.7128 },
        { "lat": 73.3245, "lon": 41.6189 },
        { "lat": 73.7562, "lon": 42.6526 }
    ]
    }
}

查询结果包含相同的匹配文档。

然而，如果您按照以下顺序指定顶点：

"geo_polygon": {
    "point": {
    "points": [
        { "lat": 74.5627, "lon": 41.8645 },
        { "lat": 74.0060, "lon": 40.7128 },
        { "lat": 73.7562, "lon": 42.6526 },
        { "lat": 73.3245, "lon": 41.6189 }
    ]
    }
}

则不返回任何结果。

参数说明 #

Geopolygon 查询接受以下参数。