PostGIS中的常用函式

以下內容包括比較多的尖括號，釋出到blogger的時候會顯示不正常，內容太多我也無暇一個個手動改程式碼，因此如有問題就去參考PostGIS官方文件。

首先需要說明一下，這裡許多函式是以ST_[X]yyy形式命名的，事實上很多函式也可以通過xyyy的形式訪問，在PostGIS的函式庫中我們可以看到這兩種函式定義完全一樣。

1. OGC標準函式

管理函式： 新增幾何欄位 AddGeometryColumn(, , , , , ) 刪除幾何欄位 DropGeometryColumn(, , ) 檢查資料庫幾何欄位並在geometry_columns中歸檔 Probe_Geometry_Columns() 給幾何物件設定空間參考（在通過一個範圍做空間查詢時常用）ST_SetSRID(geometry, integer)

幾何物件關係函式： 獲取兩個幾何物件間的距離 ST_Distance(geometry, geometry) 如果兩個幾何物件間距離在給定值範圍內，則返回TRUEST_DWithin(geometry, geometry, float) 判斷兩個幾何物件是否相等 （比如LINESTRING(0 0, 2 2)和LINESTRING(0 0, 1 1, 2 2)是相同的幾何物件）ST_Equals(geometry, geometry) 判斷兩個幾何物件是否分離 ST_Disjoint(geometry, geometry) 判斷兩個幾何物件是否相交 ST_Intersects(geometry, geometry) 判斷兩個幾何物件的邊緣是否接觸 ST_Touches(geometry, geometry) 判斷兩個幾何物件是否互相穿過 ST_Crosses(geometry, geometry) 判斷A是否被B包含 ST_Within(geometry A, geometry B) 判斷兩個幾何物件是否是重疊 ST_Overlaps(geometry, geometry) 判斷A是否包含B ST_Contains(geometry A, geometry B) 判斷A是否覆蓋 B ST_Covers(geometry A, geometry B) 判斷A是否被B所覆蓋 ST_CoveredBy(geometry A, geometry B) 通過DE-9IM 矩陣判斷兩個幾何物件的關係是否成立 ST_Relate(geometry, geometry, intersectionPatternMatrix) 獲得兩個幾何物件的關係（DE-9IM矩陣） ST_Relate(geometry, geometry)

幾何物件處理函式： 獲取幾何物件的中心 ST_Centroid(geometry) 面積量測 ST_Area(geometry) 長度量測 ST_Length(geometry) 返回曲面上的一個點 ST_PointOnSurface(geometry) 獲取邊界 ST_Boundary(geometry) 獲取緩衝後的幾何物件 ST_Buffer(geometry, double,[integer]) 獲取多幾何物件的外接物件 ST_ConvexHull(geometry) 獲取兩個幾何物件相交的部分 ST_Intersection(geometry, geometry) 將經度小於0的值加360使所有經度值在0-360間 ST_Shift_Longitude(geometry) 獲取兩個幾何物件不相交的部分（A、B可互換） ST_SymDifference(geometry A,geometry B) 從A去除和B相交的部分後返回 ST_Difference(geometry A, geometryB) 返回兩個幾何物件的合併結果 ST_Union(geometry, geometry) 返回一系列幾何物件的合併結果 ST_Union(geometry set) 用較少的記憶體和較長的時間完成合並操作，結果和ST_Union相同 ST_MemUnion(geometry set)  

幾何物件存取函式： 獲取幾何物件的WKT描述 ST_AsText(geometry) 獲取幾何物件的WKB描述 ST_AsBinary(geometry) 獲取幾何物件的空間參考ID ST_SRID(geometry) 獲取幾何物件的維數 ST_Dimension(geometry) 獲取幾何物件的邊界範圍 ST_Envelope(geometry) 判斷幾何物件是否為空 ST_IsEmpty(geometry) 判斷幾何物件是否不包含特殊點（比如自相交）ST_IsSimple(geometry) 判斷幾何物件是否閉合 ST_IsClosed(geometry) 判斷曲線是否閉合並且不包含特殊點 ST_IsRing(geometry) 獲取多幾何物件中的物件個數 ST_NumGeometries(geometry) 獲取多幾何物件中第N個物件 ST_GeometryN(geometry,int) 獲取幾何物件中的點個數 ST_NumPoints(geometry) 獲取幾何物件的第N個點 ST_PointN(geometry,integer) 獲取多邊形的外邊緣 ST_ExteriorRing(geometry) 獲取多邊形內邊界個數 ST_NumInteriorRings(geometry) 同上 ST_NumInteriorRing(geometry) 獲取多邊形的第N個內邊界 ST_InteriorRingN(geometry,integer) 獲取線的終點 ST_EndPoint(geometry) 獲取線的起始點 ST_StartPoint(geometry) 獲取幾何物件的型別 GeometryType(geometry) 類似上，但是不檢查M值，即POINTM物件會被判斷為point ST_GeometryType(geometry) 獲取點的X座標 ST_X(geometry) 獲取點的Y座標 ST_Y(geometry) 獲取點的Z座標 ST_Z(geometry) 獲取點的M值 ST_M(geometry)

