Link Search Menu Expand Document Documentation Menu

地理点字段类型

1.0 版引入

地理点字段类型包含由纬度和经度指定的地理点。

示例

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

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

格式

地理点可以按以下格式进行索引

  • 包含纬度和经度的对象
PUT testindex1/_doc/1
{
  "point": { 
    "lat": 40.71,
    "lon": 74.00
  }
}

  • 纬度,经度”格式的字符串
PUT testindex1/_doc/2
{
  "point": "40.71,74.00" 
}

  • 一个地理哈希
PUT testindex1/_doc/3
{
  "point": "txhxegj0uyp3"
}

  • [经度, 纬度] 格式的数组
PUT testindex1/_doc/4
{
  "point": [74.00, 40.71] 
}

PUT testindex1/_doc/5
{
  "point": "POINT (74.00 40.71)"
}

  • GeoJSON 格式,其中 坐标[经度, 纬度] 格式
PUT testindex1/_doc/6
{
  "point": {
    "type": "Point",
    "coordinates": [74.00, 40.71]
  }
}

参数

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

参数 描述
忽略畸形值 (ignore_malformed) 一个布尔值,指定忽略格式错误的数值且不抛出异常。纬度的有效值为 [-90, 90]。经度的有效值为 [-180, 180]。默认值为 false
ignore_z_value 特定于具有三个坐标的点。如果 ignore_z_valuetrue,则第三个坐标不进行索引,但仍存储在 _source 字段中。如果 ignore_z_valuefalse,则会抛出异常。
null_value 用于替代 null 的值。必须与字段类型相同。如果未指定此参数,则当其值为 null 时,该字段被视为缺失。默认值为 null
剩余 350 字符

有问题?

想贡献?