Chapter 7. Referenz PostGIS

Table of Contents
7.1. PostgreSQL und PostGIS Datentypen - Geometry/Geography/Box
7.2. Geometrische Managementfunktionen
7.3. Geometrische Konstruktoren
7.4. Geometrische Zugriffsfunktionen
7.5. Geometrische Editoren
7.6. Geometrievalidierung
7.7. Spatial Reference System Functions
7.8. Geometrische Konstruktoren
7.8.1. Well-known-Text (WKT) Repräsentation
7.8.2. Well-known-Binary (WKB) Repräsentation
7.8.3. Weitere Formate
7.9. Geometrieausgabe
7.9.1. Well-known-Text (WKT) Repräsentation
7.9.2. Well-known-Binary (WKB) Repräsentation
7.9.3. Weitere Formate
7.10. Operatoren
7.10.1. Bounding Box Operators
7.10.2. Operatoren
7.11. Lagevergleiche
7.11.1. Topologische Beziehungen
7.11.2. Distance Relationships
7.12. Measurement Functions
7.13. Overlay Functions
7.14. Geometrieverarbeitung
7.15. Coverages
7.16. Affine Transformations
7.17. Clustering Functions
7.18. Bounding Box Functions
7.19. Kilometrierung
7.20. Trajectory Functions
7.21. SFCGAL Functions
7.22. Unterstützung von lang andauernden Transaktionen/Long Transactions
7.23. Version Functions
7.24. PostGIS Grand Unified Custom Variables (GUCs)
7.25. Troubleshooting Functions

Nachfolgend sind jene Funktionen aufgeführt, die ein PostGIS Anwender am ehesten benötigt. Es gibt weitere Funktionen, die jedoch keinen Nutzen für den allgemeinen Anwender haben, da es sich um Hilfsfunktionen für PostGIS Objekte handelt.

[Note]

PostGIS hat begonnen die bestehende Namenskonvention in eine SQL-MM orientierte Konvention zu ändern. Daher wurden die meisten Funktionen, die Sie kennen und lieben gelernt haben, mit dem Standardpräfix (ST) für spatiale Datentypen umbenannt. Vorhergegangene Funktionen sind noch verfügbar; wenn es aber entsprechende aktualisierte Funktionen gibt, dann werden sie in diesem Dokument nicht mehr aufgeführt. Wenn Funktionen kein ST_ Präfix aufweisen und in dieser Dokumentation nicht mehr angeführt sind, dann gelten sie als überholt und werden in einer zukünftigen Release entfernt. Benutzten Sie diese daher BITTE NICHT MEHR.

7.1. PostgreSQL und PostGIS Datentypen - Geometry/Geography/Box

Abstract

Dieser Abschnitt listet die von PostGIS installierten PostgreSQL-Datentypen auf. Beachten Sie bitte die hier beschriebene Verhaltensweise bei der Typumwandlung. Diese ist insbesondere dann sehr wesentlich, wenn Sie Ihre eigenen Funktionen entwerfen.

Each data type describes its type casting behavior. A type cast converts values of one data type into another type. PostgreSQL allows defining casting behavior for custom types, along with the functions used to convert type values. Casts can have automatic behavior, which allows automatic conversion of a function argument to a type supported by the function.

Some casts have explicit behavior, which means the cast must be specified using the syntax CAST(myval As sometype) or myval::sometype. Explicit casting avoids the issue of ambiguous casts, which can occur when using an overloaded function which does not support a given type. For example, a function may accept a box2d or a box3d, but not a geometry. Since geometry has an automatic cast to both box types, this produces an "ambiguous function" error. To prevent the error use an explicit cast to the desired box type.

All data types can be cast to text, so this does not need to be specified explicitly.

box2d — The type representing a 2-dimensional bounding box.
box3d — The type representing a 3-dimensional bounding box.
geometry — Der geographische Datentyp "Geography" wird zur Abbildung eines Geoobjektes im geographischen Kugelkoordinatensystem verwendet.
geometry_dump — A composite type used to describe the parts of complex geometry.
geography — The type representing spatial features with geodetic (ellipsoidal) coordinate systems.

7.2. Geometrische Managementfunktionen

Abstract

These functions assist in defining tables containing geometry columns.

AddGeometryColumn — Entfernt eine Geometriespalte aus einer räumlichen Tabelle.
DropGeometryColumn — Entfernt eine Geometriespalte aus einer räumlichen Tabelle.
DropGeometryTable — Löscht eine Tabelle und alle Referenzen in dem geometry_columns View.
Find_SRID — Returns the SRID defined for a geometry column.
Populate_Geometry_Columns — Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
UpdateGeometrySRID — Updates the SRID of all features in a geometry column, and the table metadata.

7.3. Geometrische Konstruktoren

