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.
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. |
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.
Jeder Datentyp beschreibt sein Typ-Casting-Verhalten. Ein Typ-Cast konvertiert Werte eines Datentyps in einen anderen Typ. PostgreSQL erlaubt es, das Casting-Verhalten für benutzerdefinierte Typen zu definieren, zusammen mit den Funktionen, die zur Konvertierung von Typwerten verwendet werden. Casts können ein automatisches Verhalten haben, das eine automatische Konvertierung eines Funktionsarguments in einen von der Funktion unterstützten Typ erlaubt.
Einige Casts haben explizites Verhalten, d.h. der Cast muss mit der Syntax CAST(myval As sometype)
oder myval::sometype
angegeben werden. Durch explizites Casting wird das Problem mehrdeutiger Casts vermieden, das auftreten kann, wenn eine überladene Funktion verwendet wird, die einen bestimmten Typ nicht unterstützt. Zum Beispiel kann eine Funktion ein box2d oder ein box3d akzeptieren, aber keine Geometrie. Da geometry automatisch auf beide Box-Typen gecastet wird, führt dies zu einem "ambiguous function"-Fehler. Um diesen Fehler zu vermeiden, muss ein expliziter Cast auf den gewünschten Box-Typ durchgeführt werden.
Alle Datentypen können in text
umgewandelt werden, so dass dies nicht explizit angegeben werden muss.
Diese Funktionen helfen bei der Definition von Tabellen mit Geometriespalten.
geometry_dump
Zeilen für die Komponenten einer Geometrie zurück.
geometry_dump
Zeilen für die äußeren und inneren Ringe eines Polygons zurück.
TRUE
zurück, wenn die Anfangs- und Endpunkte des LINESTRING
's zusammenfallen. Bei polyedrischen Oberflächen, wenn sie geschlossen (volumetrisch) sind.
Diese Funktionen erzeugen modifizierte Geometrien, indem sie den Typ, die Struktur oder die Scheitelpunkte ändern.
Diese Funktionen prüfen, ob die Geometrien gemäß dem OGC SFS-Standard gültig sind. Sie liefern auch Informationen über die Art und den Ort der Ungültigkeit. Es gibt auch eine Funktion zur Erstellung einer gültigen Geometrie aus einer ungültigen.
valid_detail
zurück, die angibt, ob eine Geometrie gültig ist oder, falls nicht, einen Grund und einen Ort.
Diese Funktionen arbeiten mit dem räumlichen Bezugssystem der Geometrien, wie es in der Tabelle spatial_ref_sys
definiert ist.
Diese Funktionen erstellen geometrische Objekte aus unterschiedlichen Text- oder Binärformaten.
LINESTRING
mit gegebener SRID aus einer WKB-Darstellung
Diese Funktionen konvertieren Geo-Objekte in unterschiedliche Text- oder Binärformate.
TRUE
zurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B schneidet.
TRUE
zurück, wenn sich die 2D Bounding Box (cached) einer Geometrie mit einer 2D Bounding Box mit Gleitpunktgenauigkeit (BOX2DF) überschneidet.
TRUE
zurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet.
TRUE
zurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden.
TRUE
zurück, wenn A's n-D bounding box B's n-D bounding box schneidet.
TRUE
zurück, wenn die (cached) n-D bounding box einer Geometrie eine n-D float precision bounding box (GIDX) schneidet.
TRUE
zurück, wenn eine n-D float precision bounding box (GIDX) eine (cached) n-D bounding box einer Geometrie schneidet.
TRUE
zurück, wenn sich zwei n-D float precision bounding boxes (GIDX) gegenseitig überschneiden.
TRUE
zurück, wenn die bounding box der Geometrie A, die bounding box der Geometrie B überlagert oder links davon liegt.
TRUE
zurück, wenn die bounding box von A jene von B überlagert oder unterhalb liegt.
TRUE
zurück, wenn die Bounding Box von A jene von B überlagert oder rechts davon liegt.
TRUE
zurück, wenn die Bounding Box von A zur Gänze links von der von B liegt.
TRUE
zurück, wenn A's Bounding Box zur Gänze unterhalb von der von B liegt.
TRUE
zurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind.
TRUE
zurück, wenn A's bounding box zur Gänze rechts von der von B liegt.
TRUE
zurück, wenn die Bounding Box von A in jener von B enthalten ist.
TRUE
zurück, wenn die 2D Bounding Box einer Geometrie in einer 2D float precision Bbounding Box (BOX2DF) enthalten ist.
TRUE
zurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist..
TRUE
zurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist.
TRUE
zurück, wenn A's bounding box diejenige von B überlagert oder oberhalb von B liegt.
TRUE
zurück, wenn A's bounding box is zur Gänze oberhalb der von B liegt.
TRUE
zurück, wenn A's bounding box die von B enthält.
TRUE
zurück, wenn die 2D bounding box einer Geometrie eine 2D float precision bounding box (GIDX) enthält.
TRUE
zurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält.
TRUE
zurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält.
TRUE
zurück, wenn die bounding box von A ident mit jener von B ist.
Diese Funktionen bestimmen die räumlichen Beziehungen zwischen Geometrien.
Mit diesen Funktionen werden Messungen von Abständen, Flächen und Winkeln berechnet. Es gibt auch Funktionen zur Berechnung von Geometriewerten, die durch Messungen bestimmt werden.
ST_Length
ST_Perimeter
.
Diese Funktionen berechnen Ergebnisse, die sich aus der Überlagerung von zwei Geometrien ergeben. Sie werden auch als punktmengentheoretische boolesche Operationen bezeichnet. Es werden auch einige verwandte Funktionen angeboten.
Diese Funktionen berechnen geometrische Konstruktionen oder ändern Größe oder Form der Geometrie.
Diese Funktionen arbeiten mit Mengen polygonaler Geometrie, die "implizite Überdeckungen" bilden. Um eine gültige Abdeckung zu bilden, dürfen sich die Polygone nicht überlappen, und die Eckpunkte benachbarter Kanten müssen genau übereinstimmen. Deckungen sind schnell zu verarbeiten und können mit Fensterfunktionen bearbeitet werden, die die Topologie der Deckung innerhalb der Fensterpartition beibehalten, während die Kanten verändert werden.
Diese Funktionen verändern die Position und Form von Geometrien mit Hilfe von affinen Transformationen.
Diese Funktionen implementieren Clustering-Algorithmen für Mengen von Geometrien.
Diese Funktionen erzeugen oder bearbeiten Begrenzungsrahmen. Sie können auch Geometriewerte bereitstellen und akzeptieren, indem sie automatische oder explizite Casts verwenden.
Siehe auch Section 13.7, “PostGIS-Box-Funktionen”.
Diese Funktionen unterstützen die Arbeit mit Trajektorien. Eine Trajektorie ist eine lineare Geometrie mit ansteigenden Messwerten (M-Wert) auf jeder Koordinate. Räumlich-zeitliche Daten können modelliert werden, indem relative Zeiten (wie die Epoche) als Messwerte verwendet werden.
Diese Funktionen melden und aktualisieren PostGIS-Versionen.
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.
For more examples of usage refer to SQL SET and SQL ALTER SYSTEM
Diese Funktionen sind Hilfsmittel zur Fehlersuche und Reparatur von Geometriedaten. Sie werden nur benötigt, wenn die Geometriedaten in irgendeiner Weise beschädigt sind, was unter normalen Umständen nie passieren sollte.