第8章PostGIS参考

第8章PostGIS参考

第8章PostGIS参考

下面给出的功能是PostGIS用户可能需要的功能。还有一些其他功能是PostGIS对象所需的支持功能,这些功能对于一般用户来说是不可用的。

[注意]  

PostGIS已经开始从现有的命名约定过渡到以SQL-MM为中心的约定。因此,您所知道和喜欢的大多数功能都已使用标准空间类型(ST)前缀重命名。以前的功能仍然可用,但在本文档中未列出,其中更新的功能是等效的。本文档中未列出的非ST_函数已被弃用,并将在以后的版本中删除,因此请停止使用它们。

8.1。PostGIS几何/地理/盒子数据类型

抽象

本节列出了PostGIS安装的自定义PostgreSQL数据类型,以表示空间数据。

每种数据类型均描述其类型转换行为。型投 一种数据类型的转换值转换成另一种类型。PostgreSQL允许定义自定义类型的转换行为,以及用于转换类型值的函数。强制转换可以具有自动行为,该行为允许将函数参数自动转换为该函数支持的类型。

某些类型转换具有显式的行为,这意味着必须使用语法CAST(myval As sometype) 或来指定类型转换myval::sometype显式强制转换避免了模棱两可的强制转换问题,当使用不支持给定类型的重载函数时,可能会发生歧义转换。例如,一个函数可以接受box2d或box3d,但不能接受几何。由于几何图形会自动转换为两种类型的框,因此会产生“模棱两可的函数”错误。为防止错误,请使用显式强制转换为所需的框类型。

所有数据类型都可以强制转换为text,因此无需明确指定。

box2d —二维边界框。用于描述几何图形或几何图形集合的2D范围。
box3d — 3维边界框。用于描述几何图形或几何图形集合的3D范围。
geometry — 几何 —用平面坐标系表示空间要素的类型。
geometry_dump —用于描述复杂几何图形各部分的复合类型。
地理 —用大地(椭圆)坐标系表示空间特征的类型。

8.2。表管理功能

抽象

这些功能有助于定义包含几何列的表。

AddGeometryColumn —将几何列添加到现有表。
DropGeometryColumn —从空间表中删除几何列。
DropGeometryTable —将表及其所有引用拖放到geometry_columns中。
Find_SRID —返回为几何列定义的SRID。
Populate_Geometry_Columns —确保使用类型修饰符定义几何列或具有适当的空间约束。
UpdateGeometrySRID —更新几何列中所有要素的SRID和表元数据。

8.3。几何构造函数

ST_Collect —从一组几何创建一个GeometryCollection或Multi *几何。
ST_LineFromMultiPoint —从MultiPoint几何图形创建LineString。
ST_MakeEnvelope —从最小和最大坐标创建矩形多边形。
ST_MakeLine —从Point,MultiPoint或LineString几何形状创建线串。
ST_MakePoint —创建2D,3DZ或4D点。
ST_MakePointM —从X,Y和M值创建一个点。
ST_MakePolygon —从壳和孔的可选列表创建多边形。
ST_Point —使用给定的坐标值创建一个Point。ST_MakePoint的别名。
ST_Polygon —从具有指定SRID的LineString创建多边形。
ST_TileEnvelope —使用XYZ 贴系统在Web Mercator(SRID:3857)中创建矩形多边形。

8.4。几何存取器