ST_Collect — Creates a GeometryCollection or Multi* geometry from a set of geometries.
ST_LineFromMultiPoint — Erzeugt einen LineString aus einer MultiPoint Geometrie.
ST_MakeEnvelope — Erzeugt ein rechteckiges Polygon aus den gegebenen Minimum- und Maximumwerten. Die Eingabewerte müssen in dem Koordinatenreferenzsystem sein, welches durch die SRID angegeben wird.
ST_MakeLine — Erzeugt einen Linienzug aus einer Punkt-, Mehrfachpunkt- oder Liniengeometrie.
ST_MakePoint — Erzeugt eine 2D-, 3DZ- oder 4D-Punktgeometrie.
ST_MakePointM — Erzeugt einen Punkt mit x, y und measure/Kilometrierungs Koordinaten.
ST_MakePolygon — Creates a Polygon from a shell and optional list of holes.
ST_Point — Creates a Point with X, Y and SRID values.
ST_PointZ — Creates a Point with X, Y, Z and SRID values.
ST_PointM — Creates a Point with X, Y, M and SRID values.
ST_PointZM — Creates a Point with X, Y, Z, M and SRID values.
ST_Polygon — Creates a Polygon from a LineString with a specified SRID.
ST_TileEnvelope — Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.
ST_HexagonGrid — Returns a set of hexagons and cell indices that completely cover the bounds of the geometry argument.
ST_Hexagon — Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.
ST_SquareGrid — Returns a set of grid squares and cell indices that completely cover the bounds of the geometry argument.
ST_Square — Returns a single square, using the provided edge size and cell coordinate within the square grid space.
ST_Letters — Returns the input letters rendered as geometry with a default start position at the origin and default text height of 100.

7.4. Geometrische Zugriffsfunktionen

GeometryType — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
ST_Boundary — Gibt die abgeschlossene Hülle aus der kombinierten Begrenzung der Geometrie zurück.
ST_BoundingDiagonal — Gibt die Diagonale des Umgebungsdreiecks der angegebenen Geometrie zurück.
ST_CoordDim — Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
ST_Dimension — Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
ST_Dump — Returns a set of geometry_dump rows for the components of a geometry.
ST_DumpPoints — Gibt eine Zusammenfassung des Inhalts einer Geometrie wieder.
ST_DumpSegments — Gibt eine Zusammenfassung des Inhalts einer Geometrie wieder.
ST_DumpRings — Returns a set of geometry_dump rows for the exterior and interior rings of a Polygon.
ST_EndPoint — Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
ST_Envelope — Gibt eine Geometrie in doppelter Genauigkeit (float8) zurück, welche das Umgebungsrechteck der beigestellten Geometrie darstellt.
ST_ExteriorRing — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
ST_GeometryN — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
ST_GeometryType — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
ST_HasArc — Tests if a geometry contains a circular arc
ST_InteriorRingN — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
ST_IsClosed — Gibt den Wert TRUE zurück, wenn die Anfangs- und Endpunkte des LINESTRING's zusammenfallen. Bei polyedrischen Oberflächen, wenn sie geschlossen (volumetrisch) sind.
ST_IsCollection — Gibt den Wert TRUE zurück, falls es sich bei der Geometrie um eine leere GeometryCollection, Polygon, Point etc. handelt.
ST_IsEmpty — Tests if a geometry is empty.
ST_IsPolygonCCW — Gibt TRUE zurück, wenn alle äußeren Ringe gegen den Uhrzeigersinn orientiert sind und alle inneren Ringe im Uhrzeigersinn ausgerichtet sind.
ST_IsPolygonCW — Gibt den Wert TRUE zurück, wenn alle äußeren Ringe im Uhrzeigersinn und alle inneren Ringe gegen den Uhrzeigersinn ausgerichtet sind.
ST_IsRing — Tests if a LineString is closed and simple.
ST_IsSimple — Gibt den Wert (TRUE) zurück, wenn die Geometrie keine irregulären Stellen, wie Selbstüberschneidungen oder Selbstberührungen, aufweist.
ST_M — Returns the M coordinate of a Point.
ST_MemSize — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
ST_NDims — Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
ST_NPoints — Gibt die Anzahl der Punkte (Knoten) einer Geometrie zurück.
ST_NRings — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
ST_NumGeometries — Gibt die Anzahl der Punkte einer Geometrie zurück. Funktioniert für alle Geometrien.
ST_NumInteriorRings — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
ST_NumInteriorRing — Gibt die Anzahl der inneren Ringe eines Polygons in der Geometrie aus. Ist ein Synonym für ST_NumInteriorRings.
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_NumPoints — Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
ST_PatchN — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
ST_PointN — Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
ST_Points — Gibt einen MultiPoint zurück, welcher alle Koordinaten einer Geometrie enthält.
ST_StartPoint — Returns the first point of a LineString.
ST_Summary — Gibt eine Zusammenfassung des Inhalts einer Geometrie wieder.
ST_X — Returns the X coordinate of a Point.
ST_Y — Returns the Y coordinate of a Point.
ST_Z — Returns the Z coordinate of a Point.
ST_Zmflag — Gibt die Dimension der Koordinaten von ST_Geometry zurück.

7.5. Geometrische Editoren

Abstract

These functions create modified geometries by changing type, structure or vertices.

