PostGis常用函數中文介紹


記錄常用PostGis常用函數:

1.OGC標准函數

管理函數: 
添加幾何字段 AddGeometryColumn(, , , , , ) 
刪除幾何字段 DropGeometryColumn(, , ) 
檢查數據庫幾何字段並在geometry_columns中歸檔 Probe_Geometry_Columns() 
給幾何對象設置空間參考(在通過一個范圍做空間查詢時常用) ST_SetSRID(geometry, integer)

幾何對象關系函數 : 
獲取兩個幾何對象間的距離 ST_Distance(geometry, geometry) 
如果兩個幾何對象間距離在給定值范圍內,則返回TRUE ST_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, geometry B) 
返回兩個幾何對象的合並結果 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,[])

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()

 

參考:http://www.jsjtt.com/shujuku/postgresql/31.html


免責聲明!

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



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