GeometryType —以文本形式返回几何的类型。
ST_Boundary —返回几何的边界。
ST_CoordDim —返回几何的坐标尺寸。
ST_Dimension —返回几何的拓扑尺寸。
ST_Dump —返回geometry_dump用于几何图形组件的一行。
ST_DumpPoints —返回geometry_dump几何中点的一组行。
ST_DumpRings —返回geometry_dump多边形的外环和内环的一行。
ST_EndPoint —返回LineString或CircularLineString的最后一点。
ST_Envelope —返回表示几何图形边界框的几何图形。
ST_BoundingDiagonal —返回几何边界框的对角线。
ST_ExteriorRing —返回代表Polygon外环的LineString。
ST_GeometryN —返回几何集合的第N个几何元素。
ST_GeometryType —以文本形式返回几何的SQL-MM类型。
ST_HasArc —测试几何图形是否包含圆弧
ST_InteriorRingN —返回多边形的第N个内环(孔)。
ST_IsPolygonCCW —测试多边形是否具有沿逆时针方向定位的外环和沿顺时针方向定位的内环。
ST_IsPolygonCW —测试多边形是否具有顺时针定向的外环和逆时针定向的内环。
ST_IsClosed —测试LineStrings的起点和终点是否重合。对于PolyhedralSurface测试,是否封闭(体积)。
ST_IsCollection —测试几何是否为几何集合类型。
ST_IsEmpty —测试几何是否为空。
ST_IsRing —测试LineString是否闭合且简单。
ST_IsSimple —测试几何是否没有自相交或自相切的点。
ST_M —返回点的M坐标。
ST_MemSize —返回几何占用的内存空间量。
ST_NDims —返回几何的坐标尺寸。
ST_NPoints —返回几何中的点(顶点)数。
ST_NRings —返回多边形几何中的环数。
ST_NumGeometries —返回几何集合中的元素数。
ST_NumInteriorRings —返回多边形的内部环(孔)数。
ST_NumInteriorRing —返回多边形的内部环(孔)数。ST_NumInteriorRings的Aias
ST_NumPatches —返回多面曲面上的面数。对于非多面体几何形状,将返回null。
ST_NumPoints —返回LineString或CircularString中的点数。
ST_PatchN —返回多面曲面的第N个几何(面)。
ST_PointN —返回几何图形中第一个LineString或圆形LineString中的第N个点。
ST_Points —返回包含几何图形所有坐标的MultiPoint。
ST_StartPoint —返回LineString的第一个点。
ST_Summary —返回几何内容的文本摘要。
ST_X —返回点的X坐标。
ST_Y —返回点的Y坐标。
ST_Z —返回点的Z坐标。
ST_Zmflag —返回指示几何图形的ZM坐标尺寸的代码。

8.5。几何编辑器

ST_AddPoint —将点添加到LineString。
ST_CollectionExtract —给定(多)几何,返回仅由指定类型的元素组成的(多)几何。
ST_CollectionHomogenize —给定几何集合,返回内容的“最简单”表示。
ST_Force2D —将几何强制为“二维模式”。
ST_Force3D —将几何强制为XYZ模式。这是ST_Force3DZ的别名。
ST_Force3DZ —将几何强制为XYZ模式。
ST_Force3DM —将几何强制为XYM模式。
ST_Force4D —将几何强制为XYZM模式。
ST_ForcePolygonCCW —逆时针旋转所有外环,顺时针旋转所有内环。
ST_ForceCollection —将几何转换为GEOMETRYCOLLECTION。
ST_ForcePolygonCW —顺时针定向所有外环,逆时针定向 所有内环。
ST_ForceSFS —强制几何仅使用SFS 1.1几何类型。
ST_ForceRHR —强制多边形中顶点的方向遵循右手规则。
ST_ForceCurve —将几何体转换成其弯曲类型(如果适用)。
ST_LineMerge —返回通过将MULTILINESTRING缝合在一起而形成的(一组)LineString。
ST_Multi —将几何返回为MULTI *几何。
ST_Normalize —以规范形式返回几何。
ST_QuantizeCoordinates —将坐标的最低有效位设置为零
ST_RemovePoint —从线串中删除点。
ST_Reverse —返回顶点顺序颠倒的几何。
ST_Segmentize —返回修改后的几何/地理,其片段不超过给定距离。
ST_SetPoint —用给定的点替换线串的点。
ST_SnapToGrid —将输入几何图形的所有点捕捉到常规网格。
ST_Snap —将输入几何的线段和顶点对齐到参考几何的顶点。
ST_SwapOrdinates —返回交换给定纵坐标值的给定几何的版本。

8.6。几何验证

抽象

这些功能根据OGC SFS标准测试几何形状是否有效。它们还提供有关无效性质和位置的信息。

ST_IsValid —测试几何是否在2D中格式正确。
ST_IsValidDetail —返回valid_detail一行,说明几何是否有效,如果不是,则说明原因和位置。
ST_IsValidReason —返回说明几何是否有效或无效原因的文本。

8.7。空间参考系统功能

抽象

这些功能适用于几何空间参考系统。

ST_SetSRID —将几何图形上的SRID设置为特定的整数值。
ST_SRID —返回空间索引表中定义的ST_Geometry的空间​​参考标识符。
ST_Transform —返回其坐标已转换为其他空间参考系统的新几何。

8.8。几何输入

抽象