ST_AddPoint — Fügt einem Linienzug einen Punkt hinzu.
ST_CollectionExtract — Given a geometry collection, returns a multi-geometry containing only elements of a specified type.
ST_CollectionHomogenize — Returns the simplest representation of a geometry collection.
ST_CurveToLine — Converts a geometry containing curves to a linear geometry.
ST_Scroll — Change start point of a closed LineString.
ST_FlipCoordinates — Returns a version of a geometry with X and Y axis flipped.
ST_Force2D — Die Geometrien in einen "2-dimensionalen Modus" zwingen.
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_Force3DM — Zwingt die Geometrien in einen XYM Modus.
ST_Force4D — Zwingt die Geometrien in einen XYZM Modus.
ST_ForcePolygonCCW — Richtet alle äußeren Ringe gegen den Uhrzeigersinn und alle inneren Ringe mit dem Uhrzeigersinn aus.
ST_ForceCollection — Wandelt eine Geometrie in eine GEOMETRYCOLLECTION um.
ST_ForcePolygonCW — Richtet alle äußeren Ringe im Uhrzeigersinn und alle inneren Ringe gegen den Uhrzeigersinn aus.
ST_ForceSFS — Erzwingt, dass Geometrien nur vom Typ SFS 1.1 sind.
ST_ForceRHR — Orientiert die Knoten in einem Polygon so, dass sie der Drei-Finger-Regel folgen.
ST_ForceCurve — Wandelt einen geometrischen in einen Kurven Datentyp um, soweit anwendbar.
ST_LineToCurve — Converts a linear geometry to a curved geometry.
ST_Multi — Gibt die Geometrie als MULTI* Geometrie zurück.
ST_LineExtend — Returns a line with the last and first segments extended the specified distance(s).
ST_Normalize — Gibt die Geometrie in Normalform zurück.
ST_Project — Returns a point projected from a start point by a distance and bearing (azimuth).
ST_QuantizeCoordinates — Setzt die niedrigwertigsten Bits der Koordinaten auf Null
ST_RemovePoint — Remove a point from a linestring.
ST_RemoveRepeatedPoints — Returns a version of a geometry with duplicate points removed.
ST_Reverse — Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
ST_Segmentize — Returns a modified geometry/geography having no segment longer than a given distance.
ST_SetPoint — Einen Punkt eines Linienzuges durch einen gegebenen Punkt ersetzen.
ST_ShiftLongitude — Shifts the longitude coordinates of a geometry between -180..180 and 0..360.
ST_WrapX — Versammelt eine Geometrie um einen X-Wert
ST_SnapToGrid — Fängt alle Punkte der Eingabegeometrie auf einem regelmäßigen Gitter.
ST_Snap — Fängt die Segmente und Knoten einer Eingabegeometrie an den Knoten einer Referenzgeometrie.
ST_SwapOrdinates — Gibt eine Version der Ausgangsgeometrie zurück, in der die angegebenen Ordinatenwerte ausgetauscht werden.

7.6. Geometrievalidierung

Abstract

These functions test whether geometries are valid according to the OGC SFS standard. They also provide information about the nature and location of invalidity. There is also a function to create a valid geometry out of an invalid one.

ST_IsValid — Tests if a geometry is well-formed in 2D.
ST_IsValidDetail — Returns a valid_detail row stating if a geometry is valid or if not a reason and a location.
ST_IsValidReason — Returns text stating if a geometry is valid, or a reason for invalidity.
ST_MakeValid — Attempts to make an invalid geometry valid without losing vertices.

7.7. Spatial Reference System Functions

Abstract

These functions work with the Spatial Reference System of geometries as defined in the spatial_ref_sys table.

ST_InverseTransformPipeline — Return a new geometry with coordinates transformed to a different spatial reference system using the inverse of a defined coordinate transformation pipeline.
ST_SetSRID — Set the SRID on a geometry.
ST_SRID — Returns the spatial reference identifier for a geometry.
ST_Transform — Return a new geometry with coordinates transformed to a different spatial reference system.
ST_TransformPipeline — Return a new geometry with coordinates transformed to a different spatial reference system using a defined coordinate transformation pipeline.
postgis_srs_codes — Return the list of SRS codes associated with the given authority.
postgis_srs — Return a metadata record for the requested authority and srid.
postgis_srs_all — Return metadata records for every spatial reference system in the underlying Proj database.
postgis_srs_search — Return metadata records for projected coordinate systems that have areas of useage that fully contain the bounds parameter.

7.8. Geometrische Konstruktoren

Abstract

Diese Funktionen erstellen geometrische Objekte aus unterschiedlichen Text- oder Binärformaten.

7.8.1. Well-known-Text (WKT) Repräsentation

ST_BdPolyFromText — Konstruiert ein Polygon aus einer beliebigen Ansammlung von geschlossenen Linienzügen, welche als MultiLineString in der Well-Known Text Darstellung vorliegen müssen.
ST_BdMPolyFromText — Konstruiert ein MultiPolygon aus einer beliebigen Ansammlung von geschlossenen Linienzügen, welche als MultiLineString in der Well-Known Text Darstellung vorliegen müssen.
ST_GeogFromText — Gibt einen geographischen Datentyp aus einer Well-known-Text (WKT), oder einer erweiterten WKT (EWKT), Darstellung zurück.
ST_GeographyFromText — Gibt einen geographischen Datentyp aus einer Well-known-Text (WKT), oder einer erweiterten WKT (EWKT), Darstellung zurück.
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.
ST_GeomFromEWKT — Gibt einen spezifizierten ST_Geometry-Wert von einer erweiterten Well-known-Text Darstellung (EWKT) zurück.
ST_GeomFromMARC21 — Takes MARC21/XML geographic data as input and returns a PostGIS geometry object.
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
ST_GeomFromText — Gibt einen spezifizierten ST_Geometry Wert aus einer Well-known-Text Darstellung (WKT) zurück.
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.
ST_MLineFromText — Liest einen festgelegten ST_MultiLineString Wert von einer WKT-Darstellung aus.
ST_MPointFromText — Erzeugt eine Geometrie aus WKT mit der angegebenen SRID. Wenn keine SRID angegeben wird, wird diese standardmäßig auf 0 gesetzt.
ST_MPolyFromText — Erzeugt eine MultiPolygon Geometrie aus WKT mit der angegebenen SRID. Wenn SRID nicht angegeben ist, wird sie standardmäßig auf 0 gesetzt.
ST_PointFromText — Erzeugt eine Punktgeometrie mit gegebener SRID von WKT. Wenn SRID nicht angegeben ist, wird sie standardmäßig auf 0 gesetzt.
ST_PolygonFromText — Erzeugt eine Geometrie aus WKT mit der angegebenen SRID. Wenn keine SRID angegeben wird, wird diese standardmäßig auf 0 gesetzt.
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

