Geoshape 地理形状字段类型 #
Geoshape 地理形状字段类型包含地理形状,例如多边形或地理点的集合。为了索引地理形状,Easysearch 会将形状分割成三角形网格,并将每个三角形存储在 BKD 树中。这提供了 10^-7 度的精度,代表了接近完美的空间分辨率。这个过程的性能主要受到您正在索引的多边形顶点数量多少的影响。
代码样例 #
创建一个带有地理形状字段类型的映射:
PUT testindex
{
"mappings": {
"properties": {
"location": {
"type": "geo_shape"
}
}
}
}
格式说明 #
地理形状可以用以下格式索引:
在 GeoJSON 和 WKT 中,坐标必须在坐标数组中按照
经度
,纬度
的顺序指定。注意在这种格式中经度是在前面的。
地理形状类型 #
下表描述了可能的地理形状类型以及它们与 GeoJSON 和 WKT 类型的关系。
Easysearch 类型 | GeoJSON 类型 | WKT 类型 | 描述 |
---|---|---|---|
point | Point | POINT | 由纬度和经度指定的地理点。Easysearch 使用世界大地测量系统 (WGS84) 坐标。 |
linestring | LineString | LINESTRING | 由两个或更多点指定的线。可以是直线或连接的线段路径。 |
polygon | Polygon | POLYGON | 由坐标形式的顶点列表指定的多边形。多边形必须是闭合的,这意味着最后一个点必须与第一个点相同。因此,要创建一个 n 边形,需要 n+1 个顶点。最少需要四个顶点,这会创建一个三角形。 |
multipoint | MultiPoint | MULTIPOINT | 不连接的离散相关点的数组。 |
multilinestring | MultiLineString | MULTILINESTRING | 线串的数组。 |
multipolygon | MultiPolygon | MULTIPOLYGON | 多边形的数组。 |
geometrycollection | GeometryCollection | GEOMETRYCOLLECTION | 可能是不同类型的地理形状的集合。 |
envelope | N/A | BBOX | 由左上和右下顶点指定的边界矩形。 |
Point 点位 #
一个点代表着由经度和纬度指定的单个坐标对。
在 GeoJSON 格式中索引一个点:
PUT testindex/_doc/1
{
"location" : {
"type" : "point",
"coordinates" : [74.0060, 40.7128]
}
}
在 WKT 格式中索引一个点数据:
PUT testindex/_doc/1
{
"location" : "POINT (74.0060 40.7128)"
}
Linestring 线串 #
一个线串是由两个或更多点指定的线。如果点是共线的,则线串是直线。否则,线串表示由线段组成的路径。
在 GeoJSON 格式中索引一个线串:
PUT testindex/_doc/2
{
"location" : {
"type" : "linestring",
"coordinates" : [[74.0060, 40.7128], [71.0589, 42.3601]]
}
}
在 WKT 格式中索引一个线串:
PUT testindex/_doc/2
{
"location" : "LINESTRING (74.0060 40.7128, 71.0589 42.3601)"
}
Polygon 多边形 #
一个多边形是由坐标形式的顶点列表指定的。多边形必须是闭合的,这意味着最后一个点必须与第一个点相同。在下面的例子中,创建了一个三角形,使用了四个点。
GeoJSON 要求您以逆时针顺序列出多边形的顶点。WKT 不对顶点顺序施加任何限制。
在 GeoJSON 格式中索引一个多边形(三角形):
PUT testindex/_doc/3
{
"location" : {
"type" : "polygon",
"coordinates" : [
[
[74.0060, 40.7128],
[73.7562, 42.6526],
[71.0589, 42.3601],
[74.0060, 40.7128]
]
]
}
}
在 WKT 格式中索引一个多边形(三角形):
PUT testindex/_doc/3
{
"location" : "POLYGON ((74.0060 40.7128, 71.0589 42.3601, 73.7562 42.6526, 74.0060 40.7128))"
}
多边形可以有内部的洞。在这种情况下,坐标字段将包含多个数组。第一个数组表示外部多边形,每个后续数组表示一个洞。洞表示为多边形,并指定为坐标数组。
GeoJSON 要求您以逆时针顺序列出多边形的顶点,并以顺时针顺序列出洞的顶点。WKT 不对顶点顺序施加任何限制。
在 GeoJSON 格式中索引一个多边形(三角形)和一个三角形洞:
PUT testindex/_doc/4
{
"location" : {
"type" : "polygon",
"coordinates" : [
[
[74.0060, 40.7128],
[73.7562, 42.6526],
[71.0589, 42.3601],
[74.0060, 40.7128]
],
[
[72.6734, 41.7658],
[73.0515, 41.5582],
[72.6506, 41.5623],
[72.6734, 41.7658]
]
]
}
}
在 WKT 格式中索引一个多边形(三角形)和一个三角形洞:
PUT testindex/_doc/4
{
"location" : "POLYGON ((74.0060 40.7128, 71.0589 42.3601, 73.7562 42.6526, 74.0060 40.7128), (72.6734 41.7658, 72.6506 41.5623, 73.0515 41.5582, 72.6734 41.7658))"
}
您可以通过以顺时针或逆时针顺序列出顶点来指定 Easysearch 中的多边形。这对于不跨越日期线(小于 180°)的多边形来说是有效的。然而,跨越日期线(大于 180°)的多边形可能是模糊的,因为 WKT 不对顶点顺序施加任何限制。因此,您必须通过以逆时针顺序列出顶点来指定跨越日期线的多边形。
您可以定义一个 orientation
方向参数来指定顶点遍历顺序:
PUT testindex
{
"mappings": {
"properties": {
"location": {
"type": "geo_shape",
"orientation" : "left"
}
}
}
}
随后索引的文档可以覆盖 orientation
设置:
PUT testindex/_doc/3
{
"location" : {
"type" : "polygon",
"orientation" : "cw",
"coordinates" : [
[[74.0060, 40.7128],
[71.0589, 42.3601],
[73.7562, 42.6526],
[74.0060, 40.7128]]
]
}
}
Multipoint 多点位 #
一个多点是由不连接的离散相关点组成的数组。
在 GeoJSON 格式中索引一个多点:
PUT testindex/_doc/6
{
"location" : {
"type" : "multipoint",
"coordinates" : [
[74.0060, 40.7128],
[71.0589, 42.3601]
]
}
}
在 WKT 格式中索引一个多点:
PUT testindex/_doc/6
{
"location" : "MULTIPOINT (74.0060 40.7128, 71.0589 42.3601)"
}
Multilinestring 多线串 #
一个多线串是由线串组成的数组。
在 GeoJSON 格式中索引一个多线串:
PUT testindex/_doc/2
{
"location" : {
"type" : "multilinestring",
"coordinates" : [
[[74.0060, 40.7128], [71.0589, 42.3601]],
[[73.7562, 42.6526], [72.6734, 41.7658]]
]
}
}
在 WKT 格式中索引一个多线串:
PUT testindex/_doc/2
{
"location" : "MULTILINESTRING ((74.0060 40.7128, 71.0589 42.3601), (73.7562 42.6526, 72.6734 41.7658))"
}
Multipolygon 多个多边形 #
多个多边形是由多边形组成的数组。在这个例子中,第一个多边形包含一个洞,第二个不包含。
在 GeoJSON 格式中索引多个多边形:
PUT testindex/_doc/4
{
"location" : {
"type" : "multipolygon",
"coordinates" : [
[
[
[74.0060, 40.7128],
[73.7562, 42.6526],
[71.0589, 42.3601],
[74.0060, 40.7128]
],
[
[73.0515, 41.5582],
[72.6506, 41.5623],
[72.6734, 41.7658],
[73.0515, 41.5582]
]
],
[
[
[73.9146, 40.8252],
[73.8871, 41.0389],
[73.6853, 40.9747],
[73.9146, 40.8252]
]
]
]
}
}
在 WKT 格式中索引多个多边形:
PUT testindex/_doc/4
{
"location" : "MULTIPOLYGON (((74.0060 40.7128, 71.0589 42.3601, 73.7562 42.6526, 74.0060 40.7128), (72.6734 41.7658, 72.6506 41.5623, 73.0515 41.5582, 72.6734 41.7658)), ((73.9146 40.8252, 73.6853 40.9747, 73.8871 41.0389, 73.9146 40.8252)))"
}
Geometry collection 几何集合 #
一个几何集合是可能是不同类型的地理形状的集合。
在 GeoJSON 格式中索引一个几何集合:
PUT testindex/_doc/7
{
"location" : {
"type": "geometrycollection",
"geometries": [
{
"type": "point",
"coordinates": [74.0060, 40.7128]
},
{
"type": "linestring",
"coordinates": [[73.7562, 42.6526], [72.6734, 41.7658]]
}
]
}
}
在 WKT 格式中索引一个几何集合:
PUT testindex/_doc/7
{
"location" : "GEOMETRYCOLLECTION (POINT (74.0060 40.7128), LINESTRING(73.7562 42.6526, 72.6734 41.7658))"
}
Envelope 边界矩阵 #
一个边界矩形是由左上和右下顶点指定的。在 GeoJSON 格式中,边界矩形的坐标是 [[minLon, maxLat], [maxLon, minLat]]
。
在 GeoJSON 格式中索引一个边界矩形:
PUT testindex/_doc/2
{
"location" : {
"type" : "envelope",
"coordinates" : [[71.0589, 42.3601], [74.0060, 40.7128]]
}
}
在 WKT 格式中,使用 BBOX (minLon, maxLon, maxLat, minLat)
。
在 WKT 格式中索引一个边界矩形:
PUT testindex/_doc/8
{
"location" : "BBOX (71.0589, 74.0060, 42.3601, 40.7128)"
}
参数说明 #
以下表格列出了地理形状字段类型接受的参数。所有参数都是可选的。
参数 | 描述 |
---|---|
coerce | 一个布尔值,指定是否自动关闭未闭合的线环。默认为 false 。 |
ignore_malformed | 一个布尔值,指定是否忽略格式错误的 GeoJSON 或 WKT 地理形状,而不是抛出异常。默认为 false (抛出异常)。 |
ignore_z_value | 特定于具有三个坐标的点。如果 ignore_z_value 为 true ,则第三个坐标不会被索引,但仍会存储在 _source 字段中。如果 ignore_z_value 为 false ,则会抛出异常。默认为 true 。 |
orientation | 指定地理形状坐标列表中顶点的遍历顺序。orientation 可以取以下值:1. RIGHT:逆时针。使用以下字符串(大写或小写)指定 RIGHT 方向:right 、counterclockwise 、ccw 。 2. LEFT:顺时针。使用以下字符串(大写或小写)指定 LEFT 方向:left 、clockwise 、cw 。这个值可以被单个文档覆盖。 默认为 RIGHT 。 |