这些函数从各种文本或二进制格式创建几何对象。

8.8.1。知名文字(WKT)

ST_BdPolyFromText —根据给定的闭合线串的任意集合构造一个Polygon,作为MultiLineString众所周知的文本表示形式。
ST_BdMPolyFromText —根据给定的闭合线串的任意集合构造一个MultiPolygon,作为MultiLineString文本表示形式。
ST_GeogFromText —从知名文本表示形式或扩展(WKT)返回指定的地理值。
ST_GeographyFromText —从知名文本表示形式或扩展(WKT)返回指定的地理值。
ST_GeomCollFromText —使用给定的SRID从集合WKT生成集合Geometry。如果未提供SRID,则默认为0。
ST_GeomFromEWKT —从扩展的知名文本表示形式(EWKT)返回指定的ST_Geometry值。
ST_GeometryFromText —从知名文本表示形式(WKT)返回指定的ST_Geometry值。这是ST_GeomFromText的别名。
ST_GeomFromText —从知名文本表示形式(WKT)返回指定的ST_Geometry值。
ST_LineFromText —使用给定的SRID从WKT表示形式制作几何。如果未提供SRID,则默认为0。
ST_MLineFromText —从WKT表示形式返回指定的ST_MultiLineString值。
ST_MPointFromText —使用给定的SRID从WKT创建几何。如果未提供SRID,则默认为0。
ST_MPolyFromText —使用给定的SRID从WKT创建MultiPolygon Geometry。如果未提供SRID,则默认为0。
ST_PointFromText —使用给定的SRID从WKT创建点几何。如果未提供SRID,则默认为未知。
ST_PolygonFromText —使用给定的SRID从WKT创建几何。如果未提供SRID,则默认为0。
ST_WKTToSQL —从知名文本表示形式(WKT)返回指定的ST_Geometry值。这是ST_GeomFromText的别名。

8.8.2。二进制文件(WKB)

ST_GeogFromWKB —从一个知名的二进制几何表示(WKB)或扩展的知名二进制(EWKB)创建一个地理实例。
ST_GeomFromEWKB —从扩展的知名二进制表示形式(EWKB)返回指定的ST_Geometry值。
ST_GeomFromWKB —根据众所周知的二进制几何图形表示(WKB)和可选的SRID创建几何图形实例。
ST_LineFromWKB — LINESTRING使用给定的SRID从WKB中进行
ST_LinestringFromWKB —使用给定的SRID从WKB创建几何。
ST_PointFromWKB —使用给定的SRID从WKB创建几何
ST_WKBToSQL —从众所周知的二进制表示形式(WKB)返回指定的ST_Geometry值。这是ST_GeomFromWKB的别名,不带斜线

8.8.3。其他格式

ST_Box2dFromGeoHash —从GeoHash字符串返回BOX2D。
ST_GeomFromGeoHash —从GeoHash字符串返回几何。
ST_GeomFromGML —将几何图形作为输入GML表示并输出PostGIS几何图形对象
ST_GeomFromGeoJSON —将几何的geojson表示作为输入,并输出PostGIS几何对象
ST_GeomFromKML —将几何图形作为输入KML表示并输出PostGIS几何图形对象
ST_GeomFromTWKB —从TWKB(“微小的已知二进制”)几何图形表示中创建几何图形实例。
ST_GMLToSQL —从GML表示形式返回指定的ST_Geometry值。这是ST_GeomFromGML的别名
ST_LineFromEncodedPolyline —从编码折线创建LineString。
ST_PointFromGeoHash —从GeoHash字符串返回一个点。

8.9。几何输出

抽象

这些函数将几何对象转换为各种文本或二进制格式。

8.9.1。知名文字(WKT)

ST_AsEWKT —返回带有SRID元数据的几何图形的熟知文本(WKT)表示形式。
ST_AsText —返回不带SRID元数据的几何/地理的知名文本(WKT)表示形式。

8.9.2。二进制文件(WKB)

ST_AsBinary —返回不包含SRID元数据的几何/地理的知名二进制(WKB)表示形式。
ST_AsEWKB —返回带有SRID元数据的几何图形的熟知二进制(WKB)表示形式。
ST_AsHEXEWKB —使用小尾数(NDR)或大尾数(XDR)编码,以HEXEWKB格式(作为文本)返回Geometry。

8.9.3。其他格式