7.8.2. Well-known-Binary (WKB) Repräsentation

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_GeomFromWKB — Erzeugt ein geometrisches Objekt aus der Well-known-Binary (WKB) Darstellung und einer optionalen SRID.
ST_LineFromWKB — Erzeugt einen LINESTRING mit gegebener SRID aus einer WKB-Darstellung
ST_LinestringFromWKB — Erzeugt eine Geometrie mit gegebener SRID aus einer WKB-Darstellung.
ST_PointFromWKB — Erzeugt eine Geometrie mit gegebener SRID von WKB.
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

7.8.3. Weitere Formate

ST_Box2dFromGeoHash — Gibt die BOX2D einer GeoHash Zeichenkette zurück.
ST_GeomFromGeoHash — Gibt die Geometrie einer GeoHash Zeichenfolge 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_GeomFromTWKB — Erzeugt eine Geometrie aus einer TWKB ("Tiny Well-Known Binary") Darstellung.
ST_GMLToSQL — Gibt einen spezifizierten ST_Geometry Wert aus einer GML-Darstellung zurück. Dies ist ein Aliasname für ST_GeomFromGML
ST_LineFromEncodedPolyline — Erzeugt einen LineString aus einem codierten Linienzug.
ST_PointFromGeoHash — Gibt einen Punkt von einer GeoHash Zeichenfolge zurück.
ST_FromFlatGeobufToTable — Creates a table based on the structure of FlatGeobuf data.
ST_FromFlatGeobuf — Reads FlatGeobuf data.

7.9. Geometrieausgabe

Abstract

Diese Funktionen konvertieren Geo-Objekte in unterschiedliche Text- oder Binärformate.

7.9.1. Well-known-Text (WKT) Repräsentation

ST_AsEWKT — Gibt die Well-known-Text(WKT) Darstellung der Geometrie mit den SRID-Metadaten zurück.
ST_AsText — Gibt die Well-known-Text(WKT) Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.

7.9.2. Well-known-Binary (WKB) Repräsentation

ST_AsBinary — Return the OGC/ISO Well-Known Binary (WKB) representation of the geometry/geography without SRID meta data.
ST_AsEWKB — Return the Extended Well-Known Binary (EWKB) representation of the geometry with SRID meta data.
ST_AsHEXEWKB — Gibt eine Geometrie im HEXEWKB Format (als Text) aus; verwendet entweder die Little-Endian (NDR) oder die Big-Endian (XDR) Zeichenkodierung.

7.9.3. Weitere Formate

ST_AsEncodedPolyline — Erzeugt eine codierte Polylinie aus einer LineString Geometrie.
ST_AsFlatGeobuf — Return a FlatGeobuf representation of a set of rows.
ST_AsGeobuf — Gibt eine Menge an Zeilen in der Geobuf Darstellung aus.
ST_AsGeoJSON — Return a geometry as a GeoJSON element.
ST_AsGML — Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
ST_AsKML — Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
ST_AsLatLonText — Gibt die "Grad, Minuten, Sekunden"-Darstellung für den angegebenen Punkt aus.
ST_AsMARC21 — Returns geometry as a MARC21/XML record with a geographic datafield (034).
ST_AsMVTGeom — Transforms a geometry into the coordinate space of a MVT tile.
ST_AsMVT — Aggregate function returning a MVT representation of a set of rows.
ST_AsSVG — Gibt eine Geometrie als SVG-Pfad aus.
ST_AsTWKB — Gibt die Geometrie als TWKB, aka "Tiny Well-known Binary" zurück
ST_AsX3D — Gibt eine Geometrie im X3D XML Knotenelement-Format zurück: ISO-IEC-19776-1.2-X3DEncodings-XML
ST_GeoHash — Gibt die Geometrie in der GeoHash Darstellung aus.

7.10. Operatoren

7.10.1. Bounding Box Operators

