查询地理形状

地理形状一个不寻常的地方在于它运行我们使用形状来做查询，而不仅仅是坐标点。

举个例子，当我们的用户刚刚迈出阿姆斯特丹中央火车站时，我们可以用如下方式，查询出方圆1km内所有的地标：

  2. GET /attractions/landmark/_search
  3. {
  4.   "query": {
  5.     "geo_shape": {
  6.       "location": { <1>
  7.         "shape": { <2>
  8.           "type":   "circle", <3>
  9.           "radius": "1km"
  10.           "coordinates": [ <4>
  11.             4.89994,
  12.             52.37815
  13.           ]
  14.         }
  15.       }
  16.     }
  17.   }
  18. }
  • <1> 查询使用 location 字段中的地理形状；
  • <2> 查询中的形状是由shape键对应的内容表示；
  • <3> 形状是一个半径为1km的圆形；
  • <4> 安姆斯特丹中央火车站入口的坐标点。

默认，查询（或者过滤器 —— 工作方式相同）会从已索引的形状中寻找与指定形状有交集的形状。
此外，relation 也可以设置为 disjoint来查找与指定形状不相交的，或者设置为within来查找完全落在查询形状中的。

举个例子，我们查找所有落在阿姆斯特丹内的地标：

  2. GET /attractions/landmark/_search
  3. {
  4.   "query": {
  5.     "geo_shape": {
  6.       "location": {
  7.         "relation": "within", <1>
  8.         "shape": {
  9.           "type": "polygon",
  10.           "coordinates": [[ <2>
  11.               [4.88330,52.38617],
  12.               [4.87463,52.37254],
  13.               [4.87875,52.36369],
  14.               [4.88939,52.35850],
  15.               [4.89840,52.35755],
  16.               [4.91909,52.36217],
  17.               [4.92656,52.36594],
  18.               [4.93368,52.36615],
  19.               [4.93342,52.37275],
  20.               [4.92690,52.37632],
  21.               [4.88330,52.38617]
  22.             ]]
  23.         }
  24.       }
  25.     }
  26.   }
  27. }
  • <1> 只匹配完全落在查询形状中的（已索引）形状。
  • <2> 这个多边形表示安姆斯特丹中心。