ST_AsEncodedPolyline —从LineString几何返回编码多段线。
ST_AsGeobuf —返回一组行的Geobuf表示形式。
ST_AsGeoJSON —将几何作为GeoJSON元素返回。
ST_AsGML —将几何作为GML版本2或3返回。
ST_AsKML —将几何图形作为KML元素返回。几种变体。默认版本= ​​2,默认最大十进制数字= 15
ST_AsLatLonText —返回给定点的度,分,秒表示。
ST_AsMVTGeom —将几何转换为Mapbox矢量图块的坐标空间。
ST_AsMVT —聚合函数,返回一组行的Mapbox矢量图块表示形式。
ST_AsSVG —返回几何的SVG路径数据。
ST_AsTWKB —将几何返回为TWKB,又称“微小的已知二进制”
ST_AsX3D —返回X3D xml节点元素格式的Geometry:ISO-IEC-19776-1.2-X3DEncodings-XML
ST_GeoHash —返回几何的GeoHash表示形式。

8.10。经营者

8.10.1。边界框运算符

&& —返回TRUEA的2D边界框是否与B的2D边界框相交。
&&(geometry,box2df) -返回TRUE几何的(缓存的)2D边界框是否与2D浮点精度边界框(BOX2DF)相交。
&&(box2df,geometry) —返回TRUE2D浮点精度边界框(BOX2DF)与几何图形(缓存)的2D边界框是否相交。
&&(box2df,box2df) -返回TRUE两个2D浮点精度边界框(BOX2DF)是否相交。
&&& —返回TRUEA的nD边界框是否与B的nD边界框相交。
&&&(geometry,gidx) —返回TRUE几何的(缓存的)nD边界框是否与nD浮点精度边界框(GIDX)相交。
&&&(gidx,geometry) —返回TRUEnD浮点精度边界框(GIDX)是否与几何体(缓存的)nD边界框相交。
&&&(gidx,gidx) -返回TRUE两个nD浮点精度边界框(GIDX)是否彼此相交。
&< —返回TRUEA的边界框是否重叠或位于B的左侧。
&<| —返回TRUEA的边界框是否重叠或低于B的边界框。
&> —返回TRUEA'边界框是否重叠或位于B的右侧。
<< —返回TRUEA的边界框是否严格位于B的左边。
<< | — TRUE如果A的边界框严格低于B的边界框,则返回
= —返回TRUE几何/地理A的坐标和坐标顺序是否与几何B的坐标和坐标顺序相同。
>> —返回TRUEA的边界框是否严格位于B的右边。
@ —返回TRUEA的边界框是否包含在B的边界框内。
@(geometry,box2df) —返回TRUE几何的2D边界框是否包含在2D浮点精度边界框(BOX2DF)中。
@(box2df,geometry) —返回TRUE是否将2D浮点精度边界框(BOX2DF)包含在几何的2D边界框中。
@(box2df,box2df) —返回TRUE一个2D浮点精度边界框(BOX2DF)是否包含在另一个2D浮点精度边界框中。
| &&> —返回TRUEA的边界框是否重叠或高于B的边界框。
| >> —返回TRUEA的边界框是否严格高于B的边界框。
〜—返回TRUEA的边界框是否包含B的边界。
〜(geometry,box2df) —返回TRUE几何的2D绑定框是否包含2D浮点精度边界框(GIDX)。
〜(box2df,geometry) —返回TRUE2D浮点精度边界框(BOX2DF)是否包含几何的2D绑定框。
〜(box2df,box2df) —返回TRUE2D浮点精度边界框(BOX2DF)是否包含另一个2D浮点精度边界框(BOX2DF)。
〜= —返回TRUEA的边界框是否与B的边界框相同。

8.10.2。距离算子

<-> —返回A和B之间的2D距离。
| = | —返回A和B轨迹之间最接近的点之间的距离。
<#> —返回A和B边界框之间的2D距离。
<<->> —返回A和B边界框的形心之间的nD距离。
<<#>> —返回A和B边界框之间的nD距离。

8.11。空间关系

抽象

这些函数确定几何之间的空间关系。

8.11.1。拓扑关系