&& — Gibt TRUE zurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B 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.
&&(box2df,geometry) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet.
&&(box2df,box2df) — Gibt TRUE zurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden.
&&& — Gibt TRUE zurück, wenn A's n-D bounding box B's n-D bounding box schneidet.
&&&(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.
&< — Gibt TRUE zurück, wenn die bounding box der Geometrie A, die bounding box der Geometrie B überlagert oder links davon liegt.
&<| — 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 jene von B überlagert oder rechts davon liegt.
<< — Gibt TRUE zurück, wenn die Bounding Box von A zur Gänze links von der von B liegt.
<<| — Gibt TRUE zurück, wenn A's Bounding Box zur Gänze unterhalb von der von B liegt.
= — 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 A's bounding box zur Gänze rechts von der von B liegt.
@ — Gibt TRUE zurück, wenn die Bounding Box von A in jener von B 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,geometry) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist..
@(box2df,box2df) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist.
|&> — Gibt TRUE zurück, wenn A's bounding box diejenige von B überlagert oder oberhalb von B liegt.
|>> — Gibt TRUE zurück, wenn A's bounding box is zur Gänze oberhalb der von B liegt.
~ — Gibt TRUE zurück, wenn A's bounding box die von B 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,geometry) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält.
~(box2df,box2df) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält.
~= — Gibt TRUE zurück, wenn die bounding box von A ident mit jener von B ist.

7.10.2. Operatoren

<-> — Gibt die 2D Entfernung zwischen A und B zurück.
|=| — Gibt die Entfernung zwischen den Trajektorien A und B, am Ort der dichtesten Annäherung, an.
<#> — Gibt die 2D Entfernung zwischen den Bounding Boxes von A und B zurück
<<->> — Gibt die n-D Entfernung zwischen den geometrischen Schwerpunkten der Begrenzungsrechtecke/Bounding Boxes von A und B zurück.
<<#>> — Gibt die n-D Entfernung zwischen den Bounding Boxes von A und B zurück.

7.11. Lagevergleiche

Abstract

These functions determine spatial relationships between geometries.

7.11.1. Topologische Beziehungen

ST_3DIntersects — Tests if two geometries spatially intersect in 3D - only for points, linestrings, polygons, polyhedral surface (area)
ST_Contains — Tests if every point of B lies in A, and their interiors have a point in common
ST_ContainsProperly — Tests if every point of B lies in the interior of A
ST_CoveredBy — Tests if every point of A lies in B
ST_Covers — Tests if every point of B lies in A
ST_Crosses — Tests if two geometries have some, but not all, interior points in common
ST_Disjoint — Tests if two geometries have no points in common
ST_Equals — Tests if two geometries include the same set of points
ST_Intersects — Tests if two geometries intersect (they have at least one point in common)
ST_LineCrossingDirection — Returns a number indicating the crossing behavior of two LineStrings
ST_OrderingEquals — Tests if two geometries represent the same geometry and have points in the same directional order
ST_Overlaps — Tests if two geometries have the same dimension and intersect, but each has at least one point not in the other
ST_Relate — Tests if two geometries have a topological relationship matching an Intersection Matrix pattern, or computes their Intersection Matrix
ST_RelateMatch — Tests if a DE-9IM Intersection Matrix matches an Intersection Matrix pattern
ST_Touches — Tests if two geometries have at least one point in common, but their interiors do not intersect
ST_Within — Tests if every point of A lies in B, and their interiors have a point in common

7.11.2. Distance Relationships

ST_3DDWithin — Tests if two 3D geometries are within a given 3D distance
ST_3DDFullyWithin — Tests if two 3D geometries are entirely within a given 3D distance
ST_DFullyWithin — Tests if two geometries are entirely within a given distance
ST_DWithin — Tests if two geometries are within a given distance
ST_PointInsideCircle — Tests if a point geometry is inside a circle defined by a center and radius

7.12. Measurement Functions

Abstract

These functions compute measurements of distance, area and angles. There are also functions to compute geometry values determined by measurements.

ST_Area — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
ST_Azimuth — Gibt die 2-dimenionale kürzeste Strecke zwischen zwei Geometrien als Linie zurück
ST_Angle — Gibt den Winkel zwischen 3 Punkten oder zwischen 2 Vektoren (4 Punkte oder 2 Linien) zurück.
ST_ClosestPoint — Returns the 2D point on g1 that is closest to g2. This is the first point of the shortest line from one geometry to the other.
ST_3DClosestPoint — Gibt den 3-dimensionalen Punkt auf g1 zurück, der den kürzesten Abstand zu g2 hat. Dies ist der Anfangspunkt des kürzesten Abstands in 3D.
ST_Distance — Gibt die größte 3-dimensionale Distanz zwischen zwei geometrischen Objekten als Linie zurück
ST_3DDistance — Für den geometrischen Datentyp. Es wird der geringste 3-dimensionale kartesische Abstand (basierend auf dem Koordinatenreferenzsystem) zwischen zwei geometrischen Objekten in projizierten Einheiten zurückgegeben.
ST_DistanceSphere — Gibt die kürzeste Distanz zwischen zwei geometrischen Objekten zurück, die über Länge, Breite und ein bestimmtes Referenzellipsoid gegeben sind. Vorgängerversionen von PostGIS 1.5 unterstützten nur Punkte.
ST_DistanceSpheroid — Gibt die kürzeste Distanz zwischen zwei geometrischen Objekten zurück, die über Länge, Breite und ein bestimmtes Referenzellipsoid gegeben sind. Vorgängerversionen von PostGIS 1.5 unterstützten nur Punkte.
ST_FrechetDistance — Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück
ST_HausdorffDistance — Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück
ST_Length — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
ST_Length2D — Gibt die 2-dimensionale Länge einer Linie oder einer Mehrfachlinie zurück. Dies ist ein Alias für ST_Length
ST_3DLength — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
ST_LengthSpheroid — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
ST_LongestLine — Gibt die größte 3-dimensionale Distanz zwischen zwei geometrischen Objekten als Linie zurück
ST_3DLongestLine — Gibt die größte 3-dimensionale Distanz zwischen zwei geometrischen Objekten als Linie zurück
ST_MaxDistance — Gibt die größte 2-dimensionale Distanz zwischen zwei geometrischen Objekten in projizierten Einheiten zurück.
ST_3DMaxDistance — Für den geometrischen Datentyp. Gibt die maximale 3-dimensionale kartesische Distanz (basierend auf dem Koordinatenreferenzsystem) zwischen zwei geometrischen Objekten in projizierten Einheiten zurück.
ST_MinimumClearance — Gibt das Mindestabstandsmaß für eine Geometrie zurück; ein Maß für die Robustheit einer Geometrie.
ST_MinimumClearanceLine — Gibt ein Linienstück mit zwei Punkten zurück, welche sich über das Mindestabstandsmaß erstreckt.
ST_Perimeter — Returns the length of the boundary of a polygonal geometry or geography.
ST_Perimeter2D — Returns the 2D perimeter of a polygonal geometry. Alias for ST_Perimeter.
ST_3DPerimeter — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
ST_ShortestLine — Gibt die 2-dimenionale kürzeste Strecke zwischen zwei Geometrien als Linie zurück
ST_3DShortestLine — Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück

7.13. Overlay Functions

Abstract

These functions compute results arising from the overlay of two geometries. These are also known as point-set theoretic boolean operations. Some related functions are also provided.

ST_ClipByBox2D — Computes the portion of a geometry falling within a rectangle.
ST_Difference — Computes a geometry representing the part of geometry A that does not intersect geometry B.
ST_Intersection — Computes a geometry representing the shared portion of geometries A and B.
ST_MemUnion — Aggregate function which unions geometries in a memory-efficent but slower way
ST_Node — Nodes a collection of lines.
ST_Split — Returns a collection of geometries created by splitting a geometry by another geometry.
ST_Subdivide — Computes a rectilinear subdivision of a geometry.
ST_SymDifference — Computes a geometry representing the portions of geometries A and B that do not intersect.
ST_UnaryUnion — Computes the union of the components of a single geometry.
ST_Union — Computes a geometry representing the point-set union of the input geometries.

7.14. Geometrieverarbeitung

Abstract

These functions compute geometric constructions, or alter geometry size or shape.

ST_Buffer — Computes a geometry covering all points within a given distance from a geometry.
ST_BuildArea — Creates a polygonal geometry formed by the linework of a geometry.
ST_Centroid — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
ST_ChaikinSmoothing — Returns a smoothed version of a geometry, using the Chaikin algorithm
ST_ConcaveHull — Computes a possibly concave geometry that contains all input geometry vertices
ST_ConvexHull — Berechnet die konvexe Hülle einer Geometrie.
ST_DelaunayTriangles — Returns the Delaunay triangulation of the vertices of a geometry.
ST_FilterByM — Removes vertices based on their M value
ST_GeneratePoints — Generates random points contained in a Polygon or MultiPolygon.
ST_GeometricMedian — Gibt den geometrischen Median eines Mehrfachpunktes zurück.
ST_LineMerge — Return the lines formed by sewing together a MultiLineString.
ST_MaximumInscribedCircle — Berechnet die konvexe Hülle einer Geometrie.
ST_LargestEmptyCircle — Computes the largest circle not overlapping a geometry.
ST_MinimumBoundingCircle — Returns the smallest circle polygon that contains a geometry.
ST_MinimumBoundingRadius — Returns the center point and radius of the smallest circle that contains a geometry.
ST_OrientedEnvelope — Returns a minimum-area rectangle containing a geometry.
ST_OffsetCurve — Returns an offset line at a given distance and side from an input line.
ST_PointOnSurface — Computes a point guaranteed to lie in a polygon, or on a geometry.
ST_Polygonize — Computes a collection of polygons formed from the linework of a set of geometries.
ST_ReducePrecision — Returns a valid geometry with points rounded to a grid tolerance.
ST_SharedPaths — Gibt eine Sammelgeometrie zurück, welche die gemeinsamen Strecken der beiden eingegebenen LineStrings/MultiLinestrings enthält.
ST_Simplify — Returns a simplified version of a geometry, using the Douglas-Peucker algorithm.
ST_SimplifyPreserveTopology — Returns a simplified and valid version of a geometry, using the Douglas-Peucker algorithm.
ST_SimplifyPolygonHull — Computes a simplifed topology-preserving outer or inner hull of a polygonal geometry.
ST_SimplifyVW — Returns a simplified version of a geometry, using the Visvalingam-Whyatt algorithm
ST_SetEffectiveArea — Sets the effective area for each vertex, using the Visvalingam-Whyatt algorithm.
ST_TriangulatePolygon — Computes the constrained Delaunay triangulation of polygons
ST_VoronoiLines — Returns the boundaries of the Voronoi diagram of the vertices of a geometry.
ST_VoronoiPolygons — Returns the cells of the Voronoi diagram of the vertices of a geometry.

7.15. Coverages

Abstract

