Chapter 14. PostGIS Special Functions Index

Table of Contents
14.1. PostGIS Aggregate Functions
14.2. PostGIS Window Functions
14.3. PostGIS SQL-MM Compliant Functions
14.4. PostGIS Geography Support Functions
14.5. PostGIS Raster Support Functions
14.6. PostGIS Geometry / Geography / Raster Dump Functions
14.7. PostGIS Box Functions
14.8. PostGIS Functions that support 3D
14.9. PostGIS Curved Geometry Support Functions
14.10. PostGIS Polyhedral Surface Support Functions
14.11. PostGIS Function Support Matrix
14.12. New, Enhanced or changed PostGIS Functions
14.12.1. PostGIS Functions new or enhanced in 3.0
14.12.2. PostGIS Functions new or enhanced in 2.5
14.12.3. PostGIS Functions new or enhanced in 2.4
14.12.4. PostGIS Functions new or enhanced in 2.3
14.12.5. PostGIS Functions new or enhanced in 2.2
14.12.6. PostGIS functions breaking changes in 2.2
14.12.7. PostGIS Functions new or enhanced in 2.1
14.12.8. PostGIS functions breaking changes in 2.1
14.12.9. PostGIS Functions new, behavior changed, or enhanced in 2.0
14.12.10. PostGIS Functions changed behavior in 2.0
14.12.11. PostGIS Functions new, behavior changed, or enhanced in 1.5
14.12.12. PostGIS Functions new, behavior changed, or enhanced in 1.4
14.12.13. PostGIS Functions new in 1.3

14.1. PostGIS Aggregate Functions

The functions given below are spatial aggregate functions provided with PostGIS that can be used just like any other sql aggregate function such as sum, average.

  • ST_3DExtent - Eine Aggregatfunktion, welche das umschreibende Rechteck einer Geometrie in 3D zurückgibt.
  • ST_AsGeobuf - Gibt eine Menge an Zeilen in der Geobuf Darstellung aus.
  • ST_AsMVT - Diese Aggregatfunktion gibt Datensätze in der Mapbox Vector Tile Darstellung aus.
  • ST_ClusterIntersecting - Eine Aggregatfunktion, welche räumlich zusammenhängende Geometrie in Cluster verpackt.
  • ST_ClusterWithin - Eine Aggregatfunktion, welche die gegebene Geometrie nach ihrem Abstand in Cluster verpackt.
  • ST_Collect - Wandelt eine Geometrie in eine Sammel- oder Mehrfachgeometrie um.
  • ST_Extent - Eine Aggregatfunktion, welche das umschreibende Rechteck von Geometriezeilen zurückgibt.
  • ST_MakeLine - Erzeugt eine Linie aus einer Punkt-, Mehrfachpunkt- oder Liniengeometrie.
  • ST_MemUnion - Das gleiche wie ST_Union, nur freundlicher zum Arbeitsspeicher (verwendet weniger Arbeitsspeicher und mehr Rechnerzeit).
  • ST_Polygonize - Aggregatfunktion. Erzeugt eine Sammelgeometrie/GeometryCollection, welche Polygone enthält, die aus den einzelnen Linien einer Menge von Geometrien gebildet werden können.
  • ST_SameAlignment - Gibt TRUE zurück, wenn die Raster die selbe Rotation, Skalierung, Koordinatenreferenzsystem und Versatz (Pixel können auf dasselbe Gitter gelegt werden, ohne dass die Gitterlinien durch die Pixel schneiden) aufweisen. Wenn nicht, wird FALSE und eine Bechreibung des Problems ausgegeben.
  • ST_Union - Gibt eine Geometrie zurück, welche der mengentheoretischen Vereinigung der Geometrien entspricht.
  • TopoElementArray_Agg - Gibt für eine Menge an element_id, type Feldern (topoelements) ein topoelementarray zurück.

14.2. PostGIS Window Functions

The functions given below are spatial window functions provided with PostGIS that can be used just like any other sql window function such as row_numer(), lead(), lag(). All these require an SQL OVER() clause.

  • ST_ClusterDBSCAN - Eine Windowing Funktion, welche jeder gegebenen Geometrie eine Cluster-ID nach dem DBSCAN-Algorithmus zuweist.
  • ST_ClusterKMeans - Eine Windowing Funktion, welche jeder gegebenen Geometrie eine Cluster-ID nach dem k-Means-Algorithmus zuweist.

14.3. PostGIS SQL-MM Compliant Functions

The functions given below are PostGIS functions that conform to the SQL/MM 3 standard

[Note]

SQL-MM defines the default SRID of all geometry constructors as 0. PostGIS uses a default SRID of -1.

  • ST_3DDWithin - Für den geometrischen Datentyp in 3D (z). Gibt TRUE zurück, wenn die 3D-Distanz zwischen zwei geometrischen Objekten innerhalb der gegebenen Einheiten liegt. This method implements the SQL/MM specification. SQL-MM ?
  • ST_3DDistance - Gibt die kürzeste kartesische 3D-Entfernung (basierend auf dem Koordinatenreferenzsystem) in projizierten Einheiten zwischen zwei geometrischen Objekten zurück. This method implements the SQL/MM specification. SQL-MM ?
  • ST_3DIntersects - Gibt TRUE zurück, wenn sich die geometrischen Objekte in 3D "räumlich schneiden" - nur für Punkte, Linienzüge, Polygone und polyedrische Oberflächen (Flächen). This method implements the SQL/MM specification. SQL-MM 3: ?
  • ST_AddEdgeModFace - Fügt eine Kante hinzu. Falls dabei eine Masche aufgetrennt wird, so wird die ursprüngliche Masche angepasst und eine weitere Masche hinzugefügt. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.13
  • ST_AddEdgeNewFaces - Fügt eine Kante hinzu. Falls dabei eine Masche aufgetrennt wird, so wird die ursprüngliche Masche gelöscht und durch zwei neue Maschen ersetzt. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.12
  • ST_AddIsoEdge - Fügt eine isolierte Kante, die durch die Geometrie alinestring festgelegt wird zu einer Topologie hinzu, indem zwei bestehende isolierte Knoten anode und anothernode verbunden werden. Gibt die "edgeid" der neuen Kante aus. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.4
  • ST_AddIsoNode - Fügt einen isolierten Knoten zu einer Masche in einer Topologie hinzu und gibt die "nodeid" des neuen Knotens aus. Falls die Masche NULL ist, wird der Knoten dennoch erstellt. This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X+1.3.1
  • ST_Area - Gibt die Fläche einer Polygongeometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 8.1.2, 9.5.3
  • ST_AsBinary - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.37
  • ST_AsText - Gibt die Well-known-Text(WKT) Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.25
  • ST_Boundary - Gibt den Rand einer Geometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.14
  • ST_Buffer - (T) Gibt eine Geometrie zurück, welche alle Punkte innerhalb einer gegebenen Entfernung von der Eingabegeometrie beinhaltet. This method implements the SQL/MM specification. SQL-MM 3: 5.1.17
  • ST_Centroid - Gibt den geometrischen Schwerpunkt einer Geometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 8.1.4, 9.5.5
  • ST_ChangeEdgeGeom - Ändert die geometrische Form einer Kante, ohne sich auf die topologische Struktur auszuwirken. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details X.3.6
  • ST_Contains - Gibt dann und nur dann TRUE zurück, wenn kein Punkt von B im Äußeren von A liegt und zumindest ein Punkt im Inneren von B auch im Inneren von A liegt. This method implements the SQL/MM specification. SQL-MM 3: 5.1.31
  • ST_ConvexHull - Berechnet die konvexe Hülle einer Geometrie. This method implements the SQL/MM specification. SQL-MM 3: 5.1.16
  • ST_CoordDim - Gibt die Dimension der Koordinaten einer Geometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.3
  • ST_CreateTopoGeo - Fügt eine Sammlung von Geometrien an eine leere Topologie an und gibt eine Bestätigungsmeldung aus. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details -- X.3.18
  • ST_Crosses - Gibt TRUE zurück, wenn die übergebenen geometrischen Objekte einige aber nicht alle Punkte im Inneren gemeinsam haben. This method implements the SQL/MM specification. SQL-MM 3: 5.1.29
  • ST_CurveToLine - Wandelt einen CIRCULARSTRING/CURVEPOLYGON/MULTISURFACE in ein LINESTRING/POLYGON/MULTIPOLYGON um This method implements the SQL/MM specification. SQL-MM 3: 7.1.7
  • ST_Difference - Gibt eine Geometrie zurück, die jenen Teil der Geometrie A abbildet, der sich nicht mit der Geometrie B überschneidet. This method implements the SQL/MM specification. SQL-MM 3: 5.1.20
  • ST_Dimension - Gibt die topologische Dimension einer Geometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.2
  • ST_Disjoint - Gibt TRUE zurück, wenn sich die geometrischen Objekte nicht "räumlich schneiden" - wenn sie sich keinen gemeinsamen Raum teilen. This method implements the SQL/MM specification. SQL-MM 3: 5.1.26
  • ST_Distance - Gibt die Entfernung zwischen zwei geometrischen oder geographischen Datensätzen zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.23
  • ST_EndPoint - Gibt den Endpunkt eines LineString oder CircularLineString zurück. This method implements the SQL/MM specification. SQL-MM 3: 7.1.4
  • ST_Envelope - Gibt das umschreibende Rechteck einer Geometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.15
  • ST_Equals - Gibt TRUE zurück, wenn die gegebenen geometrischen Objekte dieselbe Geometrie repräsentieren. Die Richtungsabhängigkeit wird ignoriert. This method implements the SQL/MM specification. SQL-MM 3: 5.1.24
  • ST_ExteriorRing - Gibt den äußeren Ring eines Polygons als LineString zurück. This method implements the SQL/MM specification. SQL-MM 3: 8.2.3, 8.3.3
  • ST_GMLToSQL - Gibt einen spezifizierten ST_Geometry Wert aus einer GML-Darstellung zurück. Dies ist ein Aliasname für ST_GeomFromGML This method implements the SQL/MM specification. SQL-MM 3: 5.1.50 (ausgenommen Unterstützung von Kurven).
  • ST_GeomCollFromText - Erzeugt eine Sammelgeometrie mit der gegebenen SRID aus einer WKT-Kollektion. Wenn keine SRID angegeben ist, wird diese standardmäßig auf 0 gesetzt. This method implements the SQL/MM specification.
  • ST_GeomFromText - Gibt einen spezifizierten ST_Geometry Wert aus einer Well-known-Text Darstellung (WKT) zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.40
  • ST_GeomFromWKB - Erzeugt ein geometrisches Objekt aus der Well-known-Binary (WKB) Darstellung und einer optionalen SRID. This method implements the SQL/MM specification. SQL-MM 3: 5.1.41
  • ST_GeometryFromText - Gibt einen spezifizierten ST_Geometry-Wert von einer Well-known-Text Darstellung (WKT) zurück. Die Bezeichnung ist ein Alias für ST_GeomFromText This method implements the SQL/MM specification. SQL-MM 3: 5.1.40
  • ST_GeometryN - Gibt das n-te geometrische Element einer Sammelgeometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 9.1.5
  • ST_GeometryType - Gibt den Geometrietyp nach SQL-MM als Text zurück. This method implements the SQL/MM specification. SQL-MM 3: 5.1.4
  • ST_GetFaceEdges - Gibt die Kanten, die aface begrenzen, sortiert aus. This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.5
  • ST_GetFaceGeometry - Gibt für eine Topologie und eine bestimmte Maschen-ID das Polygon zurück. This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.16
  • ST_InitTopoGeo - Erstellt ein neues topologisches Schema und registriert das neue Schema in der Tabelle topology.topology. Git eine Zusammenfassung des Prozessablaufs aus. This method implements the SQL/MM specification. SQL-MM 3 Topo-Geo and Topo-Net 3: Routine Details: X.3.17
  • ST_InteriorRingN - Gibt den n-ten inneren Ring (Loch) eines Polygons zurück. This method implements the SQL/MM specification. SQL-MM 3: 8.2.6, 8.3.5
  • ST_Intersection - (T) Gibt eine Geometrie zurück, welche den gemeinsamen Anteil von geomA und geomB repräsentiert. This method implements the SQL/MM specification. SQL-MM 3: 5.1.18
  • ST_Intersects - Gibt TRUE zurück, wenn sich die Geometrie/Geographie der Objekte "in 2D überschneidet" (einen Teil des Raums teilt); und FALSE wenn nicht (sie getrennt sind). Beim geographischen Datentyp beträgt die Toleranz 0.00001 Meter (d.h.: Punkte die so eng beisammen liegen werden als sich überschneidend betrachtet) This method implements the SQL/MM specification. SQL-MM 3: 5.1.27
  • ST_IsClosed - Überprüft ob der Anfangspunkt und der Endpunkt eines LineString's zusammenfallen. Bei einem PolyhedralSurface wird überprüft ob es geschlossen (volumetrisch) ist. This method implements the SQL/MM specification. SQL-MM 3: 7.1.5, 9.3.3
  • ST_IsEmpty - Überprüft ob die Geometrie leer ist. This method implements the SQL/MM specification. SQL-MM 3: 5.1.7
  • ST_IsRing - Überprüft ob eine Linie geschlossen und ein Simple Feature ist. This method implements the SQL/MM specification. SQL-MM 3: 7.1.6
  • ST_IsSimple - Überprüft ob eine Geometrie keine Stellen mit Selbstüberschneidungen oder Selbstberührungen aufweist. This method implements the SQL/MM specification. SQL-MM 3: 5.1.8
  • ST_IsValid - Überprüft ob eine Geometrie in 2D wohlgeformt ist. This method implements the SQL/MM specification. SQL-MM 3: 5.1.9
  • ST_Length - Gibt die 2D-Länge einer Liniengeometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 7.1.2, 9.3.4
  • ST_LineFromText - Erzeugt eine Geometrie aus einer WKT Darstellung mit der angegebenen SRID. Wenn keine SRID angegeben wird, wird diese standardmäßig auf 0 gesetzt. This method implements the SQL/MM specification. SQL-MM 3: 7.2.8
  • ST_LineFromWKB - Erzeugt einen LINESTRING mit gegebener SRID aus einer WKB-Darstellung This method implements the SQL/MM specification. SQL-MM 3: 7.2.9
  • ST_LinestringFromWKB - Erzeugt eine Geometrie mit gegebener SRID aus einer WKB-Darstellung. This method implements the SQL/MM specification. SQL-MM 3: 7.2.9
  • ST_M - Gibt die M-Koordinate eines Punktes zurück. This method implements the SQL/MM specification.
  • ST_MLineFromText - Liest einen festgelegten ST_MultiLineString Wert von einer WKT-Darstellung aus. This method implements the SQL/MM specification.SQL-MM 3: 9.4.4
  • ST_MPointFromText - Erzeugt eine Geometrie aus WKT mit der angegebenen SRID. Wenn keine SRID angegeben wird, wird diese standardmäßig auf 0 gesetzt. This method implements the SQL/MM specification. SQL-MM 3: 9.2.4
  • ST_MPolyFromText - Erzeugt eine MultiPolygon Geometrie aus WKT mit der angegebenen SRID. Wenn SRID nicht angegeben ist, wird sie standardmäßig auf 0 gesetzt. This method implements the SQL/MM specification. SQL-MM 3: 9.6.4
  • ST_ModEdgeHeal - "Heilt" zwei Kanten, indem der verbindende Knoten gelöscht wird, die erste Kante modifiziert und die zweite Kante gelöscht wird. Gibt die ID des gelöschten Knoten zurück. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_ModEdgeSplit - Trennt eine Kante auf, indem ein neuer Knoten entlang einer bestehenden Kante erstellt wird. Ändert die ursprüngliche Kante und fügt eine neue Kante hinzu. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_MoveIsoNode - Verschiebt einen isolierten Knoten in einer Topologie von einer Stelle an eine andere. Falls die neue Geometrie apoint bereits als Knoten existiert, wird eine Fehlermeldung ausgegeben. Gibt eine Beschreibung der Verschiebung aus. This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X.3.2
  • ST_NewEdgeHeal - "Heilt" zwei Kanten, indem der verbindende Knoten und beide Kanten gelöscht werden. Die beiden Kanten werden durch eine Kante ersetzt, welche dieselbe Ausichtung wie die erste Kante hat. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.9
  • ST_NewEdgesSplit - Trennt eine Kante auf, indem ein neuer Knoten entlang einer bestehenden Kante erstellt, die ursprüngliche Kante gelöscht und durch zwei neue Kanten ersetzt wird. Gibt die ID des neu erstellten Knotens aus, der die neuen Kanten verbindet. This method implements the SQL/MM specification. SQL-MM: Topo-Net Routines: X.3.8
  • ST_NumGeometries - Gibt die Anzahl der Elemente einer Sammelgeometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 9.1.4
  • ST_NumInteriorRings - Gibt die Anzahl der inneren Ringe (Löcher) einer Polygongeometrie aus. This method implements the SQL/MM specification. SQL-MM 3: 8.2.5
  • ST_NumPatches - Gibt die Anzahl der Maschen einer polyedrischen Oberfläche aus. Gibt NULL zurück, wenn es sich nicht um polyedrische Geometrien handelt. This method implements the SQL/MM specification. SQL-MM 3: ?
  • ST_NumPoints - Gibt die Anzahl der Stützpunkte einer Linie oder eines Kreisbogens zurück. This method implements the SQL/MM specification. SQL-MM 3: 7.2.4
  • ST_OrderingEquals - Gibt TRUE zurück, wenn die gegebenen geometrischen Objekte ident sind und deren Punkte in der selben Reihenfolge ausgerichtet sind. This method implements the SQL/MM specification. SQL-MM 3: 5.1.43
  • ST_Overlaps - Gibt TRUE zurück, wenn sich die geometrischen Objekte einen Raum teilen, die gleiche Dimension haben, aber sich nicht zur Gänze beinhalten. This method implements the SQL/MM specification. SQL-MM 3: 5.1.32
  • ST_PatchN - Gibt die n-te Geometrie (Masche) einer polyedrischen Oberfläche zurück. This method implements the SQL/MM specification. SQL-MM 3: ?
  • ST_Perimeter - Gibt die Länge der Berandung einer Polygongeometrie zurück; sowohl für den geometrischen als auch geographischen Datentyp. This method implements the SQL/MM specification. SQL-MM 3: 8.1.3, 9.5.4
  • ST_Point - Erstellt einen Punkt mit den gegebenen Koordinaten. Alias für ST_MakePoint. This method implements the SQL/MM specification. SQL-MM 3: 6.1.2
  • ST_PointFromText - Erzeugt eine Punktgeometrie mit gegebener SRID von WKT. Wenn SRID nicht angegeben ist, wird sie standardmäßig auf 0 gesetzt. This method implements the SQL/MM specification. SQL-MM 3: 6.1.8
  • ST_PointFromWKB - Erzeugt eine Geometrie mit gegebener SRID von WKB. This method implements the SQL/MM specification. SQL-MM 3: 6.1.9
  • ST_PointN - Gibt den n-ten Punkt einer Linie oder eines Kreisbogens als Geometrie zurück. This method implements the SQL/MM specification. SQL-MM 3: 7.2.5, 7.3.5
  • ST_PointOnSurface - Gibt einen POINT zurück, der garantiert auf der Oberfläche liegt. This method implements the SQL/MM specification. SQL-MM 3: 8.1.5, 9.5.6. Entsprechend den Spezifikationen kann ST_PointOnSurface mit geometrischen Oberflächen (POLYGONs, MULTIPOLYGONs, CURVED POLYGONs) arbeiten. Daher scheint es, dass PostGIS die Spezifikationen in diesem Bereich erweitert. Die meisten Datenbanken, wie Oracle, DB II, ESRI SDE scheinen lediglich die Funktionen der Spezifikationen zu unterstützen. SQL Server 2008 unterstützt so wie PostGIS alle üblichen geometrischen Datentypen.
  • ST_Polygon - Erstellt ein Polygon aus einer Linie mit festgelegter SRID. This method implements the SQL/MM specification. SQL-MM 3: 8.3.2
  • ST_PolygonFromText - Erzeugt eine Geometrie aus WKT mit der angegebenen SRID. Wenn keine SRID angegeben wird, wird diese standardmäßig auf 0 gesetzt. This method implements the SQL/MM specification. SQL-MM 3: 8.3.6
  • ST_Relate - Gibt TRUE zurück, wenn die Geometrie einen räumlichen Zusammenhang mit einer anderen Geometrie hat; die Überprüfung erfolgt durch Verschneidung des Inneren, der Begrenzung und des Äusseren der beiden geometrischen Objekte, so wie es in den Werten des "intersectionMatrixPattern" festgelegt ist. Wenn kein "intersectionMatrixPattern" übergeben wird, dann wird der maximale "intersectionMatrixPattern" zurückgegeben, über den die 2 geometrischen Objekte in räumlichen Zusammenhang stehen. This method implements the SQL/MM specification. SQL-MM 3: 5.1.25
  • ST_RemEdgeModFace - Entfernt eine Kante. Falls die gelöschte Kante zwei Maschen voneinander getrennt hat, wird eine der Maschen gelöscht und die andere so geändert, dass sie den Platz der beiden ursprünglichen Maschen einnimmt. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.15
  • ST_RemEdgeNewFace - Entfernt eine Kante. Falls die gelöschte Kante zwei Maschen voneinander getrennt hat, werden die ursprünglichen Maschen gelöscht und durch einer neuen Masche ersetzt. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X.3.14
  • ST_RemoveIsoEdge - Löscht einen isolierten Knoten und gibt eine Beschreibung der getroffenen Maßnahmen aus. Falls der Knoten nicht isoliert ist, wird eine Fehlermeldung ausgegeben. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
  • ST_RemoveIsoNode - Löscht einen isolierten Knoten und gibt eine Beschreibung der getroffenen Maßnahmen aus. Falls der Knoten nicht isoliert ist (ist der Anfangs- oder der Endpunkt einer Kante), wird eine Fehlermeldung ausgegeben. This method implements the SQL/MM specification. SQL-MM: Topo-Geo and Topo-Net 3: Routine Details: X+1.3.3
  • ST_SRID - Gibt den Identifikator des Koordinatenreferenzsystems, wie in der spatial_ref_sys Tabelle definiert, für die ST_Geometry aus. This method implements the SQL/MM specification. SQL-MM 3: 5.1.5
  • ST_StartPoint - Gibt den Anfangspunkt einer Linie zurück. This method implements the SQL/MM specification. SQL-MM 3: 7.1.3
  • ST_SymDifference - Gibt eine Geometrie zurück, die jene Teile von A und B repräsentiert, die sich nicht überlagern. Wird symmetrische Differenz genannt, da ST_SymDifference(A,B) = ST_SymDifference(B,A). This method implements the SQL/MM specification. SQL-MM 3: 5.1.21
  • ST_Touches - Gibt TRUE zurück wenn die geometrischen Objekte einen Punkt gemeinsam haben und ihr Inneres sich nicht schneidet. This method implements the SQL/MM specification. SQL-MM 3: 5.1.28
  • ST_Transform - Gibt eine neue Geometrie zurück, bei der die Koordinaten in ein anderes Koordinatenreferenzsystem projiziert wurden. This method implements the SQL/MM specification. SQL-MM 3: 5.1.6
  • ST_Union - Gibt eine Geometrie zurück, welche der mengentheoretischen Vereinigung der Geometrien entspricht. This method implements the SQL/MM specification. SQL-MM 3: 5.1.19 der Z-Index (Höhe) wenn Polygone beteiligt sind.
  • ST_WKBToSQL - Gibt einen geometrischen Datentyp (ST_Geometry) aus einer Well-known-Binary (WKB) Darstellung zurück. Ein Synonym für ST_GeomFromWKB, welches jedoch keine SRID annimmt This method implements the SQL/MM specification. SQL-MM 3: 5.1.36
  • ST_WKTToSQL - Gibt einen spezifizierten ST_Geometry-Wert von einer Well-known-Text Darstellung (WKT) zurück. Die Bezeichnung ist ein Alias für ST_GeomFromText This method implements the SQL/MM specification. SQL-MM 3: 5.1.34
  • ST_Within - Gibt TRUE zurück, wenn Geometrie A zur Gänze innerhalb von Geometrie B liegt This method implements the SQL/MM specification. SQL-MM 3: 5.1.30
  • ST_X - Gibt die X-Koordinate eines Punktes zurück. This method implements the SQL/MM specification. SQL-MM 3: 6.1.3
  • ST_Y - Gibt die Y-Koordinate eines Punktes zurück. This method implements the SQL/MM specification. SQL-MM 3: 6.1.4
  • ST_Z - Gibt die Z-Koordinate eines Punktes zurück. This method implements the SQL/MM specification.

