PostGIS 幾何/地理/邊界框資料型別 | |
---|---|
box2d 代表二維邊界框的型別。 | |
box3d 代表三維邊界框的型別。 | |
geometry 代表具有平面坐標系統的空間特徵的型別。 | |
geometry_dump 用於描述複雜幾何圖形部分的複合型別。 | |
geography 代表具有大地測量 (橢圓體) 坐標系統的空間特徵的型別。 |
資料表管理函式 | |
---|---|
AddGeometryColumn 3d 將幾何欄位新增至現有資料表。
| |
DropGeometryColumn 3d 從空間資料表中移除幾何欄位。
| |
DropGeometryTable 刪除資料表及其在 geometry_columns 中的所有參考。
| |
Find_SRID (a_schema_name, a_table_name, a_geomfield_name) 傳回為幾何欄位定義的 SRID。 | |
Populate_Geometry_Columns 確保幾何欄位已使用型別修飾詞定義,或具有適當的空間約束。
| |
UpdateGeometrySRID 3d 更新幾何欄位中所有特徵的 SRID 以及資料表元數據。
|
幾何建構函式 | |
---|---|
ST_Collect 3d 從一組幾何圖形建立 GeometryCollection 或 Multi* 幾何圖形。
| |
ST_LineFromMultiPoint 3d (aMultiPoint) 從 MultiPoint 幾何圖形建立 LineString。 | |
ST_MakeEnvelope (xmin, ymin, xmax, ymax, srid=unknown) 從最小和最大坐標建立矩形 Polygon。 | |
ST_MakeLine 3d 從 Point、MultiPoint 或 LineString 幾何圖形建立 LineString。
| |
ST_MakePoint 3d 建立 2D、3DZ 或 4D Point。
| |
ST_MakePointM (x, y, m) 從 X、Y 和 M 值建立 Point。 | |
ST_MakePolygon 3d 從外殼和可選的孔洞列表建立 Polygon。
| |
ST_Point mm 建立具有 X、Y 和 SRID 值的 Point。
| |
ST_PointZ (x, y, z, srid=unknown) 建立具有 X、Y、Z 和 SRID 值的 Point。 | |
ST_PointM (x, y, m, srid=unknown) 建立具有 X、Y、M 和 SRID 值的 Point。 | |
ST_PointZM (x, y, z, m, srid=unknown) 建立具有 X、Y、Z、M 和 SRID 值的 Point。 | |
ST_Polygon mm 3d (lineString, srid) 從具有指定 SRID 的 LineString 建立 Polygon。 | |
ST_TileEnvelope (tileZoom, tileX, tileY, bounds=SRID=3857;LINESTRING(-20037508.342789 -20037508.342789,20037508.342789 20037508.342789), margin=0.0) 使用 XYZ 圖磚系統在 Web Mercator (SRID:3857) 中建立矩形 Polygon。 | |
ST_HexagonGrid (size, bounds) 傳回一組六邊形和完全覆蓋幾何引數邊界的單元格索引。 | |
ST_Hexagon (size, cell_i, cell_j, origin) 在六邊形網格空間中使用提供的邊緣大小和單元格坐標傳回單個六邊形。 | |
ST_SquareGrid (size, bounds) 傳回一組完全覆蓋幾何引數邊界的網格正方形和單元格索引。 | |
ST_Square (size, cell_i, cell_j, origin) 在正方形網格空間中使用提供的邊緣大小和單元格坐標傳回單個正方形。 | |
ST_Letters ( letters, font) 傳回輸入的字母,以幾何圖形的形式呈現,預設起始位置為原點,預設文字高度為 100。 |
幾何存取器 | |
---|---|
GeometryType 3d (geomA) 以文字形式傳回幾何圖形的型別。 | |
ST_Boundary mm 3d (geomA) 傳回幾何圖形的邊界。 | |
ST_BoundingDiagonal 3d (geom, fits=false) 傳回幾何圖形邊界框的對角線。 | |
ST_CoordDim mm 3d (geomA) 傳回幾何圖形的坐標維度。 | |
ST_Dimension mm (g) 傳回幾何圖形的拓撲維度。 | |
ST_Dump 3d (g1) 傳回幾何圖形元件的一組 geometry_dump 列。 | |
ST_DumpPoints 3d (geom) 傳回幾何圖形中坐標的一組 geometry_dump 列。 | |
ST_DumpSegments 3d (geom) 傳回幾何圖形中線段的一組 geometry_dump 列。 | |
ST_DumpRings 3d (a_polygon) 傳回 Polygon 的外部和內部環的一組 geometry_dump 列。 | |
ST_EndPoint mm 3d (g) 傳回 LineString 或 CircularLineString 的最後一個點。 | |
ST_Envelope mm (g1) 傳回代表幾何圖形邊界框的幾何圖形。 | |
ST_ExteriorRing mm 3d (a_polygon) 傳回代表 Polygon 外部環的 LineString。 | |
ST_GeometryN mm 3d (geomA, n) 傳回幾何圖形集合的元素。 | |
ST_GeometryType mm 3d (g1) 以文字形式傳回幾何圖形的 SQL-MM 型別。 | |
ST_HasArc 3d (geomA) 測試幾何圖形是否包含圓弧。 | |
ST_InteriorRingN mm 3d (a_polygon, n) 傳回 Polygon 的第 N 個內部環 (孔洞)。 | |
ST_NumCurves mm 3d (a_compoundcurve) 傳回 CompoundCurve 中元件曲線的數量。 | |
ST_CurveN mm 3d (a_compoundcurve, index) 傳回 CompoundCurve 的第 N 個元件曲線幾何圖形。 | |
ST_IsClosed mm 3d (g) 測試 LineStrings 的起點和終點是否重合。對於 PolyhedralSurface,測試它是否是封閉的 (體積的)。 | |
ST_IsCollection 3d (g) 測試幾何圖形是否為幾何圖形集合型別。 | |
ST_IsEmpty mm (geomA) 測試幾何圖形是否為空的。 | |
ST_IsPolygonCCW 3d (geom) 測試 Polygon 是否具有逆時針方向的外部環和順時針方向的內部環。 | |
ST_IsPolygonCW 3d (geom) 測試 Polygon 是否具有順時針方向的外部環和逆時針方向的內部環。 | |
ST_IsRing mm (g) 測試 LineString 是否為封閉且簡單的。 | |
ST_IsSimple mm 3d (geomA) 測試幾何圖形是否沒有自相交或自相切的點。 | |
ST_M mm 3d (a_point) 傳回 Point 的 M 坐標。 | |
ST_MemSize 3d (geomA) 傳回幾何圖形佔用的記憶體空間大小。 | |
ST_NDims 3d (g1) 傳回幾何圖形的坐標維度。 | |
ST_NPoints 3d (g1) 傳回幾何圖形中點 (頂點) 的數量。 | |
ST_NRings 3d (geomA) 傳回多邊形幾何圖形中環的數量。 | |
ST_NumGeometries mm 3d (geom) 傳回幾何圖形集合中的元素數量。 | |
ST_NumInteriorRings mm (a_polygon) 傳回 Polygon 的內部環 (孔洞) 的數量。 | |
ST_NumInteriorRing (a_polygon) 傳回 Polygon 的內部環 (孔洞) 的數量。ST_NumInteriorRings 的別名 | |
ST_NumPatches mm 3d (g1) 傳回多面體表面上的面數。對於非多面體幾何,將傳回 null。 | |
ST_NumPoints mm (g1) 傳回 LineString 或 CircularString 中的點數。 | |
ST_PatchN mm 3d (geomA, n) 傳回 PolyhedralSurface 的第 N 個幾何圖形(面)。 | |
ST_PointN mm 3d (a_linestring, n) 傳回幾何圖形中第一個 LineString 或圓形 LineString 的第 N 個點。 | |
ST_Points 3d (geom) 傳回一個包含幾何圖形座標的 MultiPoint。 | |
ST_StartPoint mm 3d (geomA) 傳回 LineString 的第一個點。 | |
ST_Summary G 傳回幾何圖形內容的文字摘要。
| |
ST_X mm 3d (a_point) 傳回點的 X 座標。 | |
ST_Y mm 3d (a_point) 傳回點的 Y 座標。 | |
ST_Z mm 3d (a_point) 傳回點的 Z 座標。 | |
ST_Zmflag 3d (geomA) 傳回一個程式碼,指示幾何圖形的 ZM 座標維度。 | |
ST_HasZ 1 3d (geom) 檢查幾何圖形是否具有 Z 維度。 | |
ST_HasM 1 3d (geom) 檢查幾何圖形是否具有 M(度量)維度。 |
幾何編輯器 | |
---|---|
ST_AddPoint 3d 將一個點新增至 LineString。
| |
ST_CollectionExtract 給定一個幾何集合,傳回一個僅包含指定類型元素的複合幾何。
| |
ST_CollectionHomogenize (collection) 傳回幾何集合的最簡單表示法。 | |
ST_CurveToLine mm 3d (curveGeom, tolerance, tolerance_type, flags) 將包含曲線的幾何圖形轉換為線性幾何圖形。 | |
ST_Scroll 3d (linestring, point) 變更封閉 LineString 的起點。 | |
ST_FlipCoordinates 3d (geom) 傳回一個 X 軸和 Y 軸翻轉的幾何圖形版本。 | |
ST_Force2D 3d (geomA) 將幾何圖形強制轉換為「二維模式」。 | |
ST_Force3D 3d (geomA, Zvalue = 0.0) 將幾何圖形強制轉換為 XYZ 模式。這是 ST_Force3DZ 的別名。 | |
ST_Force3DZ 3d (geomA, Zvalue = 0.0) 將幾何圖形強制轉換為 XYZ 模式。 | |
ST_Force3DM (geomA, Mvalue = 0.0) 將幾何圖形強制轉換為 XYM 模式。 | |
ST_Force4D 3d (geomA, Zvalue = 0.0, Mvalue = 0.0) 將幾何圖形強制轉換為 XYZM 模式。 | |
ST_ForceCollection 3d (geomA) 將幾何圖形轉換為 GEOMETRYCOLLECTION。 | |
ST_ForceCurve 3d (g) 如果適用,將幾何圖形向上轉換為其曲線類型。 | |
ST_ForcePolygonCCW 3d (geom) 將所有外部環順時針方向定向,並將所有內部環逆時針方向定向。 | |
ST_ForcePolygonCW 3d (geom) 將所有外部環逆時針方向定向,並將所有內部環順時針方向定向。 | |
ST_ForceSFS 3d 強制幾何圖形僅使用 SFS 1.1 幾何圖形類型。
| |
ST_ForceRHR 3d (g) 強制多邊形中頂點的方向遵循右手規則。 | |
ST_LineExtend (line, distance_forward, distance_backward=0.0) 傳回一條向前和向後延伸指定距離的線。 | |
ST_LineToCurve 3d (geomANoncircular) 將線性幾何圖形轉換為曲線幾何圖形。 | |
ST_Multi (geom) 將幾何圖形作為 MULTI* 幾何圖形傳回。 | |
ST_Normalize (geom) 以標準形式傳回幾何圖形。 | |
ST_Project G 傳回從起點按距離和方位角(方位)投影的點。
| |
ST_QuantizeCoordinates (g, prec_x, prec_y, prec_z, prec_m) 將座標的最低有效位元設定為零。 | |
ST_RemovePoint 3d (linestring, offset) 從線字串中移除一個點。 | |
ST_RemoveRepeatedPoints 3d (geom, tolerance) 傳回一個刪除重複點的幾何圖形版本。 | |
ST_RemoveIrrelevantPointsForView 1 (geom, bounds, cartesian_hint = false) 移除與幾何圖形的特定矩形視圖的渲染無關的點。 | |
ST_RemoveSmallParts 1 (geom, minSizeX, minSizeY) 移除幾何圖形的小部分(多邊形環或線字串)。 | |
ST_Reverse 3d (g1) 傳回頂點順序反轉的幾何圖形。 | |
ST_Segmentize G 傳回修改後的幾何/地理,其線段長度不大於給定的距離。
| |
ST_SetPoint 3d (linestring, zerobasedposition, point) 以給定的點替換線字串的點。 | |
ST_ShiftLongitude 3d (geom) 將幾何圖形的經度座標在 -180..180 和 0..360 之間移動。 | |
ST_WrapX 3d (geom, wrap, move) 將幾何圖形環繞 X 值。 | |
ST_SnapToGrid 3d 將輸入幾何圖形的所有點捕捉到規則格點。
| |
ST_Snap (input, reference, tolerance) 將輸入幾何圖形的線段和頂點捕捉到參考幾何圖形的頂點。 | |
ST_SwapOrdinates 3d (geom, ords) 傳回一個給定幾何圖形版本,其中給定的座標值已交換。 |
幾何驗證 | |
---|---|
ST_IsValid mm 測試幾何圖形在 2D 中是否格式正確。
| |
ST_IsValidDetail (geom, flags) 傳回 valid_detail 列,說明幾何圖形是否有效,如果無效則說明原因和位置。 | |
ST_IsValidReason 傳回文字,說明幾何圖形是否有效,或說明無效的原因。
| |
ST_MakeValid 3d 嘗試使無效的幾何圖形有效而不遺失頂點。
|
空間參考系統函數 | |
---|---|
ST_InverseTransformPipeline (geom, pipeline, to_srid) 使用定義的坐標轉換管道的反向轉換,返回一個坐標轉換到不同空間參考系統的新幾何圖形。 | |
ST_SetSRID (geom, srid) 設定幾何圖形的 SRID。 | |
ST_SRID mm (g1) 返回幾何圖形的空間參考識別碼。 | |
ST_Transform mm 返回一個坐標轉換到不同空間參考系統的新幾何圖形。
| |
ST_TransformPipeline (g1, pipeline, to_srid) 使用定義的坐標轉換管道,返回一個坐標轉換到不同空間參考系統的新幾何圖形。 | |
postgis_srs_codes (auth_name) 返回與給定授權機構相關聯的 SRS 代碼清單。 | |
postgis_srs (auth_name, auth_srid) 返回請求的授權機構和 srid 的元數據記錄。 | |
postgis_srs_all () 返回底層 Proj 資料庫中每個空間參考系統的元數據記錄。 | |
postgis_srs_search (bounds, auth_name=EPSG) 返回使用範圍完全包含 bounds 參數的投影坐標系統的元數據記錄。 |
幾何圖形輸入 | |
---|---|
ST_BdPolyFromText (WKT, srid) 給定任意封閉線串的集合作為 MultiLineString 文本表示,建構一個多邊形。 | |
ST_BdMPolyFromText (WKT, srid) 給定任意封閉線串的集合作為 MultiLineString 文本表示,建構一個多重多邊形。 | |
ST_GeogFromText G (EWKT) 從 Well-Known Text 表示法或擴展的(WKT)返回指定的地理值。 | |
ST_GeographyFromText G (EWKT) 從 Well-Known Text 表示法或擴展的(WKT)返回指定的地理值。 | |
ST_GeomCollFromText mm 從具有給定 SRID 的 WKT 集合建立一個幾何圖形集合。如果沒有給定 SRID,則預設為 0。
| |
ST_GeomFromEWKT 3d (EWKT) 從擴展的 Well-Known Text 表示法(EWKT)返回指定的 ST_Geometry 值。 | |
ST_GeomFromMARC21 (marcxml) 取得 MARC21/XML 地理數據作為輸入,並返回 PostGIS 幾何圖形物件。 | |
ST_GeometryFromText mm 從 Well-Known Text 表示法(WKT)返回指定的 ST_Geometry 值。這是 ST_GeomFromText 的別名。
| |
ST_GeomFromText mm 從 Well-Known Text 表示法(WKT)返回指定的 ST_Geometry 值。
| |
ST_LineFromText mm 從具有給定 SRID 的 WKT 表示法建立幾何圖形。如果沒有給定 SRID,則預設為 0。
| |
ST_MLineFromText mm 從 WKT 表示法返回指定的 ST_MultiLineString 值。
| |
ST_MPointFromText mm 從具有給定 SRID 的 WKT 建立幾何圖形。如果沒有給定 SRID,則預設為 0。
| |
ST_MPolyFromText mm 從具有給定 SRID 的 WKT 建立一個多重多邊形幾何圖形。如果沒有給定 SRID,則預設為 0。
| |
ST_PointFromText mm 從具有給定 SRID 的 WKT 建立一個點幾何圖形。如果沒有給定 SRID,則預設為未知。
| |
ST_PolygonFromText mm 從具有給定 SRID 的 WKT 建立幾何圖形。如果沒有給定 SRID,則預設為 0。
| |
ST_WKTToSQL mm (WKT) 從 Well-Known Text 表示法(WKT)返回指定的 ST_Geometry 值。這是 ST_GeomFromText 的別名。 | |
ST_GeogFromWKB G (wkb) 從 Well-Known Binary 幾何表示法(WKB)或擴展的 Well Known Binary(EWKB)建立地理實例。 | |
ST_GeomFromEWKB 3d (EWKB) 從擴展的 Well-Known Binary 表示法(EWKB)返回指定的 ST_Geometry 值。 | |
ST_GeomFromWKB mm 從 Well-Known Binary 幾何表示法(WKB)和可選的 SRID 建立幾何實例。
| |
ST_LineFromWKB mm 從具有給定 SRID 的 WKB 建立一個 LINESTRING。
| |
ST_LinestringFromWKB mm 從具有給定 SRID 的 WKB 建立一個幾何圖形。
| |
ST_PointFromWKB mm 3d 從具有給定 SRID 的 WKB 建立一個幾何圖形。
| |
ST_WKBToSQL mm (WKB) 從 Well-Known Binary 表示法(WKB)返回指定的 ST_Geometry 值。這是 ST_GeomFromWKB 的別名,不帶 srid。 | |
ST_Box2dFromGeoHash (geohash, precision=full_precision_of_geohash) 從 GeoHash 字串返回一個 BOX2D。 | |
ST_GeomFromGeoHash (geohash, precision=full_precision_of_geohash) 從 GeoHash 字串返回一個幾何圖形。 | |
ST_GeomFromGML 3d 取得幾何圖形的 GML 表示法作為輸入,並輸出 PostGIS 幾何圖形物件。
| |
ST_GeomFromGeoJSON 3d 取得幾何圖形的 geojson 表示法作為輸入,並輸出 PostGIS 幾何圖形物件。
| |
ST_GeomFromKML 3d (geomkml) 取得幾何圖形的 KML 表示法作為輸入,並輸出 PostGIS 幾何圖形物件。 | |
ST_GeomFromTWKB (twkb) 從 TWKB(「Tiny Well-Known Binary」)幾何表示法建立幾何實例。 | |
ST_GMLToSQL mm 從 GML 表示法返回指定的 ST_Geometry 值。這是 ST_GeomFromGML 的別名。
| |
ST_LineFromEncodedPolyline (polyline, precision=5) 從編碼的折線建立 LineString。 | |
ST_PointFromGeoHash (geohash, precision=full_precision_of_geohash) 從 GeoHash 字串返回一個點。 | |
ST_FromFlatGeobufToTable (schemaname, tablename, FlatGeobuf input data) 根據 FlatGeobuf 數據的結構建立一個表格。 | |
ST_FromFlatGeobuf (Table reference, FlatGeobuf input data) 讀取 FlatGeobuf 數據。 |
幾何圖形輸出 | |
---|---|
ST_AsEWKT G 3d 返回帶有 SRID 元數據的幾何圖形的 Well-Known Text(WKT)表示法。
| |
ST_AsText mm G 返回不帶 SRID 元數據的幾何/地理圖形的 Well-Known Text(WKT)表示法。
| |
ST_AsBinary mm G 3d 返回不帶 SRID 元數據的幾何/地理圖形的 OGC/ISO Well-Known Binary(WKB)表示法。
| |
ST_AsEWKB 3d 返回帶有 SRID 元數據的幾何圖形的擴展 Well-Known Binary(EWKB)表示法。
| |
ST_AsHEXEWKB 3d 使用小端(NDR)或大端(XDR)編碼,以 HEXEWKB 格式(作為文本)返回幾何圖形。
| |
ST_AsEncodedPolyline (geom, precision=5) 從 LineString 幾何圖形返回編碼的折線。 | |
ST_AsFlatGeobuf 返回一組行的 FlatGeobuf 表示法。
| |
ST_AsGeobuf 返回一組行的 Geobuf 表示法。
| |
ST_AsGeoJSON G 3d 以 GeoJSON 格式返回幾何圖形或要素。
| |
ST_AsGML mm G 3d 以 GML 版本 2 或 3 元素的形式回傳幾何物件。
| |
ST_AsKML G 3d 以 KML 元素的形式回傳幾何物件。
| |
ST_AsLatLonText (pt, format='') 回傳給定點的度、分、秒表示法。 | |
ST_AsMARC21 (geom, format='hdddmmss') 以包含地理資料欄位 (034) 的 MARC21/XML 記錄形式回傳幾何物件。 | |
ST_AsMVTGeom (geom, bounds, extent=4096, buffer=256, clip_geom=true) 將幾何物件轉換為 MVT 圖磚的座標空間。 | |
ST_AsMVT 聚合函式,回傳一組列的 MVT 表示法。
| |
ST_AsSVG G 回傳幾何物件的 SVG 路徑資料。
| |
ST_AsTWKB 以 TWKB (又稱「Tiny Well-Known Binary」) 形式回傳幾何物件。
| |
ST_AsX3D 3d (g1, maxdecimaldigits=15, options=0) 以 X3D xml 節點元素格式回傳幾何物件:ISO-IEC-19776-1.2-X3DEncodings-XML | |
ST_GeoHash (geom, maxchars=full_precision_of_point) 回傳幾何物件的 GeoHash 表示法。 |
運算子 | |
---|---|
&& G 如果 A 的 2D 邊界框與 B 的 2D 邊界框相交,則回傳 TRUE。
| |
&&(geometry,box2df) (A, B) 如果幾何物件的(快取)2D 邊界框與 2D 浮點精度邊界框 (BOX2DF) 相交,則回傳 TRUE。 | |
&&(box2df,geometry) (A, B) 如果 2D 浮點精度邊界框 (BOX2DF) 與幾何物件的(快取)2D 邊界框相交,則回傳 TRUE。 | |
&&(box2df,box2df) (A, B) 如果兩個 2D 浮點精度邊界框 (BOX2DF) 彼此相交,則回傳 TRUE。 | |
&&& 3d (A, B) 如果 A 的 n 維邊界框與 B 的 n 維邊界框相交,則回傳 TRUE。 | |
&&&(geometry,gidx) 3d (A, B) 如果幾何物件的(快取)n 維邊界框與 n 維浮點精度邊界框 (GIDX) 相交,則回傳 TRUE。 | |
&&&(gidx,geometry) 3d (A, B) 如果 n 維浮點精度邊界框 (GIDX) 與幾何物件的(快取)n 維邊界框相交,則回傳 TRUE。 | |
&&&(gidx,gidx) 3d (A, B) 如果兩個 n 維浮點精度邊界框 (GIDX) 彼此相交,則回傳 TRUE。 | |
&< (A, B) 如果 A 的邊界框與 B 的邊界框重疊或位於 B 的左側,則回傳 TRUE。 | |
&<| (A, B) 如果 A 的邊界框與 B 的邊界框重疊或位於 B 的下方,則回傳 TRUE。 | |
&> (A, B) 如果 A 的邊界框與 B 的邊界框重疊或位於 B 的右側,則回傳 TRUE。 | |
<< (A, B) 如果 A 的邊界框嚴格位於 B 的左側,則回傳 TRUE。 | |
<<| (A, B) 如果 A 的邊界框嚴格位於 B 的下方,則回傳 TRUE。 | |
= G 如果幾何/地理物件 A 的座標和座標順序與幾何/地理物件 B 的座標和座標順序相同,則回傳 TRUE。
| |
>> (A, B) 如果 A 的邊界框嚴格位於 B 的右側,則回傳 TRUE。 | |
@ (A, B) 如果 A 的邊界框包含在 B 的邊界框中,則回傳 TRUE。 | |
@(geometry,box2df) (A, B) 如果幾何物件的 2D 邊界框包含在 2D 浮點精度邊界框 (BOX2DF) 中,則回傳 TRUE。 | |
@(box2df,geometry) (A, B) 如果 2D 浮點精度邊界框 (BOX2DF) 包含在幾何物件的 2D 邊界框中,則回傳 TRUE。 | |
@(box2df,box2df) (A, B) 如果 2D 浮點精度邊界框 (BOX2DF) 包含在另一個 2D 浮點精度邊界框中,則回傳 TRUE。 | |
|&> (A, B) 如果 A 的邊界框與 B 的邊界框重疊或位於 B 的上方,則回傳 TRUE。 | |
|>> (A, B) 如果 A 的邊界框嚴格位於 B 的上方,則回傳 TRUE。 | |
~ (A, B) 如果 A 的邊界框包含 B 的邊界框,則回傳 TRUE。 | |
~(geometry,box2df) (A, B) 如果幾何物件的 2D 邊界框包含 2D 浮點精度邊界框 (GIDX),則回傳 TRUE。 | |
~(box2df,geometry) (A, B) 如果 2D 浮點精度邊界框 (BOX2DF) 包含幾何物件的 2D 邊界框,則回傳 TRUE。 | |
~(box2df,box2df) (A, B) 如果 2D 浮點精度邊界框 (BOX2DF) 包含另一個 2D 浮點精度邊界框 (BOX2DF),則回傳 TRUE。 | |
~= (A, B) 如果 A 的邊界框與 B 的邊界框相同,則回傳 TRUE。 | |
<-> G 回傳 A 和 B 之間的 2D 距離。
| |
|=| (A, B) 回傳 A 和 B 軌跡在其最接近點的距離。 | |
<#> (A, B) 回傳 A 和 B 邊界框之間的 2D 距離。 | |
<<->> (A, B) 回傳 A 和 B 幾何物件或邊界框之間的 n 維距離。 |
空間關係 | |
---|---|
ST_3DIntersects mm 3d (geomA, geomB) 測試兩個幾何物件是否在 3D 空間中相交 - 僅適用於點、線串、多邊形、多面體表面(面積) | |
ST_Contains mm (geomA, geomB) 測試 B 的每個點是否都位於 A 中,且它們的內部具有一個共同點 | |
ST_ContainsProperly (geomA, geomB) 測試 B 的每個點是否都位於 A 的內部 | |
ST_CoveredBy G 測試 A 的每個點是否都位於 B 中
| |
ST_Covers G 測試 B 的每個點是否都位於 A 中
| |
ST_Crosses mm (g1, g2) 測試兩個幾何物件是否有一些但非全部的內部點是共同的 | |
ST_Disjoint mm (A, B) 測試兩個幾何物件是否沒有共同點 | |
ST_Equals mm (A, B) 測試兩個幾何物件是否包含相同的點集 | |
ST_Intersects mm G 測試兩個幾何物件是否相交(它們是否至少有一個共同點)
| |
ST_LineCrossingDirection (linestringA, linestringB) 回傳一個數字,表示兩個 LineString 的交叉行為 | |
ST_OrderingEquals mm (A, B) 測試兩個幾何物件是否代表相同的幾何物件且點的定向順序相同 | |
ST_Overlaps mm (A, B) 測試兩個幾何物件是否具有相同的維度並相交,但每個物件至少有一個點不在另一個物件中 | |
ST_Relate mm 測試兩個幾何圖形是否具有符合交集矩陣模式的拓撲關係,或計算它們的交集矩陣。
| |
ST_RelateMatch (intersectionMatrix, intersectionMatrixPattern) 測試 DE-9IM 交集矩陣是否符合交集矩陣模式 | |
ST_Touches mm (A, B) 測試兩個幾何圖形是否至少有一個共同點,但它們的內部不相交 | |
ST_Within mm (A, B) 測試 A 的每個點是否都位於 B 中,且它們的內部有共同點 | |
ST_3DDWithin mm 3d (g1, g2, distance_of_srid) 測試兩個 3D 幾何圖形是否在給定的 3D 距離內 | |
ST_3DDFullyWithin 3d (g1, g2, distance) 測試兩個 3D 幾何圖形是否完全在給定的 3D 距離內 | |
ST_DFullyWithin (g1, g2, distance) 測試一個幾何圖形是否完全在另一個幾何圖形的距離內 | |
ST_DWithin G 測試兩個幾何圖形是否在給定的距離內
| |
ST_PointInsideCircle (a_point, center_x, center_y, radius) 測試點幾何圖形是否在由中心和半徑定義的圓內 |
量測函式 | |
---|---|
ST_Area mm G 傳回多邊形幾何圖形的面積。
| |
ST_Azimuth G 傳回兩點之間線的北基準方位角。
| |
ST_Angle 傳回由 3 或 4 個點或 2 條線定義的兩個向量之間的角度。
| |
ST_ClosestPoint G 傳回 g1 上最接近 g2 的 2D 點。這是從一個幾何圖形到另一個幾何圖形的最短線的第一個點。
| |
ST_3DClosestPoint 3d (g1, g2) 傳回 g1 上最接近 g2 的 3D 點。這是 3D 最短線的第一個點。 | |
ST_Distance mm G 傳回兩個幾何或地理值之間的距離。
| |
ST_3DDistance mm 3d (g1, g2) 傳回兩個幾何圖形之間投影單位中的 3D 笛卡爾最小距離(基於空間參考)。 | |
ST_DistanceSphere (geomlonlatA, geomlonlatB, radius=6371008) 使用球體地球模型傳回兩個經緯度幾何圖形之間的最小距離(以公尺為單位)。 | |
ST_DistanceSpheroid (geomlonlatA, geomlonlatB, measurement_spheroid=WGS84) 使用橢球體地球模型傳回兩個經緯度幾何圖形之間的最小距離。 | |
ST_FrechetDistance (g1, g2, densifyFrac = -1) 傳回兩個幾何圖形之間的 Fréchet 距離。 | |
ST_HausdorffDistance 傳回兩個幾何圖形之間的 Hausdorff 距離。
| |
ST_Length mm G 傳回線性幾何圖形的 2D 長度。
| |
ST_Length2D (a_2dlinestring) 傳回線性幾何圖形的 2D 長度。是 ST_Length 的別名 | |
ST_3DLength mm 3d (a_3dlinestring) 傳回線性幾何圖形的 3D 長度。 | |
ST_LengthSpheroid 3d (a_geometry, a_spheroid) 傳回橢球體上經緯度幾何圖形的 2D 或 3D 長度/周長。 | |
ST_LongestLine (g1, g2) 傳回兩個幾何圖形之間最長的 2D 線。 | |
ST_3DLongestLine 3d (g1, g2) 傳回兩個幾何圖形之間最長的 3D 線。 | |
ST_MaxDistance (g1, g2) 傳回兩個幾何圖形之間投影單位中最大的 2D 距離。 | |
ST_3DMaxDistance 3d (g1, g2) 傳回兩個幾何圖形之間投影單位中的 3D 笛卡爾最大距離(基於空間參考)。 | |
ST_MinimumClearance (g) 傳回幾何圖形的最小間隙,這是衡量幾何圖形穩健性的指標。 | |
ST_MinimumClearanceLine (g) 傳回跨越幾何圖形最小間隙的兩點 LineString。 | |
ST_Perimeter mm G 傳回多邊形幾何圖形或地理邊界的長度。
| |
ST_Perimeter2D (geomA) 傳回多邊形幾何圖形的 2D 周長。是 ST_Perimeter 的別名。 | |
ST_3DPerimeter mm 3d (geomA) 傳回多邊形幾何圖形的 3D 周長。 | |
ST_ShortestLine G 傳回兩個幾何圖形之間最短的 2D 線。
| |
ST_3DShortestLine 3d (g1, g2) 傳回兩個幾何圖形之間最短的 3D 線。 |
疊加函式 | |
---|---|
ST_ClipByBox2D (geom, box) 計算落在矩形內的幾何圖形部分。 | |
ST_Difference mm g3.9 3d (geomA, geomB, gridSize = -1) 計算一個幾何圖形,表示幾何圖形 A 中不與幾何圖形 B 相交的部分。 | |
ST_Intersection mm G g3.9 3d 計算一個幾何圖形,表示幾何圖形 A 和 B 的共享部分。
| |
ST_MemUnion 3d (geomfield) 聚合函式,以記憶體效率高但速度較慢的方式聯集幾何圖形 | |
ST_Node 3d (geom) 將線的集合節點化。 | |
ST_Split (input, blade) 傳回透過另一個幾何圖形分割幾何圖形而建立的幾何圖形集合。 | |
ST_Subdivide g3.9 (geom, max_vertices=256, gridSize = -1) 計算幾何圖形的直線細分。 | |
ST_SymDifference mm g3.9 3d (geomA, geomB, gridSize = -1) 計算一個幾何圖形,表示幾何圖形 A 和 B 中不相交的部分。 | |
ST_UnaryUnion g3.9 3d (geom, gridSize = -1) 計算單個幾何圖形元件的聯集。 | |
ST_Union mm g3.9 3d 計算一個幾何圖形,表示輸入幾何圖形的點集聯集。
|
幾何處理 | |
---|---|
ST_Buffer mm G 計算覆蓋幾何圖形給定距離內所有點的幾何圖形。
| |
ST_BuildArea (geom) 建立由幾何圖形的線條形成的的多邊形幾何圖形。 | |
ST_Centroid mm G 傳回幾何圖形的幾何中心。
| |
ST_ChaikinSmoothing 3d (geom, nIterations = 1, preserveEndPoints = false) 使用 Chaikin 演算法傳回幾何圖形的平滑版本 | |
ST_ConcaveHull (param_geom, param_pctconvex, param_allow_holes = false) 計算一個可能包含所有輸入幾何圖形頂點的凹幾何圖形 | |
ST_ConvexHull mm 3d (geomA) 計算幾何圖形的凸包。 | |
ST_DelaunayTriangles 3d (g1, tolerance = 0.0, flags = 0) 傳回幾何圖形頂點的德洛內三角網格。 | |
ST_FilterByM (geom, min, max = null, returnM = false) 根據頂點的 M 值移除頂點。 | |
ST_GeneratePoints (g, npoints, seed = 0) 產生包含在多邊形或多重多邊形內的隨機點多點集合。 | |
ST_GeometricMedian 3d (geom, tolerance = NULL, max_iter = 10000, fail_if_not_converged = false) 傳回多點的幾何中位數。 | |
ST_LineMerge g3.11 傳回由縫合多重線段形成的路徑。
| |
ST_MaximumInscribedCircle g3.9 (geom) 計算幾何圖形內包含的最大圓。 | |
ST_LargestEmptyCircle g3.9 (geom, tolerance=0.0, boundary=POINT EMPTY) 計算不與幾何圖形重疊的最大圓。 | |
ST_MinimumBoundingCircle (geomA, num_segs_per_qt_circ=48) 傳回包含幾何圖形的最小圓多邊形。 | |
ST_MinimumBoundingRadius (geom) 傳回包含幾何圖形的最小圓的中心點和半徑。 | |
ST_OrientedEnvelope (geom) 傳回包含幾何圖形的最小面積矩形。 | |
ST_OffsetCurve (line, signed_distance, style_parameters='') 傳回與輸入線段有指定距離和側面的偏移線段。 | |
ST_PointOnSurface mm 3d (g1) 計算保證位於多邊形內或幾何圖形上的點。 | |
ST_Polygonize 計算由一組幾何圖形的線條形成的複數多邊形。
| |
ST_ReducePrecision g3.9 (g, gridsize) 傳回點被四捨五入到網格容差的有效幾何圖形。 | |
ST_SharedPaths (lineal1, lineal2) 傳回一個集合,其中包含兩個輸入線段/多重線段共用的路徑。 | |
ST_Simplify 使用 Douglas-Peucker 演算法,傳回幾何圖形的簡化表示。
| |
ST_SimplifyPreserveTopology (geom, tolerance) 使用 Douglas-Peucker 演算法,傳回幾何圖形的簡化且有效的表示。 | |
ST_SimplifyPolygonHull g3.11 (param_geom, vertex_fraction, is_outer = true) 計算多邊形幾何圖形的簡化拓撲保持外殼或內殼。 | |
ST_SimplifyVW (geom, tolerance) 使用 Visvalingam-Whyatt 演算法,傳回幾何圖形的簡化表示。 | |
ST_SetEffectiveArea (geom, threshold = 0, set_area = 1) 使用 Visvalingam-Whyatt 演算法,設定每個頂點的有效面積。 | |
ST_TriangulatePolygon g3.11 (geom) 計算多邊形的約束德洛內三角網格。 | |
ST_VoronoiLines (geom, tolerance = 0.0, extend_to = NULL) 傳回幾何圖形頂點的沃羅諾伊圖邊界。 | |
ST_VoronoiPolygons (geom, tolerance = 0.0, extend_to = NULL) 傳回幾何圖形頂點的沃羅諾伊圖單元。 |
覆蓋範圍 | |
---|---|
ST_CoverageInvalidEdges g3.12 (geom, tolerance = 0) 視窗函數,用於尋找多邊形無法形成有效覆蓋範圍的位置。 | |
ST_CoverageSimplify g3.12 (geom, tolerance, simplifyBoundary = true) 視窗函數,用於簡化多邊形覆蓋範圍的邊緣。 | |
ST_CoverageUnion (geom) 透過移除共用邊緣,計算形成覆蓋範圍的一組多邊形的聯集。 |
仿射轉換 | |
---|---|
ST_Affine 3d 將 3D 仿射轉換套用至幾何圖形。
| |
ST_Rotate 3d 將幾何圖形繞著原點旋轉。
| |
ST_RotateX 3d (geomA, rotRadians) 將幾何圖形繞 X 軸旋轉。 | |
ST_RotateY 3d (geomA, rotRadians) 將幾何圖形繞 Y 軸旋轉。 | |
ST_RotateZ 3d (geomA, rotRadians) 將幾何圖形繞 Z 軸旋轉。 | |
ST_Scale 3d 依給定的因子縮放幾何圖形。
| |
ST_Translate 3d 依給定的偏移量轉換幾何圖形。
| |
ST_TransScale 3d (geomA, deltaX, deltaY, XFactor, YFactor) 依給定的偏移量和因子轉換並縮放幾何圖形。 |
群集函數 | |
---|---|
ST_ClusterDBSCAN (geom, eps, minpoints) 視窗函數,使用 DBSCAN 演算法傳回每個輸入幾何圖形的群集 ID。 | |
ST_ClusterIntersecting (g) 彙總函數,將輸入幾何圖形群集到連接的集合中。 | |
ST_ClusterIntersectingWin (geom) 視窗函數,傳回每個輸入幾何圖形的群集 ID,將輸入幾何圖形群集到連接的集合中。 | |
ST_ClusterKMeans (geom, number_of_clusters, max_radius) 視窗函數,使用 K-means 演算法傳回每個輸入幾何圖形的群集 ID。 | |
ST_ClusterWithin (g, distance) 彙總函數,依分隔距離群集幾何圖形。 | |
ST_ClusterWithinWin (geom, distance) 視窗函數,傳回每個輸入幾何圖形的群集 ID,使用分隔距離進行群集。 |
邊界框函數 | |
---|---|
Box2D (geom) 傳回代表幾何圖形 2D 範圍的 BOX2D。 | |
Box3D 3d (geom) 傳回代表幾何圖形 3D 範圍的 BOX3D。 | |
ST_EstimatedExtent 傳回空間表格的估計範圍。
| |
ST_Expand 傳回從另一個邊界框或幾何圖形擴展的邊界框。
| |
ST_Extent (geomfield) 彙總函數,傳回幾何圖形的邊界框。 | |
ST_3DExtent 3d (geomfield) 彙總函數,傳回幾何圖形的 3D 邊界框。 | |
ST_MakeBox2D (pointLowLeft, pointUpRight) 建立由兩個 2D 點幾何圖形定義的 BOX2D。 | |
ST_3DMakeBox (point3DLowLeftBottom, point3DUpRightTop) 建立由兩個 3D 點幾何圖形定義的 BOX3D。 | |
ST_XMax 3d (aGeomorBox2DorBox3D) 傳回 2D 或 3D 邊界框或幾何圖形的 X 最大值。 | |
ST_XMin 3d (aGeomorBox2DorBox3D) 傳回 2D 或 3D 邊界框或幾何圖形的 X 最小值。 | |
ST_YMax 3d (aGeomorBox2DorBox3D) 傳回 2D 或 3D 邊界框或幾何圖形的 Y 最大值。 | |
ST_YMin 3d (aGeomorBox2DorBox3D) 傳回 2D 或 3D 邊界框或幾何圖形的 Y 最小值。 | |
ST_ZMax 3d (aGeomorBox2DorBox3D) 傳回 2D 或 3D 邊界框或幾何圖形的 Z 最大值。 | |
ST_ZMin 3d (aGeomorBox2DorBox3D) 傳回 2D 或 3D 邊界框或幾何圖形的 Z 最小值。 |
線性參考 | |
---|---|
ST_LineInterpolatePoint G 3d 傳回沿著線段在指定分數位置插值的點。
| |
ST_3DLineInterpolatePoint 3d (a_linestring, a_fraction) 傳回沿著 3D 線段在指定分數位置插值的點。 | |
ST_LineInterpolatePoints G 3d 傳回沿著線段以指定分數間隔內插的點。
| |
ST_LineLocatePoint G 傳回線上最接近某個點的位置分數。
| |
ST_LineSubstring G 3d 傳回位於兩個分數位置之間的線段部分。
| |
ST_LocateAlong mm (geom_with_measure, measure, offset = 0) 傳回幾何圖形上符合指定測量值的點。 | |
ST_LocateBetween mm (geom, measure_start, measure_end, offset = 0) 傳回幾何圖形上符合指定測量範圍的部分。 | |
ST_LocateBetweenElevations 3d (geom, elevation_start, elevation_end) 傳回幾何圖形上位於指定高程 (Z) 範圍內的部分。 | |
ST_InterpolatePoint 3d (linear_geom_with_measure, point) 傳回最接近某個點的幾何圖形的內插測量值。 | |
ST_AddMeasure 3d (geom_mline, measure_start, measure_end) 沿著線性幾何圖形內插測量值。 |
軌跡函數 | |
---|---|
ST_IsValidTrajectory 3d (line) 測試幾何圖形是否為有效的軌跡。 | |
ST_ClosestPointOfApproach 3d (track1, track2) 傳回兩個軌跡最接近點的測量值。 | |
ST_DistanceCPA 3d (track1, track2) 傳回兩個軌跡最接近點之間的距離。 | |
ST_CPAWithin 3d (track1, track2, dist) 測試兩個軌跡的最接近點是否在指定的距離內。 |
版本函數 | |
---|---|
PostGIS_Extensions_Upgrade (target_version=null) 將 PostGIS 擴充功能 (例如 postgis_raster、postgis_topology、postgis_sfcgal) 封裝並升級至指定或最新版本。 | |
PostGIS_Full_Version () 報告完整的 PostGIS 版本和建置組態資訊。 | |
PostGIS_GEOS_Version () 傳回 GEOS 函式庫的版本號碼。 | |
PostGIS_GEOS_Compiled_Version () 傳回 PostGIS 建置時所使用的 GEOS 函式庫版本號碼。 | |
PostGIS_Liblwgeom_Version () 傳回 liblwgeom 函式庫的版本號碼。此版本應與 PostGIS 的版本相符。 | |
PostGIS_LibXML_Version () 傳回 libxml2 函式庫的版本號碼。 | |
PostGIS_LibJSON_Version () 傳回 libjson-c 函式庫的版本號碼。 | |
PostGIS_Lib_Build_Date () 傳回 PostGIS 函式庫的建置日期。 | |
PostGIS_Lib_Version () 傳回 PostGIS 函式庫的版本號碼。 | |
PostGIS_PROJ_Version () 傳回 PROJ4 函式庫的版本號碼。 | |
PostGIS_PROJ_Compiled_Version () 傳回 PostGIS 建置時所使用的 PROJ 函式庫版本號碼。 | |
PostGIS_Wagyu_Version () 傳回內部 Wagyu 函式庫的版本號碼。 | |
PostGIS_Scripts_Build_Date () 傳回 PostGIS 指令碼的建置日期。 | |
PostGIS_Scripts_Installed () 傳回此資料庫中安裝的 PostGIS 指令碼版本。 | |
PostGIS_Scripts_Released () 傳回與已安裝的 PostGIS lib 一起發行的 postgis.sql 指令碼版本號碼。 | |
PostGIS_Version () 傳回 PostGIS 版本號碼和編譯時選項。 |
Grand Unified Custom Variables (GUCs) | |
---|---|
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 用於啟用對 out-db 柵格頻帶存取的布林組態選項。 | |
postgis.gdal_vsi_options 用於設定使用 out-db 柵格時所用選項的字串組態。 |
疑難排解函數 | |
---|---|
PostGIS_AddBBox (geomA) 將邊界框新增至幾何圖形。 | |
PostGIS_DropBBox (geomA) 從幾何圖形中移除邊界框快取。 | |
PostGIS_HasBBox (geomA) 如果已快取此幾何圖形的邊界框,則傳回 TRUE,否則傳回 FALSE。 |