These functions operate on sets of polygonal geometry that form "implicit coverages". To form a valid coverage polygons must not overlap, and the vertices of adjacent edges must match exactly. Coverages are fast to process, and can be operated on with window functions, which retain the coverage topology inside the window partition while altering the edges.

ST_CoverageInvalidEdges — Window function that finds locations where polygons fail to form a valid coverage.
ST_CoverageSimplify — Window function that simplifies the edges of a polygonal coverage.
ST_CoverageUnion — Computes the union of a set of polygons forming a coverage by removing shared edges.

7.16. Affine Transformations

Abstract

These functions change the position and shape of geometries using affine transformations.

ST_Affine — Apply a 3D affine transformation to a geometry.
ST_Rotate — Rotates a geometry about an origin point.
ST_RotateX — Rotates a geometry about the X axis.
ST_RotateY — Rotates a geometry about the Y axis.
ST_RotateZ — Rotates a geometry about the Z axis.
ST_Scale — Scales a geometry by given factors.
ST_Translate — Translates a geometry by given offsets.
ST_TransScale — Translates and scales a geometry by given offsets and factors.

7.17. Clustering Functions

Abstract

These functions implement clustering algorithms for sets of geometries.

ST_ClusterDBSCAN — Window function that returns a cluster id for each input geometry using the DBSCAN algorithm.
ST_ClusterIntersecting — Aggregate function that clusters input geometries into connected sets.
ST_ClusterIntersectingWin — Window function that returns a cluster id for each input geometry, clustering input geometries into connected sets.
ST_ClusterKMeans — Window function that returns a cluster id for each input geometry using the K-means algorithm.
ST_ClusterWithin — Aggregate function that clusters geometries by separation distance.
ST_ClusterWithinWin — Window function that returns a cluster id for each input geometry, clustering using separation distance.

7.18. Bounding Box Functions

Abstract

These functions produce or operate on bounding boxes. They can also provide and accept geometry values, by using automatic or explicit casts.

Siehe auch Section 12.7, “PostGIS Box Functions”.

Box2D — Returns a BOX2D representing the 2D extent of a geometry.
Box3D — Returns a BOX3D representing the 3D extent of a geometry.
ST_EstimatedExtent — Returns the estimated extent of a spatial table.
ST_Expand — Returns a bounding box expanded from another bounding box or a geometry.
ST_Extent — Aggregate function that returns the bounding box of geometries.
ST_3DExtent — Aggregate function that returns the 3D bounding box of geometries.
ST_MakeBox2D — Creates a BOX2D defined by two 2D point geometries.
ST_3DMakeBox — Creates a BOX3D defined by two 3D point geometries.
ST_XMax — Returns the X maxima of a 2D or 3D bounding box or a geometry.
ST_XMin — Returns the X minima of a 2D or 3D bounding box or a geometry.
ST_YMax — Returns the Y maxima of a 2D or 3D bounding box or a geometry.
ST_YMin — Returns the Y minima of a 2D or 3D bounding box or a geometry.
ST_ZMax — Returns the Z maxima of a 2D or 3D bounding box or a geometry.
ST_ZMin — Returns the Z minima of a 2D or 3D bounding box or a geometry.

7.19. Kilometrierung

ST_LineInterpolatePoint — Gibt einen oder mehrere, entlang einer Linie interpolierte Punkte zurück.
ST_3DLineInterpolatePoint — Gibt einen oder mehrere, entlang einer Linie interpolierte Punkte zurück.
ST_LineInterpolatePoints — Gibt einen oder mehrere, entlang einer Linie interpolierte Punkte zurück.
ST_LineLocatePoint — Returns the fractional location of the closest point on a line to a point.
ST_LineSubstring — Returns the part of a line between two fractional locations.
ST_LocateAlong — Returns the point(s) on a geometry that match a measure value.
ST_LocateBetween — Returns the portions of a geometry that match a measure range.
ST_LocateBetweenElevations — Returns the portions of a geometry that lie in an elevation (Z) range.
ST_InterpolatePoint — Für einen gegebenen Punkt wird die Kilometrierung auf dem nächstliegenden Punkt einer Geometrie zurück.
ST_AddMeasure — Interpolates measures along a linear geometry.

7.20. Trajectory Functions

Abstract

These functions support working with trajectories. A trajectory is a linear geometry with increasing measures (M value) on each coordinate. Spatio-temporal data can be modeled by using relative times (such as the epoch) as the measure values.

ST_IsValidTrajectory — Tests if the geometry is a valid trajectory.
ST_ClosestPointOfApproach — Returns a measure at the closest point of approach of two trajectories.
ST_DistanceCPA — Returns the distance between the closest point of approach of two trajectories.
ST_CPAWithin — Tests if the closest point of approach of two trajectories is within the specified distance.

7.21. SFCGAL Functions

Abstract

SFCGAL is a C++ wrapper library around CGAL that provides advanced 2D and 3D spatial functions. For robustness, geometry coordinates have an exact rational number representation.