ST_3DIntersects —如果几何在3D中“空间相交”,则返回TRUE-仅适用于点,线串,多边形,多面体表面(区域)。
ST_Contains —当且仅当B的点不位于A的外部且B的内部的至少一个点位于A的内部时,才返回true。
ST_ContainsProperly —如果B与A的内部相交而不是边界(或外部)相交,则返回true。A本身不包含自身,但是包含自身。
ST_Covers —如果几何B中的任何点都不在几何A之外,则返回1(TRUE)
ST_CoveredBy —如果几何/地理A中的任何点都不在几何/地理B之外,则返回1(TRUE)
ST_Crosses — TRUE如果提供的几何具有一些但不是全部内部公共点,则返回。
ST_LineCrossingDirection —给定2个线串,返回-3到3之间的数字,表示哪种交叉行为。0是不相交。
ST_Disjoint —如果几何不“空间相交”-如果它们不共享任何空间,则返回TRUE。
ST_Equals —如果给定的几何表示相同的几何,则返回true。方向性被忽略。
ST_Intersects —如果“几何体/地理”在2D中空间相交”(共享空间的任何部分),则返回FALSE;否则,则返回FALSE(它们不相交)。对于地理公差为0.00001米(因此,所有闭合点都视为相交)
ST_OrderingEquals —如果给定的几何表示相同的几何并且点的方向相同,则返回true。
ST_Overlaps —如果几何共享空间,具有相同的维数但彼此之间不完全包含,则返回TRUE。
ST_PointInsideCircle —是由center_x,center_y,半径定义的圆内的点几何
ST_Relate —如果此Geometry在空间上与anotherGeometry相关,则通过测试由交集MatrixPattern中的值指定的两个几何的内部,边界和外部之间的交集,返回true。如果未传入任何交集矩阵模式,则返回与2个几何相关的最大交集矩阵模式。
ST_RelateMatch —如果交集MattrixPattern1暗含交集MatrixPattern2,则返回true
ST_Touches —返回TRUE几何是否至少有一个公共点,但它们的内部不相交。
ST_Within —如果几何A完全在几何B内,则返回true

8.11.2。距离关系

ST_3DDWithin —对于3d(z)几何类型,如果两个几何3d距离在单位数量之内,则返回true。
ST_3DDFullyWithin —如果所有3D几何形状都在指定的距离之内,则返回true。
ST_DFullyWithin —如果所有几何都在指定的距离之内,则返回true
ST_DWithin —如果几何之间的指定距离内,则返回true。对于几何单位,以空间参考为单位;对于地理单位,以米为单位,并且默认将测量值设置为use_spheroid = true(围绕球体的度量),为了更快地进行检查,请使用use_spheroid = false沿球进行度量。

8.12。测量功能

抽象

这些功能可计算距离,面积和角度的测量值。还有一些功能可以计算通过测量确定的几何值。

ST_Area —返回多边形几何的面积。
ST_Azimuth —返回北点方位角,以弧度为单位,从点A的垂直方向到点B的角度以弧度为单位。
ST_Angle —返回3个点之间或2个向量之间的角度(4个点或2条线)。
ST_ClosestPoint —返回g1上最接近g2的2D点。这是最短线的第一点。
ST_3DClosestPoint —返回g1上最接近g2的3D点。这是3D最短线的第一点。
ST_Distance —返回两个几何或地理值之间的距离。
ST_3DDistance —以投影单位返回两个几何之间的3D笛卡尔最小距离(基于空间参考)。
ST_DistanceSphere —使用球形地球模型返回两个lon / lat几何之间的最小距离(以米为单位)。
ST_DistanceSpheroid —使用球状地球模型返回两个lon / lat几何之间的最小距离。
ST_FrechetDistance —返回两个几何之间的Fréchet距离。
ST_HausdorffDistance —返回两个几何之间的Hausdorff距离。
ST_Length —返回线性几何的2D长度。
ST_Length2D —返回线性几何的2D长度。别名ST_Length
ST_3DLength —返回线性几何的3D长度。
ST_LengthSpheroid —返回球体上lon / lat几何图形的2D或3D长度/周长。
ST_LongestLine —返回两个几何之间的2D最长线
ST_3DLongestLine —返回两个几何之间的3D最长线
ST_MaxDistance —以投影单位返回两个几何之间的最大二维距离。
ST_3DMaxDistance —以投影单位返回两个几何之间的3D笛卡尔最大距离(基于空间参考)。
ST_MinimumClearance —返回几何图形的最小隙,度量几何图形的鲁棒性。
ST_MinimumClearanceLine —返回跨越几何最小间隙的两点LineString。
ST_Perimeter —返回多边形几何或地理边界的长度。
ST_Perimeter2D —返回多边形几何的2D周长。的别名ST_Perimeter
ST_3DPerimeter —返回多边形几何的3D周长。
ST_Project —返回从起点投影一个距离和方位角(方位角)的点。
ST_ShortestLine —返回两个几何之间的二维最短线
ST_3DShortestLine —返回两个几何之间的3D最短线