幾何物件建構函式： 參考語義： Text：WKT WKB：WKB Geom:Geometry M:Multi Bd:BuildArea Coll:Collection ST_GeomFromText(text,[])    將wkt轉為geometry

ST_PointFromText(text,[]) ST_LineFromText(text,[]) ST_LinestringFromText(text,[]) ST_PolyFromText(text,[]) ST_PolygonFromText(text,[]) ST_MPointFromText(text,[]) ST_MLineFromText(text,[]) ST_MPolyFromText(text,[]) ST_GeomCollFromText(text,[]) ST_GeomFromWKB(bytea,[]) ST_GeometryFromWKB(bytea,[]) ST_PointFromWKB(bytea,[]) ST_LineFromWKB(bytea,[]) ST_LinestringFromWKB(bytea,[]) ST_PolyFromWKB(bytea,[]) ST_PolygonFromWKB(bytea,[]) ST_MPointFromWKB(bytea,[]) ST_MLineFromWKB(bytea,[]) ST_MPolyFromWKB(bytea,[]) ST_GeomCollFromWKB(bytea,[]) ST_BdPolyFromText(text WKT, integer SRID) ST_BdMPolyFromText(text WKT, integer SRID)

2. PostGIS擴充套件函式 管理函式：  刪除一個空間表（包括geometry_columns中的記錄） DropGeometryTable([], )  更新空間表的空間參考 UpdateGeometrySRID([], , , )  更新空間表的統計資訊 update_geometry_stats([, ])  參考語義：  Geos：GEOS庫  Jts：JTS庫  Proj：PROJ4庫 postgis_version()  postgis_lib_version()  postgis_lib_build_date()  postgis_script_build_date()  postgis_scripts_installed()  postgis_scripts_released()  postgis_geos_version()  postgis_jts_version()  postgis_proj_version()  postgis_uses_stats()  postgis_full_version() 幾何操作符：  A範圍=B範圍 A = B  A範圍覆蓋B範圍或A範圍在B範圍左側 A &<> B  A範圍在B範圍左側 A <<>> B  A範圍覆蓋B範圍或A範圍在B範圍下方 A &<| B A範圍覆蓋B範圍或A範圍在B範圍上方 A |&> B  A範圍在B範圍下方 A <<| B A範圍在B範圍上方 A |>> B  A=B A ~= B  A範圍被B範圍包含 A @ B  A範圍包含B範圍 A ~ B  A範圍覆蓋B範圍 A && B 幾何量測函式： 量測面積 ST_Area(geometry)  根據經緯度點計算在地球曲面上的距離，單位米，地球半徑取值6370986米 ST_distance_sphere(point, point)  類似上，使用指定的地球橢球引數 ST_distance_spheroid(point, point, spheroid)  量測2D物件長度 ST_length2d(geometry)  量測3D物件長度 ST_length3d(geometry)  根據經緯度物件計算在地球曲面上的長度 ST_length_spheroid(geometry,spheroid)  ST_length3d_spheroid(geometry,spheroid)  量測兩個物件間距離 ST_distance(geometry, geometry)  量測兩條線之間的最大距離 ST_max_distance(linestring,linestring)  量測2D物件的周長 ST_perimeter(geometry)  ST_perimeter2d(geometry)  量測3D物件的周長 ST_perimeter3d(geometry)  量測兩點構成的方位角，單位弧度 ST_azimuth(geometry, geometry) 幾何物件輸出：  參考語義：  NDR：Little Endian  XDR：big-endian  HEXEWKB：Canonical  SVG：SVG 格式  GML：GML 格式  KML：KML 格式  GeoJson：GeoJson 格式  ST_AsBinary(geometry,{'NDR'|'XDR'})  ST_AsEWKT(geometry)  ST_AsEWKB(geometry, {'NDR'|'XDR'})  ST_AsHEXEWKB(geometry, {'NDR'|'XDR'})  ST_AsSVG(geometry, [rel], [precision])  ST_AsGML([version], geometry, [precision])  ST_AsKML([version], geometry, [precision])  ST_AsGeoJson([version], geometry, [precision], [options]) 幾何物件建立： 參考語義：  Dump：轉儲 ST_GeomFromEWKT(text)  ST_GeomFromEWKB(bytea)  ST_MakePoint(, , [], [])  ST_MakePointM(, , )  ST_MakeBox2D(, )  ST_MakeBox3D(, )  ST_MakeLine(geometry set)  ST_MakeLine(geometry, geometry)  ST_LineFromMultiPoint(multipoint)  ST_MakePolygon(linestring, [linestring[]])  ST_BuildArea(geometry)  ST_Polygonize(geometry set)  ST_Collect(geometry set)  ST_Collect(geometry, geometry)  ST_Dump(geometry)  ST_DumpRings(geometry) 幾何物件編輯：  給幾何物件新增一個邊界，會使查詢速度加快 ST_AddBBOX(geometry)  刪除幾何物件的邊界 ST_DropBBOX(geometry)  新增、刪除、設定點 ST_AddPoint(linestring, point, [])  ST_RemovePoint(linestring, offset)  ST_SetPoint(linestring, N, point)  幾何物件型別轉換 ST_Force_collection(geometry)  ST_Force_2d(geometry)  ST_Force_3dz(geometry), ST_Force_3d(geometry),  ST_Force_3dm(geometry)  ST_Force_4d(geometry)  ST_Multi(geometry)  將幾何物件轉化到指定空間參考 ST_Transform(geometry,integer)  對3D幾何物件作仿射變化 ST_Affine(geometry, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8, float8)  對2D幾何物件作仿射變化 ST_Affine(geometry, float8, float8, float8, float8, float8, float8)  對幾何物件作偏移 ST_Translate(geometry, float8, float8, float8)  對幾何物件作縮放 ST_Scale(geometry, float8, float8, float8)  對3D幾何物件作旋轉 ST_RotateZ(geometry, float8)  ST_RotateX(geometry, float8)  ST_RotateY(geometry, float8)  對2D物件作偏移和縮放 ST_TransScale(geometry, float8, float8, float8, float8)  反轉 ST_Reverse(geometry)  轉化到右手定則 ST_ForceRHR(geometry)  參考IsSimple函式  使用Douglas-Peuker演算法 ST_Simplify(geometry, tolerance)  ST_SimplifyPreserveTopology(geometry, tolerance)  講幾何物件頂點捕捉到網格 ST_SnapToGrid(geometry, originX, originY, sizeX, sizeY)  ST_SnapToGrid(geometry, sizeX, sizeY), ST_SnapToGrid(geometry, size)  第二個引數為點，指定原點座標 ST_SnapToGrid(geometry, geometry, sizeX, sizeY, sizeZ, sizeM)  分段 ST_Segmentize(geometry, maxlength)  合併為線 ST_LineMerge(geometry) 線性參考： 根據location（0-1）獲得該位置的點 ST_line_interpolate_point(linestring, location)  獲取一段線 ST_line_substring(linestring, start, end)  根據點獲取location（0-1） ST_line_locate_point(LineString, Point)  根據量測值獲得幾何物件 ST_locate_along_measure(geometry, float8)  根據量測值區間獲得幾何物件集合 ST_locate_between_measures(geometry, float8, float8) 雜項功能函式：  幾何物件的摘要 ST_Summary(geometry)  幾何物件的邊界 ST_box2d(geometry)  ST_box3d(geometry)  多個幾何物件的邊界 ST_extent(geometry set)  0=2d, 1=3dm, 2=3dz, 3=4d ST_zmflag(geometry)  是否包含Bounding Box ST_HasBBOX(geometry)  幾何物件的維數：2、3、4 ST_ndims(geometry)  子物件的個數 ST_nrings(geometry)  ST_npoints(geometry)  物件是否驗證成功 ST_isvalid(geometry)  擴大幾何物件 ST_expand(geometry, float)  計算一個空間表的邊界範圍 ST_estimated_extent([schema], table, geocolumn)  獲得空間參考 ST_find_srid(, , )  幾何物件使用的記憶體大小，單位byte ST_mem_size(geometry)  點是否在圓上 ST_point_inside_circle(,,,)  獲取邊界的X、Y、Z ST_XMin(box3d)  ST_YMin(box3d)  ST_ZMin(box3d)  ST_XMax(box3d)  ST_YMax(box3d)  ST_ZMax(box3d)  構造一個幾何物件的陣列 ST_Accum(geometry set) 長事務支援：  啟用/關閉長事務支援，重複呼叫無副作用 EnableLongTransactions()  DisableLongTransactions()  檢查對行的update和delete操作是否已授權 CheckAuth([],   , )  鎖定行 LockRow([], , , , [])  解鎖行 UnlockRows()  在當前事務中新增授權ID AddAuth()

其他的函式還有可以到官網進行檢視