14.4. PostGIS Geography Support Functions

The functions and operators given below are PostGIS functions/operators that take as input or return as output a geography data type object.

[Note]

Functions with a (T) are not native geodetic functions, and use a ST_Transform call to and from geometry to do the operation. As a result, they may not behave as expected when going over dateline, poles, and for large geometries or geometry pairs that cover more than one UTM zone. Basic transform - (favoring UTM, Lambert Azimuthal (North/South), and falling back on mercator in worst case scenario)

  • ST_Area - Gibt die Fläche einer Polygongeometrie zurück.
  • ST_AsBinary - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
  • ST_AsEWKT - Gibt die Well-known-Text(WKT) Darstellung der Geometrie mit den SRID-Metadaten zurück.
  • ST_AsGML - Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
  • ST_AsGeoJSON - Gibt die Geometrie eines GeoJSON Elements zurück.
  • ST_AsKML - Gibt die Geometrie als KML-Element aus. Mehrere Varianten. Standardmäßig ist Version=2 und maxdecimaldigits=15 voreingestellt
  • ST_AsSVG - Gibt eine Geometrie als SVG-Pfad aus.
  • ST_AsText - Gibt die Well-known-Text(WKT) Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
  • ST_Azimuth - Gibt den auf die Nordrichtung bezogenen Azimut in Radiant zurück. Der Winkel wird von einer Senkrechten auf "pointA" nach pointB im Uhrzeigersinn gemessen.
  • ST_Buffer - (T) Gibt eine Geometrie zurück, welche alle Punkte innerhalb einer gegebenen Entfernung von der Eingabegeometrie beinhaltet.
  • ST_Centroid - Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
  • ST_CoveredBy - Gibt 1 (TRUE) zurück, falls kein Punkt der Geometrie/Geographie A außerhalb von Geometry/Geographie B liegt
  • ST_Covers - Gibt 1 (TRUE) zurück, falls kein Punkt der Geometrie B außerhalb von Geometry A liegt
  • ST_DWithin - Gibt TRUE zurück, wenn die geometrischen Objekte innerhalb einer bestimmten Entfernung voneinander liegen. Beim geometrischen Datentyp entsprechen die Einheiten dem Koordinatenreferenzsystem. Beim geographischen Datentyp sind die Einheiten in Meter und die Messung wird mit der Standardeinstellung "use_speroid=true" (Messung am Referenzellipsoid) durchgeführt; für eine schnellere Überprüfung können Sie "use_spheroid=false" setzen, um auf einer Kugel zu messen.
  • ST_Distance - Gibt die Entfernung zwischen zwei geometrischen oder geographischen Datensätzen zurück.
  • ST_GeogFromText - Gibt einen geographischen Datentyp aus einer Well-known-Text (WKT), oder einer erweiterten WKT (EWKT), Darstellung zurück.
  • ST_GeogFromWKB - Erzeugt ein geographisches Objekt aus der Well-known-Binary (WKB) oder der erweiterten Well-known-Binary (EWKB) Darstellung.
  • ST_GeographyFromText - Gibt einen geographischen Datentyp aus einer Well-known-Text (WKT), oder einer erweiterten WKT (EWKT), Darstellung zurück.
  • = - Gibt TRUE zurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind.
  • ST_Intersection - (T) Gibt eine Geometrie zurück, welche den gemeinsamen Anteil von geomA und geomB repräsentiert.
  • ST_Intersects - Gibt TRUE zurück, wenn sich die Geometrie/Geographie der Objekte "in 2D überschneidet" (einen Teil des Raums teilt); und FALSE wenn nicht (sie getrennt sind). Beim geographischen Datentyp beträgt die Toleranz 0.00001 Meter (d.h.: Punkte die so eng beisammen liegen werden als sich überschneidend betrachtet)
  • ST_Length - Gibt die 2D-Länge einer Liniengeometrie zurück.
  • ST_Perimeter - Gibt die Länge der Berandung einer Polygongeometrie zurück; sowohl für den geometrischen als auch geographischen Datentyp.
  • ST_Project - Gibt einen Punkt zurück, der von einem Anfangspunkt aus über eine Distanz und eine Peilung (Azimut) projiziert wird.
  • ST_Segmentize - Gibt eine veränderte Geometrie/Geographie zurück, bei der kein Sement länger als der gegebene Abstand ist.
  • ST_Summary - Gibt eine textliche Zusammenfassung des Inhalts einer Geometrie wieder.
  • <-> - Gibt die 2D Entfernung zwischen A und B zurück.
  • && - Gibt TRUE zurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B schneidet.

14.5. PostGIS Raster Support Functions

The functions and operators given below are PostGIS functions/operators that take as input or return as output a raster data type object. Listed in alphabetical order.

  • Box3D - Stellt das umschreibende Rechteck eines Raster als Box3D dar.
  • @ - Gibt TRUE zurück, wenn das umschreibende Rechteck von A in jenem von B enthalten ist. Das umschreibende Rechteck ist in Double Precision.
  • ~ - Gibt TRUE zurück, wenn das umschreibende Rechteck von A jenes von B enthält. Das umschreibende Rechteck ist in Double Precision.
  • = - Gibt TRUE zurück, wenn die umschreibenden Rechtecke von A und B ident sind. Das umschreibende Rechteck ist in Double Precision.
  • && - Gibt TRUE zurück, wenn das umschreibende Rechteck von A das umschreibende Rechteck von B schneidet.
  • &< - Gibt TRUE zurück, wenn das umschreibende Rechteck von A links von dem von B liegt.
  • &> - Gibt TRUE zurück, wenn das umschreibende Rechteck von A rechts von dem von B liegt.
  • ~= - Gibt TRUE zurück wenn die Umgebungsrechtecke von "A" und "B" ident sind.
  • ST_Retile - Gibt konfigurierte Kacheln eines beliebig gekachelten Rastercoverage aus.
  • ST_AddBand - Gibt einen Raster mit den neu hinzugefügten Band(Bändern) aus. Der Typ , der Ausgangswert und der Index für den Speicherort des Bandes kann angegeben werden. Wenn kein Index angegeben ist, wird das Band am Ende hinzugefügt.
  • ST_AsBinary/ST_AsWKB - Gibt die Well-known-Binary (WKB) Darstellung eines Rasters zurück.
  • ST_AsGDALRaster - Gibt die Rasterkachel in dem ausgewiesenen Rasterformat von GDAL aus. Sie können jedes Rasterformat angeben, das von Ihrer Bibliothek unterstützt wird. Um eine Liste mit den unterstützten Formaten auszugeben, verwenden Sie bitte ST_GDALDrivers().
  • ST_AsHexWKB - Gibt die Well-known-Binary (WKB) Hex-Darstellung eines Rasters zurück.
  • ST_AsJPEG - Gibt die ausgewählten Bänder der Rasterkachel als einzelnes Bild (Byte-Array) im Format "Joint Photographic Exports Group" (JPEG) aus. Wenn kein Band angegeben ist und 1 oder mehr als 3 Bänder ausgewählt wurden, dann wird nur das erste Band verwendet. Wenn 3 Bänder ausgewählt wurden, werden alle 3 Bänder verwendet und auf RGB abgebildet.
  • ST_AsPNG - Gibt die ausgewählten Bänder der Rasterkachel als einzelnes, übertragbares Netzwerkgraphik (PNG) Bild (Byte-Feld) aus. Wenn der Raster 1,3 oder 4 Bänder hat und keine Bänder angegeben sind, dann werden alle Bänder verwendet. Wenn der Raster 2 oder mehr als 4 Bänder hat und keine Bänder angegeben sind, dann wird nur Band 1 verwendet. Die Bänder werden in den RGB- oder den RGBA-Raum abgebildet.
  • ST_AsRaster - Konvertiert den geometrischen Datentyp von PostGIS in einen PostGIS Raster.
  • ST_AsTIFF - Gibt die ausgewählten Bänder des Raster als einzelnes TIFF Bild (Byte-Feld) zurück. Wenn kein Band angegeben ist oder keines der angegebenen Bänder im Raster existiert, werden alle Bänder verwendet.
  • ST_Aspect - Gibt die Exposition (standardmäßig in Grad) eines Rasterbandes mit Höhen aus. Nütlich für Terrain-Analysen.
  • ST_Band - Gibt einen oder mehrere Bänder eines bestehenden Rasters als neuen Raster aus. Nützlich um neue Raster aus bestehenden Rastern abzuleiten.
  • ST_BandFileSize - Gibt die Dateigröße eines im Dateisystem gespeicherten Bandes aus. Wenn "bandnum" nicht angegeben ist, wird 1 angenommen.
  • ST_BandFileTimestamp - Gibt den Zeitstempel eines im Dateisystem gespeicherten Bandes aus. Wenn "bandnum" nicht angegeben ist, wird 1 angenommen.
  • ST_BandIsNoData - Gibt TRUE aus, wenn das Band ausschließlich aus NODATA Werten besteht.
  • ST_BandMetaData - Gibt die grundlegenden Metadaten eines bestimmten Rasterbandes aus. Wenn der Parameter "bandnum" nicht angegeben ist, wird das 1ste Band angenommen.
  • ST_BandNoDataValue - Gibt den NODATA Wert des gegebenen Bandes aus. Wenn der Parameter "bandnum" nicht angegeben ist, wird das 1ste Band angenommen.
  • ST_BandPath - Gibt den Dateipfad aus, unter dem das Band im Dateisystem gespeichert ist. Wenn "bandnum" nicht angegeben ist, wird 1 angenommen.
  • ST_BandPixelType - Gibt den Pixeltyp des angegebenen Bandes aus. Wenn der Parameter "bandnum" nicht angegeben ist, wird das 1ste Band angenommen.
  • ST_Clip - Schneidet den Raster nach der Eingabegeometrie. Wenn die Bandnummer nicht angegeben ist, werden alle Bänder bearbeitet. Wenn crop nicht angegeben oder TRUE ist, wird der Ausgaberaster abgeschnitten.
  • ST_ColorMap - Erzeugt aus einem bestimmten Band des Ausgangsrasters einen neuen Raster mit bis zu vier 8BUI-Bändern (Grauwert, RGB, RGBA). Wenn kein Band angegeben ist, wird Band 1 angenommen.
  • ST_Contains - Gibt TRUE zurück, wenn kein Punkt des Rasters "rastB" im Äußeren des Rasters "rastA" liegt und zumindest ein Punkt im Inneren von "rastB" auch im Inneren von "rastA" liegt.
  • ST_ContainsProperly - Gibt TRUE zurück, wenn "rastB" das Innere von "rastA" schneidet, aber nicht die Begrenzung oder das Äußere von "rastA".
  • ST_ConvexHull - Gibt die Geometrie der konvexen Hülle des Raster, inklusive der Pixel deren Werte gleich BandNoDataValue sind. Bei regelmäßig geformten und nicht rotierten Raster ist das Ergebnis ident mit ST_Envelope. Diese Funktion ist deshalb nur bei unregelmäßig geformten oder rotierten Raster nützlich.
  • ST_Count - Gibt die Anzahl der Pixel für ein Band eines Rasters oder eines Raster-Coverage zurück. Wenn kein Band angegeben ist, wird standardmäßig Band 1 gewählt. Wenn der Parameter "exclude_nodata_value" auf TRUE gesetzt ist, werden nur Pixel mit Werten ungleich NODATA gezählt.
  • ST_CountAgg - Aggregatfunktion. Gibt die Anzahl der Pixel in einem bestimmten Band der Raster aus. Wenn kein Band angegeben ist, wird Band 1 angenommen. Wenn "exclude_nodata_value" TRUE ist, werden nur die Pixel ohne NODATA Werte gezählt.
  • ST_CoveredBy - Gibt TRUE zurück, wenn kein Punkt des Rasters "rastA" außerhalb des Rasters "rastB" liegt.
  • ST_Covers - Gibt TRUE zurück, wenn kein Punkt des Rasters "rastB" außerhalb des Rasters "rastA" liegt.
  • ST_DFullyWithin - Gibt TRUE zurück, wenn die Raster "rastA" und "rastB" zur Gänze innerhalb der angegebenen Distanz zueinander liegen.
  • ST_DWithin - Gibt TRUE zurück, wenn die Raster "rastA" und "rastB" innerhalb der angegebenen Entfernung voneinander liegen.
  • ST_Disjoint - Gibt TRUE zurück, wenn sich die Raster "rastA" und "rastB" räumlich nicht überschneiden.
  • ST_DumpAsPolygons - Gibt geomval (geom,val) Zeilen eines Rasterbandes zurück. Wenn kein Band angegeben ist, wird die Bandnummer standardmäßig auf 1 gesetzt.
  • ST_DumpValues - Gibt die Werte eines bestimmten Bandes als 2-dimensionales Feld aus.
  • ST_Envelope - Stellt die Ausdehnung des Raster als Polygon dar.
  • ST_FromGDALRaster - Erzeugt einen Raster aus einer von GDAL unterstützten Rasterdatei.
  • ST_GeoReference - Gibt die Metadaten der Georeferenzierung, die sich üblicherweise in einem sogenannten "World File befinden, im GDAL oder ESRI Format aus. Die Standardeinstellung ist GDAL.
  • ST_Grayscale - Erzeugt einen neuen Raster mit einem 8BUI-Band aus dem Ausgangsrasters und den angegebenen Bändern für Rot, Grün und Blau
  • ST_HasNoBand - Gibt TRUE aus, wenn kein Band mit der angegebenen Bandnummer existiert.Gibt den Pixeltyp des angegebenen Bandes aus. Wenn keine Bandnummer angegeben ist, wird das 1ste Band angenommen.
  • ST_Height - Gibt die Höhe des Rasters in Pixel aus.
  • ST_HillShade - Gibt für gegebenen Horizontalwinkel, Höhenwinkel, Helligkeit und Maßstabsverhältnis die hypothetische Beleuchtung eines Höhenrasterbandes zurück.
  • ST_Histogram - Gibt Datensätze aus, welche die Verteilung der Daten eines Rasters oder eines Rastercoverage darstellen. Dabei wird die Wertemenge in Klassen aufgeteilt und für jede Klasse zusammengefasst. Wenn die Anzahl der Klassen nicht angegeben ist, wird sie automatisch berechnet.
  • ST_Intersection - Gibt Geometry-PixelValue Paare, oder einen Raster aus, der durch die Schnittmenge der beiden Raster bestimmt wird, oder durch die geometrische Verschneidung einer Vektorisierung des Rasters mit einem geometrischen Datentyp.
  • ST_Intersects - Gibt TRUE zurück, wenn sich die Raster "rastA" und "rastB" nicht räumlich überschneiden.
  • ST_IsEmpty - Gibt TRUE zurück, wenn der Raster leer ist (width = 0 and height = 0). Andernfalls wird FALSE zurückgegeben.
  • ST_MakeEmptyCoverage - Bedeckt die georeferenzierte Fläche mit einem Gitter aus leeren Rasterkacheln.
  • ST_MakeEmptyRaster - Gibt einen leeren Raster (ohne Bänder), mit den gegebenen Dimensionen (width & height), upperleft X und Y, Pixelgröße, Rotation (scalex, scaley, skewx & skewy) und Koordinatenreferenzsystem (SRID), zurück. Wenn ein Raster übergeben wird, dann wird ein neuer Raster mit der selben Größe, Ausrichtung und SRID zurückgegeben. Wenn SRID nicht angegeben ist, wird das Koordinatenreferenzsystem auf "unknown" (0) gesetzt.
  • ST_MapAlgebra (Rückruffunktion) - Die Version mit der Rückruffunktion - Gibt für einen oder mehrere Eingaberaster einen Raster mit einem Band, den Bandindizes und einer vom Anwender vorgegebenen Rückruffunktion zurück.
  • ST_MapAlgebraExpr - Version mit 1 Rasterband: Erzeugt ein neues Rasterband, dass über eine gültige, algebraische PostgreSQL Operation für ein Rasterband mit gegebenen Pixeltyp erstellt wird. Wenn kein Band bestimmt ist, wird Band 1 angenommen.
  • ST_MapAlgebraExpr - Version mit 2 Rasterbändern: Erstellt einen neuen Einzelbandraster, indem eine gültige algebraische PostgreSQL Funktion auf die zwei Ausgangsrasterbänder und den entsprechenden Pixeltyp angewendet wird. Wenn keine Bandnummern angegeben sind, wird von jedem Raste Band 1 angenommen. Der Ergebnisraster wird nach dem Gitter des ersten Raster ausgerichtet (Skalierung, Versatz und Eckpunkte der Pixel) und hat die Ausdehnung, welche durch den Parameter "extenttype" definiert ist. Der Parameter "extenttype" kann die Werte INTERSECTION, UNION, FIRST, SECOND annehmen.
  • ST_MapAlgebraFct - Version mit 1 Rasterband: Erzeugt ein neues Rasterband, dass über eine gültige PostgreSQL Funktion für ein gegebenes Rasterband und Pixeltyp erstellt wird. Wenn kein Band bestimmt ist, wird Band 1 angenommen.
  • ST_MapAlgebraFct - Version mit 2 Rasterbändern: Erstellt einen neuen Einzelbandraster, indem eine gültige PostgreSQL Funktion auf die 2 gegebenen Rasterbänder und den entsprechenden Pixeltyp angewendet wird. Wenn kein Band bestimmt ist, wird Band 1 angenommen. Wenn der "Extent"-Typ nicht angegeben ist, wird standardmäßig INTERSECTION angenommen.
  • ST_MapAlgebraFctNgb - Version mit 1em Band: Map Algebra Nearest Neighbor mit einer benutzerdefinierten PostgreSQL Funktion. Gibt einen Raster zurück, dessen Werte sich aus einer benutzerdefinierte PL/pgsql Funktion ergeben, welche die Nachbarschaftswerte des Ausgangsrasterbandes einbezieht.
  • ST_MapAlgebra (Ausdrucksanweisung) - Version mit Ausdrücken - Gibt für einen oder zwei Ausgangsraster, Bandindizes und einer oder mehreren vom Anwender vorgegebenen SQL-Ausdrücken, einen Raster mit einem Band zurück.
  • ST_MemSize - Gibt den Platzbedarf des Rasters (in Byte) aus.
  • ST_MetaData - Gibt die wesentlichen Metadaten eines Rasterobjektes, wie Zellgröße, Rotation (Versatz) etc. aus
  • ST_MinConvexHull - Gibt die Geometrie der konvexen Hülle des Raster aus, wobei Pixel mit NODATA ausgenommen werden.
  • ST_NearestValue - Gibt den nächstgelegenen nicht NODATA Wert eines bestimmten Pixels aus, das über "columnx" und "rowy" oder durch eine Punktgeometrie - im gleichen Koordinatenreferenzsystem wie der Raster - ausgewählt wird.
  • ST_Neighborhood - Gibt ein 2-D Feld in "Double Precision" aus, das sich aus nicht NODATA Werten um ein bestimmtes Pixel herum zusammensetzt. Das Pixel Kann über "columnx" und "rowy" oder über eine Punktgeometrie - im gleichen Koordinatenreferenzsystem wie der Raster - ausgewählt werden.
  • ST_NotSameAlignmentReason - Gibt eine Meldung aus, die angibt ob die Raster untereinander ausgerichtet sind oder nicht und warum wenn nicht.
  • ST_NumBands - Gibt die Anzahl der Bänder des Rasters aus.
  • ST_Overlaps - Gibt TRUE zurück, wenn sich die Raster "rastA" und "rastB" schneiden, aber ein Raster den anderen nicht zur Gänze enthält.
  • ST_PixelAsCentroid - Gibt den geometrischen Schwerpunkt (Punktgeometrie) der Fläche aus, die durch das Pixel repräsentiert wird.
  • ST_PixelAsCentroids - Gibt den geometrischen Schwerpunkt (Punktgeometrie) für jedes Pixel des Rasterbandes zurück, zusammen mit dem Zellwert und den X- und Y-Rasterkoordinaten eines jeden Pixels. Die Koordinaten der Punkte entsprechen dem geometrischen Schwerpunkt der Pixel.
  • ST_PixelAsPoint - Gibt eine Punktgeometrie der oberen linken Ecke des Rasters zurück.
  • ST_PixelAsPoints - Gibt eine Punktgeometrie für jedes Pixel des Rasterbandes zurück, zusammen mit dem Zellwert und den X- und Y-Rasterkoordinaten eines jeden Pixels. Die Koordinaten der Punkte entsprechen dem oberen linken Eck der Pixel.
  • ST_PixelAsPolygon - Gibt die Polygongeometrie aus, die das Pixel einer bestimmten Zeile und Spalte begrenzt.
  • ST_PixelAsPolygons - Gibt die umhüllende Polygongeometrie, den Zellwert, sowie die X- und Y-Rasterkoordinate für jedes Pixel aus.
  • ST_PixelHeight - Gibt die Pixelhöhe in den Einheiten des Koordinatenreferenzsystem aus.
  • ST_PixelOfValue - Gibt die columnx- und rowy-Koordinaten jener Pixel aus, deren Zellwert gleich dem gesuchten Wert ist.
  • ST_PixelWidth - Gibt die Pixelbreite in den Einheiten des Koordinatenreferenzsystems aus.
  • ST_Polygon - Gibt eine Geometrie mit Mehrfachpolygonen zurück, die aus der Vereinigung von Pixel mit demselben Zellwert gebildet werden. Pixel mit NODATA Werten werden nicht berücksichtigt. Wenn keine Band angegeben ist, wird die Bandnummer standardmäßig auf 1 gesetzt. 
  • ST_Quantile - Berechnet die Quantile eines Rasters oder einer Rastercoverage Tabelle im Kontext von Stichproben oder Bevölkerung. Dadurch kann untersucht werden, ob ein Wert bei 25%, 50% oder 75% Perzentil des Rasters liegt.
  • ST_RastFromHexWKB - Gibt einen Rasterwert von einer Well-known-Binary (WKB) Hex-Darstellung eines Rasters zurück.
  • ST_RastFromWKB - Gibt einen Rasterwert von einer Well-known-Binary (WKB) Darstellung eines Rasters zurück.
  • ST_RasterToWorldCoord - Gibt die obere linke Ecke des Rasters in geodätischem X und Y (Länge und Breite) für eine gegebene Spalte und Zeile aus. Spalte und Zeile wird von 1 aufwärts gezählt.
  • ST_RasterToWorldCoordX - Gibt die geodätische X Koordinate links oberhalb des Rasters, der Spalte und der Zeile aus. Die Nummerierung der Spalten und Zeilen beginnt mit 1.
  • ST_RasterToWorldCoordY - Gibt die geodätische Y Koordinate links oberhalb des Rasters, der Spalte und der Zeile aus. Die Nummerierung der Spalten und Zeilen beginnt mit 1.
  • ST_Reclass - Erstellt einen neuen Raster, der aus neu klassifizierten Bändern des Originalraster besteht. Das Band "nband" ist jenes das verändert werden soll. Wenn "nband" nicht angegeben ist, wird "Band 1" angenommen. Alle anderen Bänder bleiben unverändert. Anwendungsfall: zwecks einfacherer Visualisierung ein 16BUI-Band in ein 8BUI-Band konvertieren und so weiter.
  • ST_Resample - Skaliert einen Raster mit einem bestimmten Algorithmus, neuen Dimensionen, einer beliebigen Gitterecke und über Parameter zur Georeferenzierung des Rasters, die angegeben oder von einem anderen Raster übernommen werden können.
  • ST_Rescale - Skaliert einen Raster indem lediglich der Maßstab (oder die Pixelgröße) angepasst wird. Neue Pixelwerte werden über NearestNeighbor, bilinear, kubisch, CubicSpline oder mit dem Lanczos-Filter errechnet. Die Standardeinstellung ist NearestNeighbor.
  • ST_Resize - Ändert die Zellgröße - width/height - eines Rasters
  • ST_Reskew - Skaliert einen Raster, indem lediglich der Versatz (oder Rotationsparameter) angepasst wird. Neue Pixelwerte werden über NearestNeighbor, bilinear, kubisch, CubicSpline oder mit dem Lanczos-Filter errechnet. Die Standardeinstellung ist NearestNeighbor.
  • ST_Rotation - Gibt die Rotation des Rasters im Bogenmaß aus.
  • ST_Roughness - Gibt einen Raster mit der berechneten "Rauhigkeit" des DHM zurück.
  • ST_SRID - Gibt den Identifikator des Koordinatenreferenzsystems des Rasters aus, das in der Tabelle "spatial_ref_sys" definiert ist.
  • ST_SameAlignment - Gibt TRUE zurück, wenn die Raster die selbe Rotation, Skalierung, Koordinatenreferenzsystem und Versatz (Pixel können auf dasselbe Gitter gelegt werden, ohne dass die Gitterlinien durch die Pixel schneiden) aufweisen. Wenn nicht, wird FALSE und eine Bechreibung des Problems ausgegeben.
  • ST_ScaleX - Gibt die X-Komponente der Pixelbreite in den Einheiten des Koordinatenreferenzsystems aus.
  • ST_ScaleY - Gibt die Y-Komponente der Pixelhöhe in den Einheiten des Koordinatenreferenzsystems aus.
  • ST_SetBandIndex - Aktualisiert die externe Bandnummer eines out-db Bandes.
  • ST_SetBandIsNoData - Setzt die Flag "isnodata" für das Band auf TRUE.
  • ST_SetBandNoDataValue - Setzt den NODATA Wert eines Bandes. Wenn kein Band angegeben ist, wird Band 1 angenommen. Falls ein Band keinen NODATA Wert aufweisen soll, übergeben Sie bitte für den Parameter "nodatavalue" NULL.
  • ST_SetBandPath - Aktualisiert den externen Dateipfad und die Bandnummer eines out-db Bandes.
  • ST_SetGeoReference - Georeferenziert einen Raster über 6 Parameter in einem einzigen Aufruf. Die Zahlen müssen durch Leerzeichen getrennt sein. Die Funktion akzeptiert die Eingabe im Format von 'GDAL' und von 'ESRI'. Der Standardwert ist GDAL.
  • ST_SetRotation - Bestimmt die Rotation des Rasters in Radiant.
  • ST_SetSRID - Setzt die SRID eines Rasters auf einen bestimmten Ganzzahlwert. Die SRID wird in der Tabelle "spatial_ref_sys" definiert.
  • ST_SetScale - Setzt die X- und Y-Größe der Pixel in den Einheiten des Koordinatenreferenzsystems. Entweder eine Zahl pro Pixel oder Breite und Höhe.
  • ST_SetSkew - Setzt den georeferenzierten X- und Y-Versatz (oder den Rotationsparameter). Wenn nur ein Wert übergeben wird, werden X und Y auf den selben Wert gesetzt.
  • ST_SetUpperLeft - Setzt den Wert der oberen linke Ecke des Rasters auf die projizierten X- und Y-Koordinaten.
  • ST_SetValue - Setzt den Wert für ein Pixel eines Bandes, das über columnx und rowy festgelegt wird, oder für die Pixel die eine bestimmte Geometrie schneiden, und gibt den veränderten Raster zurück. Die Bandnummerierung beginnt mit 1; wenn die Bandnummer nicht angegeben ist, wird 1 angenommen.
  • ST_SetValues - Gibt einen Raster zurück, der durch das Setzen der Werte eines bestimmten Bandes verändert wurde.
  • ST_SkewX - Gibt den georeferenzierten Versatz in X-Richtung (oder den Rotationsparameter) aus.
  • ST_SkewY - Gibt den georeferenzierten Versatz in Y-Richtung (oder den Rotationsparameter) aus.
  • ST_Slope - Gibt die Neigung (standardmäßig in Grad) eines Höhenrasterbandes zurück. Nützlich für Terrain-Analysen.
  • ST_SnapToGrid - Skaliert einen Raster durch Fangen an einem Führungsgitter. Neue Pixelwerte werden über NearestNeighbor, bilinear, kubisch, CubicSpline oder mit dem Lanczos-Filter errechnet. Die Standardeinstellung ist NearestNeighbor. 
  • ST_Summary - Gibt eine textliche Zusammenfassung des Rasterinhalts zurück.
  • ST_SummaryStats - Gibt eine zusammenfassende Statistik aus, bestehend aus der Anzahl, der Summe, dem arithmetischen Mittel, der Standardabweichung, dem Minimum und dem Maximum der Werte eines Rasterbandes oder eines Rastercoverage. Wenn kein Band angegeben ist, wird Band 1 angenommen.
  • ST_SummaryStatsAgg - Aggregatfunktion. Gibt eine zusammenfassende Statistik aus, die aus der Anzahl, der Summe, dem arithmetischen Mittel, dem Minimum und dem Maximum der Werte eines bestimmten Bandes eines Rastersatzes besteht. Wenn kein Band angegeben ist, wird Band 1 angenommen.
  • ST_TPI - Berechnet den "Topographic Position Index" eines Raster.
  • ST_TRI - Gibt einen Raster mit errechneten Geländerauheitsindex aus.
  • ST_Tile - Gibt Raster, die aus einer Teilungsoperation des Eingaberasters resultieren, mit den gewünschten Dimensionen aus.
  • ST_Touches - Gibt TRUE zurück, wenn rastA und rastB zumindest einen Punkt gemeinsam haben sich aber nicht überschneiden.
  • ST_Transform - Projiziert einen Raster von einem bekannten Koordinatenreferenzsystem in ein anderes bekanntes Koordinatenreferenzsystem um. Die Optionen für die Skalierung sind NearestNeighbor, Bilinear, Cubisch, CubicSpline und der Lanczos-Filter, die Standardeinstellung ist NearestNeighbor.
  • ST_Union - Gibt die Vereinigung mehrerer Rasterkacheln in einem einzelnen Raster mit mehreren Bändern zurück.
  • ST_UpperLeftX - Gibt die obere linke X-Koordinate des Rasters im Koordinatenprojektionssystem aus.
  • ST_UpperLeftY - Gibt die obere linke Y-Koordinate des Rasters im Koordinatenprojektionssystem aus.
  • ST_Value - Gibt den Zellwert eines Pixels aus, das über columnx und rowy oder durch einen bestimmten geometrischen Punkt angegeben wird. Die Bandnummern beginnen mit 1 und wenn keine Bandnummer angegeben ist, dann wird Band 1 angenommen. Wenn exclude_nodata_value auf FALSE gesetzt ist, werden auch die Pixel mit einem nodata Wert mit einbezogen. Wenn exclude_nodata_value nicht übergeben wird, dann wird er über die Metadaten des Rasters ausgelesen.
  • ST_ValueCount - Gibt Datensätze aus, die den Zellwert und die Anzahl der Pixel eines Rasterbandes (oder Rastercoveragebandes) für gegebene Werte enthalten. Wenn kein Band angegeben ist, wird Band 1 angenommen. Pixel mit dem Wert NODATA werden standardmäßig nicht gezählt; alle anderen Pixelwerte des Bandes werden ausgegeben und auf die nächste Ganzzahl gerundet.
  • ST_Width - Gibt die Breite des Rasters in Pixel aus.
  • ST_Within - Gibt TRUE zurück, wenn kein Punkt des Rasters "rastA" außerhalb des Rasters "rastB" liegt und zumindest ein Punkt im Inneren von "rastA" auch im Inneren von "rastB" liegt.
  • ST_WorldToRasterCoord - Gibt für ein geometrisches X und Y (geographische Länge und Breite) oder für eine Punktgeometrie im Koordinatenreferenzsystem des Rasters, die obere linke Ecke als Spalte und Zeile aus.
  • ST_WorldToRasterCoordX - Gibt für eine Punktgeometrie (pt) oder eine globale X- und Y-Koordinate (xw, yw) die Rasterspalte im globalen Koordinatenreferenzsystem des Rasters aus.
  • ST_WorldToRasterCoordY - Gibt für eine Punktgeometrie (pt) oder eine globale X- und Y-Koordinate (xw, yw) die Rasterzeile im globalen Koordinatenreferenzsystem des Rasters aus.
  • UpdateRasterSRID - Änderung der SRID aller Raster in der vom Anwender angegebenen Spalte und Tabelle.