Installation instructions for the library can be found on the SFCGAL home page (http://www.sfcgal.org). To enable the functions use create extension postgis_sfcgal.

postgis_sfcgal_version — Returns the version of SFCGAL in use
postgis_sfcgal_full_version — Returns the full version of SFCGAL in use including CGAL and Boost versions
ST_3DArea — Computes area of 3D surface geometries. Will return 0 for solids.
ST_3DConvexHull — Berechnet die konvexe Hülle einer Geometrie.
ST_3DIntersection — Perform 3D intersection
ST_3DDifference — Perform 3D difference
ST_3DUnion — Perform 3D union.
ST_AlphaShape — Computes an Alpha-shape enclosing a geometry
ST_ApproximateMedialAxis — Berechnet die konvexe Hülle einer Geometrie.
ST_ConstrainedDelaunayTriangles — Return a constrained Delaunay triangulation around the given input geometry.
ST_Extrude — Extrude a surface to a related volume
ST_ForceLHR — Force LHR orientation
ST_IsPlanar — Check if a surface is or not planar
ST_IsSolid — Test if the geometry is a solid. No validity check is performed.
ST_MakeSolid — 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_MinkowskiSum — Performs Minkowski sum
ST_OptimalAlphaShape — Computes an Alpha-shape enclosing a geometry using an "optimal" alpha value.
ST_Orientation — Determine surface orientation
ST_StraightSkeleton — Berechnet die konvexe Hülle einer Geometrie.
ST_Tesselate — Perform surface Tesselation of a polygon or polyhedralsurface and returns as a TIN or collection of TINS
ST_Volume — Computes the volume of a 3D solid. If applied to surface (even closed) geometries will return 0.

7.22. Unterstützung von lang andauernden Transaktionen/Long Transactions

Abstract

Dieses Modul und die zugehörigen pl/pgsql Funktionen wurden implementiert, um "long locking" Unterstützung anzubieten. Dies wird von der Web Feature Service Spezifikation verlangt.

AddAuth — Fügt einen Berechtigungsschlüssel für die aktuelle Transaktion hinzu.
CheckAuth — Legt einen Trigger auf eine Tabelle an um, basierend auf einen Token, Updates und Deletes von Zeilen zu verhindern oder zu erlauben.
DisableLongTransactions — DisableLongTransactions
EnableLongTransactions — EnableLongTransactions
LockRow — Setzt einen Lock/Autorisierung auf eine bestimmte Zeile in der Tabelle
UnlockRows — Removes all locks held by an authorization token.
[Note]

Es muss serializable transaction level angewandt werden, da sonst der "Locking" Mechanismus versagt.

7.23. Version Functions

Abstract

These functions report and upgrade PostGIS versions.

PostGIS_Extensions_Upgrade — Packages and upgrades PostGIS extensions (e.g. postgis_raster, postgis_topology, postgis_sfcgal) to given or latest version.
PostGIS_Full_Version — Reports full PostGIS version and build configuration infos.
PostGIS_GEOS_Version — Returns the version number of the GEOS library.
PostGIS_GEOS_Compiled_Version — Returns the version number of the GEOS library against which PostGIS was built.
PostGIS_Liblwgeom_Version — Returns the version number of the liblwgeom library. This should match the version of PostGIS.
PostGIS_LibXML_Version — Returns the version number of the libxml2 library.
PostGIS_Lib_Build_Date — Returns build date of the PostGIS library.
PostGIS_Lib_Version — Returns the version number of the PostGIS library.
PostGIS_PROJ_Version — Returns the version number of the PROJ4 library.
PostGIS_Wagyu_Version — Returns the version number of the internal Wagyu library.
PostGIS_Scripts_Build_Date — Returns build date of the PostGIS scripts.
PostGIS_Scripts_Installed — Returns version of the PostGIS scripts installed in this database.
PostGIS_Scripts_Released — Returns the version number of the postgis.sql script released with the installed PostGIS lib.
PostGIS_Version — Returns PostGIS version number and compile-time options.

7.24. PostGIS Grand Unified Custom Variables (GUCs)

Abstract

Dieser Abschnitt listet die PostGIS-spezifischen Grand Unified Custom Variables (GUC) auf. Diese können global, pro Datenbank, Session oder Transaktion gesetzt werden. Am Besten werden diese global oder auf Datenbankebene gesetzt.

postgis.backend — Dieses Backend stellt eine Funktion zur Auswahl zwischen GEOS und SFCGAL zur Verfügung.
postgis.gdal_datapath — Eine Konfigurationsmöglichkeit um den Wert von GDAL's GDAL_DATA Option zu setzen. Wenn sie nicht gesetzt ist, wird die Umgebungsvariable GDAL_DATA verwendet.
postgis.gdal_enabled_drivers — Eine Konfigurationsmöglichkeit um einen GDAL Treiber in der PostGIS Umgebung zu aktivieren. Beeinflusst die Konfigurationsvariable GDAL_SKIP von GDAL.
postgis.enable_outdb_rasters — Eine boolesche Konfigurationsmöglichkeit um den Zugriff auf out-db Rasterbänder zu ermöglichen
postgis.gdal_vsi_options — Eine boolesche Konfigurationsmöglichkeit um den Zugriff auf out-db Rasterbänder zu ermöglichen

7.25. Troubleshooting Functions

Abstract

These functions are utilities for troubleshooting and repairing geometry data. They are only needed if the geometry data is corrupted in some way, which should never happen under normal circumstances.

PostGIS_AddBBox — Add bounding box to the geometry.
PostGIS_DropBBox — Drop the bounding box cache from the geometry.
PostGIS_HasBBox — Returns TRUE if the bbox of this geometry is cached, FALSE otherwise.