【1】GEOMTERY创建和常用函数

只因后端
228 阅读13分钟

1.常用函数

参考地址：help.aliyun.com/document_de…

image.png

2.postgis函数

参考地址：

help.aliyun.com/document_de…

空间函数

PostGIS为您提供了一些空间函数， 每种函数可以将一种数据类型的值转换为另一种类型。空间函数说明具体见下表，关于函数语法，部分参数说明如下：

  • geom：表格中涉及的geom均表示一个GEOMETRY类型的值，或一个计算结果为GEOMETRY类型的表达式。
  • precision：表格中涉及的precision均表示一个INTEGER类型的值。坐标系geom将使用指定的精度1~20显示。如果未指定精度，则默认值为15。
  • index：表格中涉及的index为索引，均表示一个INTEGER类型的值。
  • srid：表格中涉及srid均表示一个INTEGER类型的值，它是空间参考标识符SRID。

更多关于空间函数的说明，请参见PostGIS官方文档。

  • Geometry Constructors函数

    函数函数语法返回类型说明支持的引擎
    ST_LineFromMultiPointST_LineFromMultiPoint(geom)GEOMETRYST_LineFromMultiPoint 返回输入多点几何体中的线串。点的顺序将保留。返回的几何体的空间参考系统标识符（SRID）与输入几何体的相同。V1.3版本HQE支持。
    ST_MakeEnvelopeST_MakeEnvelope(xmin, ymin, xmax, ymax)ST_MakeEnvelope(xmin, ymin, xmax, ymax, srid)GEOMETRY子类型的EMR集群POINT、LINESTRING或者POLYGON。ST_MakeEnvelope 包络返回一个几何，如下所示：如果输入坐标指定一个点，则返回的几何体是一个点。如果输入坐标指定一条线，则返回的几何为线串。否则，返回的几何为面，其中输入坐标指定框的左下角和右上角。如果提供，返回的几何体的空间参考系统标识符（SRID）值将设置为输入 SRID 值。V1.3版本HQE支持。
    ST_MakeLineST_MakeLine(geom1, geom2)子类型 LINESTRING的GEOMETRY。ST_MakeLine从输入几何体创建线串。V1.3版本HQE支持。
    ST_MakePointST_MakePoint(x, y)子类型POINT的 GEOMETRY。ST_MakePoint返回其坐标值为输入值的点几何体。V1.3版本HQE支持。
    ST_PointST_Point(x, y)子类型POINT的 GEOMETRY。ST_Point从输入坐标值返回点几何体。V1.3版本HQE支持。
    ST_PolygonST_Polygon(linestring, srid)子类型POLYGON的GEOMETRY。ST_Polygon返回一个多边形几何体，其外部环形是输入线串，其值是空间参考系统标识符（SRID）的输入值。V1.3版本HQE支持。

  • Geometry Accessors函数

    函数函数语法返回类型说明支持的引擎
    GeometryTypeGeometryType(geom)VARCHARGeometryType以字符串形式返回输入几何体的子类型。V1.3版本HQE支持。
    ST_BoundaryST_Boundary(geom)GEOMETRYST_Boundary返回输入几何体的边界，如下所示：如果输入几何为空（即不包含点），则按原样返回。如果输入几何是点或非空多点，则返回空几何集合。如果输入是线串或多线串，则返回包含边界上所有点的多点，多点可能为空）。如果输入是一个没有任何内环的面，则返回一个表示其边界的闭合线串。如果输入是具有内环的面，或者是多面，则返回多线串。多线串包含面积几何中所有环的所有边界作为闭合线串。V1.3版本HQE支持。
    ST_DimensionST_Dimension(geom)INTEGERST_Dimension 返回输入几何体的固有维度。固有维度 是几何体中定义的子类型的维度值。V1.3版本HQE支持。
    ST_EnvelopeST_Envelope(geom)GEOMETRYST_Envelope 返回输入几何体的最小边界框，如下所示：如果输入几何体为空，则返回的几何体是输入几何体的副本。如果输入几何体的最小边界框退化为一个点，则返回的几何体是一个点。如果输入几何体的最小边界框是一维的，则返回两点线串。如果上述条件都不成立，则函数将返回一个顺时针方向的多边形，其顶点为最小边界框的角。返回的几何体的空间参考系统标识符（SRID）与输入几何体的相同。V1.3版本HQE支持。
    ST_ExteriorRingST_ExteriorRing(geom)子类型 LINESTRING的GEOMETRY。ST_ExteriorRing返回一个表示输入面外环的闭合线串。V1.3版本HQE支持。
    ST_GeometryNST_GeometryN(geom, index)GEOMETRYST_GeometryN返回由输入几何体的输入索引指向的几何体，如下所示：当输入是点、线串或多边形时，如果索引等于一 (1)，则按原样返回几何体；如果索引不是一 (1)，则返回 null。如果输入是多点、多线串、多边形或几何体集合，则返回由输入索引指向的点、线串、多边形或几何体集合。索引是从 1 开始的。结果的空间参考系统标识符 (SRID) 与输入几何体的相同。V1.3版本HQE支持。
    ST_GeometryTypeST_GeometryType(geom)VARCHARST_GeometryType以字符串形式返回输入几何体的子类型。V1.3版本HQE支持。
    ST_InteriorRingNST_InteriorRingN(geom, index)子类型LINESTRING的GEOMETRY。ST_InteriorRingN返回与索引位置处输入多边形的内环相对应的闭合线串。V1.3版本HQE支持。
    ST_IsClosedST_IsClosed(geom)BOOLEAN如果输入几何体已闭合，则 ST_IsClosed 返回 true。以下规则定义闭合的几何体：输入的几何体是一个点或一个多点。输入几何体是一个线串，并且该线串的起点和终点是重合的。输入几何体是一个非空的多线串，并且其所有线串均已闭合。输入几何体是一个非空多边形，所有多边形的环都是非空的，并且所有环的起点和终点都是重合的。输入几何体是一个非空的多边形集合，并且其所有多边形均已闭合。输入几何体是一个非空几何体集合，并且其所有组件均已闭合。V1.3版本HQE支持。
    ST_IsCollectionST_IsCollection(geom)BOOLEAN如果输入几何体为下列子类型之一，则 ST_IsCollection返回true：GEOMETRYCOLLECTION、MULTIPOINT、MULTILINESTRING或者MULTIPOLYGON。V1.3版本HQE支持。
    ST_IsEmptyST_IsEmpty(geom)BOOLEAN如果输入几何体是空的，则ST_IsEmpty返回true。如果一个几何体不包含点，则该几何体为空。V1.3版本HQE支持。
    ST_IspolyGonCWST_IsPolygonCCW(geom)BOOLEAN如果输入多边形或多多边形是逆时针的，则ST_IspolyGonCW返回true。如果输入几何是点、线串、多点或多线串，则返回true。对于几何体集合，如果集合中的所有几何体均为逆时针方向，ST_IspolygonCW将返回true。V1.3版本HQE支持。
    ST_IsSimpleST_IsSimple(geom)BOOLEAN如果输入几何体是简单的，则ST_IsSimple返回 true。V1.3版本HQE支持。
    ST_NPointsST_NPoints(geom)INTEGERST_NPoints 返回输入几何体中的点数。V1.3版本HQE支持。
    ST_NRingsST_NRings(geom)INTEGERST_NRings 返回输入几何体中的环形数。V1.3版本HQE支持。
    ST_NumGeometriesST_NumGeometries(geom)INTEGERST_NumGeometries返回输入几何体中的几何体数。V1.3版本HQE支持。
    ST_NumInteriorRingsST_NumInteriorRings(geom)INTEGERST_NumInteriorRings返回输入多边形几何体中的环形数。V1.3版本HQE支持。
    ST_NumPointsST_NumPoints(geom)INTEGERST_NumPoints返回输入几何体中的点数。V1.3版本HQE支持。
    ST_PointNST_PointN(geom, index)子类型POINT的 GEOMETRY。ST_PointN返回由索引值指定的线串中的点。负索引值从线串的末尾开始倒计数，因此-1是最后一个点。V1.3版本HQE支持。
    ST_PointsST_Points(geom)子类型MULTIPOINT的 GEOMETRY。ST_Points返回包含输入几何中所有非空点的多点几何。ST_Points不会移除输入中重复的点，包括环形几何的起点和终点。V1.3版本HQE支持。
    ST_StartPointST_StartPoint(geom)GEOMETRYST_StartPoint返回输入线串的第一个点。结果的空间参考系统标识符（SRID）值与输入几何体的相同。V1.3版本HQE支持。
    ST_XST_X(point)DOUBLEST_X返回输入点的第一个坐标。V1.3版本HQE支持。
    ST_YST_Y(point)DOUBLEST_Y返回输入点的第二个坐标。V1.3版本HQE支持。

  • Geometry Editors函数

    函数函数语法返回类型说明支持的引擎
    ST_AddPointST_AddPoint(geom1, geom2)GEOMETRYST_AddPoint返回一个线串几何体，它与添加了点的输入几何体相同。V1.3版本HQE支持。
    ST_MultiST_Multi(geom)GEOMETRY带子类型MULTIPOINT、MULTILINESTRING、MULTIPOLYGON或者GEOMETRYCOLLECTION。ST_multi将几何转换为相应的多类型。如果输入几何已经是多类型或几何集合，则返回其副本。如果输入几何体是点、线串或多边形，则分别返回包含输入几何体的多点、多线串或多边形。V1.3版本HQE支持。
    ST_RemovePointST_RemovePoint(geom, index)GEOMETRYST_RemovePoint返回一个线串几何体，该几何体已删除输入几何体在索引位置的点。索引是从零开始的。结果的空间参考系统标识符 (SRID) 与输入几何体的相同。V1.3版本HQE支持。
    ST_ReverseST_Reverse(geom)GEOMETRYST_Reverse可反转线性和面积几何的折点顺序。对于点或多点几何，将返回原始几何的副本。对于几何体集合，ST_Reverse将反转集合中每个几何体的折点顺序。V1.3版本HQE支持。
    ST_setPointST_SetPoint(geom1, index, geom2)GEOMETRYST_setPoint返回与索引指定的输入线串位置相对于输入线串位置的更新坐标的线串。新坐标是输入点的坐标。V1.3版本HQE支持。

  • Geometry Validation函数

    函数函数语法返回类型说明支持的引擎
    ST_IsValidST_IsValid(geom)BOOLEAN如果输入几何体有效，则ST_IsVALID返回true。**说明 通过PQE支持。PQE

  • Spatial Reference System函数

    函数函数语法返回类型说明支持的引擎
    ST_SetSRIDST_SetSRID(geom, srid)GEOMETRYST_SetSRID返回一个与输入几何体相同的几何体，只不过使用空间参考系统标识符（SRID）的输入值进行了更新。V1.3版本HQE支持。
    ST_SRIDST_SRID(geom)INTEGERST_SRID返回输入几何体的空间参考系统标识符（SRID）。V1.3版本HQE支持。

  • Geometry Input函数

    函数函数语法返回类型说明支持的引擎
    ST_GeomFromText- ST_GeomFromText(wkt_string)
    • ST_GeomFromText(wkt_string, srid) | GEOMETRY。 | ST_GeomFromText从输入几何体的已知文本（WKT）表示形式构造几何体对象。**说明 通过PQE支持。 | PQE |

  • Geometry Output函数

    函数函数语法返回类型说明支持的引擎
    ST_AsBinaryST_AsBinary(geom)BYTEAST_AsBinary 使用 ASCII 十六进制字符（0—9，A—F）返回输入几何体的十六进制已知二进制 (WKB) 表示形式。V1.3版本HQE支持。
    ST_AsEWKBST_AsEWKB(geom)BYTEAST_AsEWKB 使用 ASCII 十六进制字符（0—9，A—F）返回输入几何体的扩展的已知二进制 (EWKB) 表示形式。V1.3版本HQE支持。
    ST_AsEWKTST_AsEWKT(geom)VARCHARST_AsEWKT 返回输入几何体的扩展的已知文本 (EWKT) 表示形式。V1.3版本HQE支持。
    ST_AsGeoJSONST_AsGeoJSON(geom)ST_AsGeoJSON(geom, precision)VARCHARST_AsGeoJSON 返回输入几何体的 GeoJSON 表示形式。有关 GeoJSON 的更多信息，请参阅 Wikipedia 中的 GeoJSON。V1.3版本HQE支持。
    ST_AsTextST_AsText(geom)ST_AsText(geom, precision)VARCHARST_AsText 返回输入几何体的已知文本 (WKT) 表示形式。V1.3版本HQE支持。

  • Spatial Relationships函数

    函数函数语法返回类型说明支持的引擎
    ST_ContainsST_Contains(geom1, geom2)BOOLEAN如果第一个输入几何体包含第二个输入几何体，则 ST_Contains 返回 true。如果 B 中的每个点均为 A 中的一个点，并且其内部有非空相交区域，则几何体 A 包含几何体 B。ST_Contains(A, B) 与 ST_Within(B, A) 等效。**说明 通过PQE支持。PQE
    ST_ContainsProperlyST_ContainsProperly(geom1, geom2)BOOLEAN如果两个输入几何都是非空的，并且第二个几何的所有点都是第一个几何的内部点，则 ST_ContainsProperly 返回 true。**说明 通过PQE支持。PQE
    ST_CoveredByST_CoveredBy(geom1, geom2)BOOLEAN如果第一个输入几何体被第二个输入几何体覆盖，则 ST_CoveredBy 返回 true。如果几何体 A 和几何体 B 都是非空的，并且 A 中的每个点均为 B 中的一个点，则前者被后者覆盖。ST_CoveredBy(A, B) 与 ST_Covers(B, A) 等效。**说明 通过PQE支持。PQE
    ST_CoversST_Covers(geom1, geom2)BOOLEAN如果第一个输入几何体被第二个输入几何体覆盖，则 ST_Covers 返回 true。如果几何体 A 和几何体 B 都是非空的，并且 B 中的每个点均为 A 中的一个点，则前者覆盖了后者。ST_Covers(A, B) 与 ST_CoveredBy(B, A) 等效。**说明 通过PQE支持。PQE
    ST_CrossesST_Crosses(geom1, geom2)BOOLEAN如果两个输入几何体相互交叉，则 ST_Crosses返回 true。不涉及
    ST_DisjointST_Disjoint(geom1, geom2)BOOLEAN如果两个输入几何体没有共同点，则 ST_Disjoint 返回 true。不涉及
    ST_DWithinST_DWithin(geom1, geom2, threshold)BOOLEAN如果两个输入几何体值之间的欧氏距离不大于阈值，则 ST_DWithin 返回 true。**说明 通过PQE支持。PQE
    ST_EqualsST_Equals(geom1, geom2)BOOLEAN如果输入几何体在几何上相等，则 ST_Equals 返回 true。如果几何体具有相等的点集且其内部具有非空相交区域，则将几何体视为在几何上相等。PQE
    ST_IntersectsST_Intersects(geom1, geom2)BOOLEAN如果两个输入几何体至少有一个共同点，则 ST_Intersects 返回 true。**说明 通过PQE支持。PQE
    ST_TouchesST_Touches(geom1, geom2)BOOLEAN如果两个输入几何体接触，则 ST_Touches 返回 true。如果两个几何体是非空的、相交并且没有共同的内部点，则它们是接触的。PQE
    ST_WithinST_Within(geom1, geom2)BOOLEAN如果第一个输入几何体在第二个输入几何体中，则 ST_Within 返回 true。例如，如果几何体 A 中的每个点均为几何体 B 中的一个点，并且其内部有非空相交区域，则几何体 A 在几何体 B 中。ST_Within(A, B) 与 ST_Contains(B, A) 等效。**说明 通过PQE支持。PQE

  • Measurement函数

    函数函数语法返回类型说明支持的引擎
    ST_Angle- ST_Angle(geom1, geom2, geom3)
    • ST_Angle(geom1, geom2, geom3, geom4) | DOUBLE | ST_Angle返回顺时针方向测量的点之间的角度（返回值以弧度为单位且在 [0, 2π) 范围内）。例如：- 如果输入三个点，则测量P1P2P3三个点顺时针组成的角度。
    • 如果输入四个点，则测量有向线P1P2和P3P4顺时针形成的角度。如果输入为两条线平行（即，P1等于P2，或P3等于P4），则返回 null。 | PQE | | ST_Area | ST_Area(geom) | DOUBLE | ST_Area 返回输入几何体的笛卡尔面积。面积单位与用于表示输入几何体坐标的单位相同。对于点、线串、多点和多线串，此函数返回 0。对于几何体集合，它返回集合中几何体的面积之和。 | V1.3版本HQE支持。 | | ST_Azimuth | ST_Azimuth(point1, point2) | DOUBLE | ST_Azimuth返回两个输入点的基于北向的笛卡尔方位。 | V1.3版本HQE支持。 | | ST_Distance | ST_Distance(geom1, geom2) | DOUBLE | ST_Distance返回两个输入几何体值之间的欧氏距离。 | V1.3版本HQE支持。 | | ST_Length | ST_Length(geom) | DOUBLE | ST_Length返回输入线性几何体的笛卡尔长度。长度单位与用于表示输入几何体坐标的单位相同。对于点、多点和平面几何体，此函数返回零 (0)。当输入为几何体集合时，此函数返回集合中的几何体长度之和。 | V1.3版本HQE支持。 | | ST_Perimeter | ST_Perimeter(geom) | DOUBLE | ST_Perimeter返回输入平面几何体的笛卡尔周长（边界长度）。周长单位与用于表示输入几何体坐标的单位相同。对于点、多点和线性几何体，此函数返回零 (0)。当输入为几何体集合时，此函数返回集合中的几何体周长之和。 | V1.3版本HQE支持。 |

  • Overlay函数

    函数函数语法返回类型说明支持的引擎
    ST_IntersectionST_Intersection(geom1, geom2)GEOMETRY。返回几何之间的交集。V1.3版本HQE支持。

  • Geometry Processing函数

    函数函数语法返回类型说明支持的引擎
    ST_BufferST_Buffer(geography,float8)GEOMETRY用于指定与围绕其计算缓冲区的几何图形实例的距离。**说明 通过PQE支持。PQE
    ST_ConvexhullST_ConvexHull(geom)GEOMETRYST_convexhull 返回一个几何，该几何表示输入几何中包含的非空点的凸壳。V1.3版本HQE支持。
    ST_SimplifyST_Simplify(geom, tolerance)GEOMETRYST_Simplify中使用带有给定容差的 Ramer-Douglas-Peucker 算法返回输入几何的简化副本。输入几何的拓扑可能不会保留。有关该算法的详细信息，请参阅拉默-道格拉斯-普克算法在维基百科。V1.3版本HQE支持。

  • Bounding Box函数

    函数函数语法返回类型说明支持的引擎
    ST_XMaxST_XMax(geom)DOUBLEST_XMax返回输入几何体的最大的第一个坐标。**说明 通过PQE支持。PQE
    ST_XMinST_XMin(geom)DOUBLEST_XMin返回输入几何体的最小的第一个坐标。**说明 通过PQE支持。PQE
    ST_YMaxST_YMax(geom)DOUBLEST_YMax返回输入几何体的最大的第二个坐标。**说明 通过PQE支持。PQE
    ST_YMinST_YMin(geom)DOUBLEST_YMin返回输入几何体的最小的第二个坐标。**说明 通过PQE支持。PQE

  • Linear Referencing函数

    函数函数语法返回类型说明支持的引擎
    ST_LineInterpolatePointST_LineInterpolatePoint(geom, fraction)子类型POINT的GEOMETRY。ST_LineInterpolatePoint为插值点，即返回一个距离线起点为小数距离的点。V1.3版本HQE支持。
avatar
文章
阅读
粉丝