PostGIS Geometry/Geography/Box 数据类型
box2d
表示二维边界框的类型。
box3d
表示二维边界框的类型。
geometry
表示具有平面坐标系的空间要素的类型。
geometry_dump
用于描述复杂几何形状部分的复合类型。
geography
使用大地(椭球)坐标系表示空间特征的类型。
表管理功能
AddGeometryColumn
将geometry(几何)列添加到现有表。
-
table_name, column_name, srid, type, dimension, use_typmod=true
-
schema_name, table_name, column_name, srid, type, dimension, use_typmod=true
-
catalog_name, schema_name, table_name, column_name, srid, type, dimension, use_typmod=true
DropGeometryColumn
从空间表中移除geometry(几何)列。
-
table_name, column_name
-
schema_name, table_name, column_name
-
catalog_name, schema_name, table_name, column_name
DropGeometryTable
删除表及其在geometry_columns中的所有引用。
-
table_name
-
schema_name, table_name
-
catalog_name, schema_name, table_name
Find_SRID
(a_schema_name, a_table_name, a_geomfield_name)
返回geometry(几何)列中定义的 SRID。
Populate_Geometry_Columns
确保几何列由类型修饰符定义或具有适当的空间约束。
-
use_typmod=true
-
relation_oid, use_typmod=true
UpdateGeometrySRID
更新几何列中所有要素的 SRID 以及表元数据。
-
table_name, column_name, srid
-
schema_name, table_name, column_name, srid
-
catalog_name, schema_name, table_name, column_name, srid
以 GeoJSON 元素的形式返回几何图形。
-
feature, geomcolumnname, maxdecimaldigits=9, pretty_bool=false
-
geom, maxdecimaldigits=9, options=8
-
geog, maxdecimaldigits=9, options=0
ST_AsGML
将几何图形作为 GML 版本 2 或 3 元素返回。
-
geom, maxdecimaldigits=15, options=0
-
geog, maxdecimaldigits=15, options=0, nprefix=null, id=null
-
version, geom, maxdecimaldigits=15, options=0, nprefix=null, id=null
-
version, geog, maxdecimaldigits=15, options=0, nprefix=null, id=null
ST_AsKML
将几何图形作为 KML 元素返回。
-
geom, maxdecimaldigits=15, nprefix=NULL
-
geog, maxdecimaldigits=15, nprefix=NULL
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 表示形式的聚合函数。
-
row
agg
-
row, name
-
row, name, extent
-
row, name, extent, geom_name
-
row, name, extent, geom_name, feature_id_name
ST_AsSVG
返回几何体的 SVG 路径数据。
-
geom, rel=0, maxdecimaldigits=15
-
geog, rel=0, maxdecimaldigits=15
ST_AsTWKB
返回几何形式为 TWKB,又名“微小的已知的二进制”
-
geom, prec=0, prec_z=0, prec_m=0, with_sizes=false, with_boxes=false
-
geom, ids, prec=0, prec_z=0, prec_m=0, with_sizes=false, with_boxes=false
ST_AsX3D
(g1, maxdecimaldigits=15, options=0)
返回 X3D xml 节点元素格式的几何图形:ISO-IEC-19776-1.2-X3DEncodings-XML
ST_GeoHash
(geom, maxchars=full_precision_of_point)
返回几何图形的 GeoHash 表示形式。
如果 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。
(A, B)
如果 A 的 n 维边界框与 B 的 n 维边界框相交,则返回 TRUE。
&&&(geometry,gidx)
(A, B)
如果几何体的(缓存的)n 维边界框与 n 维浮点精度边界框 (GIDX) 相交,则返回 TRUE。
&&&(gidx,geometry)
(A, B)
如果 n 维浮点精度边界框 (GIDX) 与几何体的(缓存的)n 维边界框相交,则返回 TRUE。
&&&(gidx,gidx)
(A, B)
如果两个 n 维浮点精度边界框 (GIDX) 彼此相交,则返回 TRUE。
(A, B)
如果 A 的边界框与 B 的边界框重叠或位于其左侧,则返回 TRUE。
(A, B)
如果 A 的边界框与 B 的边界框重叠或低于 B 的边界框,则返回 TRUE。
(A, B)
如果 A的边界框与 B 的边界框重叠或位于 B 右侧,则返回 TRUE。
(A, B)
如果 A 的边界框严格位于 B 的左侧,则返回 TRUE。
(A, B)
如果 A 的边界框严格低于 B 的边界框,则返回 TRUE。
如果几何/地理 A 的坐标和坐标顺序与几何/地理 B 的坐标和坐标顺序相同,则返回 TRUE。
计算覆盖距几何体给定距离内所有点的几何体。
-
g1, radius_of_buffer, buffer_style_parameters = ''
-
g1, radius_of_buffer, num_seg_quarter_circle
-
g1, radius_of_buffer, buffer_style_parameters
-
g1, radius_of_buffer, num_seg_quarter_circle
ST_BuildArea
(geom)
创建由几何体的线条形成的多边形几何体。
ST_Centroid
返回几何体的几何中心。
-
g1, use_spheroid = true
ST_ChaikinSmoothing
(geom, nIterations = 1, preserveEndPoints = false)
使用 Chaikin 算法返回几何图形的平滑版本
ST_ConcaveHull
(param_geom, param_pctconvex, param_allow_holes = false)
计算包含所有输入几何顶点的可能凹几何
ST_ConvexHull
(geomA)
计算几何体的凸包。
ST_DelaunayTriangles
(g1, tolerance = 0.0, flags = 0)
返回几何体顶点的 Delaunay 三角剖分。
ST_FilterByM
(geom, min, max = null, returnM = false)
根据 M 值删除顶点
ST_GeneratePoints
生成一个包含在多边形(Polygon)或多重多边形(MultiPolygon)内的随机点的多点对象。
-
g, npoints
-
g, npoints, seed = 0
ST_GeometricMedian
(geom, tolerance = NULL, max_iter = 10000, fail_if_not_converged = false)
返回多点的几何中位数。
ST_LineMerge
g3.11
返回通过将 MultiLineString 缝合在一起形成的线。
-
amultilinestring
-
amultilinestring, directed
ST_MaximumInscribedCircle
(geom)
计算几何体中包含的最大圆。
ST_LargestEmptyCircle
(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
计算保证位于多边形或几何体上的点。
ST_Polygonize
计算由一组几何图形的线条形成的多边形集合。
-
geomfield
agg
-
geom_array
ST_ReducePrecision
(g, gridsize)
返回有效的几何图形,其点舍入到网格公差。
ST_SharedPaths
(lineal1, lineal2)
返回一个集合,其中包含两个输入线串/多线串共享的路径。
ST_Simplify
使用 Douglas-Peucker 算法返回几何的简化版本。
-
geomA, tolerance
-
geomA, tolerance, preserveCollapsed
ST_SimplifyPreserveTopology
(geomA, tolerance)
使用 Douglas-Peucker 算法返回几何的简化且有效的版本。
ST_SimplifyPolygonHull
g3.11
(param_geom, vertex_fraction, is_outer = true)
计算多边形几何的简化的保留拓扑的外部或内部外壳。
ST_SimplifyVW
(geomA, tolerance)
使用 Visvalingam-Whyatt 算法返回几何的简化版本
ST_SetEffectiveArea
(geomA, threshold = 0, set_area = 1)
使用 Visvalingam-Whyatt 算法设置每个顶点的有效区域。
ST_TriangulatePolygon
g3.11
(geom)
计算多边形的约束 Delaunay 三角剖分
ST_VoronoiLines
(geom, tolerance = 0.0, extend_to = NULL)
返回几何体顶点的 Voronoi 图的边界。
ST_VoronoiPolygons
(geom, tolerance = 0.0, extend_to = NULL)
返回几何体顶点的 Voronoi 图的单元格。
ST_CoverageInvalidEdges
g3.12
(geom, tolerance = 0)
用于查找多边形无法形成有效覆盖范围的位置的窗口函数。
ST_CoverageSimplify
g3.12
(geom, tolerance, simplifyBoundary = true)
简化多边形覆盖范围边缘的窗口函数。
ST_CoverageUnion
(geom)
通过删除共享边来计算形成覆盖范围的一组多边形的并集。
ST_Affine
对几何体应用 3D 仿射变换。
-
geomA, a, b, c, d, e, f, g, h, i, xoff, yoff, zoff
-
geomA, a, b, d, e, xoff, yoff
ST_Rotate
绕原点旋转几何体。
-
geomA, rotRadians
-
geomA, rotRadians, x0, y0
-
geomA, rotRadians, pointOrigin
ST_RotateX
(geomA, rotRadians)
绕 X 轴旋转几何体。
ST_RotateY
(geomA, rotRadians)
绕 Y 轴旋转几何体。
ST_RotateZ
(geomA, rotRadians)
绕 Z 轴旋转几何体。
ST_Scale
按给定因子缩放几何图形。
-
geomA, XFactor, YFactor, ZFactor
-
geomA, XFactor, YFactor
-
geom, factor
-
geom, factor, origin
ST_Translate
按给定的偏移量平移几何图形。
-
g1, deltax, deltay
-
g1, deltax, deltay, deltaz
ST_TransScale
(geomA, deltaX, deltaY, XFactor, YFactor)
按给定的偏移量和系数平移和缩放几何图形。
ST_ClusterDBSCAN
(geom, eps, minpoints)
使用 DBSCAN 算法返回每个输入几何图形的簇 id 的窗口函数。
ST_ClusterIntersecting
将输入几何图形聚类成连接集的聚合函数。
ST_ClusterIntersectingWin
(geom)
窗口函数,返回每个输入几何图形的簇 ID,将输入几何图形聚类到连接的集合中。
ST_ClusterKMeans
(geom, number_of_clusters, max_radius)
使用 K 均值算法返回每个输入几何图形的簇 id 的窗口函数。
ST_ClusterWithin
(g, distance)
按间隔距离对几何图形进行聚合的聚合函数。
ST_ClusterWithinWin
(geom, distance)
窗口函数,返回每个输入几何图形的簇 ID,使用分离距离进行聚类。
边界框函数
Box2D
(geom)
返回表示几何图形的 2D 范围的 BOX2D。
Box3D
(geom)
返回表示几何体 3D 范围的 BOX3D。
ST_EstimatedExtent
返回空间表的估计范围。
-
schema_name, table_name, geocolumn_name, parent_only
-
schema_name, table_name, geocolumn_name
-
table_name, geocolumn_name
ST_Expand
返回从另一个边界框或几何图形扩展的边界框。
-
geom, units_to_expand
-
geom, dx, dy, dz=0, dm=0
-
box, units_to_expand
-
box, dx, dy
-
box, units_to_expand
-
box, dx, dy, dz=0
ST_Extent
(geomfield)
返回几何图形边界框的聚合函数。
ST_3DExtent
(geomfield)
返回几何图形的 3D 边界框的聚合函数。
ST_MakeBox2D
(pointLowLeft, pointUpRight)
创建由两个 2D 点几何图形定义的 BOX2D。
ST_3DMakeBox
(point3DLowLeftBottom, point3DUpRightTop)
创建由两个 3D 点几何图形定义的 BOX3D。
ST_XMax
(aGeomorBox2DorBox3D)
返回 2D 或 3D 边界框或几何体的 X 最大值。
ST_XMin
(aGeomorBox2DorBox3D)
返回 2D 或 3D 边界框或几何体的 X 最小值。
ST_YMax
(aGeomorBox2DorBox3D)
返回 2D 或 3D 边界框或几何体的 Y 最大值。
ST_YMin
(aGeomorBox2DorBox3D)
返回 2D 或 3D 边界框或几何体的 Y 最小值。
ST_ZMax
(aGeomorBox2DorBox3D)
返回 2D 或 3D 边界框或几何体的 Z 最大值。
ST_ZMin
(aGeomorBox2DorBox3D)
返回 2D 或 3D 边界框或几何体的 Z 最小值。
ST_LineInterpolatePoint
返回沿线在百分比指示位置的插值点。
-
a_linestring, a_fraction
-
a_linestring, a_fraction, use_spheroid = true
ST_3DLineInterpolatePoint
(a_linestring, a_fraction)
返回沿 3D 线的小数指示位置插值的点。
ST_LineInterpolatePoints
返回沿直线以分数间隔插值的点。
-
a_linestring, a_fraction, repeat
-
a_linestring, a_fraction, use_spheroid = true, repeat = true
ST_LineLocatePoint
返回线上最接近点的分数位置。
-
a_linestring, a_point
-
a_linestring, a_point, use_spheroid = true
ST_LineSubstring
返回两个小数位置之间的直线部分。
-
a_linestring, startfraction, endfraction
-
a_linestring, startfraction, endfraction
ST_LocateAlong
(geom_with_measure, measure, offset = 0)
返回几何上与测量值匹配的点。
ST_LocateBetween
(geom, measure_start, measure_end, offset = 0)
返回与测量范围匹配的几何图形部分。
ST_LocateBetweenElevations
(geom, elevation_start, elevation_end)
返回位于高程 (Z) 范围内的几何图形部分。
ST_InterpolatePoint
(linear_geom_with_measure, point)
返回最接近点的几何图形的插值测量值。
ST_AddMeasure
(geom_mline, measure_start, measure_end)
沿线性几何形状插值测量值。
ST_IsValidTrajectory
(line)
测试几何图形是否为有效轨迹。
ST_ClosestPointOfApproach
(track1, track2)
返回两条轨迹最接近点处的测量值。
ST_DistanceCPA
(track1, track2)
返回两条轨迹的最近接近点之间的距离。
ST_CPAWithin
(track1, track2, dist)
测试两条轨迹的最近接近点是否在指定距离内。
长事务支持
AddAuth
(auth_token)
添加要在当前事务中使用的授权令牌。
CheckAuth
在表上创建触发器,以根据授权令牌阻止/允许更新和删除行。
-
a_schema_name, a_table_name, a_key_column_name
-
a_table_name, a_key_column_name
DisableLongTransactions
禁用长事务支持。
EnableLongTransactions
启用长事务支持。
LockRow
为表中的行设置锁定/授权。
-
a_schema_name, a_table_name, a_row_key, an_auth_token, expire_dt
-
a_table_name, a_row_key, an_auth_token, expire_dt
-
a_table_name, a_row_key, an_auth_token
UnlockRows
(auth_token)
删除授权令牌持有的所有锁。
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_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 版本号和编译时选项。
大一统自定义变量 (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
一个布尔配置选项,用于启用对数据库外栅格波段的访问。
postgis.gdal_config_options
用于设置处理外部数据库栅格时使用的选项的字符串配置。
故障排除函数
PostGIS_AddBBox
(geomA)
向几何体添加边界框。
PostGIS_DropBBox
(geomA)
从几何体中删除边界框缓存。
PostGIS_HasBBox
(geomA)