8.13。几何加工

ST_Buffer —(T)返回一个几何图形,该几何图形覆盖距输入几何图形给定距离内的所有点。
ST_BuildArea —创建由给定几何图形的组成线条形成的面几何图形
ST_Centroid —返回几何的几何中心。
ST_ClipByBox2D —返回属于矩形的几何图形的一部分。
ST_ConcaveHull —几何形状的凹壳表示可能的凹形几何形状,该几何形状将集合中的所有几何形状都包含在内。您可以将其视为收缩包装。
ST_ConvexHull —计算几何的凸包。
ST_CurveToLine —将圆形/曲线多面/多表面转换为线性/多边/多面
ST_DelaunayTriangles —返回围绕给定输入点的Delaunay三角剖分。
ST_Difference —返回一个几何,该几何表示不与几何B相交的几何A的那一部分。
ST_FlipCoordinates —返回给定几何图形的X和Y轴已翻转的版本。对于已建立纬度/经度特征并需要对其进行修复的人员而言非常有用。
ST_GeneratePoints —将多边形或多多边形转换为由原始区域内的随机位置点组成的多点。
ST_GeometricMedian —返回MultiPoint的几何中间值。
ST_Intersection —(T)返回表示geomA和geomB共享部分的几何。
ST_LineToCurve —将LINESTRING / POLYGON转换为圆形,CURVEPOLYGON
ST_MakeValid —尝试使无效的几何图形有效而不丢失顶点。
ST_MemUnion —与ST_Union相同,仅对内存友好(使用更少的内存和更多的处理器时间)。
ST_MinimumBoundingCircle —返回可以完全包含几何图形的最小圆形多边形。默认情况下,每四分之一圈使用48个细分。
ST_MinimumBoundingRadius —返回可以完全包含几何图形的最小圆的圆心和半径。
ST_OrientedEnvelope —返回包含几何的最小旋转矩形。
ST_Polygonize —聚合。创建一个GeometryCollection,其中包含由一组几何的组成线组成的可能的多边形。
ST_Node —节点一组线串。
ST_OffsetCurve —返回距输入线给定距离和边距的偏移线。用于计算围绕中心线的平行线
ST_PointOnSurface —返回POINT保证位于表面上的位置。
ST_RemoveRepeatedPoints —返回给定几何的版本,其中删除了重复的点。
ST_SharedPaths —返回包含两个输入线串/多线串共享的路径的集合。
ST_ShiftLongitude —在-180..180和0..360范围之间切换几何坐标。
ST_WrapX —将几何图形环绕X值。
ST_Simplify —使用Douglas-Peucker算法返回给定几何的“简化”版本。
ST_SimplifyPreserveTopology —使用Douglas-Peucker算法返回给定几何的“简化”版本。将避免创建无效的派生几何(特别是多边形)。
ST_SimplifyVW —使用Visvalingam-Whyatt算法返回给定几何的“简化”版本
ST_ChaikinSmoothing —使用Chaikin算法返回给定几何的“平滑”版本
ST_FilterByM —根据顶点的m值过滤顶点
ST_SetEffectiveArea —设置每个顶点的有效面积,将值存储在M坐标中。然后可以通过对坐标进行过滤来生成简化的几何图形。
ST_Split —返回通过拆分几何图形得到的几何图形的集合。
ST_SymDifference —返回表示A和B不相交的部分的几何。之所以称其为对称差,是因为ST_SymDifference(A,B)= ST_SymDifference(B,A)。
ST_Subdivide —返回一组几何,其中该组中的任何几何都没有超过指定数量的顶点。
ST_Union —返回表示几何图形的点集并集的几何图形。
ST_UnaryUnion —与ST_Union类似,但是在几何图形组件级别工作。
ST_VoronoiLines —返回根据几何顶点构造的Voronoi图的像元之间的边界。
ST_VoronoiPolygons —返回从几何顶点构造的Voronoi图的像元。

8.14。仿射变换

抽象

这些功能使用仿射变换来更改几何的位置和形状 