14.6. PostGIS Geometry / Geography / Raster Dump Functions

The functions given below are PostGIS functions that take as input or return as output a set of or single geometry_dump or geomval data type object.

  • ST_DumpAsPolygons - Gibt geomval (geom,val) Zeilen eines Rasterbandes zurück. Wenn kein Band angegeben ist, wird die Bandnummer standardmäßig auf 1 gesetzt.
  • ST_Intersection - Gibt Geometry-PixelValue Paare, oder einen Raster aus, der durch die Schnittmenge der beiden Raster bestimmt wird, oder durch die geometrische Verschneidung einer Vektorisierung des Rasters mit einem geometrischen Datentyp.
  • ST_Dump - Gibt die Menge an geometry_dump Zeilen für die Bestandteile einer Geometrie zurück.
  • ST_DumpPoints - Gibt die Menge an geometry_dump Zeilen für die Punkte einer Geometrie zurück.
  • ST_DumpRings - Gibt die Menge an geometry_dump Zeilen für die äußeren und inneren Ringe eines Polygons zurück.

14.7. PostGIS Box Functions

The functions given below are PostGIS functions that take as input or return as output the box* family of PostGIS spatial types. The box family of types consists of box2d, and box3d

  • Box2D - Gibt eine BOX2D zurück, welche die 2D-Ausdehnung der Geometrie abbildet.
  • Box3D - Gibt eine BOX3D zurück, welche die 3D-Ausdehnung der Geometrie abbildet.
  • Box3D - Stellt das umschreibende Rechteck eines Raster als Box3D dar.
  • ST_3DExtent - Eine Aggregatfunktion, welche das umschreibende Rechteck einer Geometrie in 3D zurückgibt.
  • ST_3DMakeBox - Erzeugt eine BOX3D aus den angegebenen beiden 3D-Punkten.
  • ST_AsMVTGeom - Transformiert eine Geometrie in das Koordinatensystem eines Mapbox Vector Tiles.
  • ST_AsTWKB - Gibt die Geometrie als TWKB, aka "Tiny Well-known Binary" zurück
  • ST_Box2dFromGeoHash - Gibt die BOX2D einer GeoHash Zeichenkette zurück.
  • ST_ClipByBox2D - Gibt jenen Teil der Geometrie zurück, der innerhalb eines Rechteckes liegt.
  • ST_EstimatedExtent - Gibt die 'geschätzte' Ausdehnung einer räumlichen Tabelle zurück.
  • ST_Expand - Gibt ein umschreibendes Rechteck zurück, das entsprechend eines anderen umschreibenden Rechtecks oder einer Geometrie ausgedehnt wurde.
  • ST_Extent - Eine Aggregatfunktion, welche das umschreibende Rechteck von Geometriezeilen zurückgibt.
  • ST_MakeBox2D - Erzeugt eine BOX2D, durch Angabe von zwei 2D-Punkten.
  • ST_XMax - Gibt das größte X eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_XMin - Gibt das kleinste X eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_YMax - Gibt das größte Y eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_YMin - Gibt das kleinste Y eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_ZMax - Gibt das größte Z eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_ZMin - Gibt das kleinste Z eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ~(box2df,box2df) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält.
  • ~(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält.
  • ~(geometry,box2df) - Gibt TRUE zurück, wenn die 2D bounding box einer Geometrie eine 2D float precision bounding box (GIDX) enthält.
  • @(box2df,box2df) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist.
  • @(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist..
  • @(geometry,box2df) - Gibt TRUE zurück, wenn die 2D Bounding Box einer Geometrie in einer 2D float precision Bbounding Box (BOX2DF) enthalten ist.
  • &&(box2df,box2df) - Gibt TRUE zurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden.
  • &&(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet.
  • &&(geometry,box2df) - Gibt TRUE zurück, wenn sich die 2D Bounding Box (cached) einer Geometrie mit einer 2D Bounding Box mit Gleitpunktgenauigkeit (BOX2DF) überschneidet.

14.8. PostGIS Functions that support 3D

The functions given below are PostGIS functions that do not throw away the Z-Index.

  • AddGeometryColumn - Fügt einer bestehenden Tabelle eine geometrische Spalte hinzu.
  • Box3D - Gibt eine BOX3D zurück, welche die 3D-Ausdehnung der Geometrie abbildet.
  • DropGeometryColumn - Entfernt eine Geometriespalte aus einer räumlichen Tabelle.
  • GeometryType - Gibt den Geometrietyp als Text zurück.
  • ST_3DArea - Berechnet die Fläche von 3D-Oberflächengeometrien. Gibt 0 für Solids zurück.
  • ST_3DClosestPoint - Gibt den 3D-Punkt auf g1 zurück, der den kürzesten Abstand zu g2 hat. Dies ist der Anfangspunkt der kürzesten Verbindungslinie in 3D.
  • ST_3DDFullyWithin - Gibt TRUE zurück, wenn sich die gesamte 3D-Geometrie innerhalb einer bestimmten Entfernung zueinander befindet.
  • ST_3DDWithin - Für den geometrischen Datentyp in 3D (z). Gibt TRUE zurück, wenn die 3D-Distanz zwischen zwei geometrischen Objekten innerhalb der gegebenen Einheiten liegt.
  • ST_3DDifference - Errechnet die Differenzmenge in 3D
  • ST_3DDistance - Gibt die kürzeste kartesische 3D-Entfernung (basierend auf dem Koordinatenreferenzsystem) in projizierten Einheiten zwischen zwei geometrischen Objekten zurück.
  • ST_3DExtent - Eine Aggregatfunktion, welche das umschreibende Rechteck einer Geometrie in 3D zurückgibt.
  • ST_3DIntersection - Führt eine Verschneidung in 3D aus
  • ST_3DIntersects - Gibt TRUE zurück, wenn sich die geometrischen Objekte in 3D "räumlich schneiden" - nur für Punkte, Linienzüge, Polygone und polyedrische Oberflächen (Flächen).
  • ST_3DLength - Gibt die 3D-Länge einer Liniengeometrie zurück.
  • ST_3DLongestLine - Gibt die längste 3D-Verbindungslinie zwischen zwei geometrischen Objekten zurück.
  • ST_3DMaxDistance - Gibt die größte kartesische 3D-Entfernung (basierend auf dem Koordinatenreferenzsystem) in projizierten Einheiten zwischen zwei geometrischen Objekten zurück.
  • ST_3DPerimeter - Gibt den 3D-Umfang einer Polygongeometrie zurück.
  • ST_3DShortestLine - Gibt die kürzeste Verbindungslinie in 3D zwischen zwei geometrischen Objekten zurück.
  • ST_3DUnion - Führt eine Vereinigung/Union in 3D aus
  • ST_AddMeasure - Gibt eine abgeleitete Geometrie mit einer zwischen Anfangs- und Endpunkt linear interpolierten Kilometrierung zurück.
  • ST_AddPoint - Fügt einem Linienzug einen Punkt hinzu.
  • ST_Affine - Wendet eine affine 3D-Transformation auf die Geometrie an.
  • ST_ApproximateMedialAxis - Errechnet die genäherte Mediale Achse einer Flächengeometrie.
  • ST_AsBinary - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
  • ST_AsEWKB - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie mit den SRID Metadaten zurück.
  • ST_AsEWKT - Gibt die Well-known-Text(WKT) Darstellung der Geometrie mit den SRID-Metadaten zurück.
  • ST_AsGML - Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
  • ST_AsGeoJSON - Gibt die Geometrie eines GeoJSON Elements zurück.
  • ST_AsHEXEWKB - Gibt eine Geometrie im HEXEWKB Format (als Text) aus; verwendet entweder die Little-Endian (NDR) oder die Big-Endian (XDR) Zeichenkodierung.
  • ST_AsKML - Gibt die Geometrie als KML-Element aus. Mehrere Varianten. Standardmäßig ist Version=2 und maxdecimaldigits=15 voreingestellt
  • ST_AsX3D - Gibt eine Geometrie im X3D XML Knotenelement-Format zurück: ISO-IEC-19776-1.2-X3DEncodings-XML
  • ST_Boundary - Gibt den Rand einer Geometrie zurück.
  • ST_BoundingDiagonal - Gibt die Diagonale des umschreibenden Rechtecks einer Geometrie zurück.
  • ST_CPAWithin - Gibt true zurück, wenn die engste Annäherung zweier Trajektorien innerhalb der gegebenen Entfernung liegt.
  • ST_ClosestPointOfApproach - Gibt die Maßzahl zurück, bei der sich zwei Trajektorien am nächsten kommen.
  • ST_Collect - Wandelt eine Geometrie in eine Sammel- oder Mehrfachgeometrie um.
  • ST_ConstrainedDelaunayTriangles - Gibt eine eingeschränkte Delaunay-Triangulierung um die gegebene Geometrie herum aus.
  • ST_ConvexHull - Berechnet die konvexe Hülle einer Geometrie.
  • ST_CoordDim - Gibt die Dimension der Koordinaten einer Geometrie zurück.
  • ST_CurveToLine - Wandelt einen CIRCULARSTRING/CURVEPOLYGON/MULTISURFACE in ein LINESTRING/POLYGON/MULTIPOLYGON um
  • ST_DelaunayTriangles - Gibt die Delaunay-Triangulierung für gegebene Punkte zurück.
  • ST_Difference - Gibt eine Geometrie zurück, die jenen Teil der Geometrie A abbildet, der sich nicht mit der Geometrie B überschneidet.
  • ST_DistanceCPA - Gibt die Entfernung zurück, bei der sich zwei Trajektorien am nächsten kommen.
  • ST_Dump - Gibt die Menge an geometry_dump Zeilen für die Bestandteile einer Geometrie zurück.
  • ST_DumpPoints - Gibt die Menge an geometry_dump Zeilen für die Punkte einer Geometrie zurück.
  • ST_DumpRings - Gibt die Menge an geometry_dump Zeilen für die äußeren und inneren Ringe eines Polygons zurück.
  • ST_EndPoint - Gibt den Endpunkt eines LineString oder CircularLineString zurück.
  • ST_ExteriorRing - Gibt den äußeren Ring eines Polygons als LineString zurück.
  • ST_Extrude - Weitet eine Oberfläche auf ein entsprechendes Volumen aus
  • ST_FlipCoordinates - Gibt eine Version der gegebenen Geometrie zurück, wobei die X und Y Achse vertauscht sind. Nützlich wenn man Geoobjekte in Breite/Länge vorliegen hat und dies beheben möchte.
  • ST_Force2D - Die Geometrien in einen "2-dimensionalen Modus" zwingen.
  • ST_ForceCurve - Wandelt einen geometrischen in einen Kurven Datentyp um, soweit anwendbar.
  • ST_ForceLHR - Erzwingt LHR Orientierung
  • ST_ForcePolygonCCW - Richtet alle äußeren Ringe gegen den Uhrzeigersinn und alle inneren Ringe mit dem Uhrzeigersinn aus.
  • ST_ForcePolygonCW - Richtet alle äußeren Ringe im Uhrzeigersinn und alle inneren Ringe gegen den Uhrzeigersinn aus.
  • ST_ForceRHR - Orientiert die Knoten in einem Polygon so, dass sie der Drei-Finger-Regel folgen.
  • ST_ForceSFS - Erzwingt, dass Geometrien nur vom Typ SFS 1.1 sind.
  • ST_Force_3D - Zwingt die Geometrien in einen XYZ Modus. Dies ist ein Alias für ST_Force3DZ.
  • ST_Force_3DZ - Zwingt die Geometrien in einen XYZ Modus.
  • ST_Force_4D - Zwingt die Geometrien in einen XYZM Modus.
  • ST_Force_Collection - Wandelt eine Geometrie in eine GEOMETRYCOLLECTION um.
  • ST_GeomFromEWKB - Gibt einen geometrischen Datentyp (ST_Geometry) aus einer Well-known-Binary (WKB) Darstellung zurück.
  • ST_GeomFromEWKT - Gibt einen spezifizierten ST_Geometry-Wert von einer erweiterten Well-known-Text Darstellung (EWKT) zurück.
  • ST_GeomFromGML - Nimmt als Eingabe eine GML-Darstellung der Geometrie und gibt ein geometrisches PostGIS-Objekt aus.
  • ST_GeomFromGeoJSON - Nimmt als Eingabe eine GeoJSON-Darstellung der Geometrie und gibt ein geometrisches PostGIS-Objekt aus.
  • ST_GeomFromKML - Nimmt als Eingabe eine KML-Darstellung der Geometrie und gibt ein geometrisches PostGIS-Objekt aus.
  • ST_GeometricMedian - Gibt den geometrischen Median eines Mehrfachpunktes zurück.
  • ST_GeometryN - Gibt das n-te geometrische Element einer Sammelgeometrie zurück.
  • ST_GeometryType - Gibt den Geometrietyp nach SQL-MM als Text zurück.
  • ST_HasArc - Prüft ob eine Geometrie einen Kreisbogen enthält
  • ST_InteriorRingN - Gibt den n-ten inneren Ring (Loch) eines Polygons zurück.
  • ST_InterpolatePoint - Für einen gegebenen Punkt wird die Kilometrierung auf dem nächstliegenden Punkt einer Geometrie zurück.
  • ST_IsClosed - Überprüft ob der Anfangspunkt und der Endpunkt eines LineString's zusammenfallen. Bei einem PolyhedralSurface wird überprüft ob es geschlossen (volumetrisch) ist.
  • ST_IsCollection - Überprüft ob der geometrische Datentyp eine Sammelgeometrie ist.
  • ST_IsPlanar - Überprüft ob es sich um eine ebene Oberfläche handelt oder nicht
  • ST_IsPolygonCCW - Überprüft ob die äußeren Ringe der Polygone gegen den Uhrzeigersinn und die inneren Ringe im Uhrzeigersinn ausgerichtet sind.
  • ST_IsPolygonCW - Überprüft ob die äußeren Ringe der Polygone im Uhrzeigersinn und die inneren Ringe gegen den Uhrzeigersinn ausgerichtet sind.
  • ST_IsSimple - Überprüft ob eine Geometrie keine Stellen mit Selbstüberschneidungen oder Selbstberührungen aufweist.
  • ST_IsSolid - Überprüft ob die Geometrie ein Solid ist. Es wird keine Plausibilitätsprüfung durchgeführt.
  • ST_IsValidTrajectory - Gibt TRUE zurück, wenn die Geometrie eine valide Trajektorie ist.
  • ST_Length_Spheroid - Gibt die 2D- oder 3D-Länge/Umfang einer über Länge und Breite gegebenen Geometrie auf einem Referenzellipsoid zurück.
  • ST_LineFromMultiPoint - Erzeugt einen LineString aus einer MultiPoint Geometrie.
  • ST_LineInterpolatePoint - Fügt einen Punkt entlang einer Linie ein. Der zweite Parameter, in Float8-Darstellung mit den Werten von 0 bis 1, gibt jenen Bruchteil der Gesamtlänge des Linienzuges an, wo der Punkt liegen soll.
  • ST_LineInterpolatePoints - Gibt einen oder mehrere, entlang einer Linie interpolierte Punkte zurück.
  • ST_LineSubstring - Gibt ein Linienstück zurück, dass ein Teil des gegebenen Linienzuges ist und den Anfang und das Ende an gegebenen Anteilen der 2D-Gesamtlänge hat. Der zweite und der dritte Übergabewert sind Werte in float8 zwischen 0 und 1.
  • ST_LineToCurve - Wandelt einen LINESTRING/POLYGON in einen CIRCULARSTRING, CURVEPOLYGON um
  • ST_LocateBetweenElevations - Gibt einen abgeleiteten Sammelgeometriewert mit den Elementen zurück, die das gegebenen Intervall schneiden.
  • ST_M - Gibt die M-Koordinate eines Punktes zurück.
  • ST_MakeLine - Erzeugt eine Linie aus einer Punkt-, Mehrfachpunkt- oder Liniengeometrie.
  • ST_MakePoint - Erzeugt einen 2D-, 3DZ- oder 4D-Punkt.
  • ST_MakePolygon - Erstellt ein Polygon aus einer Hülle und einer optionalen Liste mit Aussparungen.
  • ST_MakeSolid - Wandelt die Geometrie in ein Solid um. Es wird keine Überprüfung durchgeführt. Um ein gültiges Solid zu erhalten muss die eingegebene Geometrie entweder eine geschlossene polyedrische Oberfläche oder ein geschlossenes TIN sein.
  • ST_MakeValid - Versucht eine ungültige Geometrie, ohne den Verlust an Knoten zu bereinigen.
  • ST_MemSize - Gibt den Arbeitsspeicherplatzbedarf aus den die Geometrie benötigt.
  • ST_MemUnion - Das gleiche wie ST_Union, nur freundlicher zum Arbeitsspeicher (verwendet weniger Arbeitsspeicher und mehr Rechnerzeit).
  • ST_NDims - Gibt die Dimension der Koordinaten einer Geometrie zurück.
  • ST_NPoints - Gibt die Anzahl der Punkte (Knoten) einer Geometrie zurück.
  • ST_NRings - Gibt die Anzahl der Ringe einer Polygongeometrie aus.
  • ST_Node - Knotenberechnung für eine Menge von Linienzügen.
  • ST_NumGeometries - Gibt die Anzahl der Elemente einer Sammelgeometrie zurück.
  • ST_NumPatches - Gibt die Anzahl der Maschen einer polyedrischen Oberfläche aus. Gibt NULL zurück, wenn es sich nicht um polyedrische Geometrien handelt.
  • ST_Orientation - Bestimmt die Ausrichtung der Fläche
  • ST_PatchN - Gibt die n-te Geometrie (Masche) einer polyedrischen Oberfläche zurück.
  • ST_PointFromWKB - Erzeugt eine Geometrie mit gegebener SRID von WKB.
  • ST_PointN - Gibt den n-ten Punkt einer Linie oder eines Kreisbogens als Geometrie zurück.
  • ST_PointOnSurface - Gibt einen POINT zurück, der garantiert auf der Oberfläche liegt.
  • ST_Points - Gibt einen MultiPoint mit allen Koordinaten einer Geometrie zurück.
  • ST_Polygon - Erstellt ein Polygon aus einer Linie mit festgelegter SRID.
  • ST_RemovePoint - Entfernt einen Punkt aus einem Linienzug.
  • ST_RemoveRepeatedPoints - Gibt eine Version der Eingabegeometrie zurück, wobei duplizierte Punkte entfernt werden.
  • ST_Reverse - Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
  • ST_Rotate - Dreht eine Geometrie um den Ursprungspunkt.
  • ST_RotateX - Dreht eine Geometrie um die X-Achse.
  • ST_RotateY - Dreht eine Geometrie um die Y-Achse.
  • ST_RotateZ - Dreht eine Geometrie um die Z-Achse.
  • ST_Scale - Skaliert eine Geometrie anhand der gegebenen Faktoren.
  • ST_SetPoint - Einen Punkt eines Linienzuges durch einen gegebenen Punkt ersetzen.
  • ST_Shift_Longitude - Schaltet geometrische Koordinaten zwischen den Bereichen -180..180 und 0..360 um.
  • ST_SnapToGrid - Fängt alle Punkte der Eingabegeometrie auf einem regelmäßigen Gitter.
  • ST_StartPoint - Gibt den Anfangspunkt einer Linie zurück.
  • ST_StraightSkeleton - Berechnet aus einer Geometrie ein "Gerippe" aus Geraden.
  • ST_SwapOrdinates - Gibt eine Version der Ausgangsgeometrie zurück, in der die angegebenen Ordinatenwerte ausgetauscht werden.
  • ST_SymDifference - Gibt eine Geometrie zurück, die jene Teile von A und B repräsentiert, die sich nicht überlagern. Wird symmetrische Differenz genannt, da ST_SymDifference(A,B) = ST_SymDifference(B,A).
  • ST_Tesselate - Erzeugt ein Oberflächen-Mosaik aus einem Polygon oder einer polyedrischen Oberfläche und gibt dieses als TIN oder als TIN-Kollektion zurück
  • ST_TransScale - Verschiebt und skaliert eine Geometrie um die angegebenen Versätze und Faktoren.
  • ST_Translate - Verschiebt eine Geometrie um die gegebenen Versätze.
  • ST_UnaryUnion - Wie ST_Union, arbeitet aber auf der Ebene der Geometriebestandteile.
  • ST_Volume - Berechnet das Volumen eines 3D-Solids. Auf Oberflächengeometrien (auch auf geschlossene) angewandt wird 0 zurückgegeben.
  • ST_WrapX - Versammelt eine Geometrie um einen X-Wert
  • ST_X - Gibt die X-Koordinate eines Punktes zurück.
  • ST_XMax - Gibt das größte X eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_XMin - Gibt das kleinste X eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_Y - Gibt die Y-Koordinate eines Punktes zurück.
  • ST_YMax - Gibt das größte Y eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_YMin - Gibt das kleinste Y eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_Z - Gibt die Z-Koordinate eines Punktes zurück.
  • ST_ZMax - Gibt das größte Z eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_ZMin - Gibt das kleinste Z eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_Zmflag - Gibt einen Code zurück, der die Dimension der ZM-Koordinaten der Geometrie anzeigt.
  • TG_Equals - Gibt TRUE zurück, wenn zwei TopoGeometry Objekte aus denselben topologischen Elementarstrukturen bestehen.
  • TG_Intersects - Gibt TRUE zurück, wenn sich kein beliebiges Paar von Elemtarstrukturen zweier TopoGeometry Objekte überschneidet.
  • UpdateGeometrySRID - Aktualisiert die SRID von allen Geo-Objekten einer Geometriespalte und die Metadaten der Tabelle.
  • geometry_overlaps_nd - Gibt TRUE zurück, wenn A's n-D bounding box B's n-D bounding box schneidet.
  • overlaps_nd_geometry_gidx - Gibt TRUE zurück, wenn die (cached) n-D bounding box einer Geometrie eine n-D float precision bounding box (GIDX) schneidet.
  • overlaps_nd_gidx_geometry - Gibt TRUE zurück, wenn eine n-D float precision bounding box (GIDX) eine (cached) n-D bounding box einer Geometrie schneidet.
  • overlaps_nd_gidx_gidx - Gibt TRUE zurück, wenn sich zwei n-D float precision bounding boxes (GIDX) gegenseitig überschneiden.
  • postgis_sfcgal_version - Gibt die verwendete Version von SFCGAL aus

14.9. PostGIS Curved Geometry Support Functions

The functions given below are PostGIS functions that can use CIRCULARSTRING, CURVEPOLYGON, and other curved geometry types

  • AddGeometryColumn - Fügt einer bestehenden Tabelle eine geometrische Spalte hinzu.
  • Box2D - Gibt eine BOX2D zurück, welche die 2D-Ausdehnung der Geometrie abbildet.
  • Box3D - Gibt eine BOX3D zurück, welche die 3D-Ausdehnung der Geometrie abbildet.
  • DropGeometryColumn - Entfernt eine Geometriespalte aus einer räumlichen Tabelle.
  • GeometryType - Gibt den Geometrietyp als Text zurück.
  • PostGIS_AddBBox - Fügt der Geometrie ein umschreibendes Rechteck bei.
  • PostGIS_DropBBox - Löscht die umschreibenden Rechtecke der Geometrie.
  • PostGIS_HasBBox - Gibt TRUE zurück, wenn die BBox der Geometrie zwischengespeichert ist, andernfalls wird FALSE zurückgegeben.
  • ST_3DExtent - Eine Aggregatfunktion, welche das umschreibende Rechteck einer Geometrie in 3D zurückgibt.
  • ST_Affine - Wendet eine affine 3D-Transformation auf die Geometrie an.
  • ST_AsBinary - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
  • ST_AsEWKB - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie mit den SRID Metadaten zurück.
  • ST_AsEWKT - Gibt die Well-known-Text(WKT) Darstellung der Geometrie mit den SRID-Metadaten zurück.
  • ST_AsHEXEWKB - Gibt eine Geometrie im HEXEWKB Format (als Text) aus; verwendet entweder die Little-Endian (NDR) oder die Big-Endian (XDR) Zeichenkodierung.
  • ST_AsText - Gibt die Well-known-Text(WKT) Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
  • ST_Collect - Wandelt eine Geometrie in eine Sammel- oder Mehrfachgeometrie um.
  • ST_CoordDim - Gibt die Dimension der Koordinaten einer Geometrie zurück.
  • ST_CurveToLine - Wandelt einen CIRCULARSTRING/CURVEPOLYGON/MULTISURFACE in ein LINESTRING/POLYGON/MULTIPOLYGON um
  • ST_Distance - Gibt die Entfernung zwischen zwei geometrischen oder geographischen Datensätzen zurück.
  • ST_Dump - Gibt die Menge an geometry_dump Zeilen für die Bestandteile einer Geometrie zurück.
  • ST_DumpPoints - Gibt die Menge an geometry_dump Zeilen für die Punkte einer Geometrie zurück.
  • ST_EndPoint - Gibt den Endpunkt eines LineString oder CircularLineString zurück.
  • ST_EstimatedExtent - Gibt die 'geschätzte' Ausdehnung einer räumlichen Tabelle zurück.
  • ST_FlipCoordinates - Gibt eine Version der gegebenen Geometrie zurück, wobei die X und Y Achse vertauscht sind. Nützlich wenn man Geoobjekte in Breite/Länge vorliegen hat und dies beheben möchte.
  • ST_Force2D - Die Geometrien in einen "2-dimensionalen Modus" zwingen.
  • ST_ForceCurve - Wandelt einen geometrischen in einen Kurven Datentyp um, soweit anwendbar.
  • ST_ForceSFS - Erzwingt, dass Geometrien nur vom Typ SFS 1.1 sind.
  • ST_Force3D - Zwingt die Geometrien in einen XYZ Modus. Dies ist ein Alias für ST_Force3DZ.
  • ST_Force3DM - Zwingt die Geometrien in einen XYM Modus.
  • ST_Force3DZ - Zwingt die Geometrien in einen XYZ Modus.
  • ST_Force4D - Zwingt die Geometrien in einen XYZM Modus.
  • ST_ForceCollection - Wandelt eine Geometrie in eine GEOMETRYCOLLECTION um.
  • ST_GeoHash - Gibt die Geometrie in der GeoHash Darstellung aus.
  • ST_GeogFromWKB - Erzeugt ein geographisches Objekt aus der Well-known-Binary (WKB) oder der erweiterten Well-known-Binary (EWKB) Darstellung.
  • ST_GeomFromEWKB - Gibt einen geometrischen Datentyp (ST_Geometry) aus einer Well-known-Binary (WKB) Darstellung zurück.
  • ST_GeomFromEWKT - Gibt einen spezifizierten ST_Geometry-Wert von einer erweiterten Well-known-Text Darstellung (EWKT) zurück.
  • ST_GeomFromText - Gibt einen spezifizierten ST_Geometry Wert aus einer Well-known-Text Darstellung (WKT) zurück.
  • ST_GeomFromWKB - Erzeugt ein geometrisches Objekt aus der Well-known-Binary (WKB) Darstellung und einer optionalen SRID.
  • ST_GeometryN - Gibt das n-te geometrische Element einer Sammelgeometrie zurück.
  • = - Gibt TRUE zurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind.
  • &<| - Gibt TRUE zurück, wenn die bounding box von A jene von B überlagert oder unterhalb liegt.
  • ST_HasArc - Prüft ob eine Geometrie einen Kreisbogen enthält
  • ST_IsClosed - Überprüft ob der Anfangspunkt und der Endpunkt eines LineString's zusammenfallen. Bei einem PolyhedralSurface wird überprüft ob es geschlossen (volumetrisch) ist.
  • ST_IsCollection - Überprüft ob der geometrische Datentyp eine Sammelgeometrie ist.
  • ST_IsEmpty - Überprüft ob die Geometrie leer ist.
  • ST_LineToCurve - Wandelt einen LINESTRING/POLYGON in einen CIRCULARSTRING, CURVEPOLYGON um
  • ST_MemSize - Gibt den Arbeitsspeicherplatzbedarf aus den die Geometrie benötigt.
  • ST_NPoints - Gibt die Anzahl der Punkte (Knoten) einer Geometrie zurück.
  • ST_NRings - Gibt die Anzahl der Ringe einer Polygongeometrie aus.
  • ST_PointFromWKB - Erzeugt eine Geometrie mit gegebener SRID von WKB.
  • ST_PointN - Gibt den n-ten Punkt einer Linie oder eines Kreisbogens als Geometrie zurück.
  • ST_Points - Gibt einen MultiPoint mit allen Koordinaten einer Geometrie zurück.
  • ST_Rotate - Dreht eine Geometrie um den Ursprungspunkt.
  • ST_RotateZ - Dreht eine Geometrie um die Z-Achse.
  • ST_SRID - Gibt den Identifikator des Koordinatenreferenzsystems, wie in der spatial_ref_sys Tabelle definiert, für die ST_Geometry aus.
  • ST_Scale - Skaliert eine Geometrie anhand der gegebenen Faktoren.
  • ST_SetSRID - Weist der SRID einer Geometrie einen bestimmten Ganzzahlwert zu.
  • ST_StartPoint - Gibt den Anfangspunkt einer Linie zurück.
  • ST_Summary - Gibt eine textliche Zusammenfassung des Inhalts einer Geometrie wieder.
  • ST_SwapOrdinates - Gibt eine Version der Ausgangsgeometrie zurück, in der die angegebenen Ordinatenwerte ausgetauscht werden.
  • ST_TransScale - Verschiebt und skaliert eine Geometrie um die angegebenen Versätze und Faktoren.
  • ST_Transform - Gibt eine neue Geometrie zurück, bei der die Koordinaten in ein anderes Koordinatenreferenzsystem projiziert wurden.
  • ST_Translate - Verschiebt eine Geometrie um die gegebenen Versätze.
  • ST_XMax - Gibt das größte X eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_XMin - Gibt das kleinste X eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_YMax - Gibt das größte Y eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_YMin - Gibt das kleinste Y eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_ZMax - Gibt das größte Z eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_ZMin - Gibt das kleinste Z eines Umgebungsrechtecks in 2D, 3D oder einer Geometrie zurück.
  • ST_Zmflag - Gibt einen Code zurück, der die Dimension der ZM-Koordinaten der Geometrie anzeigt.
  • UpdateGeometrySRID - Aktualisiert die SRID von allen Geo-Objekten einer Geometriespalte und die Metadaten der Tabelle.
  • ~(box2df,box2df) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält.
  • ~(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält.
  • ~(geometry,box2df) - Gibt TRUE zurück, wenn die 2D bounding box einer Geometrie eine 2D float precision bounding box (GIDX) enthält.
  • && - Gibt TRUE zurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B schneidet.
  • &&& - Gibt TRUE zurück, wenn A's n-D bounding box B's n-D bounding box schneidet.
  • @(box2df,box2df) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist.
  • @(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist..
  • @(geometry,box2df) - Gibt TRUE zurück, wenn die 2D Bounding Box einer Geometrie in einer 2D float precision Bbounding Box (BOX2DF) enthalten ist.
  • &&(box2df,box2df) - Gibt TRUE zurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden.
  • &&(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet.
  • &&(geometry,box2df) - Gibt TRUE zurück, wenn sich die 2D Bounding Box (cached) einer Geometrie mit einer 2D Bounding Box mit Gleitpunktgenauigkeit (BOX2DF) überschneidet.
  • &&&(geometry,gidx) - Gibt TRUE zurück, wenn die (cached) n-D bounding box einer Geometrie eine n-D float precision bounding box (GIDX) schneidet.
  • &&&(gidx,geometry) - Gibt TRUE zurück, wenn eine n-D float precision bounding box (GIDX) eine (cached) n-D bounding box einer Geometrie schneidet.
  • &&&(gidx,gidx) - Gibt TRUE zurück, wenn sich zwei n-D float precision bounding boxes (GIDX) gegenseitig überschneiden.

14.10. PostGIS Polyhedral Surface Support Functions

The functions given below are PostGIS functions that can use POLYHEDRALSURFACE, POLYHEDRALSURFACEM geometries

  • Box2D - Gibt eine BOX2D zurück, welche die 2D-Ausdehnung der Geometrie abbildet.
  • Box3D - Gibt eine BOX3D zurück, welche die 3D-Ausdehnung der Geometrie abbildet.
  • GeometryType - Gibt den Geometrietyp als Text zurück.
  • ST_3DArea - Berechnet die Fläche von 3D-Oberflächengeometrien. Gibt 0 für Solids zurück.
  • ST_3DClosestPoint - Gibt den 3D-Punkt auf g1 zurück, der den kürzesten Abstand zu g2 hat. Dies ist der Anfangspunkt der kürzesten Verbindungslinie in 3D.
  • ST_3DDFullyWithin - Gibt TRUE zurück, wenn sich die gesamte 3D-Geometrie innerhalb einer bestimmten Entfernung zueinander befindet.
  • ST_3DDWithin - Für den geometrischen Datentyp in 3D (z). Gibt TRUE zurück, wenn die 3D-Distanz zwischen zwei geometrischen Objekten innerhalb der gegebenen Einheiten liegt.
  • ST_3DDifference - Errechnet die Differenzmenge in 3D
  • ST_3DDistance - Gibt die kürzeste kartesische 3D-Entfernung (basierend auf dem Koordinatenreferenzsystem) in projizierten Einheiten zwischen zwei geometrischen Objekten zurück.
  • ST_3DExtent - Eine Aggregatfunktion, welche das umschreibende Rechteck einer Geometrie in 3D zurückgibt.
  • ST_3DIntersection - Führt eine Verschneidung in 3D aus
  • ST_3DIntersects - Gibt TRUE zurück, wenn sich die geometrischen Objekte in 3D "räumlich schneiden" - nur für Punkte, Linienzüge, Polygone und polyedrische Oberflächen (Flächen).
  • ST_3DLongestLine - Gibt die längste 3D-Verbindungslinie zwischen zwei geometrischen Objekten zurück.
  • ST_3DMaxDistance - Gibt die größte kartesische 3D-Entfernung (basierend auf dem Koordinatenreferenzsystem) in projizierten Einheiten zwischen zwei geometrischen Objekten zurück.
  • ST_3DShortestLine - Gibt die kürzeste Verbindungslinie in 3D zwischen zwei geometrischen Objekten zurück.
  • ST_3DUnion - Führt eine Vereinigung/Union in 3D aus
  • ST_Affine - Wendet eine affine 3D-Transformation auf die Geometrie an.
  • ST_ApproximateMedialAxis - Errechnet die genäherte Mediale Achse einer Flächengeometrie.
  • ST_Area - Gibt die Fläche einer Polygongeometrie zurück.
  • ST_AsBinary - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
  • ST_AsEWKB - Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie mit den SRID Metadaten zurück.
  • ST_AsEWKT - Gibt die Well-known-Text(WKT) Darstellung der Geometrie mit den SRID-Metadaten zurück.
  • ST_AsGML - Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
  • ST_AsX3D - Gibt eine Geometrie im X3D XML Knotenelement-Format zurück: ISO-IEC-19776-1.2-X3DEncodings-XML
  • ST_CoordDim - Gibt die Dimension der Koordinaten einer Geometrie zurück.
  • ST_Dimension - Gibt die topologische Dimension einer Geometrie zurück.
  • ST_Dump - Gibt die Menge an geometry_dump Zeilen für die Bestandteile einer Geometrie zurück.
  • ST_DumpPoints - Gibt die Menge an geometry_dump Zeilen für die Punkte einer Geometrie zurück.
  • ST_Expand - Gibt ein umschreibendes Rechteck zurück, das entsprechend eines anderen umschreibenden Rechtecks oder einer Geometrie ausgedehnt wurde.
  • ST_Extent - Eine Aggregatfunktion, welche das umschreibende Rechteck von Geometriezeilen zurückgibt.
  • ST_Extrude - Weitet eine Oberfläche auf ein entsprechendes Volumen aus
  • ST_FlipCoordinates - Gibt eine Version der gegebenen Geometrie zurück, wobei die X und Y Achse vertauscht sind. Nützlich wenn man Geoobjekte in Breite/Länge vorliegen hat und dies beheben möchte.
  • ST_Force2D - Die Geometrien in einen "2-dimensionalen Modus" zwingen.
  • ST_ForceLHR - Erzwingt LHR Orientierung
  • ST_ForceRHR - Orientiert die Knoten in einem Polygon so, dass sie der Drei-Finger-Regel folgen.
  • ST_ForceSFS - Erzwingt, dass Geometrien nur vom Typ SFS 1.1 sind.
  • ST_Force3D - Zwingt die Geometrien in einen XYZ Modus. Dies ist ein Alias für ST_Force3DZ.
  • ST_Force3DZ - Zwingt die Geometrien in einen XYZ Modus.
  • ST_ForceCollection - Wandelt eine Geometrie in eine GEOMETRYCOLLECTION um.
  • ST_GeomFromEWKB - Gibt einen geometrischen Datentyp (ST_Geometry) aus einer Well-known-Binary (WKB) Darstellung zurück.
  • ST_GeomFromEWKT - Gibt einen spezifizierten ST_Geometry-Wert von einer erweiterten Well-known-Text Darstellung (EWKT) zurück.
  • ST_GeomFromGML - Nimmt als Eingabe eine GML-Darstellung der Geometrie und gibt ein geometrisches PostGIS-Objekt aus.
  • ST_GeometryN - Gibt das n-te geometrische Element einer Sammelgeometrie zurück.
  • ST_GeometryType - Gibt den Geometrietyp nach SQL-MM als Text zurück.
  • = - Gibt TRUE zurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind.
  • &<| - Gibt TRUE zurück, wenn die bounding box von A jene von B überlagert oder unterhalb liegt.
  • ~= - Gibt TRUE zurück, wenn die bounding box von A ident mit jener von B ist.
  • ST_IsClosed - Überprüft ob der Anfangspunkt und der Endpunkt eines LineString's zusammenfallen. Bei einem PolyhedralSurface wird überprüft ob es geschlossen (volumetrisch) ist.
  • ST_IsPlanar - Überprüft ob es sich um eine ebene Oberfläche handelt oder nicht
  • ST_IsSolid - Überprüft ob die Geometrie ein Solid ist. Es wird keine Plausibilitätsprüfung durchgeführt.
  • ST_MakeSolid - Wandelt die Geometrie in ein Solid um. Es wird keine Überprüfung durchgeführt. Um ein gültiges Solid zu erhalten muss die eingegebene Geometrie entweder eine geschlossene polyedrische Oberfläche oder ein geschlossenes TIN sein.
  • ST_MemSize - Gibt den Arbeitsspeicherplatzbedarf aus den die Geometrie benötigt.
  • ST_NPoints - Gibt die Anzahl der Punkte (Knoten) einer Geometrie zurück.
  • ST_NumGeometries - Gibt die Anzahl der Elemente einer Sammelgeometrie zurück.
  • ST_NumPatches - Gibt die Anzahl der Maschen einer polyedrischen Oberfläche aus. Gibt NULL zurück, wenn es sich nicht um polyedrische Geometrien handelt.
  • ST_PatchN - Gibt die n-te Geometrie (Masche) einer polyedrischen Oberfläche zurück.
  • ST_RemoveRepeatedPoints - Gibt eine Version der Eingabegeometrie zurück, wobei duplizierte Punkte entfernt werden.
  • ST_Reverse - Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
  • ST_Rotate - Dreht eine Geometrie um den Ursprungspunkt.
  • ST_RotateX - Dreht eine Geometrie um die X-Achse.
  • ST_RotateY - Dreht eine Geometrie um die Y-Achse.
  • ST_RotateZ - Dreht eine Geometrie um die Z-Achse.
  • ST_Scale - Skaliert eine Geometrie anhand der gegebenen Faktoren.
  • ST_ShiftLongitude - Schaltet geometrische Koordinaten zwischen den Bereichen -180..180 und 0..360 um.
  • ST_StraightSkeleton - Berechnet aus einer Geometrie ein "Gerippe" aus Geraden.
  • ST_Summary - Gibt eine textliche Zusammenfassung des Inhalts einer Geometrie wieder.
  • ST_SwapOrdinates - Gibt eine Version der Ausgangsgeometrie zurück, in der die angegebenen Ordinatenwerte ausgetauscht werden.
  • ST_Tesselate - Erzeugt ein Oberflächen-Mosaik aus einem Polygon oder einer polyedrischen Oberfläche und gibt dieses als TIN oder als TIN-Kollektion zurück
  • ST_Transform - Gibt eine neue Geometrie zurück, bei der die Koordinaten in ein anderes Koordinatenreferenzsystem projiziert wurden.
  • ST_Volume - Berechnet das Volumen eines 3D-Solids. Auf Oberflächengeometrien (auch auf geschlossene) angewandt wird 0 zurückgegeben.
  • ~(box2df,box2df) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält.
  • ~(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält.
  • ~(geometry,box2df) - Gibt TRUE zurück, wenn die 2D bounding box einer Geometrie eine 2D float precision bounding box (GIDX) enthält.
  • && - Gibt TRUE zurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B schneidet.
  • &&& - Gibt TRUE zurück, wenn A's n-D bounding box B's n-D bounding box schneidet.
  • @(box2df,box2df) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist.
  • @(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist..
  • @(geometry,box2df) - Gibt TRUE zurück, wenn die 2D Bounding Box einer Geometrie in einer 2D float precision Bbounding Box (BOX2DF) enthalten ist.
  • &&(box2df,box2df) - Gibt TRUE zurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden.
  • &&(box2df,geometry) - Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet.
  • &&(geometry,box2df) - Gibt TRUE zurück, wenn sich die 2D Bounding Box (cached) einer Geometrie mit einer 2D Bounding Box mit Gleitpunktgenauigkeit (BOX2DF) überschneidet.
  • &&&(geometry,gidx) - Gibt TRUE zurück, wenn die (cached) n-D bounding box einer Geometrie eine n-D float precision bounding box (GIDX) schneidet.
  • &&&(gidx,geometry) - Gibt TRUE zurück, wenn eine n-D float precision bounding box (GIDX) eine (cached) n-D bounding box einer Geometrie schneidet.
  • &&&(gidx,gidx) - Gibt TRUE zurück, wenn sich zwei n-D float precision bounding boxes (GIDX) gegenseitig überschneiden.
  • postgis_sfcgal_version - Gibt die verwendete Version von SFCGAL aus

14.11. PostGIS Function Support Matrix

Below is an alphabetical listing of spatial specific functions in PostGIS and the kinds of spatial types they work with or OGC/SQL compliance they try to conform to.

  • A means the function works with the type or subtype natively.
  • A means it works but with a transform cast built-in using cast to geometry, transform to a "best srid" spatial ref and then cast back. Results may not be as expected for large areas or areas at poles and may accumulate floating point junk.
  • A means the function works with the type because of a auto-cast to another such as to box3d rather than direct type support.
  • A means the function only available if PostGIS compiled with SFCGAL support.
  • A means the function support is provided by SFCGAL if PostGIS compiled with SFCGAL support, otherwise GEOS/built-in support.
  • geom - Basic 2D geometry support (x,y).
  • geog - Basic 2D geography support (x,y).
  • 2.5D - basic 2D geometries in 3 D/4D space (has Z or M coord).
  • PS - Polyhedral surfaces
  • T - Triangles and Triangulated Irregular Network surfaces (TIN)

Functiongeomgeog2.5DCurvesSQL MMPST
Box2D    
Box3D   
GeometryType   
PostGIS_AddBBox      
PostGIS_DropBBox      
PostGIS_Extensions_Upgrade        
PostGIS_Full_Version        
PostGIS_GEOS_Version        
PostGIS_HasBBox      
PostGIS_LibXML_Version        
PostGIS_Lib_Build_Date        
PostGIS_Lib_Version        
PostGIS_Liblwgeom_Version        
PostGIS_PROJ_Version        
PostGIS_Scripts_Build_Date        
PostGIS_Scripts_Installed        
PostGIS_Scripts_Released        
PostGIS_Version        
PostGIS_Wagyu_Version        
ST_3DArea    
ST_3DClosestPoint     
ST_3DDifference    
ST_3DDistance    
ST_3DExtent   
ST_3DIntersection    
ST_3DLength      
ST_3DLineInterpolatePoint       
ST_3DLongestLine     
ST_3DMakeBox       
ST_3DMaxDistance     
ST_3DPerimeter      
ST_3DShortestLine     
ST_3DUnion    
ST_AddMeasure      
ST_AddPoint      
ST_Affine   
ST_Angle       
ST_ApproximateMedialAxis    
ST_Area    
ST_Azimuth      
ST_Boundary     
ST_BoundingDiagonal      
ST_Buffer     
ST_BuildArea       
ST_CPAWithin      
ST_Centroid     
ST_ChaikinSmoothing       
ST_ClipByBox2D       
ST_ClosestPoint       
ST_ClosestPointOfApproach      
ST_ClusterDBSCAN       
ST_ClusterIntersecting       
ST_ClusterKMeans       
ST_ClusterWithin       
ST_Collect     
ST_CollectionExtract       
ST_CollectionHomogenize       
ST_ConcaveHull       
ST_ConstrainedDelaunayTriangles     
ST_ConvexHull     
ST_CoordDim  
ST_CurveToLine    
ST_DelaunayTriangles     
ST_Difference     
ST_Dimension    
ST_Distance    
ST_DistanceCPA      
ST_DistanceSphere       
ST_DistanceSpheroid       
ST_Dump   
ST_DumpPoints   
ST_DumpRings      
ST_EndPoint    
ST_Envelope      
ST_EstimatedExtent      
ST_Expand     
ST_Extent     
ST_ExteriorRing     
ST_Extrude    
ST_FilterByM       
ST_FlipCoordinates   
ST_Force2D    
ST_ForceCurve     
ST_ForceLHR    
ST_ForcePolygonCCW      
ST_ForcePolygonCW      
ST_ForceRHR     
ST_ForceSFS   
ST_Force3D    
ST_Force3DM      
ST_Force3DZ    
ST_Force4D     
ST_ForceCollection    
ST_FrechetDistance       
ST_GeneratePoints       
ST_GeometricMedian      
ST_GeometryN  
ST_GeometryType    
ST_HasArc     
ST_HausdorffDistance       
ST_InteriorRingN     
ST_InterpolatePoint      
ST_Intersection     
ST_IsClosed   
ST_IsCollection     
ST_IsEmpty     
ST_IsPlanar    
ST_IsPolygonCCW      
ST_IsPolygonCW      
ST_IsRing      
ST_IsSimple     
ST_IsSolid    
ST_IsValid      
ST_IsValidDetail       
ST_IsValidReason       
ST_IsValidTrajectory      
ST_Length     
ST_Length2D       
ST_LengthSpheroid      
ST_LineFromMultiPoint      
ST_LineInterpolatePoint      
ST_LineInterpolatePoints      
ST_LineLocatePoint       
ST_LineMerge       
ST_LineSubstring      
ST_LineToCurve     
ST_LocateAlong       
ST_LocateBetween       
ST_LocateBetweenElevations      
ST_LongestLine       
ST_M     
ST_MakeBox2D       
ST_MakeEnvelope       
ST_MakeLine      
ST_MakePoint      
ST_MakePointM       
ST_MakePolygon      
ST_MakeSolid    
ST_MakeValid      
ST_MaxDistance       
ST_MemSize   
ST_MemUnion      
ST_MinimumBoundingCircle       
ST_MinimumBoundingRadius       
ST_MinimumClearance       
ST_MinimumClearanceLine       
ST_MinkowskiSum       
ST_Multi       
ST_NDims      
ST_NPoints    
ST_NRings     
ST_Node      
ST_Normalize       
ST_NumGeometries   
ST_NumInteriorRing       
ST_NumInteriorRings      
ST_NumPatches    
ST_NumPoints      
ST_OffsetCurve       
ST_Orientation      
ST_OrientedEnvelope       
ST_PatchN    
ST_Perimeter     
ST_Perimeter2D       
ST_Point      
ST_PointN    
ST_PointOnSurface     
ST_Points     
ST_Polygon     
ST_Polygonize       
ST_Project       
ST_QuantizeCoordinates       
ST_RemovePoint      
ST_RemoveRepeatedPoints     
ST_Reverse     
ST_Rotate   
ST_RotateX    
ST_RotateY    
ST_RotateZ   
ST_SRID     
ST_Scale   
ST_Segmentize      
ST_SetEffectiveArea       
ST_SetPoint      
ST_SetSRID      
ST_SharedPaths       
ST_ShiftLongitude    
ST_ShortestLine       
ST_Simplify       
ST_SimplifyPreserveTopology       
ST_SimplifyVW       
ST_Snap       
ST_SnapToGrid      
ST_Split       
ST_StartPoint    
ST_StraightSkeleton    
ST_Subdivide       
ST_Summary   
ST_SwapOrdinates   
ST_SymDifference     
ST_Tesselate    
ST_TileEnvelope       
ST_TransScale     
ST_Transform    
ST_Translate     
ST_UnaryUnion      
ST_Union      
ST_Volume    
ST_VoronoiLines       
ST_VoronoiPolygons       
ST_WrapX      
ST_X     
ST_XMax     
ST_XMin     
ST_Y     
ST_YMax     
ST_YMin     
ST_Z     
ST_ZMax     
ST_ZMin     
ST_Zmflag     
postgis.backend        
postgis.enable_outdb_rasters        
postgis.gdal_datapath        
postgis.gdal_enabled_drivers        
postgis_sfcgal_version     

14.12. New, Enhanced or changed PostGIS Functions

14.12.1. PostGIS Functions new or enhanced in 3.0

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 3.0

  • ST_3DLineInterpolatePoint - Availability: 3.0.0 Returns a point interpolated along a line in 3D. Second argument is a float8 between 0 and 1 representing fraction of total length of linestring the point has to be located.
  • ST_ConstrainedDelaunayTriangles - Availability: 3.0.0 Return a constrained Delaunay triangulation around the given input geometry.
  • ST_TileEnvelope - Availability: 3.0 Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.

Functions enhanced in PostGIS 3.0

  • ST_AsMVT - Enhanced: 3.0 - added support for Feature ID. Aggregate function returning a Mapbox Vector Tile representation of a set of rows.
  • ST_Contains - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns true if and only if no points of B lie in the exterior of A, and at least one point of the interior of B lies in the interior of A.
  • ST_ContainsProperly - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns true if B intersects the interior of A but not the boundary (or exterior). A does not contain properly itself, but does contain itself.
  • ST_CoveredBy - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns 1 (TRUE) if no point in Geometry/Geography A is outside Geometry/Geography B
  • ST_Covers - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns 1 (TRUE) if no point in Geometry B is outside Geometry A
  • ST_Crosses - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns TRUE if the supplied geometries have some, but not all, interior points in common.
  • ST_CurveToLine - Enhanced: 3.0.0 implemented a minimum number of segments per linearized arc to prevent topological collapse. Converts a CIRCULARSTRING/CURVEPOLYGON/MULTISURFACE to a LINESTRING/POLYGON/MULTIPOLYGON
  • ST_Disjoint - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns TRUE if the Geometries do not "spatially intersect" - if they do not share any space together.
  • ST_Equals - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns true if the given geometries represent the same geometry. Directionality is ignored.
  • ST_GeneratePoints - Enhanced: 3.0.0, added seed parameter Converts a polygon or multi-polygon into a multi-point composed of randomly location points within the original areas.
  • ST_GeomFromGeoJSON - Enhanced: 3.0.0 parsed geometry defaults to SRID=4326 if not specified otherwise. Takes as input a geojson representation of a geometry and outputs a PostGIS geometry object
  • ST_LocateBetween - Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE. Return a derived geometry collection value with elements that match the specified range of measures inclusively.
  • ST_LocateBetweenElevations - Enhanced: 3.0.0 - added support for POLYGON, TIN, TRIANGLE. Return a derived geometry (collection) value with elements that intersect the specified range of elevations inclusively.
  • ST_Overlaps - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns TRUE if the Geometries share space, are of the same dimension, but are not completely contained by each other.
  • ST_Relate - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns true if this Geometry is spatially related to anotherGeometry, by testing for intersections between the Interior, Boundary and Exterior of the two geometries as specified by the values in the intersectionMatrixPattern. If no intersectionMatrixPattern is passed in, then returns the maximum intersectionMatrixPattern that relates the 2 geometries.
  • ST_Segmentize - Enhanced: 3.0.0 Segmentize geometry now uses equal length segments Return a modified geometry/geography having no segment longer than the given distance.
  • ST_Touches - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns TRUE if the geometries have at least one point in common, but their interiors do not intersect.
  • ST_Within - Enhanced: 3.0.0 enabled support for GEOMETRYCOLLECTION Returns true if the geometry A is completely inside geometry B

Functions changed in PostGIS 3.0

  • PostGIS_Extensions_Upgrade - Changed: 3.0.0 to repackage loose extensions and support postgis_raster. Packages and upgrades postgis extensions (e.g. postgis_raster,postgis_topology, postgis_sfcgal) to latest available version.
  • ST_3DDistance - Changed: 3.0.0 - SFCGAL version removed Returns the 3D cartesian minimum distance (based on spatial ref) between two geometries in projected units.
  • ST_3DIntersects - Changed: 3.0.0 SFCGAL backend removed, GEOS backend supports TINs. Returns TRUE if the Geometries "spatially intersect" in 3D - only for points, linestrings, polygons, polyhedral surface (area).
  • ST_Area - Changed: 3.0.0 - does not depend on SFCGAL anymore. Returns the area of a polygonal geometry.
  • ST_AsGeoJSON - Changed: 3.0.0 support records as input Return the geometry as a GeoJSON element.
  • ST_AsGeoJSON - Changed: 3.0.0 output SRID if not EPSG:4326. Return the geometry as a GeoJSON element.
  • ST_Distance - Changed: 3.0.0 - does not depend on SFCGAL anymore. Returns the distance between two geometry or geography values.
  • ST_Intersection - Changed: 3.0.0 does not depend on SFCGAL. (T)Returns a geometry that represents the shared portion of geomA and geomB.
  • ST_Intersects - Changed: 3.0.0 SFCGAL version removed. Returns TRUE if the Geometries/Geography "spatially intersect in 2D" - (share any portion of space) and FALSE if they don't (they are Disjoint). For geography tolerance is 0.00001 meters (so any points that close are considered to intersect)
  • ST_Union - Changed: 3.0.0 does not depend on SFCGAL. Returns a geometry that represents the point set union of the Geometries.

14.12.2. PostGIS Functions new or enhanced in 2.5

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.5

  • ST_QuantizeCoordinates - Availability: 2.5.0 Sets least significant bits of coordinates to zero
  • PostGIS_Extensions_Upgrade - Availability: 2.5.0 Packages and upgrades postgis extensions (e.g. postgis_raster,postgis_topology, postgis_sfcgal) to latest available version.
  • ST_Angle - Availability: 2.5.0 Returns the angle between 3 points, or between 2 vectors (4 points or 2 lines).
  • ST_AsHexWKB - Availability: 2.5.0 Return the Well-Known Binary (WKB) in Hex representation of the raster.
  • ST_BandFileSize - Availability: 2.5.0 Returns the file size of a band stored in file system. If no bandnum specified, 1 is assumed.
  • ST_BandFileTimestamp - Availability: 2.5.0 Returns the file timestamp of a band stored in file system. If no bandnum specified, 1 is assumed.
  • ST_ChaikinSmoothing - Availability: 2.5.0 Returns a "smoothed" version of the given geometry using the Chaikin algorithm
  • ST_FilterByM - Availability: 2.5.0 Filters vertex points based on their m-value
  • ST_Grayscale - Availability: 2.5.0 Creates a new one-8BUI band raster from the source raster and specified bands representing Red, Green and Blue
  • ST_LineInterpolatePoints - Availability: 2.5.0 Returns one or more points interpolated along a line.
  • ST_OrientedEnvelope - Availability: 2.5.0 Returns a minimum rotated rectangle enclosing a geometry.
  • ST_RastFromHexWKB - Availability: 2.5.0 Return a raster value from a Hex representation of Well-Known Binary (WKB) raster.
  • ST_RastFromWKB - Availability: 2.5.0 Return a raster value from a Well-Known Binary (WKB) raster.
  • ST_SetBandIndex - Availability: 2.5.0 Update the external band number of an out-db band
  • ST_SetBandPath - Availability: 2.5.0 Update the external path and band number of an out-db band

Functions enhanced in PostGIS 2.5

  • ST_GeometricMedian - Enhanced: 2.5.0 Added support for M as weight of points. Returns the geometric median of a MultiPoint.
  • ST_AsBinary/ST_AsWKB - Enhanced: 2.5.0 Addition of ST_AsWKB Return the Well-Known Binary (WKB) representation of the raster.
  • ST_AsMVT - Enhanced: 2.5.0 - added support parallel query. Aggregate function returning a Mapbox Vector Tile representation of a set of rows.
  • ST_AsText - Enhanced: 2.5 - optional parameter precision introduced. Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
  • ST_BandMetaData - Enhanced: 2.5.0 to include outdbbandnum, filesize and filetimestamp for outdb rasters. Returns basic meta data for a specific raster band. band num 1 is assumed if none-specified.
  • ST_Buffer - Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side buffering specification side=both|left|right. (T)Returns a geometry covering all points within a given distancefrom the input geometry.
  • ST_GeomFromGeoJSON - Enhanced: 2.5.0 can now accept json and jsonb as inputs. Takes as input a geojson representation of a geometry and outputs a PostGIS geometry object
  • ST_Intersects - Enhanced: 2.5.0 Supports GEOMETRYCOLLECTION. Returns TRUE if the Geometries/Geography "spatially intersect in 2D" - (share any portion of space) and FALSE if they don't (they are Disjoint). For geography tolerance is 0.00001 meters (so any points that close are considered to intersect)
  • ST_OffsetCurve - Enhanced: 2.5 - added support for GEOMETRYCOLLECTION and MULTILINESTRING Return an offset line at a given distance and side from an input line. Useful for computing parallel lines about a center line
  • ST_Scale - Enhanced: 2.5.0 support for scaling relative to a local origin (origin parameter) was introduced. Scales a geometry by given factors.
  • ST_Split - Enhanced: 2.5.0 support for splitting a polygon by a multiline was introduced. Returns a collection of geometries resulting by splitting a geometry.
  • ST_Subdivide - Enhanced: 2.5.0 reuses existing points on polygon split, vertex count is lowered from 8 to 5. Returns a set of geometry where no geometry in the set has more than the specified number of vertices.

Functions changed in PostGIS 2.5

  • ST_GDALDrivers - Changed: 2.5.0 - add can_read and can_write columns. Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster

14.12.3. PostGIS Functions new or enhanced in 2.4

The functions given below are PostGIS functions that were added or enhanced.

Functions new in PostGIS 2.4

  • ST_ForcePolygonCCW - Availability: 2.4.0 Orients all exterior rings counter-clockwise and all interior rings clockwise.
  • ST_ForcePolygonCW - Availability: 2.4.0 Orients all exterior rings clockwise and all interior rings counter-clockwise.
  • ST_IsPolygonCCW - Availability: 2.4.0 Tests if Polygons have exterior rings oriented counter-clockwise and interior rings oriented clockwise.
  • ST_IsPolygonCW - Availability: 2.4.0 Tests if Polygons have exterior rings oriented clockwise and interior rings oriented counter-clockwise.
  • ST_AsGeobuf - Availability: 2.4.0 Return a Geobuf representation of a set of rows.
  • ST_AsMVT - Availability: 2.4.0 Aggregate function returning a Mapbox Vector Tile representation of a set of rows.
  • ST_AsMVTGeom - Availability: 2.4.0 Transform a geometry into the coordinate space of a Mapbox Vector Tile.
  • ST_Centroid - Availability: 2.4.0 support for geography was introduced. Returns the geometric center of a geometry.
  • ST_FrechetDistance - Availability: 2.4.0 - requires GEOS >= 3.7.0 Returns the Fréchet distance between two geometries.
  • ST_MakeEmptyCoverage - Availability: 2.4.0 Cover georeferenced area with a grid of empty raster tiles.

Functions enhanced in PostGIS 2.4

All aggregates now marked as parallel safe which should allow them to be used in plans that can employ parallelism.

PostGIS 2.4.1 postgis_tiger_geocoder set to load Tiger 2017 data. Can optionally load zip code 5-digit tabulation (zcta) as part of the Loader_Generate_Nation_Script.

  • Loader_Generate_Nation_Script - Enhanced: 2.4.1 zip code 5 tabulation area (zcta5) load step was fixed and when enabled, zcta5 data is loaded as a single table called zcta5_all as part of the nation script load. Generates a shell script for the specified platform that loads in the county and state lookup tables.
  • Normalize_Address - Enhanced: 2.4.0 norm_addy object includes additional fields zip4 and address_alphanumeric. Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data).
  • Pagc_Normalize_Address - Enhanced: 2.4.0 norm_addy object includes additional fields zip4 and address_alphanumeric. Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data). Requires address_standardizer extension.
  • Reverse_Geocode - Enhanced: 2.4.1 if optional zcta5 dataset is loaded, the reverse_geocode function can resolve to state and zip even if the specific state data is not loaded. Refer to for details on loading zcta5 data. Takes a geometry point in a known spatial ref sys and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets.
  • ST_AsTWKB - Enhanced: 2.4.0 memory and speed improvements. Returns the geometry as TWKB, aka "Tiny Well-Known Binary"
  • ST_Covers - Enhanced: 2.4.0 Support for polygon in polygon and line in polygon added for geography type Returns 1 (TRUE) if no point in Geometry B is outside Geometry A
  • ST_CurveToLine - Enhanced: 2.4.0 added support for max-deviation and max-angle tolerance, and for symmetric output. Converts a CIRCULARSTRING/CURVEPOLYGON/MULTISURFACE to a LINESTRING/POLYGON/MULTIPOLYGON
  • ST_Project - Enhanced: 2.4.0 Allow negative distance and non-normalized azimuth. Returns a point projected from a start point by a distance and bearing (azimuth).
  • ST_Reverse - Enhanced: 2.4.0 support for curves was introduced. Return the geometry with vertex order reversed.

Functions changed in PostGIS 2.4

All PostGIS aggregates now marked as parallel safe. This will force a drop and recreate of aggregates during upgrade which may fail if any user views or sql functions rely on PostGIS aggregates.

  • = - Changed: 2.4.0, in prior versions this was bounding box equality not a geometric equality. If you need bounding box equality, use instead. Returns TRUE if the coordinates and coordinate order geometry/geography A are the same as the coordinates and coordinate order of geometry/geography B.
  • ST_Node - Changed: 2.4.0 this function uses GEOSNode internally instead of GEOSUnaryUnion. This may cause the resulting linestrings to have a different order and direction compared to Postgis < 2.4. Node a set of linestrings.

14.12.4. PostGIS Functions new or enhanced in 2.3

The functions given below are PostGIS functions that were added or enhanced.

[Note]

PostGIS 2.3.0: PostgreSQL 9.6+ support for parallel queries.

[Note]

PostGIS 2.3.0: PostGIS extension, all functions schema qualified to reduce issues in database restore.

[Note]

PostGIS 2.3.0: PostgreSQL 9.4+ support for BRIN indexes. Refer to Section 4.6.2, “BRIN Indizes”.

[Note]

PostGIS 2.3.0: Tiger Geocoder upgraded to work with TIGER 2016 data.

Functions new in PostGIS 2.3

  • ST_GeometricMedian - Availability: 2.3.0 Returns the geometric median of a MultiPoint.
  • &&&(geometry,gidx) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's (cached) n-D bounding box intersects a n-D float precision bounding box (GIDX).
  • &&&(gidx,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a n-D float precision bounding box (GIDX) intersects a geometry's (cached) n-D bounding box.
  • &&&(gidx,gidx) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if two n-D float precision bounding boxes (GIDX) intersect each other.
  • &&(box2df,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if two 2D float precision bounding boxes (BOX2DF) intersect each other.
  • &&(box2df,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) intersects a geometry's (cached) 2D bounding box.
  • &&(geometry,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's (cached) 2D bounding box intersects a 2D float precision bounding box (BOX2DF).
  • @(box2df,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into another 2D float precision bounding box.
  • @(box2df,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) is contained into a geometry's 2D bounding box.
  • @(geometry,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's 2D bounding box is contained into a 2D float precision bounding box (BOX2DF).
  • Populate_Topology_Layer - Availability: 2.3.0 Adds missing entries to topology.layer table by reading metadata from topo tables.
  • ST_ClusterDBSCAN - Availability: 2.3.0 Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
  • ST_ClusterKMeans - Availability: 2.3.0 Window function that returns a cluster id for each input geometry using the K-means algorithm.
  • ST_GeneratePoints - Availability: 2.3.0 Converts a polygon or multi-polygon into a multi-point composed of randomly location points within the original areas.
  • ST_MakeLine - Availability: 2.3.0 - Support for multipoint input elements was introduced Creates a Linestring from Point, MultiPoint, or LineString geometries.
  • ST_MinimumClearance - Availability: 2.3.0 Returns the minimum clearance of a geometry, a measure of a geometry's robustness.
  • ST_MinimumClearanceLine - Availability: 2.3.0 - requires GEOS >= 3.6.0 Returns the two-point LineString spanning a geometry's minimum clearance.
  • ST_Normalize - Availability: 2.3.0 Return the geometry in its canonical form.
  • ST_Points - Availability: 2.3.0 Returns a MultiPoint containing all the coordinates of a geometry.
  • ST_VoronoiLines - Availability: 2.3.0 Returns the boundaries between the cells of the Voronoi diagram constructed from the vertices of a geometry.
  • ST_VoronoiPolygons - Availability: 2.3.0 Returns the cells of the Voronoi diagram constructed from the vertices of a geometry.
  • ST_WrapX - Availability: 2.3.0 Wrap a geometry around an X value.
  • TopoGeom_addElement - Availability: 2.3 Adds an element to the definition of a TopoGeometry.
  • TopoGeom_remElement - Availability: 2.3 Removes an element from the definition of a TopoGeometry.
  • ~(box2df,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) contains another 2D float precision bounding box (BOX2DF).
  • ~(box2df,geometry) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a 2D float precision bounding box (BOX2DF) contains a geometry's 2D bonding box.
  • ~(geometry,box2df) - Availability: 2.3.0 support for Block Range INdexes (BRIN) was introduced. Requires PostgreSQL 9.5+. Returns TRUE if a geometry's 2D bonding box contains a 2D float precision bounding box (GIDX).

The functions given below are PostGIS functions that are enhanced in PostGIS 2.3.

  • ST_Contains - Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon.
  • ST_Covers - Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon.
  • ST_Expand - Enhanced: 2.3.0 support was added to expand a box by different amounts in different dimensions.
  • ST_Intersects - Enhanced: 2.3.0 Enhancement to PIP short-circuit extended to support MultiPoints with few points. Prior versions only supported point in polygon.
  • ST_Segmentize - Enhanced: 2.3.0 Segmentize geography now uses equal length segments
  • ST_Transform - Enhanced: 2.3.0 support for direct PROJ.4 text was introduced.
  • ST_Within - Enhanced: 2.3.0 Enhancement to PIP short-circuit for geometry extended to support MultiPoints with few points. Prior versions only supported point in polygon.

14.12.5. PostGIS Functions new or enhanced in 2.2

The functions given below are PostGIS functions that were added or enhanced.

[Note]

postgis_sfcgal now can be installed as an extension using CREATE EXTENSION postgis_sfcgal;

[Note]

PostGIS 2.2.0: Tiger Geocoder upgraded to work with TIGER 2015 data.

[Note]

address_standardizer, address_standardizer_data_us extensions for standardizing address data refer to Chapter 12, Adressennormierer for details.

[Note]

Many functions in topology rewritten as C functions for increased performance.

Functions new in PostGIS 2.2

  • <<#>> - Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+ Returns the n-D distance between A and B bounding boxes.
  • <<->> - Availability: 2.2.0 -- KNN only available for PostgreSQL 9.1+ Returns the n-D distance between the centroids of A and B boundingboxes.
  • ST_3DDifference - Availability: 2.2.0 Perform 3D difference
  • ST_3DUnion - Availability: 2.2.0 Perform 3D union
  • ST_ApproximateMedialAxis - Availability: 2.2.0 Compute the approximate medial axis of an areal geometry.
  • ST_AsEncodedPolyline - Availability: 2.2.0 Returns an Encoded Polyline from a LineString geometry.
  • ST_AsTWKB - Availability: 2.2.0 Returns the geometry as TWKB, aka "Tiny Well-Known Binary"
  • ST_BoundingDiagonal - Availability: 2.2.0 Returns the diagonal of a geometry's bounding box.
  • ST_CPAWithin - Availability: 2.2.0 Returns true if the closest point of approach of two trajectoriesis within the specified distance.
  • ST_ClipByBox2D - Availability: 2.2.0 Returns the portion of a geometry falling within a rectangle.
  • ST_ClosestPointOfApproach - Availability: 2.2.0 Returns the measure at which points interpolated along two trajectories are closest.
  • ST_ClusterIntersecting - Availability: 2.2.0 Aggregate function that clusters the input geometries into connected sets.
  • ST_ClusterWithin - Availability: 2.2.0 Aggregate function that clusters the input geometries by separation distance.
  • ST_CountAgg - Availability: 2.2.0 Aggregate. Returns the number of pixels in a given band of a set of rasters. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the NODATA value.
  • ST_CreateOverview - Availability: 2.2.0 Create an reduced resolution version of a given raster coverage.
  • ST_DistanceCPA - Availability: 2.2.0 Returns the distance between the closest point of approach of two trajectories.
  • ST_ForceCurve - Availability: 2.2.0 Upcast a geometry into its curved type, if applicable.
  • ST_IsPlanar - Availability: 2.2.0: This was documented in 2.1.0 but got accidentally left out in 2.1 release. Check if a surface is or not planar
  • ST_IsSolid - Availability: 2.2.0 Test if the geometry is a solid. No validity check is performed.
  • ST_IsValidTrajectory - Availability: 2.2.0 Returns true if the geometry is a valid trajectory.
  • ST_LineFromEncodedPolyline - Availability: 2.2.0 Creates a LineString from an Encoded Polyline.
  • ST_MakeSolid - Availability: 2.2.0 Cast the geometry into a solid. No check is performed. To obtain a valid solid, the input geometry must be a closed Polyhedral Surface or a closed TIN.
  • ST_MapAlgebra (callback function version) - Availability: 2.2.0: Ability to add a mask Callback function version - Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
  • ST_MemSize - Availability: 2.2.0 Returns the amount of space (in bytes) the raster takes.
  • ST_RemoveRepeatedPoints - Availability: 2.2.0 Returns a version of the given geometry with duplicated points removed.
  • ST_Retile - Availability: 2.2.0 Return a set of configured tiles from an arbitrarily tiled raster coverage.
  • ST_SetEffectiveArea - Availability: 2.2.0 Sets the effective area for each vertex, storing the value in the M ordinate. A simplified geometry can then be generated by filtering on the M ordinate.
  • ST_SimplifyVW - Availability: 2.2.0 Returns a "simplified" version of the given geometry using the Visvalingam-Whyatt algorithm
  • ST_Subdivide - Availability: 2.2.0 Returns a set of geometry where no geometry in the set has more than the specified number of vertices.
  • ST_SummaryStatsAgg - Availability: 2.2.0 Aggregate. Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a set of raster. Band 1 is assumed is no band is specified.
  • ST_SwapOrdinates - Availability: 2.2.0 Returns a version of the given geometry with given ordinate values swapped.
  • ST_Volume - Availability: 2.2.0 Computes the volume of a 3D solid. If applied to surface (even closed) geometries will return 0.
  • parse_address - Availability: 2.2.0 Takes a 1 line address and breaks into parts
  • postgis.enable_outdb_rasters - Availability: 2.2.0 A boolean configuration option to enable access to out-db raster bands.
  • postgis.gdal_datapath - Availability: 2.2.0 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 - Availability: 2.2.0 A configuration option to set the enabled GDAL drivers in the PostGIS environment. Affects the GDAL configuration variable GDAL_SKIP.
  • standardize_address - Availability: 2.2.0 Returns an stdaddr form of an input address utilizing lex, gaz, and rule tables.
  • |=| - Availability: 2.2.0. Index-supported only available for PostgreSQL 9.5+ Returns the distance between A and B trajectories at their closest point of approach.

The functions given below are PostGIS functions that are enhanced in PostGIS 2.2.

  • AsTopoJSON - Enhanced: 2.2.1 added support for puntal inputs
  • ST_Area - Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires Proj >= 4.9.0 to take advantage of the new feature.
  • ST_AsX3D - Enhanced: 2.2.0: Support for GeoCoordinates and axis (x/y, long/lat) flipping. Look at options for details.
  • ST_Azimuth - Enhanced: 2.2.0 measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires Proj >= 4.9.0 to take advantage of the new feature.
  • ST_Distance - Enhanced: 2.2.0 - measurement on spheroid performed with GeographicLib for improved accuracy and robustness. Requires Proj >= 4.9.0 to take advantage of the new feature.
  • ST_Scale - Enhanced: 2.2.0 support for scaling all dimension (factor parameter) was introduced.
  • ST_Split - Enhanced: 2.2.0 support for splitting a line by a multiline, a multipoint or (multi)polygon boundary was introduced.
  • ST_Summary - Enhanced: 2.2.0 Added support for TIN and Curves
  • <-> - Enhanced: 2.2.0 -- True KNN ("K nearest neighbor") behavior for geometry and geography for PostgreSQL 9.5+. Note for geography KNN is based on sphere rather than spheroid. For PostgreSQL 9.4 and below, geography support is new but only supports centroid box.

14.12.6. PostGIS functions breaking changes in 2.2

The functions given below are PostGIS functions that have possibly breaking changes in PostGIS 2.2. If you use any of these, you may need to check your existing code.

  • Get_Geocode_Setting - Changed: 2.2.0 : default settings are now kept in a table called geocode_settings_default. Use customized settingsa are in geocode_settings and only contain those that have been set by user.
  • ST_3DClosestPoint - Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DDistance - Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DLongestLine - Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DMaxDistance - Changed: 2.2.0 - In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_3DShortestLine - Changed: 2.2.0 - if 2 2D geometries are input, a 2D point is returned (instead of old behavior assuming 0 for missing Z). In case of 2D and 3D, Z is no longer assumed to be 0 for missing Z.
  • ST_DistanceSphere - Changed: 2.2.0 In prior versions this used to be called ST_Distance_Sphere
  • ST_DistanceSpheroid - Changed: 2.2.0 In prior versions this was called ST_Distance_Spheroid
  • ST_Equals - Changed: 2.2.0 Returns true even for invalid geometries if they are binary equal
  • ST_LengthSpheroid - Changed: 2.2.0 In prior versions this was called ST_Length_Spheroid and had the alias ST_3DLength_Spheroid
  • ST_MemSize - Changed: 2.2.0 name changed to ST_MemSize to follow naming convention. In prior versions this function was called ST_Mem_Size, old name deprecated though still available.
  • ST_PointInsideCircle - Changed: 2.2.0 In prior versions this used to be called ST_Point_Inside_Circle
  • ValidateTopology - Changed: 2.2.0 values for id1 and id2 were swapped for 'edge crosses node' to be consistent with error description.
  • <-> - Changed: 2.2.0 -- For PostgreSQL 9.5 users, old Hybrid syntax may be slower, so you'll want to get rid of that hack if you are running your code only on PostGIS 2.2+ 9.5+. See examples below.

14.12.7. PostGIS Functions new or enhanced in 2.1

The functions given below are PostGIS functions that were added or enhanced.

[Note]

More Topology performance Improvements. Please refer to Chapter 11, Topologie for more details.

[Note]

Bug fixes (particularly with handling of out-of-band rasters), many new functions (often shortening code you have to write to accomplish a common task) and massive speed improvements to raster functionality. Refer to Chapter 9, Referenz Raster for more details.

[Note]

PostGIS 2.1.0: Tiger Geocoder upgraded to work with TIGER 2012 census data. geocode_settings added for debugging and tweaking rating preferences, loader made less greedy, now only downloads tables to be loaded. PostGIS 2.1.1: Tiger Geocoder upgraded to work with TIGER 2013 data. Please refer to Section 13.1, “Tiger Geokoder” for more details.

Functions new in PostGIS 2.1

  • AsTopoJSON - Availability: 2.1.0 Returns the TopoJSON representation of a topogeometry.
  • Drop_Nation_Tables_Generate_Script - Availability: 2.1.0 Generates a script that drops all tables in the specified schema that start with county_all, state_all or state code followed by county or state.
  • Get_Geocode_Setting - Availability: 2.1.0 Returns value of specific setting stored in tiger.geocode_settings table.
  • Loader_Generate_Nation_Script - Availability: 2.1.0 Generates a shell script for the specified platform that loads in the county and state lookup tables.
  • Pagc_Normalize_Address - Availability: 2.1.0 Given a textual street address, returns a composite norm_addy type that has road suffix, prefix and type standardized, street, streetname etc. broken into separate fields. This function will work with just the lookup data packaged with the tiger_geocoder (no need for tiger census data). Requires address_standardizer extension.
  • ST_3DArea - Availability: 2.1.0 Computes area of 3D surface geometries. Will return 0 for solids.
  • ST_3DIntersection - Availability: 2.1.0 Perform 3D intersection
  • ST_Box2dFromGeoHash - Availability: 2.1.0 Return a BOX2D from a GeoHash string.
  • ST_ColorMap - Availability: 2.1.0 Creates a new raster of up to four 8BUI bands (grayscale, RGB, RGBA) from the source raster and a specified band. Band 1 is assumed if not specified.
  • ST_Contains - Availability: 2.1.0 Return true if no points of raster rastB lie in the exterior of raster rastA and at least one point of the interior of rastB lies in the interior of rastA.
  • ST_ContainsProperly - Availability: 2.1.0 Return true if rastB intersects the interior of rastA but not the boundary or exterior of rastA.
  • ST_CoveredBy - Availability: 2.1.0 Return true if no points of raster rastA lie outside raster rastB.
  • ST_Covers - Availability: 2.1.0 Return true if no points of raster rastB lie outside raster rastA.
  • ST_DFullyWithin - Availability: 2.1.0 Return true if rasters rastA and rastB are fully within the specified distance of each other.
  • ST_DWithin - Availability: 2.1.0 Return true if rasters rastA and rastB are within the specified distance of each other.
  • ST_DelaunayTriangles - Availability: 2.1.0 Return a Delaunay triangulation around the given input points.
  • ST_Disjoint - Availability: 2.1.0 Return true if raster rastA does not spatially intersect rastB.
  • ST_DumpValues - Availability: 2.1.0 Get the values of the specified band as a 2-dimension array.
  • ST_Extrude - Availability: 2.1.0 Extrude a surface to a related volume
  • ST_ForceLHR - Availability: 2.1.0 Force LHR orientation
  • ST_FromGDALRaster - Availability: 2.1.0 Returns a raster from a supported GDAL raster file.
  • ST_GeomFromGeoHash - Availability: 2.1.0 Return a geometry from a GeoHash string.
  • ST_InvDistWeight4ma - Availability: 2.1.0 Raster processing function that interpolates a pixel's value from the pixel's neighborhood.
  • ST_MapAlgebra (callback function version) - Availability: 2.1.0 Callback function version - Returns a one-band raster given one or more input rasters, band indexes and one user-specified callback function.
  • ST_MapAlgebra (expression version) - Availability: 2.1.0 Expression version - Returns a one-band raster given one or two input rasters, band indexes and one or more user-specified SQL expressions.
  • ST_MinConvexHull - Availability: 2.1.0 Return the convex hull geometry of the raster excluding NODATA pixels.
  • ST_MinDist4ma - Availability: 2.1.0 Raster processing function that returns the minimum distance (in number of pixels) between the pixel of interest and a neighboring pixel with value.
  • ST_MinkowskiSum - Availability: 2.1.0 Performs Minkowski sum
  • ST_NearestValue - Availability: 2.1.0 Returns the nearest non-NODATA value of a given band's pixel specified by a columnx and rowy or a geometric point expressed in the same spatial reference coordinate system as the raster.
  • ST_Neighborhood - Availability: 2.1.0 Returns a 2-D double precision array of the non-NODATA values around a given band's pixel specified by either a columnX and rowY or a geometric point expressed in the same spatial reference coordinate system as the raster.
  • ST_NotSameAlignmentReason - Availability: 2.1.0 Returns text stating if rasters are aligned and if not aligned, a reason why.
  • ST_Orientation - Availability: 2.1.0 Determine surface orientation
  • ST_Overlaps - Availability: 2.1.0 Return true if raster rastA and rastB intersect but one does not completely contain the other.
  • ST_PixelAsCentroid - Availability: 2.1.0 Returns the centroid (point geometry) of the area represented by a pixel.
  • ST_PixelAsCentroids - Availability: 2.1.0 Returns the centroid (point geometry) for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The point geometry is the centroid of the area represented by a pixel.
  • ST_PixelAsPoint - Availability: 2.1.0 Returns a point geometry of the pixel's upper-left corner.
  • ST_PixelAsPoints - Availability: 2.1.0 Returns a point geometry for each pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel. The coordinates of the point geometry are of the pixel's upper-left corner.
  • ST_PixelOfValue - Availability: 2.1.0 Get the columnx, rowy coordinates of the pixel whose value equals the search value.
  • ST_PointFromGeoHash - Availability: 2.1.0 Return a point from a GeoHash string.
  • ST_RasterToWorldCoord - Availability: 2.1.0 Returns the raster's upper left corner as geometric X and Y (longitude and latitude) given a column and row. Column and row starts at 1.
  • ST_Resize - Availability: 2.1.0 Requires GDAL 1.6.1+ Resize a raster to a new width/height
  • ST_Roughness - Availability: 2.1.0 Returns a raster with the calculated "roughness" of a DEM.
  • ST_SetValues - Availability: 2.1.0 Returns modified raster resulting from setting the values of a given band.
  • ST_Simplify - Availability: 2.1.0 Returns a "simplified" geometry version of the given TopoGeometry using the Douglas-Peucker algorithm.
  • ST_StraightSkeleton - Availability: 2.1.0 Compute a straight skeleton from a geometry
  • ST_Summary - Availability: 2.1.0 Returns a text summary of the contents of the raster.
  • ST_TPI - Availability: 2.1.0 Returns a raster with the calculated Topographic Position Index.
  • ST_TRI - Availability: 2.1.0 Returns a raster with the calculated Terrain Ruggedness Index.
  • ST_Tesselate - Availability: 2.1.0 Perform surface Tesselation of a polygon or polyhedralsurface and returns as a TIN or collection of TINS
  • ST_Tile - Availability: 2.1.0 Returns a set of rasters resulting from the split of the input raster based upon the desired dimensions of the output rasters.
  • ST_Touches - Availability: 2.1.0 Return true if raster rastA and rastB have at least one point in common but their interiors do not intersect.
  • ST_Union - Availability: 2.1.0 ST_Union(rast, unionarg) variant was introduced. Returns the union of a set of raster tiles into a single raster composed of 1 or more bands.
  • ST_Within - Availability: 2.1.0 Return true if no points of raster rastA lie in the exterior of raster rastB and at least one point of the interior of rastA lies in the interior of rastB.
  • ST_WorldToRasterCoord - Availability: 2.1.0 Returns the upper left corner as column and row given geometric X and Y (longitude and latitude) or a point geometry expressed in the spatial reference coordinate system of the raster.
  • Set_Geocode_Setting - Availability: 2.1.0 Sets a setting that affects behavior of geocoder functions.
  • UpdateRasterSRID - Availability: 2.1.0 Change the SRID of all rasters in the user-specified column and table.
  • clearTopoGeom - Availability: 2.1 Clears the content of a topo geometry.
  • postgis.backend - Availability: 2.1.0 The backend to service a function where GEOS and SFCGAL overlap. Options: geos or sfcgal. Defaults to geos.
  • postgis_sfcgal_version - Availability: 2.1.0 Returns the version of SFCGAL in use

The functions given below are PostGIS functions that are enhanced in PostGIS 2.1.

  • ST_AddBand - Enhanced: 2.1.0 support for addbandarg added.
  • ST_AddBand - Enhanced: 2.1.0 support for new out-db bands added.
  • ST_AsBinary/ST_AsWKB - Enhanced: 2.1.0 Addition of outasin
  • ST_Aspect - Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional interpolate_nodata function parameter
  • ST_Clip - Enhanced: 2.1.0 Rewritten in C
  • ST_Distinct4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_HillShade - Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional interpolate_nodata function parameter
  • ST_Max4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_Mean4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_Min4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_PixelAsPolygons - Enhanced: 2.1.0 exclude_nodata_value optional argument was added.
  • ST_Polygon - Enhanced: 2.1.0 Improved Speed (fully C-Based) and the returning multipolygon is ensured to be valid.
  • ST_Range4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_SameAlignment - Enhanced: 2.1.0 addition of Aggegrate variant
  • ST_SetGeoReference - Enhanced: 2.1.0 Addition of ST_SetGeoReference(raster, double precision, ...) variant
  • ST_SetValue - Enhanced: 2.1.0 Geometry variant of ST_SetValue() now supports any geometry type, not just point. The geometry variant is a wrapper around the geomval[] variant of ST_SetValues()
  • ST_Slope - Enhanced: 2.1.0 Uses ST_MapAlgebra() and added optional units, scale, interpolate_nodata function parameters
  • ST_StdDev4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_Sum4ma - Enhanced: 2.1.0 Addition of Variant 2
  • ST_Transform - Enhanced: 2.1.0 Addition of ST_Transform(rast, alignto) variant
  • ST_Union - Enhanced: 2.1.0 Improved Speed (fully C-Based).
  • ST_Union - Enhanced: 2.1.0 ST_Union(rast) (variant 1) unions all bands of all input rasters. Prior versions of PostGIS assumed the first band.
  • ST_Union - Enhanced: 2.1.0 ST_Union(rast, uniontype) (variant 4) unions all bands of all input rasters.
  • ST_AsGML - Enhanced: 2.1.0 id support was introduced, for GML 3.
  • ST_Boundary - Enhanced: 2.1.0 support for Triangle was introduced
  • ST_DWithin - Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details.
  • ST_DWithin - Enhanced: 2.1.0 support for curved geometries was introduced.
  • ST_Distance - Enhanced: 2.1.0 improved speed for geography. See Making Geography faster for details.
  • ST_Distance - Enhanced: 2.1.0 - support for curved geometries was introduced.
  • ST_DumpPoints - Enhanced: 2.1.0 Faster speed. Reimplemented as native-C.
  • ST_MakeValid - Enhanced: 2.1.0, added support for GEOMETRYCOLLECTION and MULTIPOINT.
  • ST_Segmentize - Enhanced: 2.1.0 support for geography was introduced.
  • ST_Summary - Enhanced: 2.1.0 S flag to denote if has a known spatial reference system
  • toTopoGeom - Enhanced: 2.1.0 adds the version taking an existing TopoGeometry.

14.12.8. PostGIS functions breaking changes in 2.1

The functions given below are PostGIS functions that have possibly breaking changes in PostGIS 2.1. If you use any of these, you may need to check your existing code.

  • ST_Aspect - Changed: 2.1.0 In prior versions, return values were in radians. Now, return values default to degrees
  • ST_HillShade - Changed: 2.1.0 In prior versions, azimuth and altitude were expressed in radians. Now, azimuth and altitude are expressed in degrees
  • ST_Intersects - Changed: 2.1.0 The behavior of the ST_Intersects(raster, geometry) variants changed to match that of ST_Intersects(geometry, raster).
  • ST_PixelAsCentroids - Changed: 2.1.1 Changed behavior of exclude_nodata_value.
  • ST_PixelAsPoints - Changed: 2.1.1 Changed behavior of exclude_nodata_value.
  • ST_PixelAsPolygons - Changed: 2.1.1 Changed behavior of exclude_nodata_value.
  • ST_Polygon - Changed: 2.1.0 In prior versions would sometimes return a polygon, changed to always return multipolygon.
  • ST_RasterToWorldCoordX - Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordX
  • ST_RasterToWorldCoordY - Changed: 2.1.0 In prior versions, this was called ST_Raster2WorldCoordY
  • ST_Resample - Changed: 2.1.0 Parameter srid removed. Variants with a reference raster no longer applies the reference raster's SRID. Use ST_Transform() to reproject raster. Works on rasters with no SRID.
  • ST_Rescale - Changed: 2.1.0 Works on rasters with no SRID
  • ST_Reskew - Changed: 2.1.0 Works on rasters with no SRID
  • ST_Slope - Changed: 2.1.0 In prior versions, return values were in radians. Now, return values default to degrees
  • ST_SnapToGrid - Changed: 2.1.0 Works on rasters with no SRID
  • ST_WorldToRasterCoordX - Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordX
  • ST_WorldToRasterCoordY - Changed: 2.1.0 In prior versions, this was called ST_World2RasterCoordY
  • ST_EstimatedExtent - Changed: 2.1.0. Up to 2.0.x this was called ST_Estimated_Extent.
  • ST_Force2D - Changed: 2.1.0. Up to 2.0.x this was called ST_Force_2D.
  • ST_Force3D - Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3D.
  • ST_Force3DM - Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DM.
  • ST_Force3DZ - Changed: 2.1.0. Up to 2.0.x this was called ST_Force_3DZ.
  • ST_Force4D - Changed: 2.1.0. Up to 2.0.x this was called ST_Force_4D.
  • ST_ForceCollection - Changed: 2.1.0. Up to 2.0.x this was called ST_Force_Collection.
  • ST_LineInterpolatePoint - Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Interpolate_Point.
  • ST_LineLocatePoint - Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Locate_Point.
  • ST_LineSubstring - Changed: 2.1.0. Up to 2.0.x this was called ST_Line_Substring.
  • ST_Segmentize - Changed: 2.1.0 As a result of the introduction of geography support: The construct SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5); will result in ambiguous function error. You need to have properly typed object e.g. a geometry/geography column, use ST_GeomFromText, ST_GeogFromText or SELECT ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry,0.5);

14.12.9. PostGIS Functions new, behavior changed, or enhanced in 2.0

The functions given below are PostGIS functions that were added, enhanced, or have Section 14.12.10, “PostGIS Functions changed behavior in 2.0” breaking changes in 2.0 releases.

New geometry types: TIN and Polyhedral surfaces was introduced in 2.0

[Note]

Greatly improved support for Topology. Please refer to Chapter 11, Topologie for more details.

[Note]

In PostGIS 2.0, raster type and raster functionality has been integrated. There are way too many new raster functions to list here and all are new so please refer to Chapter 9, Referenz Raster for more details of the raster functions available. Earlier pre-2.0 versions had raster_columns/raster_overviews as real tables. These were changed to views before release. Functions such as ST_AddRasterColumn were removed and replaced with AddRasterConstraints, DropRasterConstraints as a result some apps that created raster tables may need changing.

[Note]

Tiger Geocoder upgraded to work with TIGER 2010 census data and now included in the core PostGIS documentation. A reverse geocoder function was also added. Please refer to Section 13.1, “Tiger Geokoder” for more details.

  • && - Availability: 2.0.0 Returns TRUE if A's bounding box intersects B's bounding box.
  • &&& - Availability: 2.0.0 Returns TRUE if A's n-D bounding box intersects B's n-D bounding box.
  • <#> - Availability: 2.0.0 -- KNN only available for PostgreSQL 9.1+ Returns the 2D distance between A and B bounding boxes.
  • <-> - Availability: 2.0.0 -- Weak KNN provides nearest neighbors based on geometry centroid distances instead of true distances. Exact results for points, inexact for all other types. Available for PostgreSQL 9.1+ Returns the 2D distance between A and B.
  • AddEdge - Availability: 2.0.0 Adds a linestring edge to the edge table and associated start and end points to the point nodes table of the specified topology schema using the specified linestring geometry and returns the edgeid of the new (or existing) edge.
  • AddFace - Availability: 2.0.0 Registers a face primitive to a topology and gets its identifier.
  • AddNode - Availability: 2.0.0 Adds a point node to the node table in the specified topology schema and returns the nodeid of new node. If point already exists as node, the existing nodeid is returned.
  • AddOverviewConstraints - Availability: 2.0.0 Tag a raster column as being an overview of another.
  • AddRasterConstraints - Availability: 2.0.0 Adds raster constraints to a loaded raster table for a specific column that constrains spatial ref, scaling, blocksize, alignment, bands, band type and a flag to denote if raster column is regularly blocked. The table must be loaded with data for the constraints to be inferred. Returns true if the constraint setting was accomplished and issues a notice otherwise.
  • AsGML - Availability: 2.0.0 Returns the GML representation of a topogeometry.
  • CopyTopology - Availability: 2.0.0 Makes a copy of a topology structure (nodes, edges, faces, layers and TopoGeometries).
  • DropOverviewConstraints - Availability: 2.0.0 Untag a raster column from being an overview of another.
  • DropRasterConstraints - Availability: 2.0.0 Drops PostGIS raster constraints that refer to a raster table column. Useful if you need to reload data or update your raster column data.
  • Drop_Indexes_Generate_Script - Availability: 2.0.0 Generates a script that drops all non-primary key and non-unique indexes on tiger schema and user specified schema. Defaults schema to tiger_data if no schema is specified.
  • Drop_State_Tables_Generate_Script - Availability: 2.0.0 Generates a script that drops all tables in the specified schema that are prefixed with the state abbreviation. Defaults schema to tiger_data if no schema is specified.
  • Geocode_Intersection - Availability: 2.0.0 Takes in 2 streets that intersect and a state, city, zip, and outputs a set of possible locations on the first cross street that is at the intersection, also includes a geomout as the point location in NAD 83 long lat, a normalized_address (addy) for each location, and the rating. The lower the rating the more likely the match. Results are sorted by lowest rating first. Can optionally pass in maximum results, defaults to 10. Uses Tiger data (edges, faces, addr), PostgreSQL fuzzy string matching (soundex, levenshtein).
  • GetEdgeByPoint - Availability: 2.0.0 Finds the edge-id of an edge that intersects a given point.
  • GetFaceByPoint - Availability: 2.0.0 Finds the face-id of a face that intersects a given point.
  • GetNodeByPoint - Availability: 2.0.0 Finds the node-id of a node at a point location.
  • GetNodeEdges - Availability: 2.0 Returns an ordered set of edges incident to the given node.
  • GetRingEdges - Availability: 2.0.0 Returns the ordered set of signed edge identifiers met by walking on ana given edge side.
  • GetTopoGeomElements - Availability: 2.0.0 Returns a set of topoelement objects containing the topological element_id,element_type of the given TopoGeometry (primitive elements).
  • GetTopologySRID - Availability: 2.0.0 Returns the SRID of a topology in the topology.topology table given the name of the topology.
  • Get_Tract - Availability: 2.0.0 Returns census tract or field from tract table of where the geometry is located. Default to returning short name of tract.
  • Install_Missing_Indexes - Availability: 2.0.0 Finds all tables with key columns used in geocoder joins and filter conditions that are missing used indexes on those columns and will add them.
  • Loader_Generate_Census_Script - Availability: 2.0.0 Generates a shell script for the specified platform for the specified states that will download Tiger census state tract, bg, and tabblocks data tables, stage and load into tiger_data schema. Each state script is returned as a separate record.
  • Loader_Generate_Script - Availability: 2.0.0 to support Tiger 2010 structured data and load census tract (tract), block groups (bg), and blocks (tabblocks) tables . Generates a shell script for the specified platform for the specified states that will download Tiger data, stage and load into tiger_data schema. Each state script is returned as a separate record. Latest version supports Tiger 2010 structural changes and also loads census tract, block groups, and blocks tables.
  • Missing_Indexes_Generate_Script - Availability: 2.0.0 Finds all tables with key columns used in geocoder joins that are missing indexes on those columns and will output the SQL DDL to define the index for those tables.
  • Polygonize - Availability: 2.0.0 Finds and registers all faces defined by topology edges.
  • Reverse_Geocode - Availability: 2.0.0 Takes a geometry point in a known spatial ref sys and returns a record containing an array of theoretically possible addresses and an array of cross streets. If include_strnum_range = true, includes the street range in the cross streets.
  • ST_3DClosestPoint - Availability: 2.0.0 Returns the 3D point on g1 that is closest to g2. This is the first point of the 3D shortest line.
  • ST_3DDFullyWithin - Availability: 2.0.0 Returns true if all of the 3D geometries are within the specified distance of one another.
  • ST_3DDWithin - Availability: 2.0.0 For 3d (z) geometry type Returns true if two geometries 3d distance is within number of units.
  • ST_3DDistance - Availability: 2.0.0 Returns the 3D cartesian minimum distance (based on spatial ref) between two geometries in projected units.
  • ST_3DIntersects - Availability: 2.0.0 Returns TRUE if the Geometries "spatially intersect" in 3D - only for points, linestrings, polygons, polyhedral surface (area).
  • ST_3DLongestLine - Availability: 2.0.0 Returns the 3D longest line between two geometries
  • ST_3DMaxDistance - Availability: 2.0.0 Returns the 3D cartesian maximum distance (based on spatial ref) between two geometries in projected units.
  • ST_3DShortestLine - Availability: 2.0.0 Returns the 3D shortest line between two geometries
  • ST_AddEdgeModFace - Availability: 2.0 Add a new edge and, if in doing so it splits a face, modify the original face and add a new face.
  • ST_AddEdgeNewFaces - Availability: 2.0 Add a new edge and, if in doing so it splits a face, delete the original face and replace it with two new faces.
  • ST_AsGDALRaster - Availability: 2.0.0 - requires GDAL >= 1.6.0. Return the raster tile in the designated GDAL Raster format. Raster formats are one of those supported by your compiled library. Use ST_GDALDrivers() to get a list of formats supported by your library.
  • ST_AsJPEG - Availability: 2.0.0 - requires GDAL >= 1.6.0. Return the raster tile selected bands as a single Joint Photographic Exports Group (JPEG) image (byte array). If no band is specified and 1 or more than 3 bands, then only the first band is used. If only 3 bands then all 3 bands are used and mapped to RGB.
  • ST_AsLatLonText - Availability: 2.0 Return the Degrees, Minutes, Seconds representation of the given point.
  • ST_AsPNG - Availability: 2.0.0 - requires GDAL >= 1.6.0. Return the raster tile selected bands as a single portable network graphics (PNG) image (byte array). If 1, 3, or 4 bands in raster and no bands are specified, then all bands are used. If more 2 or more than 4 bands and no bands specified, then only band 1 is used. Bands are mapped to RGB or RGBA space.
  • ST_AsRaster - Availability: 2.0.0 - requires GDAL >= 1.6.0. Converts a PostGIS geometry to a PostGIS raster.
  • ST_AsTIFF - Availability: 2.0.0 - requires GDAL >= 1.6.0. Return the raster selected bands as a single TIFF image (byte array). If no band is specified or any of specified bands does not exist in the raster, then will try to use all bands.
  • ST_AsX3D - Availability: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML Returns a Geometry in X3D xml node element format: ISO-IEC-19776-1.2-X3DEncodings-XML
  • ST_Aspect - Availability: 2.0.0 Returns the aspect (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
  • ST_Band - Availability: 2.0.0 Returns one or more bands of an existing raster as a new raster. Useful for building new rasters from existing rasters.
  • ST_BandIsNoData - Availability: 2.0.0 Returns true if the band is filled with only nodata values.
  • ST_Clip - Availability: 2.0.0 Returns the raster clipped by the input geometry. If band number not is specified, all bands are processed. If crop is not specified or TRUE, the output raster is cropped.
  • ST_CollectionHomogenize - Availability: 2.0.0 Given a geometry collection, return the "simplest" representation of the contents.
  • ST_ConcaveHull - Availability: 2.0.0 The concave hull of a geometry represents a possibly concave geometry that encloses all geometries within the set. You can think of it as shrink wrapping.
  • ST_Count - Availability: 2.0.0 Returns the number of pixels in a given band of a raster or raster coverage. If no band is specified defaults to band 1. If exclude_nodata_value is set to true, will only count pixels that are not equal to the nodata value.
  • ST_CreateTopoGeo - Availability: 2.0 Adds a collection of geometries to a given empty topology and returns a message detailing success.
  • ST_Distinct4ma - Availability: 2.0.0 Raster processing function that calculates the number of unique pixel values in a neighborhood.
  • ST_FlipCoordinates - Availability: 2.0.0 Returns a version of the given geometry with X and Y axis flipped. Useful for people who have built latitude/longitude features and need to fix them.
  • ST_GDALDrivers - Availability: 2.0.0 - requires GDAL >= 1.6.0. Returns a list of raster formats supported by PostGIS through GDAL. Only those formats with can_write=True can be used by ST_AsGDALRaster
  • ST_GeomFromGeoJSON - Availability: 2.0.0 requires - JSON-C >= 0.9 Takes as input a geojson representation of a geometry and outputs a PostGIS geometry object
  • ST_GetFaceEdges - Availability: 2.0 Returns a set of ordered edges that bound aface.
  • ST_HasNoBand - Availability: 2.0.0 Returns true if there is no band with given band number. If no band number is specified, then band number 1 is assumed.
  • ST_HillShade - Availability: 2.0.0 Returns the hypothetical illumination of an elevation raster band using provided azimuth, altitude, brightness and scale inputs.
  • ST_Histogram - Availability: 2.0.0 Returns a set of record summarizing a raster or raster coverage data distribution separate bin ranges. Number of bins are autocomputed if not specified.
  • ST_InterpolatePoint - Availability: 2.0.0 Return the value of the measure dimension of a geometry at the point closed to the provided point.
  • ST_IsEmpty - Availability: 2.0.0 Returns true if the raster is empty (width = 0 and height = 0). Otherwise, returns false.
  • ST_IsValidDetail - Availability: 2.0.0 Returns a valid_detail row stating if a geometry is valid, and if not a reason why and a location.
  • ST_IsValidReason - Availability: 2.0 version taking flags. Returns text stating if a geometry is valid, or a reason for invalidity.
  • ST_MakeLine - Availability: 2.0.0 - Support for linestring input elements was introduced Creates a Linestring from Point, MultiPoint, or LineString geometries.
  • ST_MakeValid - Availability: 2.0.0 Attempts to make an invalid geometry valid without losing vertices.
  • ST_MapAlgebraExpr - Availability: 2.0.0 1 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the input raster band and of pixeltype provided. Band 1 is assumed if no band is specified.
  • ST_MapAlgebraExpr - Availability: 2.0.0 2 raster band version: Creates a new one band raster formed by applying a valid PostgreSQL algebraic operation on the two input raster bands and of pixeltype provided. band 1 of each raster is assumed if no band numbers are specified. The resulting raster will be aligned (scale, skew and pixel corners) on the grid defined by the first raster and have its extent defined by the "extenttype" parameter. Values for "extenttype" can be: INTERSECTION, UNION, FIRST, SECOND.
  • ST_MapAlgebraFct - Availability: 2.0.0 1 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the input raster band and of pixeltype prodived. Band 1 is assumed if no band is specified.
  • ST_MapAlgebraFct - Availability: 2.0.0 2 band version - Creates a new one band raster formed by applying a valid PostgreSQL function on the 2 input raster bands and of pixeltype prodived. Band 1 is assumed if no band is specified. Extent type defaults to INTERSECTION if not specified.
  • ST_MapAlgebraFctNgb - Availability: 2.0.0 1-band version: Map Algebra Nearest Neighbor using user-defined PostgreSQL function. Return a raster which values are the result of a PLPGSQL user function involving a neighborhood of values from the input raster band.
  • ST_Max4ma - Availability: 2.0.0 Raster processing function that calculates the maximum pixel value in a neighborhood.
  • ST_Mean4ma - Availability: 2.0.0 Raster processing function that calculates the mean pixel value in a neighborhood.
  • ST_Min4ma - Availability: 2.0.0 Raster processing function that calculates the minimum pixel value in a neighborhood.
  • ST_ModEdgeHeal - Availability: 2.0 Heals two edges by deleting the node connecting them, modifying the first edgeand deleting the second edge. Returns the id of the deleted node.
  • ST_NewEdgeHeal - Availability: 2.0 Heals two edges by deleting the node connecting them, deleting both edges,and replacing them with an edge whose direction is the same as the firstedge provided.
  • ST_Node - Availability: 2.0.0 Node a set of linestrings.
  • ST_NumPatches - Availability: 2.0.0 Return the number of faces on a Polyhedral Surface. Will return null for non-polyhedral geometries.
  • ST_OffsetCurve - Availability: 2.0 Return an offset line at a given distance and side from an input line. Useful for computing parallel lines about a center line
  • ST_PatchN - Availability: 2.0.0 Returns the Nth geometry (face) of a PolyhedralSurface.
  • ST_PixelAsPolygon - Availability: 2.0.0 Returns the polygon geometry that bounds the pixel for a particular row and column.
  • ST_PixelAsPolygons - Availability: 2.0.0 Returns the polygon geometry that bounds every pixel of a raster band along with the value, the X and the Y raster coordinates of each pixel.
  • ST_Project - Availability: 2.0.0 Returns a point projected from a start point by a distance and bearing (azimuth).
  • ST_Quantile - Availability: 2.0.0 Compute quantiles for a raster or raster table coverage in the context of the sample or population. Thus, a value could be examined to be at the raster's 25%, 50%, 75% percentile.
  • ST_Range4ma - Availability: 2.0.0 Raster processing function that calculates the range of pixel values in a neighborhood.
  • ST_Reclass - Availability: 2.0.0 Creates a new raster composed of band types reclassified from original. The nband is the band to be changed. If nband is not specified assumed to be 1. All other bands are returned unchanged. Use case: convert a 16BUI band to a 8BUI and so forth for simpler rendering as viewable formats.
  • ST_RelateMatch - Availability: 2.0.0 Returns true if intersectionMattrixPattern1 implies intersectionMatrixPattern2
  • ST_RemEdgeModFace - Availability: 2.0 Removes an edge and, if the removed edge separated two faces,delete one of the them and modify the other to take the space of both.
  • ST_RemEdgeNewFace - Availability: 2.0 Removes an edge and, if the removed edge separated two faces,delete the original faces and replace them with a new face.
  • ST_Resample - Availability: 2.0.0 Requires GDAL 1.6.1+ Resample a raster using a specified resampling algorithm, new dimensions, an arbitrary grid corner and a set of raster georeferencing attributes defined or borrowed from another raster.
  • ST_Rescale - Availability: 2.0.0 Requires GDAL 1.6.1+ Resample a raster by adjusting only its scale (or pixel size). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
  • ST_Reskew - Availability: 2.0.0 Requires GDAL 1.6.1+ Resample a raster by adjusting only its skew (or rotation parameters). New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
  • ST_SameAlignment - Availability: 2.0.0 Returns true if rasters have same skew, scale, spatial ref, and offset (pixels can be put on same grid without cutting into pixels) and false if they don't with notice detailing issue.
  • ST_SetBandIsNoData - Availability: 2.0.0 Sets the isnodata flag of the band to TRUE.
  • ST_SharedPaths - Availability: 2.0.0 Returns a collection containing paths shared by the two input linestrings/multilinestrings.
  • ST_Slope - Availability: 2.0.0 Returns the slope (in degrees by default) of an elevation raster band. Useful for analyzing terrain.
  • ST_Snap - Availability: 2.0.0 Snap segments and vertices of input geometry to vertices of a reference geometry.
  • ST_SnapToGrid - Availability: 2.0.0 Requires GDAL 1.6.1+ Resample a raster by snapping it to a grid. New pixel values are computed using the NearestNeighbor (english or american spelling), Bilinear, Cubic, CubicSpline or Lanczos resampling algorithm. Default is NearestNeighbor.
  • ST_Split - Availability: 2.0.0 Returns a collection of geometries resulting by splitting a geometry.
  • ST_StdDev4ma - Availability: 2.0.0 Raster processing function that calculates the standard deviation of pixel values in a neighborhood.
  • ST_Sum4ma - Availability: 2.0.0 Raster processing function that calculates the sum of all pixel values in a neighborhood.
  • ST_SummaryStats - Availability: 2.0.0 Returns summarystats consisting of count, sum, mean, stddev, min, max for a given raster band of a raster or raster coverage. Band 1 is assumed is no band is specified.
  • ST_Transform - Availability: 2.0.0 Requires GDAL 1.6.1+ Reprojects a raster in a known spatial reference system to another known spatial reference system using specified resampling algorithm. Options are NearestNeighbor, Bilinear, Cubic, CubicSpline, Lanczos defaulting to NearestNeighbor.
  • ST_UnaryUnion - Availability: 2.0.0 Like ST_Union, but working at the geometry component level.
  • ST_Union - Availability: 2.0.0 Returns the union of a set of raster tiles into a single raster composed of 1 or more bands.
  • ST_ValueCount - Availability: 2.0.0 Returns a set of records containing a pixel band value and count of the number of pixels in a given band of a raster (or a raster coverage) that have a given set of values. If no band is specified defaults to band 1. By default nodata value pixels are not counted. and all other values in the pixel are output and pixel band values are rounded to the nearest integer.
  • TopoElementArray_Agg - Availability: 2.0.0 Returns a topoelementarray for a set of element_id, type arrays (topoelements).
  • TopoGeo_AddLineString - Availability: 2.0.0 Adds a linestring to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns edge identifiers.
  • TopoGeo_AddPoint - Availability: 2.0.0 Adds a point to an existing topology using a tolerance and possibly splitting an existing edge.
  • TopoGeo_AddPolygon - Availability: 2.0.0 Adds a polygon to an existing topology using a tolerance and possibly splitting existing edges/faces. Returns face identifiers.
  • TopologySummary - Availability: 2.0.0 Takes a topology name and provides summary totals of types of objects in topology.
  • Topology_Load_Tiger - Availability: 2.0.0 Loads a defined region of tiger data into a PostGIS Topology and transforming the tiger data to spatial reference of the topology and snapping to the precision tolerance of the topology.
  • toTopoGeom - Availability: 2.0 Converts a simple Geometry into a topo geometry.
  • ~= - Availability: 2.0.0 Returns TRUE if A's bounding box is the same as B's.

The functions given below are PostGIS functions that are enhanced in PostGIS 2.0.

  • AddGeometryColumn - Enhanced: 2.0.0 use_typmod argument introduced. Defaults to creating typmod geometry column instead of constraint-based.
  • Box2D - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • Box3D - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • Geocode - Enhanced: 2.0.0 to support Tiger 2010 structured data and revised some logic to improve speed, accuracy of geocoding, and to offset point from centerline to side of street address is located on. The new parameter max_results useful for specifying number of best results or just returning the best result.
  • GeometryType - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • Populate_Geometry_Columns - Enhanced: 2.0.0 use_typmod optional argument was introduced that allows controlling if columns are created with typmodifiers or with check constraints.
  • ST_Intersection - Enhanced: 2.0.0 - Intersection in the raster space was introduced. In earlier pre-2.0.0 versions, only intersection performed in vector space were supported.
  • ST_Intersects - Enhanced: 2.0.0 support raster/raster intersects was introduced.
  • ST_Value - Enhanced: 2.0.0 exclude_nodata_value optional argument was added.
  • ST_3DExtent - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Affine - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Area - Enhanced: 2.0.0 - support for 2D polyhedral surfaces was introduced.
  • ST_AsBinary - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_AsBinary - Enhanced: 2.0.0 support for higher coordinate dimensions was introduced.
  • ST_AsBinary - Enhanced: 2.0.0 support for specifying endian with geography was introduced.
  • ST_AsEWKB - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_AsEWKT - Enhanced: 2.0.0 support for Geography, Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_AsGML - Enhanced: 2.0.0 prefix support was introduced. Option 4 for GML3 was introduced to allow using LineString instead of Curve tag for lines. GML3 Support for Polyhedral surfaces and TINS was introduced. Option 32 was introduced to output the box.
  • ST_AsKML - Enhanced: 2.0.0 - Add prefix namespace. Default is no prefix
  • ST_Azimuth - Enhanced: 2.0.0 support for geography was introduced.
  • ST_ChangeEdgeGeom - Enhanced: 2.0.0 adds topological consistency enforcement
  • ST_Dimension - Enhanced: 2.0.0 support for Polyhedral surfaces and TINs was introduced. No longer throws an exception if given empty geometry.
  • ST_Dump - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_DumpPoints - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Expand - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Extent - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Force2D - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_ForceRHR - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_Force3D - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_Force3DZ - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_ForceCollection - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_GMLToSQL - Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
  • ST_GMLToSQL - Enhanced: 2.0.0 default srid optional parameter added.
  • ST_GeomFromEWKB - Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
  • ST_GeomFromEWKT - Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
  • ST_GeomFromGML - Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
  • ST_GeomFromGML - Enhanced: 2.0.0 default srid optional parameter added.
  • ST_GeometryN - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_GeometryType - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_IsClosed - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_MakeEnvelope - Enhanced: 2.0: Ability to specify an envelope without specifying an SRID was introduced.
  • ST_MakeValid - Enhanced: 2.0.1, speed improvements
  • ST_NPoints - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ST_NumGeometries - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Relate - Enhanced: 2.0.0 - added support for specifying boundary node rule.
  • ST_Rotate - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Rotate - Enhanced: 2.0.0 additional parameters for specifying the origin of rotation were added.
  • ST_RotateX - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_RotateY - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_RotateZ - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_Scale - Enhanced: 2.0.0 support for Polyhedral surfaces, Triangles and TIN was introduced.
  • ST_ShiftLongitude - Enhanced: 2.0.0 support for Polyhedral surfaces and TIN was introduced.
  • ST_Summary - Enhanced: 2.0.0 added support for geography
  • ST_Transform - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.
  • ValidateTopology - Enhanced: 2.0.0 more efficient edge crossing detection and fixes for false positives that were existent in prior versions.
  • && - Enhanced: 2.0.0 support for Polyhedral surfaces was introduced.

14.12.10. PostGIS Functions changed behavior in 2.0

The functions given below are PostGIS functions that have changed behavior in PostGIS 2.0 and may require application changes.

[Note]

Most deprecated functions have been removed. These are functions that haven't been documented since 1.2 or some internal functions that were never documented. If you are using a function that you don't see documented, it's probably deprecated, about to be deprecated, or internal and should be avoided. If you have applications or tools that rely on deprecated functions, please refer to Q: 3.2 for more details.

[Note]

Bounding boxes of geometries have been changed from float4 to double precision (float8). This has an impact on answers you get using bounding box operators and casting of bounding boxes to geometries. E.g ST_SetSRID(abbox) will often return a different more accurate answer in PostGIS 2.0+ than it did in prior versions which may very well slightly change answers to view port queries.

[Note]

The arguments hasnodata was replaced with exclude_nodata_value which has the same meaning as the older hasnodata but clearer in purpose.

  • AddGeometryColumn - Changed: 2.0.0 This function no longer updates geometry_columns since geometry_columns is a view that reads from system catalogs. It by default also does not create constraints, but instead uses the built in type modifier behavior of PostgreSQL. So for example building a wgs84 POINT column with this function is now equivalent to: ALTER TABLE some_table ADD COLUMN geom geometry(Point,4326);
  • AddGeometryColumn - Changed: 2.0.0 If you require the old behavior of constraints use the default use_typmod, but set it to false.
  • AddGeometryColumn - Changed: 2.0.0 Views can no longer be manually registered in geometry_columns, however views built against geometry typmod tables geometries and used without wrapper functions will register themselves correctly because they inherit the typmod behavior of their parent table column. Views that use geometry functions that output other geometries will need to be cast to typmod geometries for these view geometry columns to be registered correctly in geometry_columns. Refer to .
  • DropGeometryColumn - Changed: 2.0.0 This function is provided for backward compatibility. Now that since geometry_columns is now a view against the system catalogs, you can drop a geometry column like any other table column using ALTER TABLE
  • DropGeometryTable - Changed: 2.0.0 This function is provided for backward compatibility. Now that since geometry_columns is now a view against the system catalogs, you can drop a table with geometry columns like any other table using DROP TABLE
  • Populate_Geometry_Columns - Changed: 2.0.0 By default, now uses type modifiers instead of check constraints to constrain geometry types. You can still use check constraint behavior instead by using the new use_typmod and setting it to false.
  • Box3D - Changed: 2.0.0 In pre-2.0 versions, there used to be a box2d instead of box3d. Since box2d is a deprecated type, this was changed to box3d.
  • ST_GDALDrivers - Changed: 2.0.6, 2.1.3 - by default no drivers are enabled, unless GUC or Environment variable gdal_enabled_drivers is set.
  • ST_ScaleX - Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeX.
  • ST_ScaleY - Changed: 2.0.0. In WKTRaster versions this was called ST_PixelSizeY.
  • ST_SetScale - Changed: 2.0.0 In WKTRaster versions this was called ST_SetPixelSize. This was changed in 2.0.0.
  • ST_3DExtent - Changed: 2.0.0 In prior versions this used to be called ST_Extent3D
  • ST_3DLength - Changed: 2.0.0 In prior versions this used to be called ST_Length3D
  • ST_3DMakeBox - Changed: 2.0.0 In prior versions this used to be called ST_MakeBox3D
  • ST_3DPerimeter - Changed: 2.0.0 In prior versions this used to be called ST_Perimeter3D
  • ST_AsBinary - Changed: 2.0.0 Inputs to this function can not be unknown -- must be geometry. Constructs such as ST_AsBinary('POINT(1 2)') are no longer valid and you will get an n st_asbinary(unknown) is not unique error. Code like that needs to be changed to ST_AsBinary('POINT(1 2)'::geometry);. If that is not possible, then install legacy.sql.
  • ST_AsGML - Changed: 2.0.0 use default named args
  • ST_AsGeoJSON - Changed: 2.0.0 support default args and named args.
  • ST_AsKML - Changed: 2.0.0 - uses default args and supports named args
  • ST_AsSVG - Changed: 2.0.0 to use default args and support named args
  • ST_EndPoint - Changed: 2.0.0 no longer works with single geometry multilinestrings. In older versions of PostGIS -- a single line multilinestring would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other multilinestring. The older behavior was an undocumented feature, but people who assumed they had their data stored as LINESTRING may experience these returning NULL in 2.0 now.
  • ST_GeomFromText - Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards. This should now be written as ST_GeomFromText('GEOMETRYCOLLECTION EMPTY')
  • ST_GeometryN - Changed: 2.0.0 Prior versions would return NULL for singular geometries. This was changed to return the geometry for ST_GeometryN(..,1) case.
  • ST_IsEmpty - Changed: 2.0.0 In prior versions of PostGIS ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') was allowed. This is now illegal in PostGIS 2.0.0 to better conform with SQL/MM standards
  • ST_Length - Changed: 2.0.0 Breaking change -- in prior versions applying this to a MULTI/POLYGON of type geography would give you the perimeter of the POLYGON/MULTIPOLYGON. In 2.0.0 this was changed to return 0 to be in line with geometry behavior. Please use ST_Perimeter if you want the perimeter of a polygon
  • ST_LocateAlong - Changed: 2.0.0 in prior versions this used to be called ST_Locate_Along_Measure. The old name has been deprecated and will be removed in the future but is still available.
  • ST_LocateBetween - Changed: 2.0.0 - in prior versions this used to be called ST_Locate_Between_Measures. The old name has been deprecated and will be removed in the future but is still available for backward compatibility.
  • ST_ModEdgeSplit - Changed: 2.0 - In prior versions, this was misnamed ST_ModEdgesSplit
  • ST_NumGeometries - Changed: 2.0.0 In prior versions this would return NULL if the geometry was not a collection/MULTI type. 2.0.0+ now returns 1 for single geometries e.g POLYGON, LINESTRING, POINT.
  • ST_NumInteriorRings - Changed: 2.0.0 - in prior versions it would allow passing a MULTIPOLYGON, returning the number of interior rings of first POLYGON.
  • ST_PointN - Changed: 2.0.0 no longer works with single geometry multilinestrings. In older versions of PostGIS -- a single line multilinestring would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other multilinestring.
  • ST_StartPoint - Changed: 2.0.0 no longer works with single geometry multilinestrings. In older versions of PostGIS -- a single line multilinestring would work happily with this function and return the start point. In 2.0.0 it just returns NULL like any other multilinestring. The older behavior was an undocumented feature, but people who assumed they had their data stored as LINESTRING may experience these returning NULL in 2.0 now.

14.12.11. PostGIS Functions new, behavior changed, or enhanced in 1.5

The functions given below are PostGIS functions that were introduced or enhanced in this minor release.

  • PostGIS_LibXML_Version - Availability: 1.5 Returns the version number of the libxml2 library.
  • ST_AddMeasure - Availability: 1.5.0 Return a derived geometry with measure elements linearly interpolated between the start and end points.
  • ST_AsBinary - Availability: 1.5.0 geography support was introduced. Return the Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
  • ST_AsGML - Availability: 1.5.0 geography support was introduced. Return the geometry as a GML version 2 or 3 element.
  • ST_AsGeoJSON - Availability: 1.5.0 geography support was introduced. Return the geometry as a GeoJSON element.
  • ST_AsText - Availability: 1.5 - support for geography was introduced. Return the Well-Known Text (WKT) representation of the geometry/geography without SRID metadata.
  • ST_Buffer - Availability: 1.5 - ST_Buffer was enhanced to support different endcaps and join types. These are useful for example to convert road linestrings into polygon roads with flat or square edges instead of rounded edges. Thin wrapper for geography was added. (T)Returns a geometry covering all points within a given distancefrom the input geometry.
  • ST_ClosestPoint - Availability: 1.5.0 Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line.
  • ST_CollectionExtract - Availability: 1.5.0 Given a (multi)geometry, return a (multi)geometry consisting only of elements of the specified type.
  • ST_Covers - Availability: 1.5 - support for geography was introduced. Returns 1 (TRUE) if no point in Geometry B is outside Geometry A
  • ST_DFullyWithin - Availability: 1.5.0 Returns true if all of the geometries are within the specified distance of one another
  • ST_DWithin - Availability: 1.5.0 support for geography was introduced Returns true if the geometries are within the specified distance of one another. For geometry units are in those of spatial reference and for geography units are in meters and measurement is defaulted to use_spheroid=true (measure around spheroid), for faster check, use_spheroid=false to measure along sphere.
  • ST_Distance - Availability: 1.5.0 geography support was introduced in 1.5. Speed improvements for planar to better handle large or many vertex geometries Returns the distance between two geometry or geography values.
  • ST_DistanceSphere - Availability: 1.5 - support for other geometry types besides points was introduced. Prior versions only work with points. Returns minimum distance in meters between two lon/lat geometries using a spherical earth model.
  • ST_DistanceSpheroid - Availability: 1.5 - support for other geometry types besides points was introduced. Prior versions only work with points. Returns the minimum distance between two lon/lat geometries using a spheroidal earth model.
  • ST_DumpPoints - Availability: 1.5.0 Returns a set of geometry_dump rows for the points in a geometry.
  • ST_Envelope - Availability: 1.5.0 behavior changed to output double precision instead of float4 Returns a geometry representing the bounding box of a geometry.
  • ST_GMLToSQL - Availability: 1.5, requires libxml2 1.6+ Return a specified ST_Geometry value from GML representation. This is an alias name for ST_GeomFromGML
  • ST_GeomFromGML - Availability: 1.5, requires libxml2 1.6+ Takes as input GML representation of geometry and outputs a PostGIS geometry object
  • ST_GeomFromKML - Availability: 1.5, requires libxml2 2.6+ Takes as input KML representation of geometry and outputs a PostGIS geometry object
  • ~= - Availability: 1.5.0 changed behavior Returns TRUE if A's bounding box is the same as B's.
  • ST_HausdorffDistance - Availability: 1.5.0 Returns the Hausdorff distance between two geometries.
  • ST_Intersection - Availability: 1.5 support for geography data type was introduced. (T)Returns a geometry that represents the shared portion of geomA and geomB.
  • ST_Intersects - Availability: 1.5 support for geography was introduced. Returns TRUE if the Geometries/Geography "spatially intersect in 2D" - (share any portion of space) and FALSE if they don't (they are Disjoint). For geography tolerance is 0.00001 meters (so any points that close are considered to intersect)
  • ST_Length - Availability: 1.5.0 geography support was introduced in 1.5. Returns the 2D length of a linear geometry.
  • ST_LongestLine - Availability: 1.5.0 Returns the 2D longest line between two geometries.
  • ST_MakeEnvelope - Availability: 1.5 Creates a rectangular Polygon from minimum and maximum coordinates.
  • ST_MaxDistance - Availability: 1.5.0 Returns the 2D largest distance between two geometries in projected units.
  • ST_ShortestLine - Availability: 1.5.0 Returns the 2D shortest line between two geometries
  • && - Availability: 1.5.0 support for geography was introduced. Returns TRUE if A's 2D bounding box intersects B's 2D bounding box.

14.12.12. PostGIS Functions new, behavior changed, or enhanced in 1.4

The functions given below are PostGIS functions that were introduced or enhanced in the 1.4 release.

  • Populate_Geometry_Columns - Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints. Availability: 1.4.0
  • ST_AsSVG - Returns SVG path data for a geometry. Availability: 1.2.2. Availability: 1.4.0 Changed in PostGIS 1.4.0 to include L command in absolute path to conform to http://www.w3.org/TR/SVG/paths.html#PathDataBNF
  • ST_Collect - Creates a GeometryCollection or Multi* geometry from a set of geometries. Availability: 1.4.0 - ST_Collect(geomarray) was introduced. ST_Collect was enhanced to handle more geometries faster.
  • ST_ContainsProperly - Returns true if B intersects the interior of A but not the boundary (or exterior). A does not contain properly itself, but does contain itself. Availability: 1.4.0
  • ST_Extent - an aggregate function that returns the bounding box that bounds rows of geometries. Availability: 1.4.0
  • ST_GeoHash - Return a GeoHash representation of the geometry. Availability: 1.4.0
  • ST_IsValidReason - Returns text stating if a geometry is valid, or a reason for invalidity. Availability: 1.4
  • ST_LineCrossingDirection - Given 2 linestrings, returns a number between -3 and 3 denoting what kind of crossing behavior. 0 is no crossing. Availability: 1.4
  • ST_LocateBetweenElevations - Return a derived geometry (collection) value with elements that intersect the specified range of elevations inclusively. Availability: 1.4.0
  • ST_MakeLine - Creates a Linestring from Point, MultiPoint, or LineString geometries. Availability: 1.4.0 - ST_MakeLine(geomarray) was introduced. ST_MakeLine aggregate functions was enhanced to handle more points faster.
  • ST_MinimumBoundingCircle - Returns the smallest circle polygon that can fully contain a geometry. Default uses 48 segments per quarter circle. Availability: 1.4.0
  • ST_Union - Returns a geometry that represents the point set union of the Geometries. Availability: 1.4.0 - ST_Union was enhanced. ST_Union(geomarray) was introduced and also faster aggregate collection in PostgreSQL.

14.12.13. PostGIS Functions new in 1.3

The functions given below are PostGIS functions that were introduced in the 1.3 release.

  • ST_AsGML - Return the geometry as a GML version 2 or 3 element. Availability: 1.3.2
  • ST_AsGeoJSON - Return the geometry as a GeoJSON element. Availability: 1.3.4
  • ST_CurveToLine - Converts a CIRCULARSTRING/CURVEPOLYGON/MULTISURFACE to a LINESTRING/POLYGON/MULTIPOLYGON Availability: 1.3.0
  • ST_LineToCurve - Converts a LINESTRING/POLYGON to a CIRCULARSTRING, CURVEPOLYGON Availability: 1.3.0
  • ST_SimplifyPreserveTopology - Returns a "simplified" version of the given geometry using the Douglas-Peucker algorithm. Will avoid creating derived geometries (polygons in particular) that are invalid. Availability: 1.3.3