xy点字段类型

一个xy点字段类型包含一个位于二维笛卡尔坐标系中的点，由x和y坐标指定。它基于Lucene XYPoint字段类型。xy点字段类型与geopoint字段类型相似，但没有geopoint的范围限制。xy点的坐标是单精度浮点值。有关浮点值的范围和精度的信息，请参阅数值字段类型。

示例

创建一个具有xy点字段类型的映射：

PUT testindex1
{
  "mappings": {
    "properties": {
      "point": {
        "type": "xy_point"
      }
    }
  }
}

格式

xy坐标可以以下格式索引：

PUT testindex1/_doc/1
{
  "point": { 
    "x": 0.5,
    "y": 4.5
  }
}

字符串为“x，y”格式

PUT testindex1/_doc/2
{
  "point": "0.5, 4.5" 
}

一个在 [x, y] 格式的数组

PUT testindex1/_doc/3
{
  "point": [0.5, 4.5] 
}

一个已知的文本（WKT）点（POINT），格式为“POINT(xy)”

PUT testindex1/_doc/4
{
  "point": "POINT (0.5 4.5)"
}

GeoJSON格式

PUT testindex1/_doc/5
{
  "point" : {
    "type" : "Point",
    "coordinates" : [0.5, 4.5]        
  }
}

在所有 xy 点格式中，坐标必须按照 x, y 的顺序指定。

参数

以下表格列出了 xy 点字段类型接受的参数。所有参数都是可选的。

参数	描述
ignore_malformed	布尔值，指定忽略格式不正确的值，不抛出异常。默认是false。
ignore_z_value	针对具有三个坐标的点。如果ignore_z_value是true，第三个坐标未进行索引但仍然存储在_source字段中。如果ignore_z_value是false，则会抛出异常。
null_value	一个用于替代 null 的值。该值必须与字段类型相同。如果未指定此参数，当字段的值为 null 时，将该字段视为缺失。默认值是 null。