Link Search Menu Expand Document Documentation Menu

xy 点字段类型

2.4 版引入

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

示例

创建包含 xy 点字段类型的映射

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

格式

xy 点可以通过以下格式进行索引

  • 具有 x 和 y 坐标的对象
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] 
}

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_valuetrue,则第三个坐标不会被索引,但仍会存储在 _source 字段中。如果 ignore_z_valuefalse,则会抛出异常。
null_value 用于替换 null 的值。该值必须与字段类型相同。如果未指定此参数,则当其值为 null 时,该字段将被视为缺失。默认为 null
剩余 350 字符

有问题?

想贡献?