ST_Affine —将3D仿射变换应用于几何图形。
ST_Rotate —围绕原点旋转几何。
ST_RotateX —绕X轴旋转几何。
ST_RotateY —绕Y轴旋转几何。
ST_RotateZ —绕Z轴旋转几何。
ST_Scale —按给定因子缩放几何。
ST_Translate —按给定的偏移量转换几何图形。
ST_TransScale —按给定的偏移量和因子平移和缩放几何。

8.15。聚类功能

抽象

这些函数为一组几何实现聚类算法。

ST_ClusterDBSCAN —窗口函数,使用DBSCAN算法为每个输入几何返回聚类ID。
ST_ClusterIntersecting —聚合函数,用于将输入几何形状聚类为连接的集合。
ST_ClusterKMeans —窗口函数,使用K-means算法为每个输入几何返回聚类ID。
ST_ClusterWithin —聚合函数,用于按分隔距离对输入几何图形进行聚类。

8.16。边界框功能

抽象

这些函数在边界框上产生或操作。他们还可以通过使用自动或显式强制转换来提供和接受几何值。

另请参见第14.7节“ PostGIS Box功能”

Box2D —返回代表几何2D范围的BOX2D。
Box3D —返回代表几何图形3D范围的BOX3D。
ST_EstimatedExtent —返回空间表的“估计”范围。
ST_Expand —返回从另一个边界框或几何图形扩展的边界框。
ST_Extent —一个聚合函数,该函数返回包围几何行的边界框。
ST_3DExtent —返回3D边界框的聚合函数,该边界框限制了几何的行。
ST_MakeBox2D —创建由两个2D点几何定义的BOX2D。
ST_3DMakeBox —创建由两个3D点几何定义的BOX3D。
ST_XMax —返回2D或3D边界框或几何的X最大值。
ST_XMin —返回2D或3D边界框或几何的X最小值。
ST_YMax —返回2D或3D边界框或几何的Y最大值。
ST_YMin —返回2D或3D边界框或几何的Y最小值。
ST_ZMax —返回2D或3D边界框或几何的Z最大值。
ST_ZMin —返回2D或3D边界框或几何的Z最小值。

8.17。线性参考

ST_LineInterpolatePoint —返回沿直线插入的点。第二个参数是一个介于0和1之间的float8,代表必须定位该点的线串总长度的一部分。
ST_3DLineInterpolatePoint —返回沿3D线插入的点。第二个参数是一个介于0和1之间的float8,代表必须定位该点的线串总长度的一部分。
ST_LineInterpolatePoints —返回沿线插补的一个或多个点。
ST_LineLocatePoint —返回0到1之间的浮点数,表示LineString上与给定Point点最近的点的位置,以总2d线长的一部分表示。
ST_LineSubstring —返回一个线串,该线串是输入的子串,从总2d长度的给定分数开始和结束。第二个和第三个参数是介于0和1之间的float8值。
ST_LocateAlong —返回带有与指定度量匹配的元素的派生几何集合值。不支持多边形元素。
ST_LocateBetween —返回派生的几何集合值,其元素与指定的范围(包括范围在内)相匹配。
ST_LocateBetweenElevations —返回派生的几何(集合)值,其元素与指定的高程范围相交。
ST_InterpolatePoint —返回在接近提供的点的点处的几何尺寸标注的值。
ST_AddMeasure —返回带有在起点和终点之间线性插值的测量元素的派生几何。

8.18。轨迹函数

抽象

这些功能支持使用轨迹。轨迹是在每个坐标上带有度量(M值)的线性几何。测量值必须沿线增加。时空数据可以通过使用相对时间(例如纪元)作为度量值来建模。

ST_IsValidTrajectory —返回true几何是否为有效轨迹。
ST_ClosestPointOfApproach —返回沿两个轨迹插补的点最近的度量。
ST_DistanceCPA —返回两个轨迹的最接近点之间的距离。
ST_CPAWithin —返回true两个轨迹的最接近点是否在指定距离内。

8.19。SFCGAL功能

抽象

SFCGAL是围绕CGAL的C ++包装库,可提供高级2D和3D空间功能。为了鲁棒性,几何坐标具有精确的有理数表示。

