第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。


免責聲明!

本站轉載的文章為個人學習借鑒使用,本站對版權不負任何法律責任。如果侵犯了您的隱私權益,請聯系本站郵箱yoyou2525@163.com刪除。



 
粵ICP備18138465號   © 2018-2025 CODEPRJ.COM