« 类型转换函数 条件函数和表达式 »
Elastic 文档 ›Elasticsearch 指南 [8.14] ›SQL ›函数和运算符

地理函数

编辑

地理函数编辑

此功能处于测试阶段，可能会发生变化。设计和代码不如正式 GA 功能成熟，按原样提供，不提供任何保证。测试版功能不受正式 GA 功能支持 SLA 的约束。

地理函数适用于存储在 geo_point、geo_shape 和 shape 字段中的几何图形，或由其他地理函数返回的几何图形。

限制编辑

geo_point、geo_shape 和 shape 类型在 SQL 中表示为几何图形，可以互换使用，但存在以下例外情况

  • geo_shape 和 shape 字段没有文档值，因此这些字段不能用于过滤、分组或排序。
  • geo_points 字段默认情况下被索引并具有文档值，但是只有纬度和经度被存储和索引，并且与原始值相比存在一定精度损失（纬度为 4.190951585769653E-8，经度为 8.381903171539307E-8）。接受高度组件，但不会存储在文档值中，也不会被索引。因此，在过滤、分组或排序中调用 ST_Z 函数将返回 null。

几何图形转换编辑

ST_AsWKT编辑

概要

ST_AsWKT(
    geometry 
)

输入:

几何图形。如果为 null，则函数返回 null。

输出: 字符串

描述: 返回 geometry 的 WKT 表示形式。

SELECT city, ST_AsWKT(location) location FROM "geo" WHERE city = 'Amsterdam';

     city:s    |     location:s
Amsterdam      |POINT (4.850312 52.347557)

ST_WKTToSQL编辑

概要

ST_WKTToSQL(
    string 
)

输入:

几何图形的字符串 WKT 表示形式。如果为 null，则函数返回 null。

输出: 几何图形

描述: 从 WKT 表示形式返回几何图形。

SELECT CAST(ST_WKTToSQL('POINT (10 20)') AS STRING) location;

   location:s
POINT (10.0 20.0)

几何图形属性编辑

ST_GeometryType编辑

概要

ST_GeometryType(
    geometry 
)

输入:

几何图形。如果为 null，则函数返回 null。

输出: 字符串

描述: 返回 geometry 的类型，例如 POINT、MULTIPOINT、LINESTRING、MULTILINESTRING、POLYGON、MULTIPOLYGON、GEOMETRYCOLLECTION、ENVELOPE 或 CIRCLE。

SELECT ST_GeometryType(ST_WKTToSQL('POINT (10 20)')) type;

      type:s
POINT

ST_X编辑

概要

ST_X(
    geometry 
)

输入:

几何图形。如果为 null，则函数返回 null。

输出: 双精度浮点数

描述: 返回几何图形中第一个点的经度。

SELECT ST_X(ST_WKTToSQL('POINT (10 20)')) x;

      x:d
10.0

ST_Y编辑

概要

ST_Y(
    geometry 
)

输入:

几何图形。如果为 null，则函数返回 null。

输出: 双精度浮点数

描述: 返回几何图形中第一个点的纬度。

SELECT ST_Y(ST_WKTToSQL('POINT (10 20)')) y;

      y:d
20.0

ST_Z编辑

概要

ST_Z(
    geometry 
)

输入:

几何图形。如果为 null，则函数返回 null。

输出: 双精度浮点数

描述: 返回几何图形中第一个点的海拔高度。

SELECT ST_Z(ST_WKTToSQL('POINT (10 20 30)')) z;

      z:d
30.0

ST_Distance编辑

概要

ST_Distance(
    geometry, 
    geometry  
)

输入:

源几何图形。如果为 null，则函数返回 null。

目标几何图形。如果为 null，则函数返回 null。

输出: 双精度浮点数

描述: 返回几何图形之间的距离（以米为单位）。两个几何图形都必须是点。

SELECT ST_Distance(ST_WKTToSQL('POINT (10 20)'), ST_WKTToSQL('POINT (20 30)')) distance;

   distance:d
1499101.2889383635
« 类型转换函数 条件函数和表达式 »