可在SFCGAL主页(http://www.sfcgal.org上找到该库的安装说明要启用功能,请使用create extension postgis_sfcgal

postgis_sfcgal_version —返回正在使用的SFCGAL的版本
ST_Extrude —将曲面拉伸到相关体积
ST_StraightSkeleton —根据几何计算直线骨架
ST_roxlativeMedialAxis —计算平面几何的近似中间轴。
ST_IsPlanar —检查曲面是否为平面
ST_Orientation —确定表面方向
ST_ForceLHR —强制LHR方向
ST_MinkowskiSum —执行Minkowski和
ST_ConstrainedDelaunayTriangles —返回围绕给定输入几何形状的约束Delaunay三角剖分。
ST_3DIntersection —执行3D相交
ST_3DDifference —执行3D差异
ST_3DUnion —执行3D 合并
ST_3DArea —计算3D表面几何形状的面积。对于实体将返回0。
ST_Tesselate —执行多边形或多面曲面的表面镶嵌处理,并以TIN或TINS集合的形式返回
ST_Volume —计算3D实体的体积。如果应用于表面(甚至闭合)几何,则将返回0。
ST_MakeSolid —将几何体投射到实体中。不执行检查。为了获得有效的实体,输入几何必须是闭合的多面曲面或闭合的TIN。
ST_IsSolid —测试几何是否为实体。不执行有效性检查。

8.20。长期交易支持

抽象

这些功能实现了行锁定机制来支持长事务。它们主要是为Web功能服务规范的实现者提供的 

AddAuth —添加要在当前事务中使用的授权令牌。
CheckAuth —在表上创建触发器,以防止/允许基于授权令牌更新和删除行。
DisableLongTransactions-禁用长事务支持。
EnableLongTransactions-启用长期交易支持。
LockRow —为表中的行设置锁定/授权。
UnlockRows —删除授权令牌持有的所有锁。
[注意]  

为了使锁定机制正确运行,必须使用可序列化的 事务隔离级别

8.21。版本功能

抽象

这些功能报告和升级PostGIS版本。

PostGIS_Extensions_Upgrade —将postgis扩展(例如postgis_raster,postgis_topology,postgis_sfcgal)打包并升级到最新的可用版本。
PostGIS_Full_Version —报告完整的postgis版本和构建配置信息。
PostGIS_GEOS_Version —返回GEOS库的版本号。
PostGIS_Liblwgeom_Version —返回liblwgeom库的版本号。这应该与PostGIS的版本匹配。
PostGIS_LibXML_Version —返回libxml2库的版本号。
PostGIS_Lib_Build_Date —返回PostGIS库的生成日期。
PostGIS_Lib_Version —返回PostGIS库的版本号。
PostGIS_PROJ_Version —返回PROJ4库的版本号。
PostGIS_Wagyu_Version —返回内部Wagyu库的版本号。
PostGIS_Scripts_Build_Date —返回PostGIS脚本的生成日期。
PostGIS_Scripts_Installed —返回此数据库中安装的postgis脚本的版本。
PostGIS_Scripts_Released —返回与已安装的postgis库一起发布的postgis.sql脚本的版本号。
PostGIS_Version —返回PostGIS版本号和编译时选项。

8.22。大统一自定义变量(GUC)

抽象

本节列出了自定义PostGIS Grand统一自定义变量(GUC)。这些可以通过数据库,会话或事务进行全局设置。最好在全局或数据库级别设置。

postgis.backend-服务于GEOS和SFCGAL重叠的功能的后端。选项:geos或sfcgal。默认为geos。
postgis.gdal_datapath —一个配置选项,用于分配GDAL的GDAL_DATA选项的值。如果未设置,则使用环境设置的GDAL_DATA变量。
postgis.gdal_enabled_drivers —一个配置选项,用于在PostGIS环境中设置已启用的GDAL驱动程序。影响GDAL配置变量GDAL_SKIP。
postgis.enable_outdb_rasters —一个布尔型配置选项,用于允许访问外数据库栅格波段。

8.23。故障排除功能

抽象

这些功能是用于对几何数据进行故障排除和修复的实用程序。仅当几何数据以某种方式损坏(在正常情况下永远不会发生)时才需要使用它们。

PostGIS_AddBBox —将边界框添加到几何。
PostGIS_DropBBox —从几何中删除边界框缓存。
PostGIS_HasBBox —如果已缓存此几何的bbox,则返回TRUE,否则返回FALSE。
posted @ 2020-01-19 11:12  每天进步一点点_hejj  阅读(2612)  评论(0编辑  收藏  举报