文档

空间函数

更新时间:

函数

功能

ST_AREA

计算几何的面积

ST_CONTAINS

判断两个几何是否包含关系

ST_COVERS

判断两个几何是否覆盖关系

ST_CROSSES

判断两个几何是否交叉

ST_DIFFERENCE

计算两个几何的差集

ST_DISTANCE

计算两个几何之间的距离

ST_EQUALS

判断两个几何是否相等

ST_GEOM_FROM_TEXT

根据WKT字符串生成几何对象

ST_INTERSECTION

计算两个几何的交集

ST_INTERSECTS

判断两个几何是否相交

ST_LENGTH

计算几何线对象在二维空间内的长度

ST_OVERLAPS

判断两个几何是否重叠

ST_TOUCHES

判断两个几何是否接触

ST_TRANSFORM

几何坐标系转化

ST_WITHIN

判断一个几何是否在另一个几何内部

ST_AREA

  • 函数说明

返回指定多边形几何对象的面积。使用SRID指定的单位确定2D笛卡尔区域。

  • 参数说明

    • geometry:必填,几何类型。几何对象。

  • 返回值说明

几何对象的面积。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_CONTAINS

  • 函数说明

当几何A包含几何B时返回true,否则返回false。当且仅当几何B的所有点都不位于几何A的外部,并且几何B内部至少一个点位于几何A的内部时,几何A才包含几何B。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A是否包含几何B的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_COVERS

  • 函数说明

当几何B没有任何坐标点在几何A之外,表示几何A覆盖几何B,函数结果返回true,否则返回false。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A是否覆盖几何B的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_CROSSES

  • 函数说明

当两个几何有部分交集但互相不包含,表示两个几何交叉,函数结果返回true,否则返回false。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B是否交叉的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_DIFFERENCE

  • 函数说明

返回几何A中不与几何B相交的部分的几何。如果A完全包含在B中,那么该函数返回一个空对象。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B差结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_DISTANCE

  • 函数说明

返回两个几何基于参考坐标系的欧氏距离。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B基于参考坐标系的欧氏距离值。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_EQUALS

  • 函数说明

如果两个几何在空间上相等,则返回true,否则返回false。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B是否空间相等的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_GEOM_FROM_TEXT

  • 函数说明

返回一个与给定的WKT字符串相对应的几何对象。

  • 参数说明

    • wkt:必填,文本类型。wkt字符串。

    • srid:非必填,整数类型。几何对象的空间参考系ID。

  • 返回值说明

WKT字符串对应的几何对象。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_INTERSECTION

  • 函数说明

返回两个几何对象相交的点集对应的GEOMETRY对象;如果输入的两个几何对象没有任何公共的部分或者不相交,那么该函数返回一个空对象;注意该函数会丢弃对象的M坐标值。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B交集结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_INTERSECTS

  • 函数说明

如果两个几何相交则返回true,否则返回false。两个几何有任何共同点则视为相交。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B是否相交的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_LENGTH

  • 函数说明

如果指定的几何对象是一条线,则返回其2D笛卡尔长度,长度的单位由对象的空间参考系统指定;如果指定的几何对象是面对象则返回0。

  • 参数说明

    • geometry:必填,几何类型。几何对象。

  • 返回值说明

几何对象的长度值。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_OVERLAPS

  • 函数说明

如果两个几何在空间上重叠,但不存在其中一个完全包含另一个的情况,则返回true,否则返回false。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B是否重叠的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_TOUCHES

  • 函数说明

如果两个几何接触但内部不相交,则返回true,否则返回false;几何A和B接触说明A和B至少有一个公共点,并且公共点位于至少一个边界上;对于点/点输入,函数返回false,因为点没有边界。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A与几何B是否重叠的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_TRANSFORM

  • 函数说明

将指定的几何对象的坐标参考系转换成指定的坐标参考系,并返回转换后的几何对象。

  • 参数说明

    • geometry:必填,几何类型。几何对象。

    • srid:必填,整数类型。目标坐标系的SRID标识。

  • 返回值说明

几何坐标系转换后的结果对象。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。

ST_WITHIN

  • 函数说明

当几何A完全在几何B之内,表示几何A在几何B内部,函数结果返回true,否则返回false。

  • 参数说明

    • geometryA:必填,几何类型。几何A。

    • geometryB:必填,几何类型。几何B。

  • 返回值说明

几何A是否在几何B内部的判定结果。

  • 支持的计算引擎

AnalyticDB PostgreSQL(ADB_PG)、POLAR_PG、POSTGRESQL。