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]
}
- “POINT(
x
y
)”格式的知名文本 (WKT) POINT
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 。 |