Tipi di dati PostGIS Geometria/Geografia/Box | |
---|---|
box2d The type representing a 2-dimensional bounding box. | |
box3d The type representing a 3-dimensional bounding box. | |
geometry geography è un tipo spaziale usato per rappresentare un'entità in un sistema di coordinate sferico valido per l'intero pianeta. | |
geometry_dump A composite type used to describe the parts of complex geometry. | |
geography The type representing spatial features with geodetic (ellipsoidal) coordinate systems. |
Funzioni di gestione delle tabelle | |
---|---|
AddGeometryColumn
3d
Aggiunge una colonna geometrica a una tabella esistente.
| |
DropGeometryColumn
3d
Rimuove una colonna geometry da una tabella spaziale
| |
DropGeometryTable
Rimuove una tabella e tutte le sue referenze da geometry_columns
| |
Find_SRID (a_schema_name, a_table_name, a_geomfield_name) Restituisce lo SRID di una colonna di tipo geometrico. | |
Populate_Geometry_Columns
Garantisce che le colonne di tipo geometrico siano definite con dei modificatori di tipo o abbiano dei vincoli spaziali appropriati.
| |
UpdateGeometrySRID
3d
Aggiorna lo SRID e di tutte le geometrie nella colonna specificata e i metadati di tabella.
|
Costruttori geometrici. | |
---|---|
ST_Collect
3d
Creates a GeometryCollection or Multi* geometry from a set of geometries.
| |
ST_LineFromMultiPoint 3d (aMultiPoint) Crea una LineString da una geometria MultiPoint. | |
ST_MakeEnvelope (xmin, ymin, xmax, ymax, srid=unknown) Creates a rectangular Polygon from minimum and maximum coordinates. | |
ST_MakeLine
3d
Crea una LineString da una geometria Point, MultiPoint o un set di LineString
| |
ST_MakePoint
3d
Creates a 2D, 3DZ or 4D Point.
| |
ST_MakePointM (x, y, m) Creates a Point from X, Y and M values. | |
ST_MakePolygon
3d
Creates a Polygon from a shell and optional list of holes.
| |
ST_Point
mm
Creates a Point with X, Y and SRID values.
| |
ST_PointZ (x, y, z, srid=unknown) Creates a Point with X, Y, Z and SRID values. | |
ST_PointM (x, y, m, srid=unknown) Creates a Point with X, Y, M and SRID values. | |
ST_PointZM (x, y, z, m, srid=unknown) Creates a Point with X, Y, Z, M and SRID values. | |
ST_Polygon mm 3d (lineString, srid) Creates a Polygon from a LineString with a specified SRID. | |
ST_TileEnvelope (tileZoom, tileX, tileY, bounds=SRID=3857;LINESTRING(-20037508.342789 -20037508.342789,20037508.342789 20037508.342789), margin=0.0) Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system. | |
ST_HexagonGrid (size, bounds) Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument. | |
ST_Hexagon (size, cell_i, cell_j, origin) Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space. | |
ST_SquareGrid (size, bounds) Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument. | |
ST_Square (size, cell_i, cell_j, origin) Returns a single square, using the provided edge size and cell coordinate within the square grid space. | |
ST_Letters ( letters, font) Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100. |
Accessori alla geometria | |
---|---|
GeometryType 3d (geomA) Restituisce il tipo di geometria come testo. | |
ST_Boundary mm 3d (geomA) Restituisce il confine di una geometria. | |
ST_BoundingDiagonal 3d (geom, fits=false) Restituisce la diagonale del rettangolo di confine di una geometria. | |
ST_CoordDim mm 3d (geomA) Restituisce la dimensione delle coordinate di una geometrie. | |
ST_Dimension mm (g) Restituisce la dimensione topologica di una geometria. | |
ST_Dump 3d (g1) Returns a set of geometry_dump rows for the components of a geometry. | |
ST_DumpPoints 3d (geom) Returns a set of geometry_dump rows for the coordinates in a geometry. | |
ST_DumpSegments 3d (geom) Returns a set of geometry_dump rows for the segments in a geometry. | |
ST_DumpRings 3d (a_polygon) Returns a set of geometry_dump rows for the exterior and interior rings of a Polygon. | |
ST_EndPoint mm 3d (g) Returns the last point of a LineString or CircularLineString. | |
ST_Envelope mm (g1) Returns a geometry representing the bounding box of a geometry. | |
ST_ExteriorRing mm 3d (a_polygon) Returns a LineString representing the exterior ring of a Polygon. | |
ST_GeometryN mm 3d (geomA, n) Restituisce il tipo di geometria per il valore ST_Geometry. | |
ST_GeometryType mm 3d (g1) Restituisce il tipo di geometria per il valore ST_Geometry. | |
ST_HasArc 3d (geomA) Tests if a geometry contains a circular arc | |
ST_InteriorRingN mm 3d (a_polygon, n) Returns the Nth interior ring (hole) of a Polygon. | |
ST_NumCurves mm 3d (a_compoundcurve) Return the number of component curves in a CompoundCurve. | |
ST_CurveN mm 3d (a_compoundcurve, index) Returns the Nth component curve geometry of a CompoundCurve. | |
ST_IsClosed mm 3d (g) Restituisce TRUE se il punto iniziale e quello finale di LINESTRING coincidono. Per le superfici poliedriche indica una superficie chiusa (volumetrica). | |
ST_IsCollection 3d (g) Restituisce TRUE se la geometria è una geometrycollection, un poligono o un punto vuoto, ecc. | |
ST_IsEmpty mm (geomA) Tests if a geometry is empty. | |
ST_IsPolygonCCW 3d (geom) Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise. | |
ST_IsPolygonCW 3d (geom) Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise. | |
ST_IsRing mm (g) Tests if a LineString is closed and simple. | |
ST_IsSimple mm 3d (geomA) Tests if a geometry has no points of self-intersection or self-tangency. | |
ST_M mm 3d (a_point) Returns the M coordinate of a Point. | |
ST_MemSize 3d (geomA) Restituisce il tipo di geometria per il valore ST_Geometry. | |
ST_NDims 3d (g1) Restituisce la dimensione delle coordinate di una geometria. | |
ST_NPoints 3d (g1) Returns the number of points (vertices) in a geometry. | |
ST_NRings 3d (geomA) Returns the number of rings in a polygonal geometry. | |
ST_NumGeometries mm 3d (geom) Restituisce TRUE se la geometria è una geometrycollection, un poligono o un punto vuoto, ecc. | |
ST_NumInteriorRings mm (a_polygon) Returns the number of interior rings (holes) of a Polygon. | |
ST_NumInteriorRing (a_polygon) Returns the number of interior rings (holes) of a Polygon. Aias for ST_NumInteriorRings | |
ST_NumPatches mm 3d (g1) Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries. | |
ST_NumPoints mm (g1) Returns the number of points in a LineString or CircularString. | |
ST_PatchN mm 3d (geomA, n) Restituisce il tipo di geometria per il valore ST_Geometry. | |
ST_PointN mm 3d (a_linestring, n) Returns the Nth point in the first LineString or circular LineString in a geometry. | |
ST_Points 3d (geom) Restituisce un MultiPoint contenente le coordinate di una geometria. | |
ST_StartPoint mm 3d (geomA) Returns the first point of a LineString. | |
ST_Summary
G
Returns a text summary of the contents of a geometry.
| |
ST_X mm 3d (a_point) Returns the X coordinate of a Point. | |
ST_Y mm 3d (a_point) Returns the Y coordinate of a Point. | |
ST_Z mm 3d (a_point) Returns the Z coordinate of a Point. | |
ST_Zmflag 3d (geomA) Restituisce un codice indicante le dimensioni ZM di una geometria. | |
ST_HasZ 1 3d (geom) Checks if a geometry has a Z dimension. | |
ST_HasM 1 3d (geom) Checks if a geometry has an M (measure) dimension. |
Editori di geometria | |
---|---|
ST_AddPoint
3d
Aggiunge un punto a una stringa di linee.
| |
ST_CollectionExtract
Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
| |
ST_CollectionHomogenize (collection) Returns the simplest representation of a geometry collection. | |
ST_CurveToLine mm 3d (curveGeom, tolerance, tolerance_type, flags) Converts a geometry containing curves to a linear geometry. | |
ST_Scroll 3d (linestring, point) Change start point of a closed LineString. | |
ST_FlipCoordinates 3d (geom) Returns a version of a geometry with X and Y axis flipped. | |
ST_Force2D 3d (geomA) Force the geometries into a "2-dimensional mode". | |
ST_Force3D 3d (geomA, Zvalue = 0.0) Force the geometries into XYZ mode. This is an alias for ST_Force3DZ. | |
ST_Force3DZ 3d (geomA, Zvalue = 0.0) Force the geometries into XYZ mode. | |
ST_Force3DM (geomA, Mvalue = 0.0) Force the geometries into XYM mode. | |
ST_Force4D 3d (geomA, Zvalue = 0.0, Mvalue = 0.0) Force the geometries into XYZM mode. | |
ST_ForceCollection 3d (geomA) Convert the geometry into a GEOMETRYCOLLECTION. | |
ST_ForceCurve 3d (g) Upcast a geometry into its curved type, if applicable. | |
ST_ForcePolygonCCW 3d (geom) Orients all exterior rings counter-clockwise and all interior rings clockwise. | |
ST_ForcePolygonCW 3d (geom) Orients all exterior rings clockwise and all interior rings counter-clockwise. | |
ST_ForceSFS
3d
Force the geometries to use SFS 1.1 geometry types only.
| |
ST_ForceRHR 3d (g) Force the orientation of the vertices in a polygon to follow the Right-Hand-Rule. | |
ST_LineExtend (line, distance_forward, distance_backward=0.0) Returns a line extended forwards and backwards by specified distances. | |
ST_LineToCurve 3d (geomANoncircular) Converts a linear geometry to a curved geometry. | |
ST_Multi (geom) Return the geometry as a MULTI* geometry. | |
ST_Normalize (geom) Return the geometry in its canonical form. | |
ST_Project
G
Returns a point projected from a start point by a distance and bearing (azimuth).
| |
ST_QuantizeCoordinates (g, prec_x, prec_y, prec_z, prec_m) Sets least significant bits of coordinates to zero | |
ST_RemovePoint 3d (linestring, offset) Remove a point from a linestring. | |
ST_RemoveRepeatedPoints 3d (geom, tolerance) Returns a version of a geometry with duplicate points removed. | |
ST_RemoveIrrelevantPointsForView 1 (geom, bounds, cartesian_hint = false) Removes points that are irrelevant for rendering a specific rectangluar view of a geometry. | |
ST_RemoveSmallParts 1 (geom, minSizeX, minSizeY) Removes small parts (polygon rings or linestrings) of a geometry. | |
ST_Reverse 3d (g1) Return the geometry with vertex order reversed. | |
ST_Segmentize
G
Returns a modified geometry/geography having no segment longer than a given distance.
| |
ST_SetPoint 3d (linestring, zerobasedposition, point) Replace point of a linestring with a given point. | |
ST_ShiftLongitude 3d (geom) Shifts the longitude coordinates of a geometry between -180..180 and 0..360. | |
ST_WrapX 3d (geom, wrap, move) Wrap a geometry around an X value. | |
ST_SnapToGrid
3d
Snap all points of the input geometry to a regular grid.
| |
ST_Snap (input, reference, tolerance) Snap segments and vertices of input geometry to vertices of a reference geometry. | |
ST_SwapOrdinates 3d (geom, ords) Returns a version of the given geometry with given ordinate values swapped. |
Geometry Validation | |
---|---|
ST_IsValid
mm
Tests if a geometry is well-formed in 2D.
| |
ST_IsValidDetail (geom, flags) Returns a valid_detail row stating if a geometry is valid or if not a reason and a location. | |
ST_IsValidReason
Returns text stating if a geometry is valid, or a reason for invalidity.
| |
ST_MakeValid
3d
Attempts to make an invalid geometry valid without losing vertices.
|
Spatial Reference System Functions | |
---|---|
ST_InverseTransformPipeline (geom, pipeline, to_srid) Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline. | |
ST_SetSRID (geom, srid) Set the SRID on a geometry. | |
ST_SRID mm (g1) Returns the spatial reference identifier for a geometry. | |
ST_Transform
mm
Return a new geometry with coordinates transformed to a different spatial reference system.
| |
ST_TransformPipeline (g1, pipeline, to_srid) Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline. | |
postgis_srs_codes (auth_name) Return the list of SRS codes associated with the given authority. | |
postgis_srs (auth_name, auth_srid) Return a metadata record for the requested authority and srid. | |
postgis_srs_all () Return metadata records for every spatial reference system in the underlying Proj database. | |
postgis_srs_search (bounds, auth_name=EPSG) Return metadata records for projected coordinate systems that have areas of usage that fully contain the bounds parameter. |
Ingresso geometria | |
---|---|
ST_BdPolyFromText (WKT, srid) Costruisce un poligono an partire da una collezione arbitraria di linee chiuse in forma di multilinee rappresentate come testo Well-Known | |
ST_BdMPolyFromText (WKT, srid) Costruisce un MultiPolygon a partire da una collezione arbitraria di linee chiuse sotto forma di MultiLineString in formato Well-Known-Text. | |
ST_GeogFromText G (EWKT) Ritorna un valore geography sotto forma di Well-Know-Text (WKT) oppure di Extended-Well-Know-Text (EWKT) | |
ST_GeographyFromText G (EWKT) Ritorna un valore geography sotto forma di Well-Know-Text (WKT) oppure di Extended-Well-Know-Text (EWKT) | |
ST_GeomCollFromText
mm
Crea una collezione Geometria dalla collezione WKT con il SRID indicato. Se SRID non è indicato, il valore predefinito è 0.
| |
ST_GeomFromEWKT 3d (EWKT) Ritorna un valore ST_Geometry a partire da una rappresentazione Extended Well-Known Text (EWKT). | |
ST_GeomFromMARC21 (marcxml) Prende in input i dati geografici MARC21/XML e restituisce un oggetto geometrico PostGIS. | |
ST_GeometryFromText
mm
Restituisce un valore ST_Geometry a partire da Well-Known-Text (WKT). È un alias per ST_GeomFromText
| |
ST_GeomFromText
mm
Restituisce un valore ST_Geometry a partire da una rappresentazione Well-Known-Text (WKT)
| |
ST_LineFromText
mm
Crea una geometria dalla rappresentazione WKT con il SRID indicato. Se SRID non viene indicato, il valore predefinito è 0.
| |
ST_MLineFromText
mm
Restituisce un valore ST_MultiLineString specificato dalla rappresentazione WKT.
| |
ST_MPointFromText
mm
Crea una geometria da WKT con il SRID indicato. Se SRID non viene indicato, il valore predefinito è 0.
| |
ST_MPolyFromText
mm
Crea una geometria multipoligono da WKT con il SRID indicato. Se SRID non è indicato, l'impostazione predefinita è 0.
| |
ST_PointFromText
mm
Crea una geometria di punti da WKT con il SRID indicato. Se SRID non è indicato, il valore predefinito è sconosciuto.
| |
ST_PolygonFromText
mm
Crea una geometria da WKT con il SRID indicato. Se SRID non viene indicato, il valore predefinito è 0.
| |
ST_WKTToSQL mm (WKT) Restituisce un valore ST_Geometry a partire da Well-Known-Text (WKT). È un alias per ST_GeomFromText | |
ST_GeogFromWKB G (wkb) Crea un oggetto geography a partire da una geometria in Well-Known Binary (WKB) oppure Extended Well-Known Binary (EWKB). | |
ST_GeomFromEWKB 3d (EWKB) Ritorna un valore ST_Geometry a partire da Extended Well-Known Binary (EWKB). | |
ST_GeomFromWKB
mm
Crea un'istanza di geometria da una rappresentazione geometrica Well-Known Binary (WKB) e da un SRID opzionale.
| |
ST_LineFromWKB
mm
Crea un LINESTRING da WKB con il SRID indicato
| |
ST_LinestringFromWKB
mm
Crea una geometria da WKB con il SRID indicato.
| |
ST_PointFromWKB
mm
3d
Crea una geometria da WKB con il SRID indicato
| |
ST_WKBToSQL mm (WKB) Restituisce un valore ST_Geometry specificato dalla rappresentazione Well-Known Binary (WKB). Si tratta di un nome alias per ST_GeomFromWKB che non accetta srid | |
ST_Box2dFromGeoHash (geohash, precision=full_precision_of_geohash) Restituisce un BOX2D da una stringa GeoHash. | |
ST_GeomFromGeoHash (geohash, precision=full_precision_of_geohash) Restituisce una geometria da una stringa GeoHash. | |
ST_GeomFromGML
3d
Accetta una geometria in formato GML come input e restituisce un oggetto PostGIS geometry
| |
ST_GeomFromGeoJSON
3d
Accetta come input la rappresentazione geojson di una geometria e restituisce una geometria PostGIS
| |
ST_GeomFromKML 3d (geomkml) Accetta come input una geometria in formato KML e restituisce una geometria PostGIS. | |
ST_GeomFromTWKB (twkb) Crea un'istanza di geometria da una rappresentazione geometrica TWKB ("Tiny Well Known Binary"). | |
ST_GMLToSQL
mm
Restituisce un valore ST_Geometry a partire da una rappresentazione GML. Questo è solo un alias per la funzione ST_GeomFromGML.
| |
ST_LineFromEncodedPolyline (polyline, precision=5) Crea una stringa di linee da una polilinea codificata. | |
ST_PointFromGeoHash (geohash, precision=full_precision_of_geohash) Restituisce un punto da una stringa GeoHash. | |
ST_FromFlatGeobufToTable (schemaname, tablename, FlatGeobuf input data) Crea una tabella basata sulla struttura dei dati di FlatGeobuf. | |
ST_FromFlatGeobuf (Table reference, FlatGeobuf input data) Legge i dati di FlatGeobuf. |
Geometry Output | |
---|---|
ST_AsEWKT
G
3d
Ritorna la rappresentazione Well-Known Text (WKT) della geometria con incluso lo SRID.
| |
ST_AsText
mm
G
Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
| |
ST_AsBinary
mm
G
3d
Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
| |
ST_AsEWKB
3d
Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
| |
ST_AsHEXEWKB
3d
Returns a Geometry in HEXEWKB format (as text) using either little-endian (NDR) or big-endian (XDR) encoding.
| |
ST_AsEncodedPolyline (geom, precision=5) Returns an Encoded Polyline from a LineString geometry. | |
ST_AsFlatGeobuf
Return a FlatGeobuf representation of a set of rows.
| |
ST_AsGeobuf
Return a Geobuf representation of a set of rows.
| |
ST_AsGeoJSON
G
3d
Return a geometry or feature in GeoJSON format.
| |
ST_AsGML
mm
G
3d
Return the geometry as a GML version 2 or 3 element.
| |
ST_AsKML
G
3d
Return the geometry as a KML element.
| |
ST_AsLatLonText (pt, format='') Return the Degrees, Minutes, Seconds representation of the given point. | |
ST_AsMARC21 (geom, format='hdddmmss') Returns geometry as a MARC21/XML record with a geographic datafield (034). | |
ST_AsMVTGeom (geom, bounds, extent=4096, buffer=256, clip_geom=true) Transforms a geometry into the coordinate space of a MVT tile. | |
ST_AsMVT
Aggregate function returning a MVT representation of a set of rows.
| |
ST_AsSVG
G
Returns SVG path data for a geometry.
| |
ST_AsTWKB
Returns the geometry as TWKB, aka "Tiny Well-Known Binary"
| |
ST_AsX3D 3d (g1, maxdecimaldigits=15, options=0) Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-X3DEncodings-XML | |
ST_GeoHash (geom, maxchars=full_precision_of_point) Return a GeoHash representation of the geometry. |
Operatori | |
---|---|
&&
G
Returns TRUE if A's 2D bounding box intersects B's 2D bounding box.
| |
&&(geometry,box2df) (A, B) Returns TRUE if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF). | |
&&(box2df,geometry) (A, B) Returns TRUE if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box. | |
&&(box2df,box2df) (A, B) Returns TRUE if two 2D float precision bounding boxes (BOX2DF) intersect each other. | |
&&& 3d (A, B) Returns TRUE if A's n-D bounding box intersects B's n-D bounding box. | |
&&&(geometry,gidx) 3d (A, B) Returns TRUE if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX). | |
&&&(gidx,geometry) 3d (A, B) Returns TRUE if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box. | |
&&&(gidx,gidx) 3d (A, B) Returns TRUE if two n-D float precision bounding boxes (GIDX) intersect each other. | |
&< (A, B) Returns TRUE if A's bounding box overlaps or is to the left of B's. | |
&<| (A, B) Returns TRUE if A's bounding box overlaps or is below B's. | |
&> (A, B) Returns TRUE if A' bounding box overlaps or is to the right of B's. | |
<< (A, B) Returns TRUE if A's bounding box is strictly to the left of B's. | |
<<| (A, B) Returns TRUE if A's bounding box is strictly below B's. | |
=
G
Returns TRUE if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
| |
>> (A, B) Returns TRUE if A's bounding box is strictly to the right of B's. | |
@ (A, B) Returns TRUE if A's bounding box is contained by B's. | |
@(geometry,box2df) (A, B) Returns TRUE if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF). | |
@(box2df,geometry) (A, B) Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box. | |
@(box2df,box2df) (A, B) Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box. | |
|&> (A, B) Returns TRUE if A's bounding box overlaps or is above B's. | |
|>> (A, B) Returns TRUE if A's bounding box is strictly above B's. | |
~ (A, B) Returns TRUE if A's bounding box contains B's. | |
~(geometry,box2df) (A, B) Returns TRUE if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX). | |
~(box2df,geometry) (A, B) Returns TRUE if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box. | |
~(box2df,box2df) (A, B) Returns TRUE if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF). | |
~= (A, B) Returns TRUE if A's bounding box is the same as B's. | |
<->
G
Returns the 2D distance between A and B.
| |
|=| (A, B) Returns the distance between A and B trajectories at their closest point of approach. | |
<#> (A, B) Returns the 2D distance between A and B bounding boxes. | |
<<->> (A, B) Returns the n-D distance between the A and B geometries or bounding boxes |
Relazioni Spaziali | |
---|---|
ST_3DIntersects mm 3d (geomA, geomB) Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area) | |
ST_Contains mm (geomA, geomB) Tests if every point of B lies in A, and their interiors have a point in common | |
ST_ContainsProperly (geomA, geomB) Tests if every point of B lies in the interior of A | |
ST_CoveredBy
G
Tests if every point of A lies in B
| |
ST_Covers
G
Tests if every point of B lies in A
| |
ST_Crosses mm (g1, g2) Tests if two geometries have some, but not all, interior points in common | |
ST_Disjoint mm (A, B) Tests if two geometries have no points in common | |
ST_Equals mm (A, B) Tests if two geometries include the same set of points | |
ST_Intersects
mm
G
Tests if two geometries intersect (they have at least one point in common)
| |
ST_LineCrossingDirection (linestringA, linestringB) Returns a number indicating the crossing behavior of two LineStrings | |
ST_OrderingEquals mm (A, B) Tests if two geometries represent the same geometry and have points in the same directional order | |
ST_Overlaps mm (A, B) Tests if two geometries have the same dimension and intersect, but each has at least one point not in the other | |
ST_Relate
mm
Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix
| |
ST_RelateMatch (intersectionMatrix, intersectionMatrixPattern) Tests if a DE-9IM Intersection Matrix matches an Intersection Matrix pattern | |
ST_Touches mm (A, B) Tests if two geometries have at least one point in common, but their interiors do not intersect | |
ST_Within mm (A, B) Tests if every point of A lies in B, and their interiors have a point in common | |
ST_3DDWithin mm 3d (g1, g2, distance_of_srid) Tests if two 3D geometries are within a given 3D distance | |
ST_3DDFullyWithin 3d (g1, g2, distance) Tests if two 3D geometries are entirely within a given 3D distance | |
ST_DFullyWithin (g1, g2, distance) Tests if a geometry is entirely inside a distance of another | |
ST_DWithin
G
Tests if two geometries are within a given distance
| |
ST_PointInsideCircle (a_point, center_x, center_y, radius) Tests if a point geometry is inside a circle defined by a center and radius |
Measurement Functions | |
---|---|
ST_Area
mm
G
Returns the area of a polygonal geometry.
| |
ST_Azimuth
G
Returns the north-based azimuth of a line between two points.
| |
ST_Angle
Returns the angle between two vectors defined by 3 or 4 points, or 2 lines.
| |
ST_ClosestPoint
G
Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
| |
ST_3DClosestPoint 3d (g1, g2) Returns the 3D point on g1 that is closest to g2. This is the first point of the 3D shortest line. | |
ST_Distance
mm
G
Returns the distance between two geometry or geography values.
| |
ST_3DDistance mm 3d (g1, g2) Returns the 3D cartesian minimum distance (based on spatial ref) between two geometries in projected units. | |
ST_DistanceSphere (geomlonlatA, geomlonlatB, radius=6371008) Returns minimum distance in meters between two lon/lat geometries using a spherical earth model. | |
ST_DistanceSpheroid (geomlonlatA, geomlonlatB, measurement_spheroid=WGS84) Returns the minimum distance between two lon/lat geometries using a spheroidal earth model. | |
ST_FrechetDistance (g1, g2, densifyFrac = -1) Returns the Fréchet distance between two geometries. | |
ST_HausdorffDistance
Returns the Hausdorff distance between two geometries.
| |
ST_Length
mm
G
Returns the 2D length of a linear geometry.
| |
ST_Length2D (a_2dlinestring) Returns the 2D length of a linear geometry. Alias for ST_Length | |
ST_3DLength mm 3d (a_3dlinestring) Returns the 3D length of a linear geometry. | |
ST_LengthSpheroid 3d (a_geometry, a_spheroid) Returns the 2D or 3D length/perimeter of a lon/lat geometry on a spheroid. | |
ST_LongestLine (g1, g2) Returns the 2D longest line between two geometries. | |
ST_3DLongestLine 3d (g1, g2) Returns the 3D longest line between two geometries | |
ST_MaxDistance (g1, g2) Returns the 2D largest distance between two geometries in projected units. | |
ST_3DMaxDistance 3d (g1, g2) Returns the 3D cartesian maximum distance (based on spatial ref) between two geometries in projected units. | |
ST_MinimumClearance (g) Returns the minimum clearance of a geometry, a measure of a geometry's robustness. | |
ST_MinimumClearanceLine (g) Returns the two-point LineString spanning a geometry's minimum clearance. | |
ST_Perimeter
mm
G
Returns the length of the boundary of a polygonal geometry or geography.
| |
ST_Perimeter2D (geomA) Returns the 2D perimeter of a polygonal geometry. Alias for ST_Perimeter. | |
ST_3DPerimeter mm 3d (geomA) Returns the 3D perimeter of a polygonal geometry. | |
ST_ShortestLine
G
Returns the 2D shortest line between two geometries
| |
ST_3DShortestLine 3d (g1, g2) Returns the 3D shortest line between two geometries |
Overlay Functions | |
---|---|
ST_ClipByBox2D (geom, box) Computes the portion of a geometry falling within a rectangle. | |
ST_Difference mm g3.9 3d (geomA, geomB, gridSize = -1) Computes a geometry representing the part of geometry A that does not intersect geometry B. | |
ST_Intersection
mm
G
g3.9
3d
Computes a geometry representing the shared portion of geometries A and B.
| |
ST_MemUnion 3d (geomfield) Aggregate function which unions geometries in a memory-efficent but slower way | |
ST_Node 3d (geom) Nodes a collection of lines. | |
ST_Split (input, blade) Returns a collection of geometries created by splitting a geometry by another geometry. | |
ST_Subdivide g3.9 (geom, max_vertices=256, gridSize = -1) Computes a rectilinear subdivision of a geometry. | |
ST_SymDifference mm g3.9 3d (geomA, geomB, gridSize = -1) Computes a geometry representing the portions of geometries A and B that do not intersect. | |
ST_UnaryUnion g3.9 3d (geom, gridSize = -1) Computes the union of the components of a single geometry. | |
ST_Union
mm
g3.9
3d
Computes a geometry representing the point-set union of the input geometries.
|
Geometry Processing | |
---|---|
ST_Buffer
mm
G
Computes a geometry covering all points within a given distance from a geometry.
| |
ST_BuildArea (geom) Creates a polygonal geometry formed by the linework of a geometry. | |
ST_Centroid
mm
G
Restituisce il centro geometrico di una geometria.
| |
ST_ChaikinSmoothing 3d (geom, nIterations = 1, preserveEndPoints = false) Returns a smoothed version of a geometry, using the Chaikin algorithm | |
ST_ConcaveHull (param_geom, param_pctconvex, param_allow_holes = false) Computes a possibly concave geometry that contains all input geometry vertices | |
ST_ConvexHull mm 3d (geomA) Computes the convex hull of a geometry. | |
ST_DelaunayTriangles 3d (g1, tolerance = 0.0, flags = 0) Returns the Delaunay triangulation of the vertices of a geometry. | |
ST_FilterByM (geom, min, max = null, returnM = false) Removes vertices based on their M value | |
ST_GeneratePoints (g, npoints, seed = 0) Generates a multipoint of random points contained in a Polygon or MultiPolygon. | |
ST_GeometricMedian 3d (geom, tolerance = NULL, max_iter = 10000, fail_if_not_converged = false) Returns the geometric median of a MultiPoint. | |
ST_LineMerge
g3.11
Return the lines formed by sewing together a MultiLineString.
| |
ST_MaximumInscribedCircle g3.9 (geom) Computes the largest circle contained within a geometry. | |
ST_LargestEmptyCircle g3.9 (geom, tolerance=0.0, boundary=POINT EMPTY) Computes the largest circle not overlapping a geometry. | |
ST_MinimumBoundingCircle (geomA, num_segs_per_qt_circ=48) Returns the smallest circle polygon that contains a geometry. | |
ST_MinimumBoundingRadius (geom) Restituisce il punto centrale e il raggio del cerchio più piccolo che contiene una geometria. | |
ST_OrientedEnvelope (geom) Returns a minimum-area rectangle containing a geometry. | |
ST_OffsetCurve (line, signed_distance, style_parameters='') Returns an offset line at a given distance and side from an input line. | |
ST_PointOnSurface mm 3d (g1) Calcola un punto che si trova in un poligono o su una geometria. | |
ST_Polygonize
Calcola un insieme di poligoni formati dalle linee di un insieme di geometrie.
| |
ST_ReducePrecision g3.9 (g, gridsize) Restituisce una geometria valida con punti arrotondati alla tolleranza della griglia. | |
ST_SharedPaths (lineal1, lineal2) Restituisce un insieme contenente i percorsi condivisi dalle due stringhe/multilinghe in ingresso. | |
ST_Simplify
Returns a simplified representation of a geometry, using the Douglas-Peucker algorithm.
| |
ST_SimplifyPreserveTopology (geom, tolerance) Returns a simplified and valid representation of a geometry, using the Douglas-Peucker algorithm. | |
ST_SimplifyPolygonHull g3.11 (param_geom, vertex_fraction, is_outer = true) Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry. | |
ST_SimplifyVW (geom, tolerance) Returns a simplified representation of a geometry, using the Visvalingam-Whyatt algorithm | |
ST_SetEffectiveArea (geom, threshold = 0, set_area = 1) Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm. | |
ST_TriangulatePolygon g3.11 (geom) Computes the constrained Delaunay triangulation of polygons | |
ST_VoronoiLines (geom, tolerance = 0.0, extend_to = NULL) Returns the boundaries of the Voronoi diagram of the vertices of a geometry. | |
ST_VoronoiPolygons (geom, tolerance = 0.0, extend_to = NULL) Returns the cells of the Voronoi diagram of the vertices of a geometry. |
Coverages | |
---|---|
ST_CoverageInvalidEdges g3.12 (geom, tolerance = 0) Window function that finds locations where polygons fail to form a valid coverage. | |
ST_CoverageSimplify g3.12 (geom, tolerance, simplifyBoundary = true) Window function that simplifies the edges of a polygonal coverage. | |
ST_CoverageUnion (geom) Computes the union of a set of polygons forming a coverage by removing shared edges. |
Affine Transformations | |
---|---|
ST_Affine
3d
Apply a 3D affine transformation to a geometry.
| |
ST_Rotate
3d
Rotates a geometry about an origin point.
| |
ST_RotateX 3d (geomA, rotRadians) Rotates a geometry about the X axis. | |
ST_RotateY 3d (geomA, rotRadians) Rotates a geometry about the Y axis. | |
ST_RotateZ 3d (geomA, rotRadians) Rotates a geometry about the Z axis. | |
ST_Scale
3d
Scales a geometry by given factors.
| |
ST_Translate
3d
Translates a geometry by given offsets.
| |
ST_TransScale 3d (geomA, deltaX, deltaY, XFactor, YFactor) Translates and scales a geometry by given offsets and factors. |
Clustering Functions | |
---|---|
ST_ClusterDBSCAN (geom, eps, minpoints) Window function that returns a cluster id for each input geometry using the DBSCAN algorithm. | |
ST_ClusterIntersecting (g) Aggregate function that clusters input geometries into connected sets. | |
ST_ClusterIntersectingWin (geom) Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets. | |
ST_ClusterKMeans (geom, number_of_clusters, max_radius) Window function that returns a cluster id for each input geometry using the K-means algorithm. | |
ST_ClusterWithin (g, distance) Aggregate function that clusters geometries by separation distance. | |
ST_ClusterWithinWin (geom, distance) Window function that returns a cluster id for each input geometry, clustering using separation distance. |
Bounding Box Functions | |
---|---|
Box2D (geom) Returns a BOX2D representing the 2D extent of a geometry. | |
Box3D 3d (geom) Returns a BOX3D representing the 3D extent of a geometry. | |
ST_EstimatedExtent
Returns the estimated extent of a spatial table.
| |
ST_Expand
Returns a bounding box expanded from another bounding box or a geometry.
| |
ST_Extent (geomfield) Funzione aggregata che restituisce il rettangolo di selezione delle geometrie. | |
ST_3DExtent 3d (geomfield) Funzione aggregata che restituisce il rettangolo di selezione 3D delle geometrie. | |
ST_MakeBox2D (pointLowLeft, pointUpRight) Crea un BOX2D definito da due geometrie di punti 2D. | |
ST_3DMakeBox (point3DLowLeftBottom, point3DUpRightTop) Creates a BOX3D defined by two 3D point geometries. | |
ST_XMax 3d (aGeomorBox2DorBox3D) Returns the X maxima of a 2D or 3D bounding box or a geometry. | |
ST_XMin 3d (aGeomorBox2DorBox3D) Returns the X minima of a 2D or 3D bounding box or a geometry. | |
ST_YMax 3d (aGeomorBox2DorBox3D) Returns the Y maxima of a 2D or 3D bounding box or a geometry. | |
ST_YMin 3d (aGeomorBox2DorBox3D) Returns the Y minima of a 2D or 3D bounding box or a geometry. | |
ST_ZMax 3d (aGeomorBox2DorBox3D) Returns the Z maxima of a 2D or 3D bounding box or a geometry. | |
ST_ZMin 3d (aGeomorBox2DorBox3D) Returns the Z minima of a 2D or 3D bounding box or a geometry. |
Sistemi di riferimento lineare | |
---|---|
ST_LineInterpolatePoint
G
3d
Returns a point interpolated along a line at a fractional location.
| |
ST_3DLineInterpolatePoint 3d (a_linestring, a_fraction) Returns a point interpolated along a 3D line at a fractional location. | |
ST_LineInterpolatePoints
G
3d
Returns points interpolated along a line at a fractional interval.
| |
ST_LineLocatePoint
G
Returns the fractional location of the closest point on a line to a point.
| |
ST_LineSubstring
G
3d
Returns the part of a line between two fractional locations.
| |
ST_LocateAlong mm (geom_with_measure, measure, offset = 0) Returns the point(s) on a geometry that match a measure value. | |
ST_LocateBetween mm (geom, measure_start, measure_end, offset = 0) Returns the portions of a geometry that match a measure range. | |
ST_LocateBetweenElevations 3d (geom, elevation_start, elevation_end) Returns the portions of a geometry that lie in an elevation (Z) range. | |
ST_InterpolatePoint 3d (linear_geom_with_measure, point) Returns the interpolated measure of a geometry closest to a point. | |
ST_AddMeasure 3d (geom_mline, measure_start, measure_end) Interpolates measures along a linear geometry. |
Trajectory Functions | |
---|---|
ST_IsValidTrajectory 3d (line) Tests if the geometry is a valid trajectory. | |
ST_ClosestPointOfApproach 3d (track1, track2) Returns a measure at the closest point of approach of two trajectories. | |
ST_DistanceCPA 3d (track1, track2) Returns the distance between the closest point of approach of two trajectories. | |
ST_CPAWithin 3d (track1, track2, dist) Tests if the closest point of approach of two trajectories is within the specified distance. |
Version Functions | |
---|---|
PostGIS_Extensions_Upgrade (target_version=null) Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version. | |
PostGIS_Full_Version () Reports full PostGIS version and build configuration infos. | |
PostGIS_GEOS_Version () Returns the version number of the GEOS library. | |
PostGIS_GEOS_Compiled_Version () Returns the version number of the GEOS library against which PostGIS was built. | |
PostGIS_Liblwgeom_Version () Returns the version number of the liblwgeom library. This should match the version of PostGIS. | |
PostGIS_LibXML_Version () Returns the version number of the libxml2 library. | |
PostGIS_LibJSON_Version () Returns the version number of the libjson-c library. | |
PostGIS_Lib_Build_Date () Returns build date of the PostGIS library. | |
PostGIS_Lib_Version () Returns the version number of the PostGIS library. | |
PostGIS_PROJ_Version () Returns the version number of the PROJ4 library. | |
PostGIS_PROJ_Compiled_Version () Returns the version number of the PROJ library against which PostGIS was built. | |
PostGIS_Wagyu_Version () Returns the version number of the internal Wagyu library. | |
PostGIS_Scripts_Build_Date () Returns build date of the PostGIS scripts. | |
PostGIS_Scripts_Installed () Returns version of the PostGIS scripts installed in this database. | |
PostGIS_Scripts_Released () Returns the version number of the postgis.sql script released with the installed PostGIS lib. | |
PostGIS_Version () Returns PostGIS version number and compile-time options. |
Grand Unified Custom Variables (GUCs) | |
---|---|
postgis.backend The backend to service a function where GEOS and SFCGAL overlap. Options: geos or sfcgal. Defaults to geos. | |
postgis.gdal_datapath A configuration option to assign the value of GDAL's GDAL_DATA option. If not set, the environmentally set GDAL_DATA variable is used. | |
postgis.gdal_enabled_drivers A configuration option to set the enabled GDAL drivers in the PostGIS environment. Affects the GDAL configuration variable GDAL_SKIP. | |
postgis.enable_outdb_rasters A boolean configuration option to enable access to out-db raster bands. | |
postgis.gdal_vsi_options A string configuration to set options used when working with an out-db raster. |
Troubleshooting Functions | |
---|---|
PostGIS_AddBBox (geomA) Add bounding box to the geometry. | |
PostGIS_DropBBox (geomA) Drop the bounding box cache from the geometry. | |
PostGIS_HasBBox (geomA) Returns TRUE if the bbox of this geometry is cached, FALSE otherwise. |