Die PostGIS Development Group
PostGIS ist eine Erweiterung des objektrelationalen Datenbanksystems PostgreSQL. Es ermöglicht die Speicherung von Geoobjekten eines GIS (Geoinformationssystem) in der Datenbank. PostGIS unterstützt räumliche, GIST-basierte R-Tree Indizes, sowie Funktionen zur Analyse und Bearbeitung von Geoobjekten.
Dieses Handbuch beschreibt die Version 3.0.0
Diese Arbeit ist unter der Creative Commons Attribution-Share Alike 3.0 License lizensiert. Sie können den Inhalt ungeniert nutzen, aber wir ersuchen Sie das PostGIS Projekt namentlich aufzuführen und wenn möglich einen Verweis auf http://postgis.net zu setzen.
- 1. Einführung
- 2. PostGIS Installation
- 2.1. Kurzfassung
- 2.2. Raster konfigurieren
- 2.3. Systemvoraussetzungen
- 2.4. Nutzung des Quellcodes
- 2.5. Kompilierung und Installation des Quellcodes: Detaillierte Beschreibung
- 2.6. Eine Geodatenbank mit EXTENSIONS anlegen
- 2.7. Ersellung einer Geodatenbank ohne Extensions
- 2.8. Installation und Verwendung des Adressennormierers
- 2.9. Installation, Aktualisierung des Tiger Geokodierers und Daten laden
- 2.9.1. Aktivierung des Tiger Geokodierer in Ihrer PostGIS Datenbank: Verwendung von Extension
- 2.9.2. Den Tiger Geokodierer in der PostGIS Datenbank aktivieren: ohne die Verwendung von Extensions
- 2.9.3. Die Adressennormierer-Extension zusammen mit dem Tiger Geokodierer verwenden
- 2.9.4. Tiger-Daten laden
- 2.9.5. Upgrade Ihrer Tiger Geokodierer Installation
- 2.10. Erzeugung einer Geodatenbank mit einem Template
- 2.11. Upgrading
- 2.12. Übliche Probleme bei der Installation
- 2.13. Loader/Dumper
- 3. Häufige Fragen zu PostGIS
- 4. PostGIS anwenden: Datenverwaltung und Abfragen
- 5. Rasterdatenverwaltung, -abfrage und Anwendungen
- 5.1. Laden und Erstellen von Rastertabellen
- 5.2. Raster Katalog
- 5.3. Eigene Anwendungen mit PostGIS Raster erstellen
- 5.3.1. PHP Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen
- 5.3.2. ASP.NET C# Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen
- 5.3.3. Applikation für die Java-Konsole, welche eine Rasterabfrage als Bilddatei ausgibt
- 5.3.4. Verwenden Sie PLPython um Bilder via SQL herauszuschreiben
- 5.3.5. Faster mit PSQL ausgeben
- 6. Anwendung der PostGIS Geometrie: Applikationsentwicklung
- 7. Performance Tipps
- 8. Referenz PostGIS
- 8.1. PostgreSQL und PostGIS Datentypen - Geometry/Geography/Box
- 8.2. PostGIS Grand Unified Custom Variables (GUCs)
- 8.3. Geometrische Managementfunktionen
- 8.4. Geometrische Konstruktoren
- 8.5. Geometrische Zugriffsfunktionen
- 8.6. Geometrische Editoren
- 8.7. Ausgabe von Geometrie
- 8.8. Operatoren
- 8.9. Measurement Functions
- 8.10. SFCGAL Funktionen
- 8.11. Geometrieverarbeitung
- 8.12. Kilometrierung
- 8.13. Unterstützung von lang andauernden Transaktionen/Long Transactions
- 9. Referenz Raster
- 9.1. Datentypen zur Unterstützung von Rastern.
- 9.2. Rastermanagement
- 9.3. Raster Constructors
- 9.4. Zugriffsfunktionen auf Raster
- 9.5. Zugriffsfunktionen auf Rasterbänder
- 9.6. Zugriffsfunktionen und Änderungsmethoden für Rasterpixel
- 9.7. Raster Editoren
- 9.8. Editoren für Rasterbänder
- 9.9. Rasterband Statistik und Analytik
- 9.10. Rastereingabe
- 9.11. Ausgabe von Rastern
- 9.12. Rasterdatenverarbeitung
- 9.13. Rasteroperatoren
- 9.14. Räumliche Beziehungen von Rastern und Rasterbändern
- 9.15. Raster Tipps
- 10. Häufige Fragen zu PostGIS Raster
- 11. Topologie
- 11.1. Topologische Datentypen
- 11.2. Topologische Domänen
- 11.3. Verwaltung von Topologie und TopoGeometry
- 11.4. Topologie Konstruktoren
- 11.5. Topologie Editoren
- 11.6. Zugriffsfunktionen zur Topologie
- 11.7. Topologie Verarbeitung
- 11.8. TopoGeometry Konstruktoren
- 11.9. TopoGeometry Editoren
- 11.10. TopoGeometry Accessors
- 11.11. TopoGeometry Ausgabe
- 11.12. Räumliche Beziehungen einer Topologie
- 12. Adressennormierer
- 13. PostGIS Extras
- 14. PostGIS Special Functions Index
- 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 new, behavior changed, or enhanced in 2.0
- 14.12.9. PostGIS Functions changed behavior in 2.0
- 14.12.10. PostGIS Functions new, behavior changed, or enhanced in 1.5
- 14.12.11. PostGIS Functions new, behavior changed, or enhanced in 1.4
- 14.12.12. PostGIS Functions new in 1.3
- 15. Meldung von Problemen
- A. Anhang
- A.1. Release 3.0.0
- A.2. Release 3.0.0rc2
- A.3. Release 3.0.0rc1
- A.4. Release 3.0.0beta1
- A.5. Release 3.0.0alpha4
- A.6. Release 3.0.0alpha3
- A.7. Release 3.0.0alpha2
- A.8. Release 3.0.0alpha1
- A.9. Release 2.4.0
- A.10. Release 2.4.4
- A.11. Release 2.4.4
- A.12. Release 2.4.3
- A.13. Release 2.4.2
- A.14. Release 2.4.1
- A.15. Release 2.4.0
- A.16. Release 2.3.3
- A.17. Release 2.3.2
- A.18. Release 2.3.1
- A.19. Release 2.3.0
- A.20. Release 2.2.2
- A.21. Release 2.2.1
- A.22. Release 2.2.0
- A.23. Release 2.1.8
- A.24. Release 2.1.7
- A.25. Release 2.1.6
- A.26. Release 2.1.5
- A.27. Release 2.1.4
- A.28. Release 2.1.3
- A.29. Release 2.1.2
- A.30. Release 2.1.1
- A.31. Release 2.1.0
- A.32. Release 2.0.5
- A.33. Release 2.0.4
- A.34. Release 2.0.3
- A.35. Release 2.0.2
- A.36. Release 2.0.1
- A.37. Release 2.0.0
- A.38. Release 1.5.4
- A.39. Release 1.5.3
- A.40. Release 1.5.2
- A.41. Release 1.5.1
- A.42. Release 1.5.0
- A.43. Release 1.4.0
- A.44. Release 1.3.6
- A.45. Release 1.3.5
- A.46. Release 1.3.4
- A.47. Release 1.3.3
- A.48. Release 1.3.2
- A.49. Release 1.3.1
- A.50. Release 1.3.0
- A.51. Release 1.2.1
- A.52. Release 1.2.0
- A.53. Release 1.1.6
- A.54. Release 1.1.5
- A.55. Release 1.1.4
- A.56. Release 1.1.3
- A.57. Release 1.1.2
- A.58. Release 1.1.1
- A.59. Release 1.1.0
- A.60. Release 1.0.6
- A.61. Release 1.0.5
- A.62. Release 1.0.4
- A.63. Release 1.0.3
- A.64. Release 1.0.2
- A.65. Release 1.0.1
- A.66. Release 1.0.0
- A.67. Release 1.0.0RC6
- A.68. Release 1.0.0RC5
- A.69. Release 1.0.0RC4
- A.70. Release 1.0.0RC3
- A.71. Release 1.0.0RC2
- A.72. Release 1.0.0RC1
PostGIS erweitert das relationale Datenbanksystem PostgreSQL zu einer Geodatenbank. PostGIS wurde im Rahmen eines Technologieforschungsprojektes zu Geodatenbanken von Refractions Research Inc gegründet. Refractions ist ein Beratungsunternehmen für GIS und Datenbanken in Viktoria, British Columbia, Kanada, spezialisiert auf Datenintegration und Entwicklung von Individualsoftware.
PostGIS ist ein Projekt der OSGeo Foundation. PostGIS wird von vielen FOSS4G-Entwicklern und Unternehmen auf der ganzen Welt laufend verbessert und finanziert. Diese profitieren ihrerseits von der Funktionsvielfalt und Einsatzflexibilität von PostGIS.
Die PostGIS Project Develpment Group beabsichtigt durch die Unterstützung und Weiterentwicklung von PostGIS eine hohe Funktionsvielfalt zu erreichen. Diese soll wichtige GIS-Funktionalitäten, Kompatibilität mit den spatialen Standards OpenGIS und SQL/MM, hochentwickelte topologische Konstrukte (Coverages, Oberflächen, Netzwerke), Datenquellen für Desktop Benutzeroberflächen zum Darstellen und Bearbeiten von GIS Daten, sowie Werkzeuge für den Zugriff via Internettechnologie beinhalten.
Das PostGIS Project Steering Committee (PSC) koordiniert die allgemeine Ausrichtung, den Releasezyklus, die Dokumentation und die Öffentlichkeitsarbeit des PostGIS Projektes. Zusätzlich bietet das PSC allgemeine Unterstützung für Anwender, übernimmt und prüft Patches aus der PostGIS Gemeinschaft und stimmt über sonstige Themen, wie Commit-Zugriff für Entwickler, neue PSC Mitglieder oder entscheidende Änderungen an der API, ab.
- Regina Obe
Buildbot Wartung, Kompilierung produktiver und experimenteller Softwarepakete für Windows, Abgleich von PostGIS mit den PostgreSQL Releases, allgemeine Unterstützung von Anwendern auf der PostGIS Newsgroup, Mitarbeit an X3D, Tiger Geokodierer, an Funktionen zur Verwaltung von Geometrien; Smoke testing neuer Funktionalität und wichtige Änderungen am Code.
- Bborie Park
Entwicklung im Bereich Raster, Integration mit GDAL, Raster-Lader, Anwender-Support, allgemeine Fehlerbeseitigung, Softwaretests auf verschiedenen Betriebssystemen (Slackware, Mac, Windows und andere).
- Paul Ramsey (Vorsitzender)
Mitbegründer des PostGIS Projektes. Allgemeine Fehlerbehebung, geographische Unterstützung, Indizes zur Unterstützung von Geographie und Geometrie (2D, 3D, nD Index und jegliche räumliche Indizes), grundlegende interne geometrische Strukturen, PointCloud (in Entwicklung), Einbindung von GEOS Funktionalität und Abstimmung mit GEOS Releases, Abglech von PostGIS mit den PostgreSQL Releases, Loader/Dumper und die Shapefile Loader GUI.
- Sandro Santilli
Bugfixes, Wartung, Git Mirrors Management und Integration neuer GEOS-Funktionalitäten, sowie Abstimmung mit den GEOS Versionen, Topologieunterstützung, Raster Grundstruktur und Funktionen der Low-Level-API.
- Jorge Arévalo
Entwicklung von PostGIS Raster, GDAL-Treiberunterstützung, Lader/loader
- Nicklas Avén
Verbesserung und Erweiterung von Distanzfunktionen (einschließlich 3D-Distanz und Funktionen zu räumlichen Beziehungen), Tiny WKB Ausgabeformat (TWKB) (in Entwicklung) und allgemeine Unterstützung von Anwendern.
- Dan Baston
Beiträge zu den geometrischen Clusterfunktionen, Verbesserung anderer geometrischer Alorithmen, GEOS Erweiterungen und allgemeine Unterstützung von Anwendern.
- Olivier Courtin
Ein- und Ausgabefunktionen für XML (KML,GML)/GeoJSON, 3D Unterstützng und Bugfixes.
- Martin Davis
GEOS enhancements and documentation
- Björn Harrtell
MapBox Vector Tile und GeoBuf Funktionen. Gogs Tests und GitLab Experimente.
- Mateusz Loskot
CMake Unterstützung für PostGIS, Entwicklung des ursprünglichen Raster-Laders in Python und systemnahe Funktionen der Raster-API
- Raúl Marín Rodríguez
Bugfixes
- Darafei Praliaskouski
Index Optimierung, Bugfixes und Verbesserungen von Funktionen für den geometrischen/geographischer Datentyp, GitHub Verwalter und Wartung des Travis Bot.
- Pierre Racine
Gesamtarchitektur für Raster, Prototyping, Unterstützung bei der Programmierung
- Mark Cave-Ayland
Koordiniert die Wartung und Fehlerbehebung, die Selektivität und die Anbindung von räumlichen Indizes, den Loader/Dumper und die Shapfile Loader GUI, die Einbindung von neuen Funktionen sowie die Verbesserung von neuen Funktionen.
- Chris Hodgson
Ehemaliges PSC Mitglied. Allgemeine Entwicklungsarbeit, Wartung von Buildbot und Homepage, OSGeo Inkubationsmanagement.
- Kevin Neufeld
Ehemaliges PSC Mitglied. Dokumentation und Werkzeuge zur Dokumentationsunterstützung, Buildbot Wartung, fortgeschrittene Anwenderunterstützung auf der PostGIS Newsgroup, Verbesserungen an den Funktionen zur Verwaltung von Geometrien.
- Dave Blasby
Der ursprüngliche Entwickler und Mitbegründer von PostGIS. Dave schrieb die serverseitigen Bereiche, wie das Binden von Indizes und viele der serverseitiger analytischer Funktionen.
- Jeff Lounsbury
Ursprüngliche Entwicklung des Shapefile Loader/Dumper. Aktuell ist er Vertreter der PostGIS Projekt Inhaber.
- Mark Leslie
Laufende Wartung und Entwicklung der Kernfunktionen. Erweiterte Unterstützung von Kurven. Shapefile Loader GUI.
- David Zwarg
Entwickelt für Raster (in erster Linie analytische Funktionen in Map Algebra)
- Die einzelnen Mitwirkenden
Alex Bodnaru Gerald Fenoy Maxime Guillaud Alex Mayrhofer Gino Lucrezi Maxime van Noppen Andrea Peri Greg Troxel Michael Fuhr Andreas Forø Tollefsen Guillaume Lelarge Mike Toews Andreas Neumann Haribabu Kommi Nathan Wagner Anne Ghisla Havard Tveite Nathaniel Clay Antoine Bajolet IIDA Tetsushi Nikita Shulga Artur Zakirov Ingvild Nystuen Norman Vine Barbara Phillipot Jackie Leng Patricia Tozer Ben Jubb James Marca Rafal Magda Bernhard Reiter Jason Smith Ralph Mason Björn Esser Jeff Adams Rémi Cura Brian Hamlin Jonne Savolainen Richard Greenwood Bruce Rindahl Jose Carlos Martinez Llari Roger Crew Bruno Wolff III Jörg Habenicht Ron Mayer Bryce L. Nordgren Julien Rouhaud Sebastiaan Couwenberg Carl Anderson Kashif Rasul Sergey Fedoseev Charlie Savage Klaus Foerster Shinichi Sugiyama Christoph Berg Kris Jurka Shoaib Burq Christoph Moench-Tegeder Laurenz Albe Silvio Grosso Dane Springmeyer Lars Roessiger Steffen Macke Dave Fuhry Leo Hsu Stepan Kuzmin David Zwarg Loic Dachary Stephen Frost David Zwarg Luca S. Percich Talha Rizwan David Zwarg Maria Arias de Reyna Tom Glancy Dmitry Vasilyev Marc Ducobu Tom van Tilburg Eduin Carrillo Mark Sondheim Vincent Mora Eugene Antimirov Markus Schaber Vincent Picavet Even Rouault Markus Wanner Volf Tomáš Frank Warmerdam Matt Amos George Silva Matthias Bay - Gründungs-Sponsoren
Dabei handelt es sich um Unternehmen, die Entwicklungszeit, Hosting, oder direkte finanzielle Förderungen, in das PostGIS Projekt eingebracht haben
- Arrival 3D
- Associazione Italiana per l'Informazione Geografica Libera (GFOSS.it)
- AusVet
- Avencia
- Azavea
- Boundless
- Cadcorp
- Camptocamp
- Carto
- City of Boston (DND)
- City of Helsinki
- Clever Elephant Solutions
- Cooperativa Alveo
- Deimos Space
- Faunalia
- Geographic Data BC
- Hunter Systems Group
- ISciences, LLC
- Lidwala Consulting Engineers
- LISAsoft
- Logical Tracking & Tracing International AG
- Maponics
- Michigan Tech Research Institute
- Natural Resources Canada
- Norwegian Forest and Landscape Institue
- OSGeo
- Oslandia
- Palantir Technologies
- Paragon Corporation
- R3 GIS
- Refractions Research
- Regione Toscana - SITA
- Safe Software
- Sirius Corporation plc
- Stadt Uster
- UC Davis Center for Vectorborne Diseases
- Université Laval
- U.S. Department of State (HIU)
- Zonar Systems
- Crowd Funding-Kampagnen
Wir starten Crowdfunding Kampagnen, um dringend gewünschte und von vielen Anwendern benötigte Funktionalitäten zu finanzieren. Jede Kampagne konzentriert sich auf eine bestimmte Funktionalität oder eine Gruppe von Funktionen. Jeder Sponsor spendiert einen kleinen Teil des benötigten Geldes und wenn genug Menschen/Organisationen mitmachen, können wir die Arbeit bezahlen, von der dann viele etwas haben. Falls Sie eine Idee für eine Funktionalität haben, bei der Sie glauben, dass viele andere bereit sind diese mitzufinanzieren, dann schicken Sie bitte Ihre Überlegungen an die PostGIS newsgroup - gemeinsam wird es uns gelingen.
PostGIS 2.0.0 war die erste Version, mit der wir diese Strategie verfolgten. Wir benutzten PledgeBank und hatten zwei erfolgreiche Kampagnen.
postgistopology - mehr als 10 Sponsoren förderten mit jeweils $250 USD die Entwicklung von TopoGeometry Funktionen und das Aufmöbeln der Topologie-Unterstützung für 2.0.0.
postgis64windows - 20 Sponsoren förderten die Arbeit an den Problemen mit der 64-bit Version von PostGIS für Windows mit jeweils $100 USD. Es ist tatsächlich geschehen und nun steht eine 64-bit Version von PostGIS 2.0.1 als PostgreSQL Stack-Builder zur Verfügung.
- Wichtige Support-Bibliotheken
The GEOS geometry operations library
Die GDAL Geospatial Data Abstraction Library von Frank Warmerdam und anderen ist die Grundlage für einen großen Teil der Rasterfunktionalität, die mit PostGIS 2.0.0 eingeführt wurde. Im Prinzip werden die zur Unterstützung von PostGIS nötigen Neuerungen in GDAL, an das GDAL-Projekt zurückgegeben.
The PROJ cartographic projection library
Zu guter Letzt das PostgreSQL DBMS, der Gigant auf dessen Schultern PostGIS steht. Die Geschwindigkeit und Flexibilität von PostGIS wäre ohne die Erweiterbarkeit, den großartigen Anfrageplaner, den GIST Index, und der Unmenge an SQL Funktionen, die von PostgreSQL bereitgestellt werden, nicht möglich.
- 2.1. Kurzfassung
- 2.2. Raster konfigurieren
- 2.3. Systemvoraussetzungen
- 2.4. Nutzung des Quellcodes
- 2.5. Kompilierung und Installation des Quellcodes: Detaillierte Beschreibung
- 2.6. Eine Geodatenbank mit EXTENSIONS anlegen
- 2.7. Ersellung einer Geodatenbank ohne Extensions
- 2.8. Installation und Verwendung des Adressennormierers
- 2.9. Installation, Aktualisierung des Tiger Geokodierers und Daten laden
- 2.9.1. Aktivierung des Tiger Geokodierer in Ihrer PostGIS Datenbank: Verwendung von Extension
- 2.9.2. Den Tiger Geokodierer in der PostGIS Datenbank aktivieren: ohne die Verwendung von Extensions
- 2.9.3. Die Adressennormierer-Extension zusammen mit dem Tiger Geokodierer verwenden
- 2.9.4. Tiger-Daten laden
- 2.9.5. Upgrade Ihrer Tiger Geokodierer Installation
- 2.10. Erzeugung einer Geodatenbank mit einem Template
- 2.11. Upgrading
- 2.12. Übliche Probleme bei der Installation
- 2.13. Loader/Dumper
Dieses Kapitel erläutert die notwendigen Schritte zur Installation von PostGIS.
Zum Kompilieren müssen die Abhängigkeiten im Suchpfad eingetragen sein:
tar xvfz postgis-3.0.0.tar.gz cd postgis-3.0.0 ./configure make make install
Nachdem PostGIS installiert ist, muss es in jeder Datenbank-Instanz, in der es verwendet werden soll, aktiviert werden.
![[Note]](images/note.png) | |
Die Verwendung der Erweiterung wird bevorzugt und ist benutzerfreundlicher. So aktivieren Sie Ihre Datenbank räumlich: |
psql -d ihredatenbank -c "CREATE EXTENSION postgis;" - wenn Sie mit Raster-Unterstützung kompiliert haben und sie installieren möchten - psql -d ihredatenbank -c "CREATE EXTENSION postgis_raster;" - wenn Sie die Topologieunterstützung installieren möchten - psql -d ihredatenbank -c "CREATE EXTENSION postgis_topology;" - wenn Sie mit Unterstützung von sfcgal erstellt haben und sie installieren möchten - psql -d ihredatenbank -c "CREATE EXTENSION postgis_sfcgal;" - wenn Sie eine Tiger-Geokodierung installieren möchten - psql -d ihredatenbank -c "CREATE EXTENSION fuzzystrmatch" psql -d ihredatenbank -c "CREATE EXTENSION postgis_tiger_geocoder;" - wenn Sie mit pcre installiert haben - sollten Sie auch die Erweiterung zur Adressstandardisierung hinzufügen psql -d ihredatenbank -c "CREATE EXTENSION address_standardizer;"
Unter Section 2.5.3, “Build-Prozess für die PostGIS Extensions und deren Bereitstellung” sind die Details beschrieben, wie man die installierten/vorhandenen Erweiterungen abfragen und aktualisieren kann, bzw. wie man von einer Installation ohne Erweiterungen zu einer Erweiterungsinstallation kommt.
Für diejenigen, die sich aus irgendeinem Grund entschieden haben, nicht die Erweiterungsinstallation zu verwenden, sind hier die längeren schmerzvolleren Anweisungen:
Nach der Installation befinden sich alle .sql Dateien unter dem Ordner "share/contrib/postgis-3.0" der PostgreSQL Installation.
createdb ihredatenbank createlang plpgsql ihredatenbank psql -d ihredatenbank -f postgis.sql psql -d ihredatenbank -f postgis_comments.sql psql -d ihredatenbank -f spatial_ref_sys.sql - wenn Sie die Topologie aktivieren möchten psql -d ihredatenbank -f topologie.sql psql -d ihredatenbank -f topology_comments.sql - wenn Sie Raster aktivieren möchten - und nur wenn Sie mit Raster (GDAL) kompiliert haben psql -d ihredatenbank -f rtpostgis.sql psql -d ihredatenbank -f raster_comments.sql - wenn Sie das sfcgal-Backend aktivieren möchten - und nur wenn Sie mit sfcgal Unterstützung kompiliert haben - psql -d ihredatenbank -f sfcgal.sql psql -d ihredatenbank -f sfcgal_comments.sql
Wenn Sie die Raster-Unterstützung aktiviert haben, sollten Sie im Folgenden nachlesen, wie Sie sie richtig konfigurieren.
Ab PostGIS 2.1.3 sind out-of-db Raster und alle Raster Treiber standardmäßig ausgeschaltet. Um diese zu aktivieren müssen folgende Umgebungsvariablen
POSTGIS_GDAL_ENABLED_DRIVERS and POSTGIS_ENABLE_OUTDB_RASTERS am Server gesetzt werden. Für PostGIS 2.2 kann ein plattformübergreifender Ansatz gewählt werden, indem der entsprechende Section 8.2, “PostGIS Grand Unified Custom Variables (GUCs)” gesetzt wird.
Falls Offline-Raster ermöglicht werden sollen:
POSTGIS_ENABLE_OUTDB_RASTERS=1
Jede andere Einstellung oder keine Einstellung deaktiviert out-of-db Raster.
Um alle in der jeweiligen GDAL Installation verfügbaren Treiber zu aktivieren, muss folgende Umgebungsvariable gesetzt werden:
POSTGIS_GDAL_ENABLED_DRIVERS=ENABLE_ALL
Falls nur bestimmte Treiber aktiviert werden sollen, kann die Umgebungsvariable auf diese beschränkt werden:
POSTGIS_GDAL_ENABLED_DRIVERS="GTiff PNG JPEG GIF XYZ"
| |
Unter Windows darf die Treiberliste nicht unter Anführungszeichen gesetzt werden. |
Die Zuweisung von Umgebungsvariablen wechselt je nach Betriebssystem. Für PostgreSQL Installationen auf Ubuntu oder Debian via apt-postgresql, ist der bevorzugte Weg /etc/postgresql/ zu editieren, wobei 10 auf die PostgreSQL Version verweist und main auf den Cluster hinweist.10/main/environment
Als Service unter Windows können Sie die Systemvariablen setzen; diese befinden sich bei Windows 7 mit Rechtsklick auf Computer->Properties Advanced System Settings oder im Explorer unter Control Panel\All Control Panel Items\System. Anschließend auf Advanced System Settings ->Advanced->Environment Variables und die neuen Systemvariablen hinzufügen.
Nachdem die Umgebungsvariablen gesetzt sind, ist ein Neustart des PostgreSQL-Dienstes notwendig, damit die Änderungen wirksam werden.
Zur Kompilation und Anwendung stellt PostGIS die folgenden Systemanforderungen:
Notwendige Systemvoraussetzungen
PostgreSQL 9.5 oder höher. Es wird eine vollständige PostgreSQL Installation (inklusive Server headers) benötigt. PostgreSQL steht unter http://www.postgresql.org zur Verfügung.
Welche PostgreSQL Version von welcher PostGIS Version unterstützt wird und welche PostGIS Version von welcher GEOS Version unterstützt wird findet sich unter http://trac.osgeo.org/postgis/wiki/UsersWikiPostgreSQLPostGIS
GNU C Compiler (
gcc). Es können auch andere ANSI C Compiler zur PostGIS Kompilation verwendet werden, aber die Kompilation mitgccmacht die geringsten Probleme.GNU Make (
gmakeodermake). Für viele Systeme ist GNUmakedie Standardversion von make. Überprüfe die Version durchmake -v. Andere Versionen vonmakekönnen das PostGISMakefilenicht richtig ausführen.Proj4 Projektionsbibliothek, Version 4.9.0 oder höher. Die Proj4 4.9 oder höher wird benötigt um Koordinatentransformationen in PostGIS zu ermöglichen. Proj4 kann von http://trac.osgeo.org/proj/ heruntergeladen werden.
Proj4 Projektionsbibliothek, Version 4.9.0 oder höher. Die Proj4 4.9 oder höher wird benötigt um Koordinatentransformationen in PostGIS zu ermöglichen. Proj4 kann von http://trac.osgeo.org/proj/ heruntergeladen werden.
LibXML2, Version 2.5.x oder höher. LibXML2 wird derzeit für einige Import Funktionen genutzt (ST_GeomFromGML und ST_GeomFromKML). LibXML2 steht unter http://xmlsoft.org/downloads.html zur Verfügung.
JSON-C, Version 0.9 oder höher. JSON-C wird zurzeit benutzt um GeoJSON über die Funktion ST_GeomFromGeoJson zu importieren. JSON-C kann unter https://github.com/json-c/json-c/releases/ bezogen werden.
GDAL, Version 1.8 oder höher (Version 1.9 oder höher wird dringend empfohlen, da niedrigere Versionen in manchen Bereichen nicht gut funktionieren oder zu unvorhergesehenen Verhalten führen können). Es ist für die Rasterunterstützung erforderlich. http://trac.osgeo.org/gdal/wiki/DownloadSource.
Wenn mit PostgreSQL+JIT kompiliert wird, ist die LLVM-Version >=6 erforderlich https://trac.osgeo.org/postgis/ticket/4125 .
Optionale Systemanforderungen
GDAL (pseudo optional) nur wenn Sie kein Rasterunterstützung möchten, können Sie es weglassen. Sorgen Sie außerdem dafür das Treiber, die Sie brauchen wie in Section 2.2, “Raster konfigurieren” beschrieben, aktiviert sind.
GTK (benötigt GTK+2.0, 2.8+) um den "shp2pgsql-gui shape file loader" zu kompilieren. http://www.gtk.org/ .
SFCGAL, Version 1.1 (oder höher) bietet zusätzliche, hoch entwickelte 2D und 3D Analysefunktionen für PostGIS cf Section 8.10, “SFCGAL Funktionen”. Ermöglicht auch die Anwendung von SFCGAL anstatt von GEOS für einige 2D Funktionen, die von beiden Backends unterstützt werden (wie ST_Intersection oder ST_Area). Eine PostgreSQL Konfigurationsvariable
postgis.backendermöglicht es den Endanwendern zwischen dem Backend zu wählen, falls SFCGAL installiert ist (Standardwert ist GEOS). Anmerkung: SFCGAL 1.2 benötigt mindestens CGAL 4.3 und Boost 1.54 (cf: http://oslandia.github.io/SFCGAL/installation.html) https://github.com/Oslandia/SFCGAL.Um den Chapter 12, Adressennormierer zu kompilieren wird http://www.pcre.org benötigt (ist normalerweise auf Unix-Systemen bereits vorinstalliert).
Regex::Assembleperl CPAN package ist nur für eine Neukodierung der Daten inparseaddress-stcities.herforderlich. Chapter 12, Adressennormierer wird selbsttätig erzeugt, wenn eine PCRE Bibliothek gefunden wird, oder ein gültiger--with-pcre-dir=/path/to/pcreim Konfigurationsschritt angegeben wird.Um ST_AsMVT verwenden zu können, wird die protobuf-c Bibliothek (für die Anwendung) und der protoc-c Kompiler (für die Kompilation) benötigt. Weiters ist pgk-config erforderlich um die korrekte Minimumversion von protobuf-c zu bestimmen. Siehe protobuf-c.
CUnit (
CUnit). Wird für Regressionstest benötigt. http://cunit.sourceforge.net/DocBook (
xsltproc) ist für die Kompilation der Dokumentation notwendig. Docbook steht unter http://www.docbook.org/ zur Verfügung.DBLatex (
dblatex) ist zur Kompilation der Dokumentation im PDF-Format nötig. DBLatex liegt unter http://dblatex.sourceforge.net/ vor.ImageMagick (
convert) wird zur Erzeugung von Bildern für die Dokumentation benötigt. ImageMagick kann von http://www.imagemagick.org/ bezogen werden.
Das PostGIS Quellarchiv kann von der Download Webseite http://download.osgeo.org/postgis/source/postgis-3.0.0.tar.gz bezogen werden.
wget http://download.osgeo.org/postgis/source/postgis-3.0.0.tar.gz tar -xvzf postgis-3.0.0.tar.gz
Dadurch wird das Verzeichnis postgis-3.0.0 im aktuellen Arbeitsverzeichnis erzeugt.
Alternativ kann der Quellcode auch von svn repository http://svn.osgeo.org/postgis/trunk/ bezogen werden.
svn checkout http://svn.osgeo.org/postgis/trunk/ postgis-3.0.0
Um die Installation fortzusetzen ist in das neu erstellte Verzeichnis postgis-3.0.0 zu wechseln.
| |
Viele Betriebssysteme stellen heute bereits vorkompilierte Pakete für PostgreSQL/PostGIS zur Verfügung. Somit ist eine Kompilation nur notwendig, wenn man die aktuellsten Versionen benötigt oder für die Paketverwaltung zustänig ist. Dieser Abschnitt enthält die allgemeinen Installationsanweisungen. Für das Kompilieren unter Windows oder unter einem anderen Betriebssystem findet sich zusätzliche, detailliertere Hilfe unter PostGIS User contributed compile guides und PostGIS Dev Wiki. Vorkompilierte Pakete für unterschiedliche Betriebssysteme sind unter PostGIS Pre-built Packages aufgelistet. Wenn Sie ein Windowsbenutzer sind, können Sie stabile Kompilationen mittels Stackbuilder oder die PostGIS Windows download site erhalten. Es gibt auch very bleeding-edge windows experimental builds, die ein oder zweimal pro Woche, bzw. anlassweise kompiliert werden. Damit können Sie mit im Aufbau befindlichen PostGIS Releases experimentieren. |
PostGIS ist eine Erweiterung des PostgreSQL Servers. Daher benötigt PostGIS 3.0.0 vollen Zugriff auf die PostgreSQL server headers für die Kompilation. PostGIS kann in Abhängigkeit von PostgreSQL Versionen 9.5 oder höher kompiliert werden. Niedrigere Versionen von PostgreSQL werden nicht unterstützt.
Beziehen Sie sich auf die PostgreSQL Installationshilfe, falls Sie PostgreSQL noch nicht installiert haben. http://www.postgresql.org .
| |
Um die GEOS Funktionen nutzen zu können, muss bei der Installation von PostgreSQL explizit gegen die Standard C++ Bibliothek gelinkt werden: LDFLAGS=-lstdc++ ./configure [IHRE OPTIONEN] Dies dient als Abhilfe für C++ Fehler bei der Interaktion mit älteren Entwicklungswerkzeugen. Falls eigenartige Probleme auftreten (die Verbindung zum Backend bricht unerwartet ab oder ähnliches) versuchen Sie bitte diesen Trick. Dies verlangt natürlich die Kompilation von PostgreSQL von Grund auf. |
Die folgenden Schritte bescheiben die Konfiguration und Kompilation des PostGIS Quellcodes. Sie gelten für Linux Anwender und funktionieren nicht für Windows oder Mac.
Wie bei den meisten Installationen auf Linux besteht der erste Schritt in der Erstellung eines Makefiles, welches dann zur Kompilation des Quellcodes verwendet wird. Dies wird durch einen Aufruf des Shell Scripts erreicht.
./configure
Ohne zusätzliche Parameter legt dieser Befehl die Komponenten und Bibliotheken fest, welche für die Kompilation des PostGIS Quellcodes auf Ihrem System benötigt werden. Obwohl dies der häufigste Anwendungsfall von ./configure ist, akzeptiert das Skript eine Reihe von Parametern, falls sich die benötigten Bibliotheken und Programme nicht in den Standardverzeichnissen befinden.
Die folgende Liste weist nur die am häufigsten verwendeten Parameter auf. Für eine vollständige Liste benutzen Sie bitte --help oder --help=short .
- --with-library-minor-version
Starting with PostGIS 3.0, the library files generated by default will no longer have the minor version as part of the file name. This means all PostGIS 3 libs will end in
postgis-3. This was done to make pg_upgrade easier, with downside that you can only install one version PostGIS 3 series in your server. To get the old behavior of file including the minor version: e.g.postgis-3.0add this switch to your configure statement.- --prefix=PREFIX
Das Verzeichnis, in dem die PostGIS Bibliotheken und SQL-Skripts installiert werden. Standardmäßig ist dies das Verzeichnis in dem auch PostgreSQL installatiert wurde.
![[Caution]](images/caution.png)
Dieser Parameter ist zur Zeit defekt; somit kann PostGIS nur in das PostgreSQL Installationsverzeichnis installiert werden. Dieser Bug kann auf http://trac.osgeo.org/postgis/ticket/635 verfolgt werden.
- --with-pgconfig=FILE
PostgreSQL stellt das Dienstprogramm pg_config zur Verfügung um Extensions wie PostGIS die Auffindung des PostgreSQL Installationsverzeichnisses zu ermöglichen. Benutzen Sie bitte diesen Parameter (--with-pgconfig=/path/to/pg_config) um eine bestmmte PostgreSQL Installation zu definieren, gegen die PostGIS kompiliert werden soll.
- --with-gdalconfig=FILE
GDAL, eine erforderliche Bibliothek, welche die Funktionalität zur Rasterunterstützung liefert. gdal-config um Software Installationen die Auffindung des GDAL Installationsverzeichnis zu ermöglichen. Benutzen Sie bitte diesen Parameter (--with-gdalconfig=/path/to/gdal-config) um eine bestimmte GDAL Installation zu definieren, gegen die PostGIS kompiliert werden soll.
- --with-geosconfig=FILE
GEOS, eine erforderliche Geometriebibliothek, stellt geos-config zur Verfügung, um Software Installationen das Auffinden des GEOS Installationsverzeichnisses zu ermöglichen. Benutzen Sie bitte diesen Parameter (--with-geosconfig=/path/to/geos-config) um eine bestimmte GEOS Installation zu definieren, gegen die PostGIS kompiliert werden soll.
- --with-xml2config=FILE
LibXML ist die Bibliothek, welche für die Prozesse GeomFromKML/GML benötigt wird. Falls Sie libxml installiert haben, wird sie üblicherweise gefunden. Falls nicht oder wenn Sie eine bestimmte Version verwenden wollen, müssen Sie PostGIS auf eine bestimmte Konfigurationsdatei
xml2-configverweisen, damit Softwareinstallationen das Installationsverzeichnis von LibXML finden können. Verwenden Sie bitte diesen Parameter ( >--with-xml2config=/path/to/xml2-config) um eine bestimmte LibXML Installation anzugeben, gegen die PostGIS kompiliert werden soll.- --with-projdir=DIR
Proj4 ist eine Bibliothek, die von PostGIS zur Koordinatentransformation benötigt wird. Benutzen Sie bitte diesen Parameter (--with-projdir=/path/to/projdir) um ein bestimmtes Proj4 Installationsverzeichnis anzugeben, für das PostGIS kompiliert werden soll.
- --with-libiconv=DIR
Das Verzeichnis in dem iconv installiert ist.
- --with-jsondir=DIR
JSON-C ist eine MIT-lizensierte JSON Bibliothek, die von PostGIS für ST_GeomFromJSON benötigt wird. Benutzen Sie bitte diesen Parameter (--with-jsondir=/path/to/jsondir), um ein bestimmtes JSON-C Installationsverzeichnis anzugeben, für das PostGIS kompiliert werden soll.
- --with-pcredir=DIR
PCRE ist eine BSD-lizensierte Perl compatible Bibliothek für reguläre Ausdrücke, die von der Erweiterung "address_standardizer" benötigt wird. Verwenden Sie diesen Parameter (--with-pcredir=/path/to/pcredir), um ein bestimmtes Installationsverzeichnis von PCRE anzugeben, gegen das PostGIS kompiliert werden soll.
- --with-gui
Kompilieren Sie die Datenimport-GUI (benötigt GTK+2.0). Dies erzeugt die graphische Schnittstelle "shp2pgsql-gui" für shp2pgsql.
- --without-raster
Ohne Rasterunterstützung kompilieren.
- --without-topology
Ausschalten der Topologie Unterstützung. Es existiert keine entsprechende Bibliothek, da sich die gesamte benötigte Logik in der postgis-3.0.0 Bibliothek befindet.
- --with-gettext=no
Standardmäßig versucht PostGIS gettext zu detektieren und kompiliert mit gettext Unterstützung. Wenn es allerdings zu Inkompatibilitätsproblemen kommt, die zu einem Zusammenbrechen des Loader führen, so können Sie das mit diesem Befehl zur Gänze deaktivieren. Siehe Ticket http://trac.osgeo.org/postgis/ticket/748 für ein Beispiel wie dieses Problem gelöst werden kann. Sie verpassen nicht viel, wenn Sie dies deaktivieren, da es für die internationale Hilfe zum GUI Loader/Label verwendet wird, welcher nicht dokumentiert und immer noch experimentell ist.
- --with-sfcgal=PATH
Ohne diesen Switch wird PostGIS ohne sfcgal Unterstützung installiert.
PATHist ein optionaler Parameter, welcher einen alternativen Pfad zu sfcgal-config angibt.- --without-wagyu
When building with MVT support, Postgis will use Wagyu to clip and validate MVT polygons. Wagyu is the fastest alternative and guarantees producing correct values for this specific case, but it requires a C++-11 compiler. With this optional argument you can disable using this library; GEOS will be used instead.
| |
Wenn Sie PostGIS vom Code Repository bezogen haben, müssen Sie zu allererst das Skript ausführen ./autogen.sh Dieses Skript erzeugt das configure Skript, welches seinerseits zur Anpassung der Installation von PostGIS eingesetzt wird. Falls Sie stattdessen PostGIS als Tarball vorliegen haben, dann ist es nicht notwendig ./autogen.sh auszuführen, da configure bereits erzeugt wurde. |
Sobald das Makefile erzeugt wurde, ist der Build-Prozess für PostGIS so einfach wie
make
Die letzte Zeile der Ausgabe sollte "PostGIS was built successfully. Ready to install." enthalten
Seit PostGIS v1.4.0 haben alle Funktionen Kommentare, welche aus der Dokumentation erstellt werden. Wenn Sie diese Kommentare später in die räumliche Datenbank importieren wollen, können Sie den Befehl ausführen der "docbook" benötigt. Die Dateien "postgis_comments.sql", "raster_comments.sql" und "topology_comments.sql" sind im Ordner "doc" der "tar.gz"-Distribution mit paketiert, weshalb Sie bei einer Installation vom "tar ball" her, die Kommentare nicht selbst erstellen müssen. Die Kommentare werden auch als Teil der Installation "CREATE EXTENSION" angelegt.
make comments
Eingeführt in PostGIS 2.0. Erzeugt HTML-Spickzettel, die als schnelle Referenz oder als Handzettel für Studenten geeignet sind. Dies benötigt xsltproc zur Kompilation und erzeugt 4 Dateien in dem Ordner "doc": topology_cheatsheet.html,tiger_geocoder_cheatsheet.html, raster_cheatsheet.html, postgis_cheatsheet.html
Einige bereits Vorgefertigte können von PostGIS / PostgreSQL Study Guides als HTML oder PDF heruntergeladen werden
make cheatsheets
Die PostGIS Erweiterungen/Extensions werden ab PostgreSQL 9.1+ automatisch kompiliert und installiert.
Wenn Sie aus dem Quell-Repository kompilieren, müssen Sie zuerst die Beschreibung der Funktionen kompilieren. Diese lassen sich kompilieren, wenn Sie docbook installiert haben. Sie können sie aber auch händisch mit folgender Anweisung kompilieren:
make comments
Sie müssen die Kommentare nicht kompilieren, wenn sie von einem Format "tar" weg kompilieren, da diese in der tar-Datei bereits vorkompilierten sind.
Wenn Sie gegen PostgreSQL 9.1 kompilieren, sollten die Erweiterungen automatisch als Teil des Prozesses "make install" kompilieren. Falls notwendig, können Sie auch vom Ordner mit den Erweiterungen aus kompilieren, oder die Dateien auf einen anderen Server kopieren.
cd extensions cd postgis make clean make export PGUSER=postgres #overwrite psql variables make check #to test before install make install # to test extensions make check RUNTESTFLAGS=--extension
| |
|
Die Erweiterungsdateien sind für dieselbe Version von PostGIS immer ident, unabhängig vom Betriebssystem. Somit ist es in Ordnung, die Erweiterungsdateien von einem Betriebssystem auf ein anderes zu kopieren, solange die Binärdateien von PostGIS bereits installiert sind.
Falls Sie die Erweiterungen händisch auf einen anderen Server installieren wollen, müssen sie folgende Dateien aus dem Erweiterungsordner in den Ordner PostgreSQL / share / extension Ihrer PostgreSQL Installation kopieren. Ebenso die benötigten Binärdateien für das reguläre PostGIS, falls sich PostGIS noch nicht auf dem Server befindet.
Dies sind die Kontrolldateien, welche Information wie die Version der zu installierenden Erweiterung anzeigen, wenn diese nicht angegben ist.
postgis.control, postgis_topology.control.Alle Dateien in dem Ordner "/sql" der jeweiligen Erweiterung. Diese müssen in das Verzeichnis "share/extension" von PostgreSQL
extensions/postgis/sql/*.sql,extensions/postgis_topology/sql/*.sqlkopiert werden
Sobald Sie dies ausgeführt haben, sollten Sie postgis, postgis_topology als verfügbare Erweiterungen in PgAdmin -> extensions sehen.
Falls Sie psql verwenden, können Sie die installierten Erweiterungen folgendermaßen abfragen:
SELECT name, default_version,installed_version
FROM pg_available_extensions WHERE name LIKE 'postgis%' or name LIKE 'address%';
name | default_version | installed_version
------------------------------+-----------------+-------------------
address_standardizer | 3.0.0 | 3.0.0
address_standardizer_data_us | 3.0.0 | 3.0.0
postgis | 3.0.0 | 3.0.0
postgis_sfcgal | 3.0.0 |
postgis_tiger_geocoder | 3.0.0 | 3.0.0
postgis_topology | 3.0.0 |
(6 rows)Wenn Sie in der Datenbank, die Sie abfragen, eine Erweiterung installiert haben, dann sehen Sie einen Hinweis in der Spalte installed_version. Wenn Sie keine Datensätze zurückbekommen bedeutet dies, dass Sie überhaupt keine PostGIS Erweiterung auf dem Server installiert haben. PgAdmin III 1.14+ bietet diese Information ebenfalls in der Sparte extensions im Navigationsbaum der Datenbankinstanz an und ermöglicht sogar ein Upgrade oder eine Deinstallation über einen Rechtsklick.
Wenn die Erweiterungen vorhanden sind, können Sie die PostGIS-Extension sowohl mit der erweiterten pgAdmin Oberfläche als auch mittels folgender SQL-Befehle in einer beliebigen Datenbank installieren:
CREATE EXTENSION postgis; CREATE EXTENSION postgis_sfcgal; CREATE EXTENSION fuzzystrmatch; --needed for postgis_tiger_geocoder --optional used by postgis_tiger_geocoder, or can be used standalone CREATE EXTENSION address_standardizer; CREATE EXTENSION address_standardizer_data_us; CREATE EXTENSION postgis_tiger_geocoder; CREATE EXTENSION postgis_topology;
Sie können psql verwenden, um sich die installierten Versionen und die Datenbankschemen in denen sie installiert sind, anzeigen zu lassen.
\connect mygisdb \x \dx postgis*
List of installed extensions -[ RECORD 1 ]------------------------------------------------- Name | postgis Version | 3.0.0 Schema | public Description | PostGIS geometry, geography, and raster spat.. -[ RECORD 2 ]------------------------------------------------- Name | postgis_raster Version | 3.0.0dev Schema | public Description | PostGIS raster types and functions -[ RECORD 3 ]------------------------------------------------- Name | postgis_tiger_geocoder Version | 3.0.0 Schema | tiger Description | PostGIS tiger geocoder and reverse geocoder -[ RECORD 4 ]------------------------------------------------- Name | postgis_topology Version | 3.0.0 Schema | topology Description | PostGIS topology spatial types and functions
![[Warning]](images/warning.png) | |
Die Erweiterungstabellen |
Wenn Sie 3.0.0 ohne unser wunderbares Extension System installiert haben, können Sie auf erweiterungsbasiert wechseln, indem Sie folgende Befehle ausführen, welche die Funktionen in ihre entsprechenden Erweiterungen paketieren.
CREATE EXTENSION postgis FROM unpackaged; CREATE EXTENSION postgis_raster FROM unpackaged; CREATE EXTENSION postgis_topology FROM unpackaged; CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;
Wenn Sie die Kompilation von PostGIS überprüfen wollen:
make check
Obiger Befehl durchläuft mehere Überprüfungen und Regressionstests, indem er die angelegte Bibliothek in einer aktuellen PostgreSQL Datenbank ausführt.
| |
Falls Sie PostGIS so konfiguriert haben, dass nicht die Standardverzeichnisse für PostgreSQL, GEOS oder Proj4 verwendet werden, kann es sein, dass Sie die Speicherstellen dieser Bibliotheken in der Umgebungsvariablen "LD_LIBRARY_PATH" eintragen müssen. |
| |
Zurzeit beruht make check auf die Umgebungsvariablen |
Wenn der Test erfolgreich war, sollte die Ausgabe etwa so aussehen:
CUnit - A unit testing framework for C - Version 2.1-2
http://cunit.sourceforge.net/
Suite: computational_geometry
Test: test_lw_segment_side ...passed
Test: test_lw_segment_intersects ...passed
Test: test_lwline_crossing_short_lines ...passed
Test: test_lwline_crossing_long_lines ...passed
Test: test_lwline_crossing_bugs ...passed
Test: test_lwpoint_set_ordinate ...passed
Test: test_lwpoint_get_ordinate ...passed
Test: test_point_interpolate ...passed
Test: test_lwline_clip ...passed
Test: test_lwline_clip_big ...passed
Test: test_lwmline_clip ...passed
Test: test_geohash_point ...passed
Test: test_geohash_precision ...passed
Test: test_geohash ...passed
Test: test_geohash_point_as_int ...passed
Test: test_isclosed ...passed
Test: test_lwgeom_simplify ...passed
Suite: buildarea
Test: buildarea1 ...passed
Test: buildarea2 ...passed
Test: buildarea3 ...passed
Test: buildarea4 ...passed
Test: buildarea4b ...passed
Test: buildarea5 ...passed
Test: buildarea6 ...passed
Test: buildarea7 ...passed
Suite: geometry_clean
Test: test_lwgeom_make_valid ...passed
Suite: clip_by_rectangle
Test: test_lwgeom_clip_by_rect ...passed
Suite: force_sfs
Test: test_sfs_11 ...passed
Test: test_sfs_12 ...passed
Test: test_sqlmm ...passed
Suite: geodetic
Test: test_sphere_direction ...passed
Test: test_sphere_project ...passed
Test: test_lwgeom_area_sphere ...passed
Test: test_signum ...passed
Test: test_gbox_from_spherical_coordinates ...passed
Test: test_gserialized_get_gbox_geocentric ...passed
Test: test_clairaut ...passed
Test: test_edge_intersection ...passed
Test: test_edge_intersects ...passed
Test: test_edge_distance_to_point ...passed
Test: test_edge_distance_to_edge ...passed
Test: test_lwgeom_distance_sphere ...passed
Test: test_lwgeom_check_geodetic ...passed
Test: test_gserialized_from_lwgeom ...passed
Test: test_spheroid_distance ...passed
Test: test_spheroid_area ...passed
Test: test_lwpoly_covers_point2d ...passed
Test: test_gbox_utils ...passed
Test: test_vector_angle ...passed
Test: test_vector_rotate ...passed
Test: test_lwgeom_segmentize_sphere ...passed
Test: test_ptarray_contains_point_sphere ...passed
Test: test_ptarray_contains_point_sphere_iowa ...passed
Suite: GEOS
Test: test_geos_noop ...passed
Test: test_geos_subdivide ...passed
Test: test_geos_linemerge ...passed
Suite: Clustering
Test: basic_test ...passed
Test: nonsequential_test ...passed
Test: basic_distance_test ...passed
Test: single_input_test ...passed
Test: empty_inputs_test ...passed
Suite: Clustering Union-Find
Test: test_unionfind_create ...passed
Test: test_unionfind_union ...passed
Test: test_unionfind_ordered_by_cluster ...passed
Suite: homogenize
Test: test_coll_point ...passed
Test: test_coll_line ...passed
Test: test_coll_poly ...passed
Test: test_coll_coll ...passed
Test: test_geom ...passed
Test: test_coll_curve ...passed
Suite: encoded_polyline_input
Test: in_encoded_polyline_test_geoms ...passed
Test: in_encoded_polyline_test_precision ...passed
Suite: geojson_input
Test: in_geojson_test_srid ...passed
Test: in_geojson_test_bbox ...passed
Test: in_geojson_test_geoms ...passed
Suite: twkb_input
Test: test_twkb_in_point ...passed
Test: test_twkb_in_linestring ...passed
Test: test_twkb_in_polygon ...passed
Test: test_twkb_in_multipoint ...passed
Test: test_twkb_in_multilinestring ...passed
Test: test_twkb_in_multipolygon ...passed
Test: test_twkb_in_collection ...passed
Test: test_twkb_in_precision ...passed
Suite: serialization/deserialization
Test: test_typmod_macros ...passed
Test: test_flags_macros ...passed
Test: test_serialized_srid ...passed
Test: test_gserialized_from_lwgeom_size ...passed
Test: test_gbox_serialized_size ...passed
Test: test_lwgeom_from_gserialized ...passed
Test: test_lwgeom_count_vertices ...passed
Test: test_on_gser_lwgeom_count_vertices ...passed
Test: test_geometry_type_from_string ...passed
Test: test_lwcollection_extract ...passed
Test: test_lwgeom_free ...passed
Test: test_lwgeom_flip_coordinates ...passed
Test: test_f2d ...passed
Test: test_lwgeom_clone ...passed
Test: test_lwgeom_force_clockwise ...passed
Test: test_lwgeom_calculate_gbox ...passed
Test: test_lwgeom_is_empty ...passed
Test: test_lwgeom_same ...passed
Test: test_lwline_from_lwmpoint ...passed
Test: test_lwgeom_as_curve ...passed
Test: test_lwgeom_scale ...passed
Test: test_gserialized_is_empty ...passed
Test: test_gbox_same_2d ...passed
Suite: measures
Test: test_mindistance2d_tolerance ...passed
Test: test_rect_tree_contains_point ...passed
Test: test_rect_tree_intersects_tree ...passed
Test: test_lwgeom_segmentize2d ...passed
Test: test_lwgeom_locate_along ...passed
Test: test_lw_dist2d_pt_arc ...passed
Test: test_lw_dist2d_seg_arc ...passed
Test: test_lw_dist2d_arc_arc ...passed
Test: test_lw_arc_length ...passed
Test: test_lw_dist2d_pt_ptarrayarc ...passed
Test: test_lw_dist2d_ptarray_ptarrayarc ...passed
Test: test_lwgeom_tcpa ...passed
Test: test_lwgeom_is_trajectory ...passed
Suite: effectivearea
Test: do_test_lwgeom_effectivearea_lines ...passed
Test: do_test_lwgeom_effectivearea_polys ...passed
Suite: miscellaneous
Test: test_misc_force_2d ...passed
Test: test_misc_simplify ...passed
Test: test_misc_count_vertices ...passed
Test: test_misc_area ...passed
Test: test_misc_wkb ...passed
Test: test_grid ...passed
Suite: noding
Test: test_lwgeom_node ...passed
Suite: encoded_polyline_output
Test: out_encoded_polyline_test_geoms ...passed
Test: out_encoded_polyline_test_srid ...passed
Test: out_encoded_polyline_test_precision ...passed
Suite: geojson_output
Test: out_geojson_test_precision ...passed
Test: out_geojson_test_dims ...passed
Test: out_geojson_test_srid ...passed
Test: out_geojson_test_bbox ...passed
Test: out_geojson_test_geoms ...passed
Suite: gml_output
Test: out_gml_test_precision ...passed
Test: out_gml_test_srid ...passed
Test: out_gml_test_dims ...passed
Test: out_gml_test_geodetic ...passed
Test: out_gml_test_geoms ...passed
Test: out_gml_test_geoms_prefix ...passed
Test: out_gml_test_geoms_nodims ...passed
Test: out_gml2_extent ...passed
Test: out_gml3_extent ...passed
Suite: kml_output
Test: out_kml_test_precision ...passed
Test: out_kml_test_dims ...passed
Test: out_kml_test_geoms ...passed
Test: out_kml_test_prefix ...passed
Suite: svg_output
Test: out_svg_test_precision ...passed
Test: out_svg_test_dims ...passed
Test: out_svg_test_relative ...passed
Test: out_svg_test_geoms ...passed
Test: out_svg_test_srid ...passed
Suite: x3d_output
Test: out_x3d3_test_precision ...passed
Test: out_x3d3_test_geoms ...passed
Test: out_x3d3_test_option ...passed
Suite: ptarray
Test: test_ptarray_append_point ...passed
Test: test_ptarray_append_ptarray ...passed
Test: test_ptarray_locate_point ...passed
Test: test_ptarray_isccw ...passed
Test: test_ptarray_signed_area ...passed
Test: test_ptarray_unstroke ...passed
Test: test_ptarray_insert_point ...passed
Test: test_ptarray_contains_point ...passed
Test: test_ptarrayarc_contains_point ...passed
Test: test_ptarray_scale ...passed
Suite: printing
Test: test_lwprint_default_format ...passed
Test: test_lwprint_format_orders ...passed
Test: test_lwprint_optional_format ...passed
Test: test_lwprint_oddball_formats ...passed
Test: test_lwprint_bad_formats ...passed
Suite: SFCGAL
Test: test_sfcgal_noop ...passed
Suite: split
Test: test_lwline_split_by_point_to ...passed
Test: test_lwgeom_split ...passed
Suite: stringbuffer
Test: test_stringbuffer_append ...passed
Test: test_stringbuffer_aprintf ...passed
Suite: surface
Test: triangle_parse ...passed
Test: tin_parse ...passed
Test: polyhedralsurface_parse ...passed
Test: surface_dimension ...passed
Suite: Internal Spatial Trees
Test: test_tree_circ_create ...passed
Test: test_tree_circ_pip ...passed
Test: test_tree_circ_pip2 ...passed
Test: test_tree_circ_distance ...passed
Test: test_tree_circ_distance_threshold ...passed
Suite: triangulate
Test: test_lwgeom_delaunay_triangulation ...passed
Suite: twkb_output
Test: test_twkb_out_point ...passed
Test: test_twkb_out_linestring ...passed
Test: test_twkb_out_polygon ...passed
Test: test_twkb_out_multipoint ...passed
Test: test_twkb_out_multilinestring ...passed
Test: test_twkb_out_multipolygon ...passed
Test: test_twkb_out_collection ...passed
Test: test_twkb_out_idlist ...passed
Suite: varint
Test: test_zigzag ...passed
Test: test_varint ...passed
Test: test_varint_roundtrip ...passed
Suite: wkb_input
Test: test_wkb_in_point ...passed
Test: test_wkb_in_linestring ...passed
Test: test_wkb_in_polygon ...passed
Test: test_wkb_in_multipoint ...passed
Test: test_wkb_in_multilinestring ...passed
Test: test_wkb_in_multipolygon ...passed
Test: test_wkb_in_collection ...passed
Test: test_wkb_in_circularstring ...passed
Test: test_wkb_in_compoundcurve ...passed
Test: test_wkb_in_curvpolygon ...passed
Test: test_wkb_in_multicurve ...passed
Test: test_wkb_in_multisurface ...passed
Test: test_wkb_in_malformed ...passed
Suite: wkb_output
Test: test_wkb_out_point ...passed
Test: test_wkb_out_linestring ...passed
Test: test_wkb_out_polygon ...passed
Test: test_wkb_out_multipoint ...passed
Test: test_wkb_out_multilinestring ...passed
Test: test_wkb_out_multipolygon ...passed
Test: test_wkb_out_collection ...passed
Test: test_wkb_out_circularstring ...passed
Test: test_wkb_out_compoundcurve ...passed
Test: test_wkb_out_curvpolygon ...passed
Test: test_wkb_out_multicurve ...passed
Test: test_wkb_out_multisurface ...passed
Test: test_wkb_out_polyhedralsurface ...passed
Suite: wkt_input
Test: test_wkt_in_point ...passed
Test: test_wkt_in_linestring ...passed
Test: test_wkt_in_polygon ...passed
Test: test_wkt_in_multipoint ...passed
Test: test_wkt_in_multilinestring ...passed
Test: test_wkt_in_multipolygon ...passed
Test: test_wkt_in_collection ...passed
Test: test_wkt_in_circularstring ...passed
Test: test_wkt_in_compoundcurve ...passed
Test: test_wkt_in_curvpolygon ...passed
Test: test_wkt_in_multicurve ...passed
Test: test_wkt_in_multisurface ...passed
Test: test_wkt_in_tin ...passed
Test: test_wkt_in_polyhedralsurface ...passed
Test: test_wkt_in_errlocation ...passed
Suite: wkt_output
Test: test_wkt_out_point ...passed
Test: test_wkt_out_linestring ...passed
Test: test_wkt_out_polygon ...passed
Test: test_wkt_out_multipoint ...passed
Test: test_wkt_out_multilinestring ...passed
Test: test_wkt_out_multipolygon ...passed
Test: test_wkt_out_collection ...passed
Test: test_wkt_out_circularstring ...passed
Test: test_wkt_out_compoundcurve ...passed
Test: test_wkt_out_curvpolygon ...passed
Test: test_wkt_out_multicurve ...passed
Test: test_wkt_out_multisurface ...passed
Run Summary: Type Total Ran Passed Failed Inactive
suites 38 38 n/a 0 0
tests 251 251 251 0 0
asserts 2468 2468 2468 0 n/a
Elapsed time = 0.298 seconds
Creating database 'postgis_reg'
Loading PostGIS into 'postgis_reg'
/projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/postgis/postgis.sql
/projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/postgis/postgis_comments.sql
Loading SFCGAL into 'postgis_reg'
/projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/postgis/sfcgal.sql
/projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/postgis/sfcgal_comments.sql
PostgreSQL 9.4.4, compiled by Visual C++ build 1800, 32-bit
Postgis 2.2.0dev - r13980 - 2015-08-23 06:13:07
scripts 2.2.0dev r13980
GEOS: 3.5.0-CAPI-1.9.0 r4088
PROJ: Rel. 4.9.1, 04 March 2015
SFCGAL: 1.1.0
Running tests
loader/Point .............. ok
loader/PointM .............. ok
loader/PointZ .............. ok
loader/MultiPoint .............. ok
loader/MultiPointM .............. ok
loader/MultiPointZ .............. ok
loader/Arc .............. ok
loader/ArcM .............. ok
loader/ArcZ .............. ok
loader/Polygon .............. ok
loader/PolygonM .............. ok
loader/PolygonZ .............. ok
loader/TSTPolygon ......... ok
loader/TSIPolygon ......... ok
loader/TSTIPolygon ......... ok
loader/PointWithSchema ..... ok
loader/NoTransPoint ......... ok
loader/NotReallyMultiPoint ......... ok
loader/MultiToSinglePoint ......... ok
loader/ReprojectPts ........ ok
loader/ReprojectPtsGeog ........ ok
loader/Latin1 .... ok
loader/Latin1-implicit .... ok
loader/mfile .... ok
dumper/literalsrid ....... ok
dumper/realtable ....... ok
affine .. ok
bestsrid .. ok
binary .. ok
boundary .. ok
cluster .. ok
concave_hull .. ok
ctors .. ok
dump .. ok
dumppoints .. ok
empty .. ok
forcecurve .. ok
geography .. ok
in_geohash .. ok
in_gml .. ok
in_kml .. ok
in_encodedpolyline .. ok
iscollection .. ok
legacy .. ok
long_xact .. ok
lwgeom_regress .. ok
measures .. ok
operators .. ok
out_geometry .. ok
out_geography .. ok
polygonize .. ok
polyhedralsurface .. ok
postgis_type_name .. ok
regress .. ok
regress_bdpoly .. ok
regress_index .. ok
regress_index_nulls .. ok
regress_management .. ok
regress_selectivity .. ok
regress_lrs .. ok
regress_ogc .. ok
regress_ogc_cover .. ok
regress_ogc_prep .. ok
regress_proj .. ok
relate .. ok
remove_repeated_points .. ok
removepoint .. ok
setpoint .. ok
simplify .. ok
simplifyvw .. ok
size .. ok
snaptogrid .. ok
split .. ok
sql-mm-serialize .. ok
sql-mm-circularstring .. ok
sql-mm-compoundcurve .. ok
sql-mm-curvepoly .. ok
sql-mm-general .. ok
sql-mm-multicurve .. ok
sql-mm-multisurface .. ok
swapordinates .. ok
summary .. ok
temporal .. ok
tickets .. ok
twkb .. ok
typmod .. ok
wkb .. ok
wkt .. ok
wmsservers .. ok
knn .. ok
hausdorff .. ok
regress_buffer_params .. ok
offsetcurve .. ok
relatematch .. ok
isvaliddetail .. ok
sharedpaths .. ok
snap .. ok
node .. ok
unaryunion .. ok
clean .. ok
relate_bnr .. ok
delaunaytriangles .. ok
clipbybox2d .. ok
subdivide .. ok
in_geojson .. ok
regress_sfcgal .. ok
sfcgal/empty .. ok
sfcgal/geography .. ok
sfcgal/legacy .. ok
sfcgal/measures .. ok
sfcgal/regress_ogc_prep .. ok
sfcgal/regress_ogc .. ok
sfcgal/regress .. ok
sfcgal/tickets .. ok
sfcgal/concave_hull .. ok
sfcgal/wmsservers .. ok
sfcgal/approximatemedialaxis .. ok
uninstall . /projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/postgis/uninstall_sfcgal.sql
/projects/postgis/branches/2.2/regress/00-regress-install/share/contrib/postgis/uninstall_postgis.sql
. ok (4336)
Run tests: 118
Failed: 0
-- if you built --with-gui, you should see this too
CUnit - A unit testing framework for C - Version 2.1-2
http://cunit.sourceforge.net/
Suite: Shapefile Loader File shp2pgsql Test
Test: test_ShpLoaderCreate() ...passed
Test: test_ShpLoaderDestroy() ...passed
Suite: Shapefile Loader File pgsql2shp Test
Test: test_ShpDumperCreate() ...passed
Test: test_ShpDumperDestroy() ...passed
Run Summary: Type Total Ran Passed Failed Inactive
suites 2 2 n/a 0 0
tests 4 4 4 0 0
asserts 4 4 4 0 n/aDie Erweiterungen postgis_tiger_geocoder und address_standardizer unterstützen zurzeit nur die standardmäßige Installationsüberprüfung von PostgreSQL. Um diese zu überprüfen siehe unterhalb. Anmerkung: "make install" ist nicht notwendig, wenn Sie bereits ein "make install" im Root des Ordners mit dem PostGIS Quellcode durchgeführt haben.
Für den address_standardizer:
cd extensions/address_standardizer
make install
make installcheck
Die Ausgabe sollte folgendermaßen aussehen:
============== dropping database "contrib_regression" ============== DROP DATABASE ============== creating database "contrib_regression" ============== CREATE DATABASE ALTER DATABASE ============== running regression test queries ============== test test-init-extensions ... ok test test-parseaddress ... ok test test-standardize_address_1 ... ok test test-standardize_address_2 ... ok ===================== All 4 tests passed. =====================
Für den Tiger Geokodierer müssen Sie die Erweiterungen "postgis" und "fuzzystrmatch" in Ihrer PostgreSQL Instanz haben. Die Überprüfungen des "address_standardizer" laufen ebenfalls an, wenn Sie postgis mit "address_standardizer" Unterstützung kompiliert haben:
cd extensions/postgis_tiger_geocoder
make install
make installcheck
Die Ausgabe sollte folgendermaßen aussehen:
============== dropping database "contrib_regression" ============== DROP DATABASE ============== creating database "contrib_regression" ============== CREATE DATABASE ALTER DATABASE ============== installing fuzzystrmatch ============== CREATE EXTENSION ============== installing postgis ============== CREATE EXTENSION ============== installing postgis_tiger_geocoder ============== CREATE EXTENSION ============== installing address_standardizer ============== CREATE EXTENSION ============== running regression test queries ============== test test-normalize_address ... ok test test-pagc_normalize_address ... ok ===================== All 2 tests passed. =====================
Um PostGIS zu installieren geben Sie bitte folgendes ein
make install
Dies kopiert die Installationsdateien von PostGIS in das entsprechende Unterverzeichnis, welches durch den Konfigurationsparameter --prefix bestimmt wird. Insbesondere:
Die Binärdateien vom Loader und Dumper sind unter
[prefix]/bininstalliert.Die SQL-Dateien, wie
postgis.sqlsind unter[prefix]/share/contribinstalliert.Die PostGIS Bibliotheken sind unter
[prefix]/libinstalliert.
Falls Sie zuvor den Befehl make comments ausgeführt haben, um die Dateien postgis_comments.sql und raster_comments.sql anzulegen, können Sie die SQL-Dateien folgendermaßen installieren:
make comments-install
| |
|
Wenn Sie PostgreSQL 9.1+ verwenden und das Extensions/PostGIS-Modul installiert haben, können Sie Geodatenbanken auf neue Art und Weise erstellen.
createdb [yourdatabase]
Die Core-Extension installiert PostGIS-Geometrie, -Geographie, die spatial_ref_sys Tabelle und alle Funktionen und Kommentare mit einem einfachen
CREATE EXTENSION postgis;
Befehl.
psql -d [yourdatabase] -c "CREATE EXTENSION postgis;"
Die Raster-Funktionalität ist in einer eigenen Extension paketiert und kann mit folgendem Befehl installiert werden:
psql -d [ihredatenbank] -c "CREATE EXTENSION postgis_raster;"
Die topologische Funktionalität ist in einer eigenen Extension paketiert und kann mit folgendem Befehl installiert werden:
psql -d [yourdatabase] -c "CREATE EXTENSION postgis_topology;"
Falls Sie die Sicherung einer Vorgängerversion in die neue Datenbank einspielen wollen, führen Sie bitte folgendes aus:
psql -d [yourdatabase] -f legacy.sql
| |
Wenn Sie veraltete Funktionen benötigen, müssen Sie bei jedem geringfügigen Upgrade von PostGIS auf eine neue Version das Skript legacy.sql neu installieren. Wenn Sie z.B. von 2.4.3 auf 2.5.0 aktualisieren, dann müssen Sie das legacy.sql welches mit 2.5.0 paketiert ist neu installieren, da einige Funktionen auf die Bibliothek referenzieren und diese mit der "Minor Version" bezeichnet ist. |
Um die veralteten Funktionen loszuwerden, können Sie anschließend an die Wiederherstellung und Aufräumarbeiten uninstall_legacy.sql ausführen.
| |
Dies wird grundsätzlich nur benötigt, wenn PostGIS nicht in im PostgreSQL-Extensionverzeichnis installiert werden kann oder soll (z.B. beim Testen, in der Entwicklung oder in beschränken Umgebungen). |
Der erste Schritt zur Erstellung einer PostGIS-Datenbank ist das Anlegen einer einfachen PostgreSQL Datenbank.
createdb [yourdatabase]
Viele der PostGIS Funktionen sind in der prozeduralen Sprache PL/pgSQL geschrieben. Daher ist der nächste Schritt zur Erstellung einer PostGIS Datenbank die Aktivierung von PL/pgSQL. Dies wird durch den unten angeführten Befehl erreicht. Ab PostgreSQL 8.4 ist PL/pgSQL üblicherweise bereits installiert.
createlang plpgsql [yourdatabase]
Nun erstellen Sie die Definitionen der PostGIS-Objekte und -Funktionen in Ihrer Datenbank, indem Sie die Definitionen mit der Datei postgis.sql laden (diese befindet sich in dem beim Konfigurationsschritt festgelegten Verzeichnis [prefix]/share/contrib).
psql -d [yourdatabase] -f postgis.sql
Für einen vollständigen Satz an EPSG Koordinatensystemen, können Sie die Definitionen auch über die Datei spatial_ref_sys.sql laden und die spatial_ref_sys Tabelle auf diese Weise befüllen. Diese Tabelle ermöglicht die Ausführung von ST_Transform() auf die Geometrien.
psql -d [yourdatabase] -f spatial_ref_sys.sql
Falls Sie Kommentare zu den PostGIS-Funktionen hinzufügen wollen, ist der letzte Schritt das Laden von postgis_comments.sql in Ihre Geodatenbank. Die Kommentare können mit dem einfachen Aufruf von \dd [function_name] in der psql Konsole angezeigt werden.
psql -d [yourdatabase] -f postgis_comments.sql
Installation der Rasterunterstützung
psql -d [yourdatabase] -f rtpostgis.sql
Die Installation der Kommentare zur Rasterunterstützung stellt eine schnelle Hilfe für jede Rasterfunktion bereit. Diese kann dann über psql, PgAdmin oder andere PostgreSQL Werkzeuge die Funktionskommentare anzeigen können, aufgerufen werden.
psql -d [yourdatabase] -f raster_comments.sql
Installation der Topologieunterstützung
psql -d [yourdatabase] -f topology/topology.sql
Die Installation der Kommentare zur Topologie-Unterstützung stellt eine schnelle Hilfe für jede topologische Funktion und jeden topologischen Datentyp bereit. Diese kann dann über psql, PgAdmin oder andere PostgreSQL Werkzeuge die Funktionskommentare anzeigen können, aufgerufen werden.
psql -d [yourdatabase] -f topology/topology_comments.sql
Falls Sie die Sicherung einer Vorgängerversion in die neue Datenbank einspielen wollen, führen Sie bitte folgendes aus:
psql -d [yourdatabase] -f legacy.sql
| |
Es gibt eine alternative |
Um die veralteten Funktionen loszuwerden, können Sie anschließend an die Wiederherstellung und Aufräumarbeiten uninstall_legacy.sql ausführen.
Die Erweiterung address_standardizer musste als getrenntes Paket heruntergeladen werden. Ab PostGIS 2.2 ist es mitgebündelt. Für weitere Informationen zu dem address_standardizer, was er kann und wie man ihn für spezielle Bedürfnisse konfigurieren kann, siehe Chapter 12, Adressennormierer.
Dieser Adressennormierer kann in Verbindung mit der in PostGIS paketierten Erweiterung "tiger gecoder" als Ersatz für Normalize_Address verwendet werden. Um diesen als Ersatz zu nutzen, siehe Section 2.9.3, “Die Adressennormierer-Extension zusammen mit dem Tiger Geokodierer verwenden”. Sie können diesen auch als Baustein für Ihren eigenen Geokodierer verwenden oder für die Normierung von Adressen um diese leichter vergleichbar zu machen.
Der Adressennormierer benötigt PCRE, welches üblicherweise auf Nix-Systemen bereits installiert ist. Sie können die letzte Version aber auch von http://www.pcre.org herunterladen. Wenn PCRE während der Section 2.5.1, “Konfiguration” gefunden wird, dann wird die Erweiterung "address standardizer" automatisch kompiliert. Wenn Sie stattdessen eine benutzerdefinierte Installation von PCRE verwenden wollen, können Sie --with-pcredir=/path/to/pcre an "configure" übergeben, wobei /path/to/pcre der Root-Ordner Ihrer Verzeichnisse "include" und "lib" von PCRE ist.
Für Windows Benutzer ist ab PostGIS 2.1+ die Erweiterung "address_standardizer" bereits mitpaketiert. Somit besteht keine Notwendigkeit zu Kompilieren und es kann sofort der Schritt CREATE EXTENSION ausgeführt werden.
Sobald die Installation beendet ist, können Sie sich mit Ihrer Datenbank verbinden und folgenden SQL-Befehl ausführen:
CREATE EXTENSION address_standardizer;
Der folgende Test benötigt keine rules-, gaz- oder lex-Tabellen
SELECT num, street, city, state, zip
FROM parse_address('1 Devonshire Place PH301, Boston, MA 02109');Die Ausgabe sollte wie folgt sein:
num | street | city | state | zip -----+------------------------+--------+-------+------- 1 | Devonshire Place PH301 | Boston | MA | 02109
Perl Regex:Assemble wird nicht länger für die Kompiation der Erweiterung "address_standardizer" benötigt, da die generierten Dateien jetzt Teil des Quellcodes sind. Wenn Sie allerdings usps-st-city-orig.txt oder usps-st-city-orig.txt usps-st-city-adds.tx editieren müssen, dann müssen Sie parseaddress-stcities.h neu kompilieren, wozu Regex:Assemble benötigt wird.
cpan Regexp::Assemble
oder wenn Sie auf einer Ubuntu / Debian Distribution arbeiten, müssen Sie möglicherweise folgendes ausführen:
sudo perl -MCPAN -e "install Regexp::Assemble"
- 2.9.1. Aktivierung des Tiger Geokodierer in Ihrer PostGIS Datenbank: Verwendung von Extension
- 2.9.2. Den Tiger Geokodierer in der PostGIS Datenbank aktivieren: ohne die Verwendung von Extensions
- 2.9.3. Die Adressennormierer-Extension zusammen mit dem Tiger Geokodierer verwenden
- 2.9.4. Tiger-Daten laden
- 2.9.5. Upgrade Ihrer Tiger Geokodierer Installation
Extras wie den Tiger Geokodierer befinden sich möglicherweise nicht in Ihrer PostGIS Distribution. Wenn Sie die Erweiterung "Tiger Geokodierer" vermissen, oder eine neuere Version installieren wollen, dann können Sie die Dateien share/extension/postgis_tiger_geocoder.* aus den Paketen des Abschnitts Windows Unreleased Versions für Ihre Version von PostgreSQL verwenden. Obwohl diese Pakete für Windows sind, funktionieren die Dateien der Erweiterung "postgis_tiger_geocoder" mit jedem Betriebssystem, da die Erweiterung eine reine SQL/plpgsql Anwendung ist.
Falls Sie PostgreSQL 9.1+ und PostGIS 2.1+ verwenden, können Sie Vorteil aus dem Extension-Modell ziehen, um den Tiger Geokodierer zu installieren. Um dies zu tun:
Besorgen Sie sich zuerst die Binärdateien für PostGIS 2.1+ oder kompilieren und installieren Sie diese wie üblich. Dies sollte alle notwendigen Extension-Dateien auch für den Tiger Geokodierer installieren.
Verbinden Sie sich zu Ihrer Datenbank über psql, pgAdmin oder ein anderes Werkzeug und führen Sie die folgenden SQL Befehle aus. Wenn Sie in eine Datenbank installieren, die bereits PostGIS beinhaltet, dann müssen Sie den ersten Schritt nicht ausführen. Wenn Sie auch die Erweiterung
fuzzystrmatchbereits installiert haben, so müssen Sie auch den zweiten Schritt nicht ausführen.CREATE EXTENSION postgis; CREATE EXTENSION fuzzystrmatch; CREATE EXTENSION postgis_tiger_geocoder; --Optional wenn Sir den regelbasierten Adressennormierer verwenden (pagc_normalize_address) CREATE EXTENSION address_standardizer;
Wenn Sie bereits die postgis-tiger-geocoder Extension installiert haben und nur auf den letzten Stand updaten wollen:
ALTER EXTENSION postgis UPDATE; ALTER EXTENSION postgis_tiger_geocoder UPDATE;
Wenn benutzerdefinierte Einträge oder Änderungen an
tiger.loader_platformodertiger.loader_variablesgemacht wurden, müssen diese aktualisiert werden.Um die Richtigkeit der Installation festzustellen, führen Sie bitte folgenden SQL-Befehl in Ihrer Datenbank aus:
SELECT na.address, na.streetname,na.streettypeabbrev, na.zip FROM normalize_address('1 Devonshire Place, Boston, MA 02109') AS na;Dies sollte folgendes ausgeben:
address | streetname | streettypeabbrev | zip ---------+------------+------------------+------- 1 | Devonshire | Pl | 02109Erstellen Sie einen neuen Datensatz in der Tabelle
tiger.loader_platform, welcher die Pfade zu Ihren ausführbaren Dateien und zum Server beinhaltet.Um zum Beispiel ein Profil mit dem Namen "debbie" anzulegen. welches der
shKonvention folgt, können Sie folgendes tun:INSERT INTO tiger.loader_platform(os, declare_sect, pgbin, wget, unzip_command, psql, path_sep, loader, environ_set_command, county_process_command) SELECT 'debbie', declare_sect, pgbin, wget, unzip_command, psql, path_sep, loader, environ_set_command, county_process_command FROM tiger.loader_platform WHERE os = 'sh';Anschließend ändern Sie die Pfade in der Spalte declare_sect, so dass diese mit den Speicherpfaden von Debbie's "pg", "nzip", "shp2pgsql", "psql", etc. übereinstimmen.
Wenn Sie die Tabelle
loader_platformnicht editieren, so beinhaltet diese lediglich die üblichen Ortsangaben und Sie müssen das erzeugte Skript editieren, nachdem es erzeugt wurde.Ab PostGIS 2.4.1 wurde der Ladevorgang der "Zip code-5 digit tabulation area"
zcta5überarbeitet, um aktuelle zcta5 Daten zu laden und ist nun ein Teil von Loader_Generate_Nation_Script, falls aktiviert. Standardmäßig ausgeschaltet, da der Ladevorgang ziemlich viel Zeit benötigt (20 bis 60 Minuten), ziemlich viel Festplattenspeicher beansprucht wird und es nur selten verwendet wird.Folgendermaßen können Sie deise aktivieren:
UPDATE tiger.loader_lookuptables SET load = true WHERE table_name = 'zcta510';
Falls vorhanden kann die Funktion Geocode diese verwenden, wenn die zips durch einen Boundary Filter begrenzt sind. Die Funktion Reverse_Geocode verwendet dies wenn eine zurückgegebene Adresse keinen zip-Code enthält, was oft bei der inversen Geokodierung von Highways auftritt.
Erstellen Sie einen Ordner mit der Bezeichnung
gisdataim Root des Servers oder auf Ihrem lokalen PC, wenn Sie eine schnelle Netzwerkverbindung zu dem Server haben. In diesen Ordner werden die Dateien von Tiger heruntergeladen und aufbereitet. Wenn Sie den Ordner nicht im Root des Servers haben wollen, oder für die Staging-Umgebung in eine anderen Ordner wechseln wollen, dann können Sie das Attributstaging_foldin der Tabelletiger.loader_variableseditieren.Erstellen Sie einen Ordner "temp" in dem Ordner
gisdataoder wo immer Siestaging_foldhaben wollen. Dies wird der Ordner, in dem der Loader die heruntergeladenen Tigerdaten extrahiert.Anschließend führen Sie die SQL Funktion Loader_Generate_Nation_Script aus, um sicherzustellen dass die Bezeichnung Ihres benutzerdefinierten Profils verwendet wird und kopieren das Skript in eine .sh oder .bat Datei. Um zum Beispiel das Skript zum Laden einer Nation zu erzeugen:
psql -c "SELECT Loader_Generate_Nation_Script('debbie')" -d geocoder -tA > /gisdata/nation_script_load.shFühren Sie die erzeugten Skripts zum Laden der Nation auf der Befehlszeile aus.
cd /gisdata sh nation_script_load.sh
Nachdem Sie das "Nation" Skript ausgeführt haben, sollten sich drei Tabellen in dem Schema
tiger_databefinden und mit Daten befüllt sein. Führen Sie die folgenden Abfragen in "psql" oder "pgAdmin" aus, um dies sicher zu stellenSELECT count(*) FROM tiger_data.county_all;
count ------- 3233 (1 row)
SELECT count(*) FROM tiger_data.state_all;
count ------- 56 (1 row)Standardmäßig werden die Tabellen, welche
bg,tractundtabblockentsprechen, nicht geladen. Diese Tabellen werden vom Geokodierer nicht verwendet, können aber für Bevölkerungsstatistiken genutzt werden. Wenn diese als Teil der Nation geladen werden sollen, können Sie die folgenden Anweisungen ausführen.UPDATE tiger.loader_lookuptables SET load = true WHERE load = false AND lookup_name IN('tract', 'bg', 'tabblock');Alternativ können Sie diese Tabellen nach dem Laden der Länderdaten importieren, indem Sie das Loader_Generate_Census_Script verwenden
Für jeden Staat, für den Sie Daten laden wollen, müssen Sie ein Skript Loader_Generate_Script erstellen.
Erstellen Sie das Skript für die Bundesstaaten NICHT bevor die Daten zur Nation geladen wurden, da das Skript die Liste "county" verwendet, welche durch das "nation"-Skript geladen wird.
psql -c "SELECT Loader_Generate_Script(ARRAY['MA'], 'debbie')" -d geocoder -tA > /gisdata/ma_load.sh
Die vorher erzeugten, befehlszeilenorientierten Skripts ausführen.
cd /gisdata sh ma_load.sh
Nachdem Sie mit dem Laden der Daten fertig sind, ist es eine gute Idee ein ANALYZE auf die Tigertabellen auszuführen, um die Datenbankstatistik (inklusive vererbter Statistik) zu aktualisieren
SELECT install_missing_indexes(); vacuum analyze verbose tiger.addr; vacuum analyze verbose tiger.edges; vacuum analyze verbose tiger.faces; vacuum analyze verbose tiger.featnames; vacuum analyze verbose tiger.place; vacuum analyze verbose tiger.cousub; vacuum analyze verbose tiger.county; vacuum analyze verbose tiger.state; vacuum analyze verbose tiger.zip_lookup_base; vacuum analyze verbose tiger.zip_state; vacuum analyze verbose tiger.zip_state_loc;
Falls Sie den Tiger Geokodierer ohne Extension Modell installiert haben, können Sie wie folgt auf das Extension-Modell wechseln:
Für ein Upgrade ohne Extension-Modell, folgen Sie bitte den Anweisungen unter Section 2.9.5, “Upgrade Ihrer Tiger Geokodierer Installation”.
Verbinden Sie sich über "psql" mit Ihrer Datenbank und führen Sie folgenden Befehl aus:
CREATE EXTENSION postgis_tiger_geocoder FROM unpackaged;
Zuerst installieren Sie PostGIS entsprechend den vorherigen Anweisungen.
Wenn Sie keinen Ordner "extras" haben, können Sie http://download.osgeo.org/postgis/source/postgis-3.0.0.tar.gz herunterladen
tar xvfz postgis-3.0.0.tar.gz
cd postgis-3.0.0/extras/tiger_geocoder
Editieren Sie die Datei tiger_loader_2015.sql (oder die aktuellste Loader Datei die Sie finden, außer Sie wollen ein anderes Jahr laden) um die Pfade zu den ausführbaren Dateien, dem Server etc. richtigzustellen. Alternativ können Sie auch die Tabelle loader_platform nach der Installation editieren. Wenn Sie diese Datei oder die Tabelle loader_platform nicht editieren, dann enthält diese nur die üblichen Ortsangaben und Sie müssen das erzeugte Skript nachträglich bearbeiten, wenn Sie die SQL Funktionen Loader_Generate_Nation_Script und Loader_Generate_Script ausgeführt haben.
Wenn Sie den Tiger Geokodierer zum ersten Mal installieren, dann editierren Sie entweder das Skript create_geocode.bat auf Windows oder create_geocode.sh auf Linux/Unix/Mac OSX entsprechend Ihren spezifischen Einstellungen von PostgreSQL und führen das entsprechende Skript auf der Befehlszeile aus.
Überprüfen sie, ob Sie ein Schema tiger in Ihrer Datenbank haben und sich das Schema in dem "search_path" Ihrer Datenbank befindet. Falls nicht, können Sie das Schema mit folgendem Befehl hinzufügen:
ALTER DATABASE geocoder SET search_path=public, tiger;
Die Funktionalität zur Standardisierung von Adressen funktioniert mehr oder weniger auch ohne Daten, mit Ausnahme von komplizierten Adressen. Führen Sie diese Tests durch und überprüfen Sie, ob das Ergebnis ähnlich wie dieses aussieht:
SELECT pprint_addy(normalize_address('202 East Fremont Street, Las Vegas, Nevada 89101')) As pretty_address;
pretty_address
---------------------------------------
202 E Fremont St, Las Vegas, NV 89101
Eine von vielen Beschwerden betrifft die Funktion Normalize_Address des Adressennormierers, die eine Adresse vor der Geokodierung vorbereitend standardisiert. Der Normierer ist bei weitem nicht perfekt und der Versuch seine Unvollkommenheit auszubessern nimmt viele Ressourcen in Anspruch. Daher haben wir ein anderes Projekt integriert, welches eine wesentlich bessere Funktionseinheit für den Adressennormierer besitzt. Um diesen neuen Adressennormierer zu nutzen, können Sie die Erweiterung so wie unter Section 2.8, “Installation und Verwendung des Adressennormierers” beschrieben kompilieren und als Extension in Ihrer Datenbank installieren.
Sobald Sie diese Extension in der gleichen Datenbank installieren, in der Sie auch postgis_tiger_geocoder installiert haben, dann können Sie Pagc_Normalize_Address anstatt Normalize_Address verwenden. Diese Erweiterung ist nicht auf Tiger beschränkt, wodurch sie auch mit anderen Datenquellen, wie internationalen Adressen, genutzt werden kann. Die Tiger Geokodierer Extension enthält eine eigenen Versionen von rules Tabelle (tiger.pagc_rules), gaz Tabelle (tiger.pagc_gaz) und lex Tabelle (tiger.pagc_lex). Diese können Sie hinzufügen und aktualisieren, um die Normierung an die eigenen Bedürfnisse anzupassen.
Die Anweisungen zum Laden von Daten sind unter extras/tiger_geocoder/tiger_2011/README detailliert beschrieben. Hier sind nur die allgemeinen Schritte berücksichtigt.
Der Ladeprozess lädt Daten von der Census Webseite für die jeweiligen Nationsdateien und die angeforderten Bundesstaaten herunter, extrahiert die Dateien und lädt anschließlich jeden Bundesstaat in einen eigenen Satz von Bundesstaattabellen. Jede Bundesstaattabelle erbt von den Tabellen im Schema tiger, wodurch es ausreicht nur diese Tabellen abzufragen um auf alle Daten zugreifen zu können. Sie können auch jederzeit Bundesstaattabellen mit Drop_State_Tables_Generate_Script löschen, wenn Sie einen Bundesstaat neu laden müssen oder den Bundesstaat nicht mehr benötigen.
Um Daten laden zu können benötigen Sie folgende Werkzeuge:
Ein Werkzeug, um die Zip-Dateien der Census Webseite zu entpacken.
Auf UNIX-ähnlichen Systemen: Das Programm
unzip, das üblicherweise auf den meisten UNIX-ähnlichen Systemen bereits vorinstalliert ist.Auf Windows 7-zip, ein freies Werkzeug zum komprimieren/entkomprimieren, das Sie von http://www.7-zip.org/ herunterladen können.
Das
shp2pgsqlKommandozeilenprogramm, welches standardmäßig mit PostGIS mitinstalliert wird.wget, ein Download-Manager, der üblicherweise auf den meisten UNIX/Linux Systemen vorinstalliert ist.Für Windows können Sie vorkompilierte Binärdateien von http://gnuwin32.sourceforge.net/packages/wget.htm herunterladen
Wenn Sie von tiger_2010 her upgraden, müssen Sie zuerst das Skript Drop_Nation_Tables_Generate_Script generieren und ausführen. Bevor Sie irgendwelche Bundesstaatdaten laden, müssen Sie die nationsweiten Daten mit Loader_Generate_Nation_Script laden. Dies erstellt ein Skript zum Laden. Loader_Generate_Nation_Script ist ein einmaliger Schritt, der vor dem Upgrade (von 2010) und vor neuen Installationen aufsgeführt werden sollte.
Wie ein Skript zum Laden der Daten für Ihre Plattform und für die gewünschten Bundesstaaten generiert werden kann siehe Loader_Generate_Script. Sie können diese stückchenweise installieren. Sie müssen nicht alle benötigten Staaten auf einmal laden. Sie können sie laden wenn Sie diese benötigen.
Nachdem die gewünschten Bundesstaaten geladen wurden, führen Sie so wie unter Install_Missing_Indexes beschrieben
SELECT install_missing_indexes();
aus.
Um zu überprüfen, dass alles funktioniert wie es sollte, können Sie eine Geokodierung über eine Adresse Ihres Staates laufen lassen, indem Sie Geocode verwenden
Wenn Sie den Tiger Geokodierer der mit 2.0+ paketiert ist bereits installiert haben, können Sie die Funktionen jederzeit sogar mit einem vorläufigen Tarball aktualisieren, wenn Bugs fixiert wurden oder Sie es unbedingt benötigen. Dies funktioniert nur für einen Tiger Geokodierer, der nicht als Extension installiert wurde.
Wenn Sie keinen Ordner "extras" haben, können Sie http://download.osgeo.org/postgis/source/postgis-3.0.0.tar.gz herunterladen
tar xvfz postgis-3.0.0.tar.gz
cd postgis-3.0.0/extras/tiger_geocoder/tiger_2011
Finden Sie das Skript upgrade_geocoder.bat auf Windows, oder upgrade_geocoder.sh unter Linux/Unix/Mac OSX. Editieren Sie die Datei um die Berechtigungsnachweise für Ihre PostGIS Datenbank zu erhalten.
Wenn Sie von 2010 oder 2011 her upgraden, sollten Sie die Loader-Skriptzeile auskommentieren, um das neueste Skript zum Laden der Daten von 2012 zu erhalten.
Dann führen Sie das dazugehörige Skript von der Befehlszeile aus.
Anschließend löschen Sie alle "nation"-Tabellen und laden die Neuen. Erstellen Sie ein "drop"-Skript mit den unter Drop_Nation_Tables_Generate_Script beschriebenen SQL-Anweisungen
SELECT drop_nation_tables_generate_script();
Führen Sie die erstellten SQL "drop"-Anweisungen aus.
Die untere SELECT Anweisung erstellt ein Skript zum Laden eines Staates. Details dazu finden Sie unter Loader_Generate_Nation_Script.
Auf Windows:
SELECT loader_generate_nation_script('windows'); Auf Unix/Linux:
SELECT loader_generate_nation_script('sh');Siehe Section 2.9.4, “Tiger-Daten laden” für Anleitungen wie das "generate"-Skript auszuführen ist. Dies muss nur einmal ausgeführt werden.
| |
Sie können eine Mischung aus Bundesstaattabellen von 2010/2011 haben und jeden Bundesstaat getrennt aktualisieren. Bevor Sie einen Bundesstaat auf 2011 aktualisieren, müssen Sie zuerst die Tabellen von 2010 für diesen Bundesstaat mit Drop_State_Tables_Generate_Script entfernen. |
Einige Distributionen von PostGIS (insbesondere die Win32 Installers für PostGIS >= 1.1.5) laden die PostGIS Funktionen in eine template Datenbank mit der Bezeichnung template_postgis. Wenn die Datenbank template_postgis in Ihrer PostgreSQL Installation existiert, dann können Anwender und/oder Applikationen eine Geodatenbank mit einem einzigen Befehl erstellen. In beiden Fällen muss der Datenbank Benutzer das Recht zur Erstellung einer neuen Datenbank haben.
Von der Shell aus:
# createdb -T template_postgis my_spatial_db
Mit SQL:
postgres=# CREATE DATABASE my_spatial_db TEMPLATE=template_postgis
Das Upgrade einer bestehenden Geodatenbank kann trickreich sein, wenn der Ersatz oder die Einführung von neuen Objektdefinitionen in PostGIS nötig ist.
Unglücklicherweise können in einer produktiven Datenbank nicht alle Definitionen einfach ersetzt werden, weshalb ein dump/reload Prozess manchmal die bessere Wahl ist.
PostGIS bietet die Prozedur "SOFT UPGRADE" für "minor"- oder "bugfix" Releases und eine Prozedur "HARD UPGRADE" für die "major" Releases.
Bevor Sie versuchen PostGIS zu aktualisieren, sollten Sie eine Sicherung Ihrer Daten vornehmen. Wenn Sie die Flag -Fc von pg_dump verwenden, können Sie die Daten über ein HARD UPGRADE immer wieder herstellen.
Wenn Sie Ihre Datenbank mittels Extensions installiert haben, müssen Sie auch mit dem Extension Modell upgraden. Wenn Sie auf die alte Art mit dem SQL-Skript installiert haben, dann sollten Sie auch mit dem SQL-Skript upgraden. Beziehen Sie sich bitte auf das Richtige.
Dieser Abschnitt bezieht sich lediglich auf die Installation von PostGIS ohne Extensions. Wenn Sie Extensions haben und ein Upgrade auf diese Weise versuchen, dann erhalten Sie Meldungen wie:
can't drop ... because postgis extension depends on it
HINWEIS: Wenn Sie von PostGIS 1. * zu PostGIS 2. * oder von PostGIS 2. * vor r7409 wechseln, können Sie diese Prozedur nicht verwenden, sondern müssen ein schweres Upgrade durchführen.
Nach der Kompilierung und Installation (make install) sollten Sie eine Reihe von *_upgrade.sql-Dateien in den Installationsordnern finden. Y
Sie können sie alle auflisten mit:
ls `pg_config --sharedir`/contrib/postgis-3.0.0/*_upgrade.sql
Laden Sie sie alle nacheinander, beginnend mit postgis_upgrade.sql.
psql -f postgis_upgrade.sql -d your_spatial_database
Dieselbe Vorgangsweise kann auf die Erweiterungen "raster", "topology" und "sfcgal" angewendet werden. Die Dateien für das Upgrade heissen rtpostgis_upgrade.sql, topology_upgrade.sql und sfcgal_upgrade.sql. Wenn Sie diese benötigen:
psql -f rtpostgis_upgrade.sql -d your_spatial_database
psql -f topology_upgrade.sql -d your_spatial_database
psql -f sfcgal_upgrade.sql -d your_spatial_database
| |
Wenn Sie die Datei |
Die Funktion ??? sollte Sie mit der Meldung "procs need upgrade" darüber informieren, ob Sie diese Art von Upgrade durchführen müssen.
Wenn Sie PostGIS urspünglich mittels Extensions installiert haben, dan müssen Sie beim Upgrade ebenfalls Extensions verwenden. Ein minor Upgrade mit Extensions ist einigermaßen schmerzlos.
ALTER EXTENSION postgis UPDATE TO "3.0.0"; ALTER EXTENSION postgis_topology UPDATE TO "3.0.0";
Falls eine Fehlermeldung angezeigt wird, unternehemen Sie bitte etwas ähnliches wie:
No migration path defined for ... to 3.0.0
Dann müssen Sie ein Backup Ihrer Datenbank erstellen, eine neue so wie unter Section 2.6, “Eine Geodatenbank mit EXTENSIONS anlegen” beschrieben erstellen und das Backup in dieser neuen Datenbank wiederherstellen.
Falls Sie eine ähnliche Meldung wie folgt bekommen:
Version "3.0.0" of extension "postgis" is already installed
Dann ist alles bereits auf dem letzten Stand und Sie können das bedenkenlos ignorieren. SOFERN NICHT versucht wird, von einer Entwicklungsversion auf die nächste (welche keine neue Versionsnummer bekommt) upzugraden; In diesem Fall können Sie "next" an die Versionszeichenkette anhängen und das nächste Mal das Suffix "next" wieder entfernen:
ALTER EXTENSION postgis UPDATE TO "3.0.0next"; ALTER EXTENSION postgis_topology UPDATE TO "3.0.0next";
| |
Wenn Sie PostGIS ursprünglich ohne festgelegte Version installiert haben, dann können Sie die erneute Installation der PostGIS Erweiterungen - vor der Wiederherstellung - überspringen, da im Backup bereits |
| |
Wenn Sie die PostGIS-Erweiterung von einer Version vor 3.0.0 aktualisieren, erhalten Sie eine unverpackte PostGIS Raster-Unterstützung. Sie können die Raster-Unterstützung mit folgendem Befehl neu packen: CREATE EXTENSION postgis_raster FROM unpackaged; Danach, falls Sie es nicht brauchen, löschen Sie es mit: DROP EXTENSION postgis_raster;
|
Unter einem HARD UPGRADE verstehen wir einen vollen Dump/Reload von PostGIS-Datenbanken. Sie benötigen ein HARD UPGRADE, wenn sich die interne Speicherung von PostGIS Objekten geändert hat, oder wenn ein SOFT UPGRADE nicht möglich ist. Der Anhang Release Notes zeigt für jede Version an, ob ein dump/reload (HARD UPGRADE) notwendig ist.
Der Prozess "Dump/Reload" wird von dem Skript "postgis_restore.pl" unterstützt, welches aufpasst dass alle Definitionen, die zu PostGIS gehören (inklusive der alten) beim Dump übersprungen werden. Dies ermöglicht es Ihnen, Ihre Schemata und Daten in einer Datenbank mit PostGIS Erweiterung wiederherzustellen, ohne dass Fehler aufgrund duplizierter Symbole oder überholter Objekte auftreten.
Zusätzliche Anweisungen für Windows Benutzer sind unter Windows Hard upgrade verfügbar.
Die Vorgehensweise ist wie folgt:
Erzeugt einen "custom-format" Dump der Datenbank, die Sie upgraden wollen (nennen wir diese
olddb), inklusive Binary Large Objects (-b) und ausführlich (-v). Kann auch vom "owner" der Datenbank durchgeführt werden; Administratorrechte des Superusers "postgres" sind nicht notwendig.pg_dump -h localhost -p 5432 -U postgres -Fc -b -v -f "/somepath/olddb.backup" olddb
Eine neue Installation von PostGIS in einer neuen Datenbank erstellen; wir verweisen auf die Datenbank mit
newdb. Anleitungen dazu finden Sie unter Section 2.7, “Ersellung einer Geodatenbank ohne Extensions” und Section 2.6, “Eine Geodatenbank mit EXTENSIONS anlegen”.Die Einträge der Tabelle "spatial_ref_sys", die sich in Ihrem Dump befinden werden wiederhergestellt; bestehende Einträge in "spatial_ref_sys" werden aber nicht überschrieben. Dies soll sicherstellen, dass Fehler die in dem offiziellen Satz behoben wurden, auch ordnungsgemäß an die wiederhergestellten Datenbanken weitergegeben werden. Wenn Sie aus irgendeinem Grund die Standardeinträge mit Ihren eigenen Einträgen überschreiben wollen, dann können Sie einfach die Datei "spatial_ref_sys.sql" beim Erstellen der neuen Datenbank nicht laden.
Wenn Ihre Datenbank sehr veraltet ist, oder Sie seit langem überholte Funktionen in Ihren Views und Funktionen verwenden, kann es sein, dass Sie
legacy.sqlausführen müssen. Tun Sie das bitte nur, wenn es unbedingt notwendig ist. Überlegen Sie, die Views und Funktionen vor dem Dump upzugraden, wenn möglich. Die überholten Funktionen können zu einem späteren Zeitpunkt mittelsuninstall_legacy.sqlentfernt werden.Stellt das Backup in der neuen Datenbank
newdbmittels "postgis_restore.pl" wieder her. Falls unvorhergesehene Fehler auftreten, werden diese von psql über die Standardfehlerausgabe angezeigt. Heben Sie sich eine Log-Datei davon auf.perl utils/postgis_restore.pl "/somepath/olddb.backup" | psql -h localhost -p 5432 -U postgres newdb 2 > errors.txt
In folgenden Fällen können Fehler auftreten:
Einige Views oder Funktionen verwenden überholte PostGIS Objekte. Um dies zu beheben, können Sie versuchen das Skript
legacy.sqlvor dem Restore zu laden, oder Sie müssen eine Version von PostGIS wiederherstellen die diese Objekte noch aufweist, und nach der Portierung Ihres Codes die Migration erneut versuchen. Wenn die Methode mitlegacy.sqlfunktioniert, dann sollten Sie Ihren Code so fixieren, dass keine überholten Funktionen mehr verwendet werden und diese anschließend mituninstall_legacy.sqllöschen.Einige benutzerdefinierte Datensätze in der Tabelle "spatial_ref_sys" in der Dumpdatei haben einen ungültige SRID Wert. Gültige Werte für SRID sind größer als 0 und kleiner als 999000. Werte zwischen 999000 und 999999 sind für den internen Gebrauch reserviert, während Werte > 999999 gar nicht verwendet werden können. Alle benutzerdefinierten Datensätze mit ungültiger SRID bleiben erhalten, wobei jene > 999999 in den reservierten Bereich verschoben werden. Die Tabelle "spatial_ref_sys" verliert allerdings einen Check-Constraint für die Überwachung dieser Unveränderlichen und möglicherweise den Primärschlüssel (wenn mehrere ungültige SRIDs auf den gleichen reservierten SRID Wert konvertiert werden).
In order to fix this you should copy your custom SRS to a SRID with a valid value (maybe in the 910000..910999 range), convert all your tables to the new srid (see UpdateGeometrySRID), delete the invalid entry from spatial_ref_sys and re-construct the check(s) with:
ALTER TABLE spatial_ref_sys ADD CONSTRAINT spatial_ref_sys_srid_check check (srid > 0 AND srid < 999000 );
ALTER TABLE spatial_ref_sys ADD PRIMARY KEY(srid));
If you are upgrading an old database containing french IGN cartography, you will have probably SRIDs out of range and you will see, when importing your database, issues like this :
WARNING: SRID 310642222 converted to 999175 (in reserved zone)
In this case, you can try following steps : first throw out completely the IGN from the sql which is resulting from postgis_restore.pl. So, after having run :
perl utils/postgis_restore.pl "/somepath/olddb.backup" > olddb.sql
run this command :
grep -v IGNF olddb.sql > olddb-without-IGN.sql
Create then your newdb, activate the required Postgis extensions, and insert properly the french system IGN with : this script After these operations, import your data :
psql -h localhost -p 5432 -U postgres -d newdb -f olddb-without-IGN.sql 2> errors.txt
Falls Ihre Installation/Upgrade nicht so verläuft wie erwartet, gibt es eine ganze Reihe von Dingen zu überprüfen.
Überprüfen Sie, ob Sie PostgreSQL 9.5 oder neuer installiert haben und dass die Version des PostgreSQL Quellcodes, gegen den Sie kompilieren, mit der Version der laufenden PostgreSQL Datenbank übereinstimmt. Ein Wirrwarr kann dann entstehen, wenn die Linux Distribution bereits PostgreSQL installiert hat, oder wenn Sie PostgreSQL in einem anderen Zusammenhang installiert und darauf vergessen haben. PostGIS funktioniert nur mit PostgreSQL 9.5 oder jünger und es kommt zu merkwürdigen, unerwarteten Fehlermeldungen, wenn Sie eine ältere Version verwenden. Um die Version Ihrer laufenden PostgreSQL Datenbank zu überprüfen, können Sie sich mittels psql zur Datenbank verbinden und folgende Anfrage ausführen:
SELECT version();
Falls Sie eine RPM-basierte Distribution am Laufen haben, können Sie nach vorinstallierten Paketen mit dem Befehl rpm suchen: rpm -qa | grep postgresql
Wenn das Upgrade schief geht, stellen Sie bitte sicher, dass PostGIS, in der Datenbank die Sie wiederherstellen wollen, installiert ist.
SELECT postgis_full_version();
Überprüfen Sie bitte auch, ob "configure" den korrekten Speicherort und die korrekte Version von PostgreSQL, sowie der Bibliotheken Proj4 und GEOS gefunden hat.
Die Ausgabe von configure wird verwendet, um die Datei
postgis_config.hzu erstellen. Überprüfen Sie bitte, ob die VariablenPOSTGIS_PGSQL_VERSION,POSTGIS_PROJ_VERSIONundPOSTGIS_GEOS_VERSIONkorrekt gesetzt sind.
Der Loader und der Dumper werden automatisch, als Teil von PostGIS kompiliert und installiert. Um diese händisch zu kompilieren und zu installieren:
# cd postgis-3.0.0/loader # make # make install
Der Loader heisst shp2pgsql und konvertiert ESRI Shapefiles in SQL, das in PostGIS/PostgreSQL geladen werden kann. Der Dumper heisst pgsql2shp2 und kopiert PostGIS Tabellen (oder Abfragen) in ESRI Shapefiles. Für eine ausführlichere Beschreibung, siehe die Online Hilfe und das Handbuch.
- 3.1. Wo kann ich Lernprogramme, Anleitungen und Seminare für die Arbeit mit PostGIS finden?
- 3.2. Meine Anwendungen und Desktop-Tools funktionierten mit PostGIS 1.5, nicht jedoch mit PostGIS 2.0. Wie kann ich dies beheben?
- 3.3. Wenn ich OpenStreetMap-Daten mit »osm2pgsql« lade, bekomme ich eine Fehlermeldung: »operator class "gist_geometry_ops" does not exist for access method "gist" Error occurred.« In PostGIS 1.5 klappte das gut.
- 3.4. Ich führe PostgreSQL 9.0 aus und kann Geometrien nicht länger in OpenJump, Safe FME und einigen anderen Werkzeugen lesen/schreiben.
- 3.5. Ich habe versucht, meine Geometriespalte mit PgAdmin anzusehen, aber sie ist leer. Was ist los?
- 3.6. Welche Art geometrischer Objekte kann ich speichern?
- 3.7. Ich bin verwirrt. Welchen Datenspeicher soll ich verwenden, »geometry« oder »geography«?
- 3.8. Ich habe tiefergehende Fragen über »geography«, wie beispielsweise welche Größe einer geografischen Region kann ich in eine »geography«-Spalte stopfen und trotzdem noch vernünftige Antworten erhalten. Gibt es Beschränkungen wie Pole, etwas im Feld, das in eine Hemisphäre passen muss (wie bei SQL Server 2008), Geschwindigkeit etc.?
- 3.9. Wie füge ich ein GIS-Objekt in die Datenbank ein?
- 3.10. Wie erstelle ich eine räumliche Abfrage?
- 3.11. Wie kann ich räumliche Abfragen auf großen Tabellen beschleunigen?
- 3.12. Warum werden keine R-Baum-Indizes von PostgreSQL unterstützt?
- 3.13. Warum soll ich die Funktion AddGeometryColumn() und all das andere OpenGIS-Zeug verwenden?
- 3.14. Was ist der beste Weg, alle Objekte innerhalb eines Radius eines anderen Objekts zu finden?
- 3.15. Wie kann ich die Koordinaten-Rückprojektion als Teil einer Abfrage durchführen?
- 3.16. Ich führte ein ST_AsEWKT und ST_AsText auf meiner eher großen Geometrie aus und erhielt ein leeres Feld zurück. Was ist passiert?
- 3.17. ST_Intersects ergibt, dass sich meine beiden geometrischen Objekte nicht überschneiden, obwohl ICH WEISS, DASS SIE DIES TUN. Was ist passiert?
- 3.18. Ich veröffentliche Software, die PostGIS verwendet. Bedeutet das, dass meine Software wie PostGIS unter der GPL lizenziert werden muss? Muss ich all meinen Code veröffentlichen, falls ich PostGIS benutze?
3.1. | Wo kann ich Lernprogramme, Anleitungen und Seminare für die Arbeit mit PostGIS finden? | |||
OpenGeo hat ein schrittweises Lernprogramm Introduction to PostGIS. Es beinhaltet sowohl paketierte Daten als auch ein Einführung in das Arbeiten mit der OpenGeo-Suite. Es ist wahrscheinlich das beste Lernprogramm für PostGIS. Außerdem hat BostonGIS ein PostGIS almost idiot's guide on getting started. Dieser ist eher für Windows-Benutzer gedacht. | ||||
3.2. | Meine Anwendungen und Desktop-Tools funktionierten mit PostGIS 1.5, nicht jedoch mit PostGIS 2.0. Wie kann ich dies beheben? | |||
Viele überholte Funktionen wurden aus der Codebasis von PostGIS 2.0 entfernt. Dies betraf Anwendungen sowie Werkzeuge von Drittanbietern wie Geoserver, MapServer, QuantumGIS und OpenJump, um nur ein paar zu nennen. Es gibt mehrere Möglichkeiten dieses Problem zu lösen. Bei Anwendungen von Drittanbietern können Sie versuchen diese auf die neuste Version zu aktualisieren, bei der viele dieser Probleme bereits fixiert wurden. Ihren eigenen Code können Sie so ändern, dass er die überholten Funktionen nicht mehr benutzt. Die meisten dieser Funktionen sind Pseudonyme von ST_Union, ST_Length etc. ohne den Präfix "ST_". Als letzten Ausweg können Sie die gesamte Die Datei | ||||
3.3. | Wenn ich OpenStreetMap-Daten mit »osm2pgsql« lade, bekomme ich eine Fehlermeldung: »operator class "gist_geometry_ops" does not exist for access method "gist" Error occurred.« In PostGIS 1.5 klappte das gut. | |||
In PostGIS 2 wurde die Standardgeometrieoperatorklasse »gist_geometry_ops« in »gist_geometry_ops_2d« geändert und »gist_geometry_ops« wurde vollständig entfernt. Grund ist, dass PostGIS auch räumliche Nd-Indizes für 3D-Unterstützung einführt und der alte Name als verwirrend und fehlerhaft angesehen wurde. Einige ältere Anwendungen, die als Teil des Prozesses Tabellen und Indizes erstellen, referenzieren explizit den Operatorklassennamen. Dies ist nicht nötig, wenn Sie den Standard-2D-Index wollten. Falls Sie dies erreichen möchten, ändern Sie die Indexerstellung von: SCHLECHT: CREATE INDEX idx_my_table_geom ON my_table USING gist(geom gist_geometry_ops); in GUT: CREATE INDEX idx_my_table_geom ON my_table USING gist(geom); Der einzige Fall, in dem Sie die Operatorklasse angeben müssen, ist, wenn Sie einen räumlichen 3D-Index wie folgt möchten: CREATE INDEX idx_my_super3d_geom ON my_super3d USING gist(geom gist_geometry_ops_nd); Falls Sie unglücklicherweise kompilierten Code, den Sie nicht mehr ändern können, am Hals haben und bei dem altes »gist_geometry_ops« hart codiert ist, können Sie die alte Klasse mittels des in PostGIS 2.0.2+ paketierten | ||||
3.4. | Ich führe PostgreSQL 9.0 aus und kann Geometrien nicht länger in OpenJump, Safe FME und einigen anderen Werkzeugen lesen/schreiben. | |||
In PostgreSQL 9.0+ wurde die Standardcodierung für »bytea«-Daten in hexadezimal geändert und ältere JDBC-Treiber gehen immer noch vom Escape-Format aus. Dies beeinflusste einige Anwendungen wie Java-Programme, die ältere JDBC-Treiber benutzen oder .NET-Anwendungen, die ältere »npgsql«-Treiber verwenden, die das frühere Verhalten von ST_AsBinary erwarten. Es gibt zwei Herangehensweisen, dies wieder zum Laufen zu bringen. Sie können Ihren JDBC-Treiber auf die neuste PostgreSQL-9.0-Version aktualisieren. Diese erhalten Sie unter http://jdbc.postgresql.org/download.html. Falls Sie eine .NET-Anwendung ausführen, können Sie Npgsql 2.0.11 oder neuer verwenden. Dies können Sie von http://pgfoundry.org/frs/?group_id=1000140, wie im Blog-Eintrag von Francisco Figueiredo zur Veröffentlichung von NpgSQL 2.0.11 beschrieben, herunterladen. Falls das Aktualisieren Ihres PostgreSQL-Treibers nicht in Frage kommt, können Sie die Voreinstellung mit der folgenden Änderung auf das vorherige Verhalten zurücksetzen: ALTER DATABASE mypostgisdb SET bytea_output='escape'; | ||||
3.5. | Ich habe versucht, meine Geometriespalte mit PgAdmin anzusehen, aber sie ist leer. Was ist los? | |||
PgAdmin zeigt bei großen Geometrien nichts an. Was ist der beste Weg, um zu prüfen, ob sich in Ihren Geometriespalten Daten befinden? -- Wenn alle Geometriefelder ausgefüllt sind, dann sollte diese Abfrage keine Datensätze zurückgeben SELECT somefield FROM mytable WHERE geom IS NULL; -- Um lediglich die Größe einer Geometrie festzustellen, können Sie eine Abfrage in der folgenden Form ausführen. -- Sie wird Ihnen die Höchstzahl von Punkten mitteilen, die Sie in Ihren Geometriespalten haben. SELECT MAX(ST_NPoints(geom)) FROM sometable; | ||||
3.6. | Welche Art geometrischer Objekte kann ich speichern? | |||
Sie können Punkte, Linien, Polygone, Objekte aus mehreren Punkten, Linien und Polygonen, sowie Geometriesammlungen speichern. In PostGIS 2.0 und höher können Sie auch TINs und Polyederoberflächen im Basistyp »geometry« speichern. Diese werden im »Well-known Text«-Open-GIS-Textformat (mit XYZ-, XYM- und XYZM-Erweiterungen) angegeben. Derzeit werden drei Datentypen unterstützt: Der Standard-OGC-Datentyp »geometry«, der für die Messung ein flaches Koordinatensystem verwendet, der Datentyp »geography«, der ein geodätisches Koordinatensystem benutzt (nicht OGC, aber Sie finden einen ähnlichen Typ in Microsoft SQL Server 2008+). Nur WGS 84 long lat (SRID:4326) wird vom Datentyp »geography« unterstützt. Das neuste Familienmitglied der räumlichen PostGIS-Typenfamilie ist »raster« zum Speichern und Analysieren von Rasterdaten. »raster« hat seine eigene FAQ. Weitere Einzelheiten finden Sie unter Chapter 10, Häufige Fragen zu PostGIS Raster und Chapter 9, Referenz Raster. | ||||
3.7. | Ich bin verwirrt. Welchen Datenspeicher soll ich verwenden, »geometry« oder »geography«? | |||
Kurze Antwort: »geography« ist ein neuer Datentyp, der Distanzmessungen über weite Bereiche hinweg unterstützt; allerdings sind die meisten Berechnungen damit derzeit langsamer als bei »geometry«. Wenn Sie den Datentyp »geography« benutzen, dann müssen Sie nicht viel über ebene Koordinatenreferenzsysteme lernen. Der Datentyp »geography« ist im Allgemeinen dann am besten geeignet, wenn Sie weltweite Daten haben und Sie nur am Messen von Entfernungen und Längen interessiert sind. Der Datentyp »geometry« ist ein alter Datentyp, der von wesentlich mehr Funktionen unterstützt wird, der eine größere Unterstützung von Werkzeugen Dritter genießt und mit dem Transaktionen generell schneller sind; bei einer großen Geometrie manchmal bis zum Zehnfachen schneller. Der Datentyp »geometry« ist die beste Wahl, wenn Sie sich in räumlichen Bezugssystemen sicher fühlen oder Sie mit lokalen Daten arbeiten, bei denen alle Ihre Daten in ein einziges räumliches Bezugssystem (spatial reference system/SRID) passen oder falls Sie eine große Menge räumlicher Daten verarbeiten wollen. Hinweis: Es ist ziemlich einfach, einmalige Umwandlungen zwischen den zwei Typen vorzunehmen, um von den Vorteilen beider zu profitieren. Was derzeit unterstützt wird und was nicht, erfahren Sie unter Section 14.11, “PostGIS Function Support Matrix”. Lange Antwort: Eine ausführlichere Erörterung finden Sie unter Section 4.2.2, “Wann sollte man den geographischen Datentyp dem geometrischen Datentyp vorziehen” und function type matrix. | ||||
3.8. | Ich habe tiefergehende Fragen über »geography«, wie beispielsweise welche Größe einer geografischen Region kann ich in eine »geography«-Spalte stopfen und trotzdem noch vernünftige Antworten erhalten. Gibt es Beschränkungen wie Pole, etwas im Feld, das in eine Hemisphäre passen muss (wie bei SQL Server 2008), Geschwindigkeit etc.? | |||
Ihre Fragen sind zu tiefgehend und komplex, um in diesem Abschnitt angemessen beantwortet werden zu können. Bitte lesen Sie unsere Section 4.2.3, “Fortgeschrittene FAQ's zum geographischen Datentyp”. | ||||
3.9. | Wie füge ich ein GIS-Objekt in die Datenbank ein? | |||
Zuerst müssen Sie eine Tabelle mit einer Spalte des Typs »geometry« oder »geography« erstellen, die Ihre GIS-Daten bereithält. Das Speichern des Datentyps »geography« unterscheidet sich etwas vom Speichern des Datentyps »geometry«. Einzelheiten über das Speichern von »geography« finden Sie unter Section 4.2.1, “Grundsätzliches zum geographischen Datentyp”. Für »geometry«: Verbinden Sie Ihre Datenbank mit CREATE TABLE gtest (id serial primary key, name varchar(20), geom geometry(LINESTRING)); Falls die Definition der Spalte »geometry« fehlschlägt, haben Sie wahrscheinlich die PostGIS-Funktionen und -Objekte nicht in Ihre Datenbank geladen oder Sie verwenden eine Version von PostGIS vor 2.0. Siehe Section 2.5, “Kompilierung und Installation des Quellcodes: Detaillierte Beschreibung”. Dann können Sie mittels eines SQL-INSERT-Befehls eine Geometrie in Ihre Tabelle einfügen. Das GIS-Objekt selbst ist mit dem Format »well-known-text« des OpenGIS-Konsortiums formatiert: INSERT INTO gtest (ID, NAME, GEOM)
VALUES (
1,
'First Geometry',
ST_GeomFromText('LINESTRING(2 3,4 5,6 5,7 8)')
);Mehr Informationen über weitere GIS-Objekte finden Sie in der Objektreferenz. So sehen Sie sich Ihre GIS-Daten in der Tabelle an: SELECT id, name, ST_AsText(geom) AS geom FROM gtest; Der Rückgabewert sollte etwa so aussehen: id | name | geom ----+----------------+----------------------------- 1 | First Geometry | LINESTRING(2 3,4 5,6 5,7 8) (1 row) | ||||
3.10. | Wie erstelle ich eine räumliche Abfrage? | |||
Auf die gleiche Weise, wie alle anderen Datenbankabfragen erstellt werden, als Kombination von Rückgabewerten, Funktionen und booleschen Tests. Es gibt bei räumlichen Abfragen zwei Aspekte, die Sie beim Erstellen Ihrer Abfrage im Hinterkopf behalten sollten: Es gibt einen räumlichen Index, von dem Sie Gebrauch machen können, und führen Sie aufwendige Berechnungen auf einer großen Zahl von Geometrien durch? Im Allgemeinen werden Sie den »Überschneidungsoperator« (&&) benutzen wollen, der prüft, ob sich die Hüllquader der Objekte überschneiden. Der Hauptnutzen des &&-Operators besteht darin, dass er, falls ein räumlicher Index zum Beschleunigen des Tests verfügbar ist, Gebrauch davon macht. Dies kann Abfragen sehr stark beschleunigen. Sie werden auch von räumlichen Funktionen wie Distance(), ST_Intersects(), ST_Contains() und ST_Within() Gebrauch machen, um die Ergebnisse Ihrer Suche einzugrenzen. Die meisten räumlichen Abfragen enthalten sowohl einen indizierten als auch einen räumlichen Funktionstest. Der Indextest begrenzt die Auswahl von Tupeln auf nur diejenigen Tupel, die die Bedingung, die von Interesse ist, treffen könnten. Die räumlichen Funktionen werden dann verwendet, um die Bedingung genau zu prüfen. SELECT id, the_geom FROM thetable WHERE ST_Contains(the_geom,'POLYGON((0 0, 0 10, 10 10, 10 0, 0 0))'); | ||||
3.11. | Wie kann ich räumliche Abfragen auf großen Tabellen beschleunigen? | |||
Schnelle Abfragen großer Tabellen sind die Daseinsberechtigung räumlicher Datenbanken (neben der Unterstützung von Transaktionen). Daher ist es wichtig, über einen guten Index zu verfügen. Um einen räumlichen Index für eine Tablle mit einer CREATE INDEX [indexname] ON [tabellenname] USING GIST ( [geometry_spalte] ); Die Option »USING GIST« teilt dem Server mit, dass er einen GiST-Index (Generalized Search Tree/Verallgemeinerter Suchbaum) verwenden soll.
Sie sollten außerdem sicherstellen, dass das PostgreSQL-Abfrageplanungsprogramm ausreichende Informationen über Ihren Index hat, um vernünftige Entscheidungen treffen zu können, wann er benutzt wird. Zu diesem Zweck müssen Sie für Ihre Geometrietabellen »Statistiken erstellen«. Unter PostgeSQL 8.0.x und neuer führen Sie einfach den Befehl VACUUM ANALYZE aus. Unter PostgreSQL 7.4.x und älter führen Sie den Befehl SELECT UPDATE_GEOMETRY_STATS() aus. | ||||
3.12. | Warum werden keine R-Baum-Indizes von PostgreSQL unterstützt? | |||
Ältere Versionen von PostGIS verwendeten die PostgreSQL-R-Baum-Indizes. PostgreSQL-R-Bäume wurden jedoch seit Version 0.6 komplett ausrangiert und räumliche Indizierung wird mit dem Schema »R-Tree-over-GiST« bereitgestellt. Unsere Tests haben gezeigt, dass die Suchgeschwindigkeit für native R-Bäume und GiST vergleichbar ist. Native PostgreSQL-R-Bäume haben zwei Einschränkungen, wegen der sie für den Gebrauch mit GIS-Objekten unerwünscht sind (beachten Sie, dass diese Einschränkungen aufgrund der Implementierung nativer PostgreSQL-R-Bäume und nicht wegen des Konzepts der R-Bäume im Allgemeinen bestehen):
| ||||
3.13. | Warum soll ich die Funktion | |||
Falls Sie keine OpenGIS-Hilfsfunktionen nutzen möchten, müssen Sie dies nicht. Erstellen Sie einfach Ihre Tabellen in älteren Versionen, indem Sie Ihre »geometry«-Spalten im CREATE-Befehl erstellen. Alle Ihre Geometrien werden SRIDs von -1 haben und die OpenGIS-Metadatentabellen werden nicht ordentlich gefüllt. Dies wird jedoch die meistenAnwendungen, die auf PostGIS basieren, zum Abstürzen bringen und es wird generell empfohlen, dass Sie zum Erstellen von »geometry«-Tabellen MapServer ist eine dieser Anwendungen, die Gebrauch von | ||||
3.14. | Was ist der beste Weg, alle Objekte innerhalb eines Radius eines anderen Objekts zu finden? | |||
Um die Datenbank möglichst effizient zu nutzen, ist es am besten Radiusabfragen zu verwenden. Diese kombinieren den Radiustest mit einem Hüllquadertest: Der Hüllquadertest benutzt den räumlichen Index, der schnellen Zugriff auf eine Untermenge von Daten gewährt, auf die dann der Radiustest angewendet wird. Die Funktion Um zum Beispiel alle Objekte mit 100 Metern Entfernung zu POINT(1000 1000) zu finden, wäre die folgende Abfrage gut geeignet: SELECT * FROM geotable WHERE ST_DWithin(geocolumn, 'POINT(1000 1000)', 100.0); | ||||
3.15. | Wie kann ich die Koordinaten-Rückprojektion als Teil einer Abfrage durchführen? | |||
Um eine Rückprojektion durchzuführen, müssen sowohl die Quell- als auch die Zielkoordinatensysteme in einer SPATIAL_REF_SYS-Tabelle definiert sein und und die SRIDs der Geometrien, die rückprojiziert werden, müssen bereits gesetzt sein. Sobald dies erledigt ist, ist die Rückprojektion so einfach wie Bezug auf die gewünschte Ziel-SRID zu nehmen. Nachfolgend wird eine Geometrie auf »NAD 83 long lat« projiziert. Das Folgende funktioniert nur, falls die SRID der Geometrie nicht -1 ist (keine undefinierte räumliche Referenz). SELECT ST_Transform(die_geometrie,4269) FROM geometrietabelle; | ||||
3.16. | Ich führte ein ST_AsEWKT und ST_AsText auf meiner eher großen Geometrie aus und erhielt ein leeres Feld zurück. Was ist passiert? | |||
Sie verwenden vermutlich PgAdmin oder irgendein anderes Werkzeug, das keine großen Texte ausgibt. Falls Ihre Geometrie groß genug ist, wird sie in diesen Werkzeugen leer erscheinen. Falls Sie sie wirklich sehen oder in WKT ausgeben möchten, verwenden Sie PSQL. --zum Prüfen, ob die Anzahl der Geometrien wirklich leer ist
SELECT count(gid) FROM geotable WHERE the_geom IS NULL; | ||||
3.17. | ST_Intersects ergibt, dass sich meine beiden geometrischen Objekte nicht überschneiden, obwohl ICH WEISS, DASS SIE DIES TUN. Was ist passiert? | |||
Im Allgemeinen kommt das in zwei Fällen vor. Ihre Geometrie ist ungültig – prüfen Sie dies mit ??? oder Sie gehen davon aus, dass sie sich überschneiden, da ST_AsText die Zahlen rundet und Sie viele Dezimalstellen dahinter haben, die Ihnen nicht angezeigt werden. | ||||
3.18. | Ich veröffentliche Software, die PostGIS verwendet. Bedeutet das, dass meine Software wie PostGIS unter der GPL lizenziert werden muss? Muss ich all meinen Code veröffentlichen, falls ich PostGIS benutze? | |||
Höchstwahrscheinlich nicht. Oracle-Datenbanken laufen zum Beispiel unter Linux. Linux steht unter der GPL, Oracles Datenbank nicht. Muss Oracles Datenbank, die unter Linux läuft, unter der GPL verteilt werden? Nein. In ähnlicher Weise kann Ihre Software die PostgreSQL/PostGIS Datenbank soviel nutzen wie sie will, und kann unter irgendeiner, von Ihnen gewünschten Lizenz vorliegen. Die einzige Ausnahme wäre, wenn Sie Veränderungen am PostGIS-Quellcode vorgenommen hätten und die veränderte Version verteilen würden. In diesem Fall müssten Sie den Code Ihres veränderten PostGIS freigeben (aber nicht den Code von Anwendungen, die darauf laufen). Sogar in diesem begrenzten Fall müssten Sie nur den Quellcode an Leute verteilen, denen Sie Binärcode weitergegeben haben. Die GPL verlangt nicht, dass Sie Ihren Quellcode veröffentlichen, nur dass Sie ihn mit Leuten teilen, denen Sie Binärcode geben. Die oberen Angaben treffen auch zu, wenn Sie PostGIS in Verbindung mit den optionalen CGAL-aktivierten Funktionen nutzen. Teile von CGAL liegen unter GPL vor, so wie bereits das gesamte PostGIS: die Verwendung von CGAL macht PostGIS nicht mehr GPL als es bereits von vornherein ist. |
Die Geoobjekte, die von PostGIS unterstützt werden, sind eine Obermenge der durch das OpenGIS Consortium (OGC) festgelegten "Simple Features". PostGIS unterstützt sämtliche Objekte und Funktionen, die in der OGC "Simple Features for SQL" Spezifikation normiert sind.
PostGIS erweitert den Standard mit der Unterstützung von 3DZ-, 3DM -und 4D-Koordinaten.
Die OpenGIS Spezifikation standardisiert zwei Möglichkeiten um Geoobjekte darzustellen: die Well-known-Text (WKT) und die Well-Known-Binary (WKB) Darstellung. Sowohl WKT als auch WKB enthalten Information über den Objekttyp und die Koordinaten, die das Objekt bilden.
Beispiele für die Textdarstellung (WKT) von Geoobjekten:
POINT(0 0)
LINESTRING(0 0,1 1,1 2)
POLYGON((0 0,4 0,4 4,0 4,0 0),(1 1, 2 1, 2 2, 1 2,1 1))
MULTIPOINT((0 0),(1 2))
MULTILINESTRING((0 0,1 1,1 2),(2 3,3 2,5 4))
MULTIPOLYGON(((0 0,4 0,4 4,0 4,0 0),(1 1,2 1,2 2,1 2,1 1)), ((-1 -1,-1 -2,-2 -2,-2 -1,-1 -1)))
GEOMETRYCOLLECTION(POINT(2 3),LINESTRING(2 3,3 4))
Die OpenGIS Spezifikation verlangt auch, dass das der Identifikator des Koordinatenreferenzsystem (SRID) im internen Format der Geoobjekte mit abgespeichert ist.
Für die Ein- und Ausgabe dieser Formate stehen die folgenden Schnittstellen zur Verfügung
bytea WKB = ST_AsBinary(geometry); text WKT = ST_AsText(geometry); geometry = ST_GeomFromWKB(bytea WKB, SRID); geometry = ST_GeometryFromText(text WKT, SRID);
Eine gültige Einfügeanweisung, um ein räumliches OGC-Objekt zu erzeugen und einzufügen, wäre:
INSERT INTO geotable ( the_geom, the_name )
VALUES ( ST_GeomFromText('POINT(-126.4 45.32)', 312), 'A Place');Das OGC Format unterstützt nur 2D-Geometrien, und die dazugehörige SRID ist *niemals* in den Eingabe/Ausgabe-Darstellungen eingebettet.
Zur Zeit sind die erweiterten Formate von PostGIS eine Obermenge von den OGC-Formaten (jeder gültige WKT/WKB ist auch ein gültiger EWKT/EWKB). Dies kann sich in der Zukunft allerdings ändern, insbesondere dann, wenn OGC ein neues Format einführt, welches mit diesen Erweiterungen im Widerspruch steht. Daher sollten SIE sich BITTE NICHT auf diese Eigenschaft verlassen!
PostGIS EWKB/EWKT add 3DM, 3DZ, 4D coordinates support and embedded SRID information.
Beispiele für die Textdarstellung (EWKT) von erweiterten Geoobjekten:
POINT(0 0 0) -- XYZ
SRID=32632;POINT(0 0) -- XY mit SRID
POINTM(0 0 0) -- XYM
POINT(0 0 0 0) -- XYZM
SRID=4326;MULTIPOINTM(0 0 0,1 2 1) -- XYM mit SRID
MULTILINESTRING((0 0 0,1 1 0,1 2 1),(2 3 1,3 2 1,5 4 1))
POLYGON((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 0))
MULTIPOLYGON(((0 0 0,4 0 0,4 4 0,0 4 0,0 0 0),(1 1 0,2 1 0,2 2 0,1 2 0,1 1 0)),((-1 -1 0,-1 -2 0,-2 -2 0,-2 -1 0,-1 -1 0)))
GEOMETRYCOLLECTIONM( POINTM(2 3 9), LINESTRINGM(2 3 4, 3 4 5) )
MULTICURVE( (0 0, 5 5), CIRCULARSTRING(4 0, 4 4, 8 4) )
POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)), ((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)), ((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )
TRIANGLE ((0 0, 0 9, 9 0, 0 0))
TIN( ((0 0 0, 0 0 1, 0 1 0, 0 0 0)), ((0 0 0, 0 1 0, 1 1 0, 0 0 0)) )
Für die Konvertierung zwischen diesen Formaten stehen die folgenden Schnittstellen zur Verfügung:
bytea EWKB = ST_AsEWKB(geometry); text EWKT = ST_AsEWKT(geometry); geometry = ST_GeomFromEWKB(bytea EWKB); geometry = ST_GeomFromEWKT(text EWKT);
Zum Beispiel würde eine gültige Eingabeanweisung, um räumliche PostGIS Objekte zu erzeugen und einzufügen, wie folgt lauten:
INSERT INTO geotable ( the_geom, the_name )
VALUES ( ST_GeomFromEWKT('SRID=312;POINTM(-126.4 45.32 15)'), 'A Place' )Die "kanonische Form" eines PostgreSQL Datentyps ist jene Darstellung die man mit einer einfachen Abfrage (ohne Funktionsaufruf) erhält und bei der sichergestellt ist, dass sie von einem einfachen INSERT, UPDATE oder COPY angenommen wird. Beim geometrischen Datentyp von PostGIS sind dies:
- Ausgabe
- binary: EWKB
ascii: HEXEWKB (EWKB in hex form)
- Eingabe
- binary: EWKB
ascii: HEXEWKB|EWKT Zum Beispiel liest die folgende Anweisung EWKT ein und gibt HEXEWKB in Normalform aus:
=# SELECT 'SRID=4;POINT(0 0)'::geometry; geometry ---------------------------------------------------- 01010000200400000000000000000000000000000000000000 (1 row)
Die "SQL Multimedia Applications Spatial" Spezifikation erweitert die SQL Spezifikation für Simple Features indem es eine Reihe von kreisförmig interpolierten Kurven definiert.
Die Definitionen in SQL-MM schließen 3DM-, 3DZ- und 4D-Koordinaten ein, erlauben allerdings nicht das Einbinden von Information über SRID.
Die Erweiterungen zur Well-known-Text-Darstellung werden zur Zeit noch nicht zur Gänze unterstützt. Im Folgenden werden Beispiele für einige einfache gekrümmte Geometrien gezeigt:
CIRCULARSTRING(0 0, 1 1, 1 0)
CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0)
CIRCULARSTRING ist der grundlegende Kurventyp, ähnlich wie LINESTRING in der linearen Welt. Ein einziges Segment benötigt drei Punkte, den Anfangs- und den Endpunkt (erster und dritter) und irgendeinen weiterer Punkt auf dem Kreisbogen. Eine Ausnahme ist der geschlossene Kreis, wo Anfangs- und Endpunkt ident sind. In diesem Fall muss der zweite Punkt dem Kreismittelpunkt entsprechen. Um Kreisbögen aneinanderzuketten, wird der Endpunkt des vorangehenden Bogens zum Anfangspunkt des nächstfolgenden Bogens, genauso wie beim LINESTRING. D.h., dass ein Kreisbogen eine ungerade Anzahl an Punkten grösser als 1 aufweisen muss.
COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 1, 1 0),(1 0, 0 1))
Eine zusammengesetzte Kurve ist eine einzelne, durchgängige Kurve, die sowohl gekrümmte (kreisförmige) als auch gerade Segmente aufweist. Dies bedeutet, daß die Komponenten nicht nur wohlgeformt sein müssen, sondern auch der Endpunkt einer jeden Komponente (außer der letzten) mit dem Anfangspunkt der nachfolgenden Komponente zusammenfallen muss.
CURVEPOLYGON(CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0),(1 1, 3 3, 3 1, 1 1))
Beispiel einer zusammengesetzten Kurve in einem Kurvenpolygon: CURVEPOLYGON(COMPOUNDCURVE(CIRCULARSTRING(0 0,2 0, 2 1, 2 3, 4 3),(4 3, 4 5, 1 4, 0 0)), CIRCULARSTRING(1.7 1, 1.4 0.4, 1.6 0.4, 1.6 0.5, 1.7 1) )
Ein CurvePolygon hat, genau wie ein Polygon, einen äußeren Ring und keinen oder mehrere innere Ringe. Der Unterschied liegt darin, dass ein Ring aus Kreisbögen, Geraden oder zusammengesetzten Strecken bestehen kann.
Ab PostGIS 1.4 werden zusammengesetzte Kurven/CompoundCurve in einem Kurvenpolygon/CurvePolygon unterstützt.
MULTICURVE((0 0, 5 5),CIRCULARSTRING(4 0, 4 4, 8 4))
Eine MultiCurve ist eine Sammelgeometrie von Kurven, welche aus Geraden, Kreisabschnitte oder zusammengesetzten Abschnitten bestehen kann.
MULTISURFACE(CURVEPOLYGON(CIRCULARSTRING(0 0, 4 0, 4 4, 0 4, 0 0),(1 1, 3 3, 3 1, 1 1)),((10 10, 14 12, 11 10, 10 10),(11 11, 11.5 11, 11 11.5, 11 11)))
Dies ist eine Sammelgeometrie von Oberflächen, welche (lineare) Polygone oder Kurvenpolygone sein können.
| |
Alle Gleitpunkt Vergleiche der SQL-MM Implementierung werden mit einer bestimmten Toleranz ausgeführt, zurzeit 1E-8. |
Der geographische Datentyp bietet native Unterstützung für Geoobjekte die durch "geographische" Koordinaten (manchmal auch als "geodätische" Koordinaten, "Länge/Breite" oder "Breite/Länge" bezeichnet) festgelegt sind. Geographische Koordinaten sind Kugelkoordinaten, die durch Winkel (in Grad) angegeben werden.
Der geometrische Datentyp von PostGIS beruht auf der Ebene. Die kürzeste Entfernung zwischen zwei Punkten einer Ebene entspricht einer Gerade. Das bedeutet, dass geometrische Berechnungen (wie Flächen, Distanzen, Längen, Schnittpunkte, etc.) im kartesischen Koordinatensystem mit geradlinigen Vektoren ausgeführt werden können.
Der geographische Datentyp von PostGIS beruht auf einer Kugel. Die kürzeste Verbindung zwischen zwei Punkten auf einer Kugeloberfläche ist ein Bogenteil eines Großkreises. D.h., dass Berechnungen auf geographische Datentypen (wie Flächen, Distanzen, Längen, Schnittpunkte, etc.) auf der Kugeloberfläche mit einer komplexeren Mathematik durchgeführt werden müssen. Für genauere Messungen müssen die Berechnungen das Rotationsellipsoid der Erde in Betracht ziehen.
Da die zugrunde liegende Mathematik wesentlich schwieriger ist, gibt es weniger Funktionen für den geographischen Datentyp, als für den geometrischen Datentyp. Mit der Zeit werden neue Algorithmen hinugefügt und die Möglichkeiten des geographischen Datentyps erweitert werden.
Es verwendet den Datentyp geography, der allerdings von den Funktionen der Bibliothek GEOS in keiner Weise unterstützt wird. Als provisorische Lösung kann man zwischen dem geometrischen und dem geographischen Datentypen hin- und herkonvertieren.
Vor PostGIS 2.2 hat der geographische Datentyp nur WGS 84 Länge und Breite (SRID:4326) unterstützt. Ab PostGIS 2.2 kann dieser jedes Koordinatenreferenzsystem verwenden, das auf Länge und Breite basiert und in der Tabelle spatial_ref_sysaufgeführt ist. Sie können sogar Ihr eigenes Polarkoordinatenreferenzsystem hinzufügen, wie unter geography type is not limited to earth beschrieben.
Unabhängig vom verwendeten Koordinatenreferenzsystem sind die Einheiten der ausgegebenen Messungen (ST_Distance, ST_Length, ST_Perimeter, ST_Area) und der Eingabe für ??? in Meter.
Der geographische Datentyp verwendet die Typmod-Formatangabe von PostgreSQL, sodass eine Tabelle mit einem geographischen Attribut in einem einzigen Schritt erstellt werden kann. Es werden alle Formate des OGC-Standards unterstützt, mit Ausnahme von Kurven.
Der geographische Datentyp unterstützt Geometrien, ausgenommen sind jedoch Kuven, TINS und POLYHEDRALSURFACEs. Daten vom geometrischen Datentyp, welche eine SRID von 4326 aufweisen, werden implizit in den geographischen Datentyp umgewandelt. Sie können Daten auch entsprechend der EWKT- und EWKB-Konvention einfügen.
POINT: Erstellung einer 2D-Punkttabelle mit dem geographischen Datentyp. Wenn die SRID nicht festgelegt ist, wird 4326 WGS 84 Länge und Breite angenommen:
CREATE TABLE ptgeogwgs(gid serial PRIMARY KEY, geog geography(POINT) );
POINT: Erstellung einer Tabelle mit 2D-Punkten als geographischen Datentyp in NAD83 Länge und Breite:
CREATE TABLE ptgeognad83(gid serial PRIMARY KEY, geog geography(POINT,4269) );
Erstellung einer Punkttabelle mit Z-Koordinaten und explizit angegebener SRID
CREATE TABLE ptzgeogwgs84(gid serial PRIMARY KEY, geog geography(POINTZ,4326) );
LINESTRING
CREATE TABLE lgeog(gid serial PRIMARY KEY, geog geography(LINESTRING) );
POLYGON
-- Polygon in NAD 1927 Länge und Breite CREATE TABLE lgeognad27(gid serial PRIMARY KEY, geog geography(POLYGON,4267) );
MULTIPOINT
MULTILINESTRING
MULTIPOLYGON
GEOMETRYCOLLECTION
Die Attribute des geographischen Datentyps werden in dem System View geography_columns registriert.
Nun überprüfen Sie bitte ob Ihre Tabelle in der gespeicherten Abfrage "geography_columns" aufscheint.
Sie können eine neue Tabelle mit einer geographischen Datentypspalte mit der Syntax von CREATE TABLE erstellen.
CREATE TABLE global_points (
id SERIAL PRIMARY KEY,
name VARCHAR(64),
location GEOGRAPHY(POINT,4326)
);
Beachten Sie bitte, dass die Spalte "location" den geographischen Datentyp verwendet und dieser zwei optionale Modifikatoren unterstützt: Einen Typmodifikator, der die geometrische Form und die Dimension der Geometriespalte festlegt; ein Modifikator für SRID, der den Identifikator für das Koordinatenreferenzsystem auf eine bestimmte Zahl einschränkt.
Für den Typmodifikator sind folgende Werte erlaubt: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON. Der Modifikator unterstützt auch Einschränkungen der Dimensionalität durch Nachsilben: Z, M und ZM. So erlaubt zum Beispiel ein Modifikator mit dem Wert 'LINESTRINGM' nur die Eingabe von Linienzügen mit drei Dimensionen, wobei die dritte Dimension als Kilometrierung/measure behandelt wird. Ebenso verlangt 'POINTZM' die Eingabe von vierdimensionalen Daten.
Wenn Sie keine SRID angeben, dann wird standardmäßig die SRID 4326 WGS84 Länge/Breite verwendet und alle Berechnungen in WGS84 ausgeführt.
Sobald Sie Ihre Tabelle erstellt haben, können Sie diese in der Tabelle "geography_columns" sehen:
-- Metadaten abfragen SELECT * FROM geography_columns;
Sie können Daten auf dieselbe Art und Weise in die Tabelle einfügen wie Sie dies bei einer Geometriespalte tun würden:
-- Ein paar Daten in die Testtabelle einfügen
INSERT INTO global_points (name, location) VALUES ('Town', 'SRID=4326;POINT(-110 30)');
INSERT INTO global_points (name, location) VALUES ('Forest', 'SRID=4326;POINT(-109 29)');
INSERT INTO global_points (name, location) VALUES ('London', 'SRID=4326;POINT(0 49)');Die Erstellung eines Index funktioniert gleich wie beim Datentyp GEOMETRY. PostGIS erkennt, dass es sich um den Datentyp GEOGRAPHY handelt und erzeugt einen entsprechenden, auf einer Kugeloberfläche basierenden Index anstelle des üblichen planaren Index, der für den Datentyp GEOMETRY verwendet wird.
-- Einen sphärischen Index auf die Testtabelle legen CREATE INDEX global_points_gix ON global_points USING GIST ( location );
Anfrage und Messfunktionen verwenden die Einheit Meter. Daher sollten Entfernungsparameter in Metern ausgedrückt werden und die Rückgabewerte sollten ebenfalls in Meter (oder Quadratmeter für Flächen) erwartet werden.
-- Eine Distanzabfrage; Beachten Sie bitte, dass London ausserhalb der 1000km Toleranz liegt SELECT name FROM global_points WHERE ST_DWithin(location, 'SRID=4326;POINT(-110 29)'::geography, 1000000);
Sie können die Mächtigkeit von GEOGRAPHY erfahren, indem Sie berechnen, wie nahe ein Flugzeug, das von Seattle nach London (LINESTRING(-122.33 47.606, 0.0 51.5)) fliegt, an Reykjavik (POINT(-21.96 64.15)) vorbeikommt.
-- Die Entfernung mittels GEOGRAPHY ausrechnen (122.2km)
SELECT ST_Distance('LINESTRING(-122.33 47.606, 0.0 51.5)'::geography, 'POINT(-21.96 64.15)':: geography);
-- Die Entfernung mittels GEOMETRIE ausrechnen (13.3 "degrees")
SELECT ST_Distance('LINESTRING(-122.33 47.606, 0.0 51.5)'::geometry, 'POINT(-21.96 64.15)':: geometry);
Ausprobieren von verschiedenen Projektionen in Länge/Breie. Es ist jedes Koordinatenreferenzsystem in Länge und Breite zulässig, das in der Tabelle spatial_ref_sys aufgeführt ist.
-- NAD 83 in Länge und Breite
SELECT 'SRID=4269;POINT(-123 34)'::geography;
geography
----------------------------------------------------
0101000020AD1000000000000000C05EC00000000000004140
(1 row)
-- NAD27 in Länge und Breite
SELECT 'SRID=4267;POINT(-123 34)'::geography;
geography
----------------------------------------------------
0101000020AB1000000000000000C05EC00000000000004140
(1 row)
-- NAD83 UTM Zone in Meter, resultiert in einem Fehler, da metrische Projektion SELECT 'SRID=26910;POINT(-123 34)'::geography; ERROR: Nur Koordinatensysteme in Länge und Breite werden vom geographischen Datentyp unterstützt. LINE 1: SELECT 'SRID=26910;POINT(-123 34)'::geography;
Mit dem Datentyp GEOGRAPHY wird die wahre, kürzeste Entfernung auf der Kugeloberfläche zwischen Reykjavik und der Flugstrecke entlang des Großkreises von Seattle nach London errechnet.
Great Circle mapper Beim geometrischen Datentyp wird die Entfernung sinnloserweise in einem kartesischen Koordinatensystem zwischen Reykjavik und einer Geraden von Seattle nach London errechnet und auf einer ebenen Weltkarte angezeigt. Dem Namen nach mag das Ergebnis in der Einheit "Grad" angegeben sein, da es aber in keiner Weise irgendeinem wahren Winkel zwischen den Punkten entspricht, ist sogar die Verwendung der Bezeichnung "Grad" falsch.
Der geographische Datentyp speichert die Koordinaten in Form von Länge und Breite. Er hat allerdings den Nachteil, dass für den Datentyp GEOGRAPHY weniger Funktionen zur Verfügung stehen, als für den Datentyp GEOMETRY und diese auch mehr CPU-Zeit beanspruchen.
Welchen Datentyp Sie wählen, sollte aufgrund der zu erwartenden Flächenausdehnung ihrer Anwendung festgelegt werden. Erstrecken sich Ihre Daten über den gesamten Globus oder über eine große kontinentale Fläche, oder sind sie auf einen Staat, ein Land oder eine Gemeinde beschränkt.
Wenn sich Ihre Daten in einem kleinen Bereich befinden, werden Sie vermutlich eine passende Projektion wählen und den geometrischen Datentyp verwenden, da dies in Bezug auf die Rechenleistung und die verfügbare Funktionalität die bessere Lösung ist.
Wenn Ihre Daten global sind oder einen ganzen Kontinent bedecken, ermöglicht der geographische Datentyp ein System aufzubauen, bei dem Sie sich nicht um Projektionsdetails kümmern müssen. Sie speichern die Daten als Länge und Breite und verwenden dann jene Funktionen, die für den geographischen Datentyp definiert sind.
Wenn Sie keine Ahnung von Projektionen haben, sich nicht näher damit beschäftigen wollen und die Einschränkungen der verfügbaren Funktionalität für den geographischen Datentyp in Kauf nehmen können, ist es vermutlich einfacher für Sie, den geographischen anstatt des geometrischen Datentyps zu verwenden.
Für einen Vergleich, welche Funktionalität von Geography vs. Geometry unterstützt wird, siehe Section 14.11, “PostGIS Function Support Matrix”. Für eine kurze Liste mit der Beschreibung der geographischen Funktionen, siehe Section 14.4, “PostGIS Geography Support Functions”
- 4.2.3.1. Werden die Berechnungen auf einer Kugel oder auf einem Rotationsellipsoid durchgeführt?
- 4.2.3.2. Wie schaut das mit der Datumsgrenze und den Polen aus?
- 4.2.3.3. Wie lang kann ein Bogen sein, damit er noch verarbeitet werden kann?
- 4.2.3.4. Warum dauert es so lange, die Fläche von Europa / Russland / irgendeiner anderen großen geographischen Region zu berechnen?
4.2.3.1. | Werden die Berechnungen auf einer Kugel oder auf einem Rotationsellipsoid durchgeführt? |
Standardmäßig werden alle Entfernungs- und Flächenberechnungen auf dem Referenzellipsoid ausgeführt. Das Ergebnis der Berechnung sollte in lokalen Gebieten gut mit dem planaren Ergebnis zusammenpassen - eine gut gewählte lokale Projektion vorausgesetzt. Bei größeren Gebieten ist die Berechnung über das Referenzellipsoid genauer als eine Berechnung die auf der projizierten Ebene ausgeführt wird. Alle geographischen Funktionen verfügen über eine Option um die Berechnung auf einer Kugel durchzuführen. Dies erreicht man, indem der letzte boolesche Eingabewert auf 'FALSE' gesetzt wird. Dies beschleunigt die Berechnung einigermaßen, insbesondere wenn die Geometrie sehr einfach gestaltet ist. | |
4.2.3.2. | Wie schaut das mit der Datumsgrenze und den Polen aus? |
Alle diese Berechnungen wissen weder über Datumsgrenzen noch über Pole Bescheid. Da es sich um sphärische Koordinaten handelt (Länge und Breite), unterscheidet sich eine Geometrie, die eine Datumsgrenze überschreitet vom Gesichtspunkt der Berechnung her nicht von irgendeiner anderen Geometrie. | |
4.2.3.3. | Wie lang kann ein Bogen sein, damit er noch verarbeitet werden kann? |
Wir verwenden Großkreisbögen als "Interpolationslinie" zwischen zwei Punkten. Das bedeutet, dass es für den Join zwischen zwei Punkten zwei Möglichkeiten gibt, je nachdem, aus welcher Richtung man den Großkreis überquert. Unser gesamter Code setzt voraus, dass die Punkte von der "kürzeren" der beiden Strecken her durch den Großkreis verbunden werden. Als Konsequenz wird eine Geometrie, welche Bögen von mehr als 180 Grad aufweist nicht korrekt modelliert. | |
4.2.3.4. | Warum dauert es so lange, die Fläche von Europa / Russland / irgendeiner anderen großen geographischen Region zu berechnen? |
Weil das Polygon so verdammt groß ist! Große Flächen sind aus zwei Gründen schlecht: ihre Begrenzung ist riesig, wodurch der Index dazu tendiert, das Geoobjekt herauszuholen, egal wie Sie die Anfrage ausführen; die Anzahl der Knoten ist riesig, und Tests (wie ST_Distance, ST_Contains) müssen alle Knoten zumindest einmal, manchmal sogar n-mal durchlaufen (wobei N die Anzahl der Knoten im beteiligten Geoobjekt bezeichnet). Wenn es sich um sehr große Polygone handelt, die Abfragen aber nur in kleinen Gebieten stattfinden, empfehlen wir wie beim geometrischen Datentyp, dass Sie die Geometrie in kleinere Stücke "denormalisieren". Dadurch kann der Index effiziente Unterabfragen auf Teile des Geoobjekts ausführen, da eine Abfrage nicht jedesmal das gesamte Geoobjekt herausholen muss. Konsultieren Sie dazu bitte die Dokumentation der FunktionST_Subdivide. Nur weil Sie ganz Europa in einem Polygon speichern *können* heißt das nicht, dass Sie dies auch tun *sollten*. |
Die OpenGIS "Simple Features Specification for SQL" standardisert die Datentypen von Geoobjekten, die Funktionen die benötigt werden um diese zu verarbeiten, sowie die Metadatentabellen. Um sicherzustellen, dass die Metadaten konsistent bleiben, werden Vorgänge wie das Erstellen oder das Löschen einer Geometriespalte, durch dafür eigens von OpenGIS festgelegten Prozeduren ausgeführt.
Es gibt zwei OpenGIS Metadatentabellen: SPATIAL_REF_SYS und GEOMETRY_COLUMNS. Die SPATIAL_REF_SYS Tabelle enthält die numerischen Identifikatoren und textlichen Beschreibungen der in der Datenbank verwendeten Koordinatensysteme.
Die Tabelle "spatial_ref_sys" ist eine mit PostGIS kommende und OGC-konforme Datenbanktabelle, die über 3000 bekannte Koordinatenreferenzsysteme enthält, sowie Details zur Koordinatentransformation zwischen diesen.
Obwohl in der PostGIS Tabelle "spatial_ref_sys" über 3000 der gebräuchlichsten Koordinatenreferenzsysteme definiert sind, die mit der Bibliothek "Proj4" gehandhabt werden können, enthält sie nicht alle bekannten Projektionen. Sie können auch ihre eigenen Projektionen in der Tabelle definieren, falls Sie mit den Konstrukten von "Proj4" vertraut sind. Sie sollten nicht außer Acht lassen, dass die meisten Koordinatenreferenzsysteme regional sind und außerhalb des vorgesehenen Bereichs keinen Sinn haben.
Eine hervorragende Quelle zum Auffinden von Koordinatenreferenzsystemen, welche nicht in der Grundmenge enthalten sind, ist http://spatialreference.org/
Einige der häufiger eingesetzten Koordinatenreferenzsysteme sind: 4326 - WGS 84 Long Lat, 4269 - NAD 83 Long Lat, 3395 - WGS 84 World Mercator, 2163 - US National Atlas Equal Area, Koordinatenreferenzsysteme für jede NAD 83, WGS 84 und UTM Zone - UTM Zonen sind ideal für Messungen, decken aber nur 6 Grad breite, vertikale Zonen ab.
Verschiedenste Koordinatenreferenzsysteme "US State Plane" (auf Meter und Fuß basierend) - üblicherweise 2 pro US Staat. Die meisten auf Meter basierten befinden sich in der Grundmenge, aber viele der auf Fuß basierten, oder von ESRI erzeugten müssen von spatialreference.org heruntergeladen werden.
Genauere Angaben zur Ermittlung der UTM Zone für ein bestimmtes Gebiet finden Sie unter utmzone PostGIS plpgsql helper function.
Die SPATIAL_REF_SYS Tabelle ist folgendermaßen definiert:
CREATE TABLE spatial_ref_sys ( srid INTEGER NOT NULL PRIMARY KEY, auth_name VARCHAR(256), auth_srid INTEGER, srtext VARCHAR(2048), proj4text VARCHAR(2048) )
Die SPATIAL_REF_SYS Spalten folgendermaßen:
- SRID
Ein ganzzahliger Wert, der das Koordinatenreferenzsystem (SRS) innerhalb der Datenbank eindeutig ausweist.
- AUTH_NAME
Der Name des Standards oder der Normungsorganisation, unter dem dieses Koordinatenreferenzsystem zitiert wird. Zum Beispiel ist "EPSG" ein gültiger
AUTH_NAME.- AUTH_SRID
Die von der in
AUTH_NAMEzitierten Quelle festgelegte ID des Koordinatenreferenzsystems. Im Falle von EPSG ist dies der EPSG Projektionscode.- SRTEXT
Die Well-Known-Text Darstellung des Koordinatenreferenzsystems. Ein Beispiel dazu:
PROJCS["NAD83 / UTM Zone 10N", GEOGCS["NAD83", DATUM["North_American_Datum_1983", SPHEROID["GRS 1980",6378137,298.257222101] ], PRIMEM["Greenwich",0], UNIT["degree",0.0174532925199433] ], PROJECTION["Transverse_Mercator"], PARAMETER["latitude_of_origin",0], PARAMETER["central_meridian",-123], PARAMETER["scale_factor",0.9996], PARAMETER["false_easting",500000], PARAMETER["false_northing",0], UNIT["metre",1] ]Für eine Auflistung der EPSG Projektionscodes und deren entsprechende WKT Darstellung siehe http://www.opengeospatial.org/. Eine allgemeine Erläuterung zu WKT finden Sie in der OpenGIS "Coordinate Transformation Services Implementation Specification" unter http://www.opengeospatial.org/standards. Information zur European Petroleum Survey Group (EPSG) und deren Datenbank über Koordinatenreferenzsysteme finden Sie unter http://www.epsg.org.
- PROJ4TEXT
PostGIS verwendet die Bibliothek "Proj4" zur Koordinatentransformation. Die Spalte
PROJ4TEXTenthält eine Proj4 Zeichenfolge mit der Definition des Koordinatensystems für eine bestimmte SRID. Zum Beispiel:+proj=utm +zone=10 +ellps=clrk66 +datum=NAD27 +units=m
Weiterführende Information finden Sie auf der Proj4 Webseite unter http://trac.osgeo.org/proj/. Die Datei
spatial_ref_sys.sqlenthält sowohlSRTEXTals auchPROJ4TEXTDefinitionen aller EPSG Projektionen.
GEOMETRY_COLUMNS ist ein View der den Systemkatalog der Datenbank ausliest. Er hat folgende Struktur:
\d geometry_columns
View "public.geometry_columns"
Column | Type | Modifiers
-------------------+------------------------+-----------
f_table_catalog | character varying(256) |
f_table_schema | character varying(256) |
f_table_name | character varying(256) |
f_geometry_column | character varying(256) |
coord_dimension | integer |
srid | integer |
type | character varying(30) |Die Spalten bedeuten:
- F_TABLE_CATALOG, F_TABLE_SCHEMA, F_TABLE_NAME
Der vollständige Name der Tabelle, welche die Geometriespalte enthält. Die Bezeichnungen "catalog" und "schema" kommen von Oracle. Es gibt keine Entsprechung in PostgreSQL für "catalog", weshalb diese Spalte leer bleibt - für "schema" wird der Name des Schemas in PostgreSQL verwendet (standardmäßig
public).- F_GEOMETRY_COLUMN
Der Name der Geometriespalte in der Feature-Tabelle.
- COORD_DIMENSION
Die räumliche Dimension (2-, 3- oder 4-dimensional) der Geometriespalte.
- SRID
Der Identifikator des Koordinatenreferenzsystems, welches für die Geometrie in dieser Tabelle verwendet wird. Dieser ist ein Fremdschlüssel, der sich auf die Tabelle
SPATIAL_REF_SYSbezieht.- TYPE
Der Datentyp des Geoobjekts. Um die räumliche Spalte auf einen einzelnen Datentyp zu beschränken, benutzen Sie bitte: POINT, LINESTRING, POLYGON, MULTIPOINT, MULTILINESTRING, MULTIPOLYGON, GEOMETRYCOLLECTION oder die entsprechenden XYM Versionen POINTM, LINESTRINGM, POLYGONM, MULTIPOINTM, MULTILINESTRINGM, MULTIPOLYGONM und GEOMETRYCOLLECTIONM. Für uneinheitliche Kollektionen (gemischete Datentypen) können Sie den Datentyp "GEOMETRY" verwenden.
Dieses Attribut gehört (wahrscheinlich) nicht zur OpenGIS Spezifikation, wird aber benötigt um homogene Datentypen zu gewährleisten.
Die Erzeugung einer Tabelle mit räumlichen Daten kann in einem Schritt ausgeführt werden. Dies wird im folgenden Beispiel demonstriert, welches eine Straßentabelle mit einer geometrischen Spalte für 2D Linienzüge in WGS84 Länge/Breite erzeugt
CREATE TABLE ROADS (ID serial, ROAD_NAME text, geom geometry(LINESTRING,4326) );
Wir können zusätzliche Spalten hinzufügen, indem wir den normalen ALTER TABLE Befehl verwenden. Wir zeigen dies im nächsten Beispiel, wo wir einen 3D-Linienzug hinzufügen.
ALTER TABLE roads ADD COLUMN geom2 geometry(LINESTRINGZ,4326);
Zwei Fälle bei denen Sie dies benötigen könnten sind SQL-Views und Masseninserts. Beim Fall von Masseninserts können Sie die Registrierung in der Tabelle "geometry_columns" korrigieren, indem Sie auf die Spalte einen CONSTRAINT setzen oder ein "ALTER TABLE" durchführen. Falls Ihre Spalte Typmod basiert ist, geschieht die Registrierung beim Erstellungsprozess auf korrekte Weise, so dass Sie hier nichts tun müssen. Auch Views, bei denen keine räumliche Funktion auf die Geometrie angewendet wird, werden auf gleiche Weise wie die Geometrie der zugrunde liegenden Tabelle registriert.
-- Angenommen Sie erstellen folgenden View
CREATE VIEW public.vwmytablemercator AS
SELECT gid, ST_Transform(geom,3395) As geom, f_name
FROM public.mytable;
-- Für eine korrekte Registrierung
-- wird eine Typumwandlung der Geometrie benötigt
--
DROP VIEW public.vwmytablemercator;
CREATE VIEW public.vwmytablemercator AS
SELECT gid, ST_Transform(geom,3395)::geometry(Geometry, 3395) As geom, f_name
FROM public.mytable;
-- Wenn Sie sicher sind, das es sich bei der Geometrie um ein 2D-Polygon handelt, können Sie folgendes tun
DROP VIEW public.vwmytablemercator;
CREATE VIEW public.vwmytablemercator AS
SELECT gid, ST_Transform(geom,3395)::geometry(Polygon, 3395) As geom, f_name
FROM public.mytable;-- Angenommen Sie haben eine abgeleitete Tabelle über ein Masseninsert erzeugt
SELECT poi.gid, poi.geom, citybounds.city_name
INTO myschema.my_special_pois
FROM poi INNER JOIN citybounds ON ST_Intersects(citybounds.geom, poi.geom);
-- Einen 2D Index auf die neue Tabelle legen
CREATE INDEX idx_myschema_myspecialpois_geom_gist
ON myschema.my_special_pois USING gist(geom);
-- Falls Ihre Punkte 3D-Punkte oder 3M-Punkte sind,
-- können Sie einen ND-Index anstatt eines 2D-Indexes erstellen
CREATE INDEX my_special_pois_geom_gist_nd
ON my_special_pois USING gist(geom gist_geometry_ops_nd);
-- Um die Geometriespalte der neuen Tabelle in geometry_columns händisch zu registrieren.
-- Beachten Sie bitte, dass dies auch die zugrundeliegende Struktur der Tabelle ändert,
-- um die Spalte Typmod basiert zu machen.
SELECT populate_geometry_columns('myschema.my_special_pois'::regclass);
-- Wenn Sie PostGIS 2.0 verwenden und aus welchem Grund auch immer
-- das alte Verhalten mit auf CONSTRAINTs basierender Definition benötigen
-- (wie im Fall von vererbten Tabellen bei denen nicht alle Kindtabellen denselben Datentyp und dieselbe SRID aufweisen),
-- setzen Sie das optionale Argument "use_typmod" auf FALSE
SELECT populate_geometry_columns('myschema.my_special_pois'::regclass, false); Obwohl die alte auf CONSTRAINTs basierte Methode immer noch unterstützt wird, wird eine auf Constraints basierende Geometriespalte, die direkt in einem View verwendet wird, nicht korrekt in geometry_columns registriert. Eine Typmod basierte wird korrekt registriert. Im folgenden Beispiel definieren wir eine Spalte mit Typmod und eine andere mit Constraints.
CREATE TABLE pois_ny(gid SERIAL PRIMARY KEY, poi_name text, cat text, geom geometry(POINT,4326));
SELECT AddGeometryColumn('pois_ny', 'geom_2160', 2160, 'POINT', 2, false);In psql:
\d pois_ny;
Wir sehen, das diese Spalten unterschiedlich definiert sind -- eine mittels Typmodifizierer, eine nutzt einen Constraint
Table "public.pois_ny"
Column | Type | Modifiers
-----------+-----------------------+------------------------------------------------------
gid | integer | not null default nextval('pois_ny_gid_seq'::regclass)
poi_name | text |
cat | character varying(20) |
geom | geometry(Point,4326) |
geom_2160 | geometry |
Indexes:
"pois_ny_pkey" PRIMARY KEY, btree (gid)
Check constraints:
"enforce_dims_geom_2160" CHECK (st_ndims(geom_2160) = 2)
"enforce_geotype_geom_2160" CHECK (geometrytype(geom_2160) = 'POINT'::text
OR geom_2160 IS NULL)
"enforce_srid_geom_2160" CHECK (st_srid(geom_2160) = 2160)Beide registrieren sich korrekt in "geometry_columns"
SELECT f_table_name, f_geometry_column, srid, type
FROM geometry_columns
WHERE f_table_name = 'pois_ny';f_table_name | f_geometry_column | srid | type -------------+-------------------+------+------- pois_ny | geom | 4326 | POINT pois_ny | geom_2160 | 2160 | POINT
Jedoch -- wenn wir einen View auf die folgende Weise erstellen
CREATE VIEW vw_pois_ny_parks AS
SELECT *
FROM pois_ny
WHERE cat='park';
SELECT f_table_name, f_geometry_column, srid, type
FROM geometry_columns
WHERE f_table_name = 'vw_pois_ny_parks';Die Typmod basierte geometrische Spalte eines View registriert sich korrekt, die auf Constraint basierende nicht.
f_table_name | f_geometry_column | srid | type ------------------+-------------------+------+---------- vw_pois_ny_parks | geom | 4326 | POINT vw_pois_ny_parks | geom_2160 | 0 | GEOMETRY
Dies kann sich bei zukünftigen Versionen von PostGIS ändern, vorerst müssen Sie aber folgendes ausführen, um die auf Constraint basierende Spalte eines View korrekt zu registrieren:
DROP VIEW vw_pois_ny_parks;
CREATE VIEW vw_pois_ny_parks AS
SELECT gid, poi_name, cat,
geom,
geom_2160::geometry(POINT,2160) As geom_2160
FROM pois_ny
WHERE cat = 'park';
SELECT f_table_name, f_geometry_column, srid, type
FROM geometry_columns
WHERE f_table_name = 'vw_pois_ny_parks';f_table_name | f_geometry_column | srid | type ------------------+-------------------+------+------- vw_pois_ny_parks | geom | 4326 | POINT vw_pois_ny_parks | geom_2160 | 2160 | POINT
PostGIS ist mit den Open Geospatial Consortium (OGC) OpenGIS Spezifikationen konform. Daher setzen viele PostGIS Methoden voraus, dass die Geometrien mit denen sie rechnen sowohl "Simple" als auch "Valid" sind . Zum Beispiel hat es keinen Sinn, die Fläche eines Polygons zu berechnen, das eine Insel aufweist, die ausserhalb des Polygons festgelegt ist, oder ein Polygon aus einer Begrenzungslinie zu konstruieren, welche nicht "simple" ist.
Entsprechend der OGC Spezifikationen ist eine simple Geometrie eine solche, die sich nicht selbst überschneidet oder berührt und bezieht sich in erster Linie auf 0- und 1-dimensionale Geometrien (insbesondere [MULTI]POINT, [MULTI]LINESTRING). Andererseits bezieht sich die Validität einer Geometrie hauptsächlich auf 2-dimensionale Geometrien (insbesondere [MULTI]POLYGON) und definiert die Menge an Aussagen, welche ein valides/gültiges Polygon auszeichnen. Die Beschreibung einer jeden geometrischen Klasse schließt bestimmte Bedingungen mit ein, welche die Simplizität und Validität von Geometrien näher beschreiben.
Da ein POINT ein 0-dimensionales geometrisches Objekt ist, ist er von vornherein simple.
MULTIPOINTs sind simple, wenn sich keine zwei Koordinaten (POINTs) decken (keine identischen Koordinatenpaare aufweisen).
Ein LINESTRING ist simple, wenn er nicht zweimal durch denselben POINT geht (ausgenommen bei Endpunkten, wo dieser als linearer Ring benannt wird und zusätzlich als geschlossen angesehen wird).
 (a) |  (b) |
 (c) |  (d) |
(a) und (c) sind simple |
Ein MULTILINESTRING ist nur dann simple, wenn alle seine Elemente "simple" sind und die einzigen Überschneidungen zwischen zwei Elementen nur an jenen POINTs auftreten, die an den Begrenzungen der beiden Elemente liegen.
 (e) |  (f) |  (g) |
(e) und (f) sind simple |
Definitionsgemäß ist ein POLYGON immer simple. Es ist valid, wenn sich keine zwei Ringe an der Begrenzung (bestehend aus einem äußeren Ring und inneren Ringen) kreuzen. Die Begrenzung eines POLYGONs darf an einem POINT schneiden, allerdings nur als Tangente (insbesondere nicht an einer Linie). Ein POLYGON darf keine Schnittlinien oder "Spikes" aufweisen und die inneren Ringe müssen zur Gänze im äußeren Ring enthalten sein.
 (h) |  (i) |  (j) |
 (k) |  (l) |  (m) |
(h) und (i) sind valide |
Ein MULTIPOLYGON ist dann und nur dann valide, wenn alle seine Elemente valide sind und sich das Innere zweier Elemente nicht überschneidet. Die Begrenzungen zweier Elemente können sich berühren, allerdings nur an einer endlichen Anzahl von POINTs.
 (n) |  (o) |  (p) |
(n) und (o) sind keine validen |
Die meisten von der GEOS Bibliothek implementierten Funktionen beruhen auf der Annahme, dass die verwendete Geometrie - entsprechend der OpenGIS Simple Feature Spezifikation - valide ist. Um die Simplizität und Validität einer Geometrie festzustellen, können Sie ST_IsSimple() und ST_IsValid() verwenden.
-- Üblicherweise hat es keinen Sinn lineare Geometrien
-- auf Validität zu überprüfen, da immer TRUE zurückgegeben wird.
-- Aber in diesem Beispiel erweitert PostGIS die OGC Definition von IsValid
-- indem es FALSE zurückgibt, wenn ein LineString weniger als 2 *eindeutige* Stützpunkte aufweist.
gisdb=# SELECT
ST_IsValid('LINESTRING(0 0, 1 1)'),
ST_IsValid('LINESTRING(0 0, 0 0, 0 0)');
st_isvalid | st_isvalid
------------+-----------
t | fStandardmäßig überprüft PostGIS eine Geometrieeingabe nicht auf Validität, da Validitätstests von komplexen Geometrien, insbesondere Polygonen, viel CPU Zeit beanspruchen. Fall Sie Ihren Datenquellen nicht trauen, können Sie eine Überprüfung Ihrer Tabellen durch eine "Check Constraint"/Prüfbeschränkung erzwingen:
ALTER TABLE mytable
ADD CONSTRAINT geometry_valid_check
CHECK (ST_IsValid(the_geom));Falls Sie irgendwelche seltsamen Fehlermeldungen, wie "GEOS Intersection() threw an error!" erhalten, obwohl sie eine PostGIS Funktion mit validen Eingabegeometrien aufgerufen haben, ist es wahrscheinlich dass Sie einen Fehler in PostGIS oder einer von PostGIS verwendeten Bibliothek gefunden haben. In diesem Fall sollten Sie das PostGIS Entwicklerteam kontaktieren. Dasselbe gilt, wenn eine PostGIS Funktion auf eine valide Eingabegeometrie eine invalide Geometrie zurückgibt.
| |
Eine streng konforme OGC-Geometrie hat keine Z- oder M-Werte. Die Funktion ST_IsValid() betrachtet höhere geometrische Dimensionen nicht als invalide! Aufrufe von AddGeometryColumn() fügen einen Check-Constraint für die geometrische Dimension hinzu, weshalb es hier ausreicht 2 anzugeben. |
Manchmal kommt es vor, dass die typischen räumlichen Aussagen (???, ???, ???, ???, ...) an sich nicht ausreichen, um den verlangten räumlichen Filter auf geeignete Weise zu liefern.
 Betrachten Sie zum Beispiel einen linearen Datensatz, der ein Straßennetz darstellt. Es kann sein, dass ein GIS-Analyst die Aufgabe hat, alle Straßenabschnitte herauszufinden, die sich gegenseitig nicht an einem Punkt sondern entlang einer Linie kreuzen, da dies möglicherweise einer Unternehmensvorschrift widerspricht. In diesem Fall liefert ??? nicht den passenden räumlichen Filter, da bei linearen Geoobjekten nur dann Eine zweistufige Lösung kann sein, dass man zuerst die eigentliche Verschneidung (ST_Intersection) von Straßenabschnittspaaren, die sich räumlich überschneiden (???) ausführt und anschließend den ST_GeometryType der Verschneidung mit ' Eine elegantere/schnellere Lösung wäre sicherlich wünschenswert. |
 Ein zweites (theoretisches) Beispiel wäre, dass ein GIS-Analyst versucht, alle Anlegestellen oder Kais, welche die Begrenzung eines Sees entlang einer Linie überschneiden und bei denen nur ein Ende der Anlegestelle an der Küste liegt. Anders ausgedrückt, wo ein Kai nicht zur Gänze im See liegt, da er den See entlang einer Linie schneidet und seine Endpunkte sowohl zur Gänze in und auf der Begrenzung des Sees liegen. Dazu kann es nötig sein, dass der Analyst eine Kombination von Aussagen ausführen muss, um die gesuchten Geoobjekte herauszufiltern:
|
Somit stürzen wir uns auf die DE-9IM-Matrix, oder kurz DE-9IM
Gemäß der OpenGIS Simple Features Implementation Specification for SQL, ist der grundlegende Ansatz für einen Lagevergleich von zwei geometrischen Objekten, die paarweise Überprüfung der Verschneidung des Inneren, der Begrenzung und des Äusseren der beiden geometrischen Objekte und der Einstufung der Beziehung zwischen den beiden geometrischen Objekten an Hand der Einträge in die resultierende 'Verschneidungs'-Matrix.
- Boundary
Die Begrenzung einer Geometrie ist die geometrische Grundmenge der nächst kleineren Dimension. Bei
POINTs, die die Dimension 0 haben ist die Begrenzung die leere Menge. Die Begrenzung einesLINESTRINGs sind die zwei Endpunkte. BeiPOLYGONen entspricht die Begrenzung jenen Linien, die die äußeren und inneren Ringe zusammensetzen.- Interior
Die Innenseite/interior einer Geometrie besteht aus jenen Punkten einer Geometrie, die zurückbleiben, wenn die Außenbegrenzung/boundary entfernt wird. Bei
POINTs ist die Innenseite derPOINTselbst. Die Innenseite einesLINESTRINGs ist die Menge der echten Punkte zwischen den Endpunkten. BeiPOLYGONen entspricht die Innenseite der Fläche innerhalb des Polygons.- Exterior
Die Außenseite/exterior einer Geometrie ist durch die Grundgesamtheit gegeben. Das ist jene Fläche, die nicht auf der Innenseite/interior oder auf der Begrenzung der Geometrie liegt.
Gegeben sei die Geometrie a, wobei I(a), B(a), und E(a) das Innere/Interior, die Begrenzung/Boundary und dasÄussere/Exterior von a sind; die mathematische Formulierung der Matrix lautet:
| Interior | Boundary | Exterior | |
|---|---|---|---|
| Interior | dim( I(a) ∩ I(b) ) | dim( I(a) ∩ B(b) ) | dim( I(a) ∩ E(b) ) |
| Boundary | dim( B(a) ∩ I(b) ) | dim( B(a) ∩ B(b) ) | dim( B(a) ∩ E(b) ) |
| Exterior | dim( E(a) ∩ I(b) ) | dim( E(a) ∩ B(b) ) | dim( E(a) ∩ E(b) ) |
Wobei dim(a), so wie von ST_Dimension festgelegt, die Dimension von a ist, aber zu der Domäne von {0,1,2,T,F,*} gehört.
0=> point1=> line2=> areaT=>{0,1,2}F=> Leere Menge*=> braucht nicht zu kümmern
Bildlich schaut dies für zwei überlappende Polygongeometrien folgendermaßen aus:
| ||||||||||||||||||
|
|
Von links nach rechts und von oben nach unten gelesen wird die Dimensionsmatrix durch '212101212' dargestellt.
Eine Beziehungsmatrix, welche das erste Beispiel von zwei Linien, die sich auf einer Linie schneiden, abbildet, würde '102101FF2' entsprechen.
-- Identifizierung der Strassenabschnitte, die eine Linie kreuzen SELECT a.id FROM roads a, roads b WHERE a.id != b.id AND a.geom && b.geom AND ST_Relate(a.geom, b.geom, '1*1***1**');
Eine Beziehungsmatrix, welche das zweite Beispiel mit den Kais, die teilweise an der Uferlinie des Sees liegen, abbildet, würde '102101FF2' entsprechen.
-- Ermittlung von Dämmen, die teilweise an der Uferlinie eines Sees liegen SELECT a.lake_id, b.wharf_id FROM lakes a, wharfs b WHERE a.geom && b.geom AND ST_Relate(a.geom, b.geom, '102101FF2');
Für weiterführende Information siehe:
OpenGIS Simple Features Implementation Specification for SQL (Version 1.1, Abschnitt 2.1.13.2)
Geotools: Mengentheoretische Topologie und die DE-9IM-Matrix
Encyclopedia of GIS By Hui Xiong
Sobald Sie eine räumliche Tabelle erstellt haben, können Sie GIS Daten in die Datenbank laden. Zurzeit gibt es zwei Möglichkeiten, Daten in die PostGIS/PostgreSQL Datenbank zu importieren: die Verwendung von formatierten SQL-Anweisungen oder der Shapefile Loader/Dumper.
Wenn Sie Ihre Daten in eine Textdarstellung konvertieren können, dann ist möglicherweise die Verwendung von formatiertem SQL der leichteste Weg um die Daten in PostGIS zu importieren. Wie bei Oracle und anderen Datenbanken, können die Daten über Masseninserts geladen werden, indem eine große Textdatei, in der sich zahlreiche SQL "INSERT" Anweisungen befinden, an die SQL-Konsole weitergeleitet wird.
Eine Importdatei (z.B. roads.sql) könnte folgendermaßen aussehen:
BEGIN; INSERT INTO roads (road_id, roads_geom, road_name) VALUES (1,'LINESTRING(191232 243118,191108 243242)','Jeff Rd'); INSERT INTO roads (road_id, roads_geom, road_name) VALUES (2,'LINESTRING(189141 244158,189265 244817)','Geordie Rd'); INSERT INTO roads (road_id, roads_geom, road_name) VALUES (3,'LINESTRING(192783 228138,192612 229814)','Paul St'); INSERT INTO roads (road_id, roads_geom, road_name) VALUES (4,'LINESTRING(189412 252431,189631 259122)','Graeme Ave'); INSERT INTO roads (road_id, roads_geom, road_name) VALUES (5,'LINESTRING(190131 224148,190871 228134)','Phil Tce'); INSERT INTO roads (road_id, roads_geom, road_name) VALUES (6,'LINESTRING(198231 263418,198213 268322)','Dave Cres'); COMMIT;
Diese Datei kann dann über die "psql" SQL-Konsole sehr leicht nach PostgreSQL weitergeleitet werden:
psql -d [database] -f roads.sql
Der shp2pgsql Datenlader wandelt ESRI Shapefiles in eine SQL-Datei um, die für das Einfügen in eine PostGIS/PostgreSQL Datenbank mit der "psql"-Konsole, sowohl im Geometrie- als auch im Geographie-Format, geeignet ist. Der Loader besitzt eine Reihe von Betriebsmodi, die durch Flags auf der Befehlszeile ausgewählt werden:
Zusätzlich zu dem befehlszeilenorientierten Lader "shp2pgsql" gibt es auch die graphische Schnittstelle shp2pgssql-gui, welche fast ebensoviele Optionen wie der befehlszeilenorientierte Lader zur Verfügung stellt. Für viele Anwender, die mit der Befehlszeile nicht versiert sind, oder mit PostGIS erst beginnen, ist die GUI möglicherweise einfacher zu bedienen. Sie kann auch in PgAdminIII als Plugin konfiguriert werden.
- (c|a|d|p) Dies sind sich gegenseitig ausschließende Optionen:
- -c
Erstellt eine neue Tabelle und füllt sie von einem Shapefile her. Dies ist der Standardmodus.
- -a
Fügt Daten aus dem Shapefile zu der Datenbanktabelle hinzu. Beachten Sie bitte, falls Sie diese Option verwenden um mehrere Dateien zu laden, dass die Attribute und Datentypen in den Dateien übereinstimmen müssen.
- -d
Löscht die Datenbanktabelle, bevor eine neue Tabelle mit den Daten vom Shapefile befüllt wird.
- -p
Erzeugt nur den SQL-Code zur Erstellung der Tabelle, ohne irgendwelche Daten hinzuzufügen. Kann verwendet werden, um die Erstellung und das Laden einer Tabelle vollständig zu trennen.
- -?
Zeigt die Hilfe an.
- -D
Verwendung des PostgreSQL "dump" Formats für die Datenausgabe. Kann mit -a, -c und -d kombiniert werden. Ist wesentlich schneller als das standardmäßige SQL "insert" Format. Verwenden Sie diese Option wenn Sie sehr große Datensätze haben.
- -s [<FROM_SRID%gt;:]<SRID>
Erzeugt und befüllt die Geometrietabelle in einer bestimmten SRID. Optional kann FROM_SRID für die Shapedatei angegeben werden, wodurch die Geometrie von FROM_SRID in die Ziel-SRID projiziert wird. FROM_SRID und -D können nicht gleichzeitig angegeben werden.
- -k
Erhält die Groß- und Kleinschreibung (Spalte, Schema und Attribute). Beachten Sie bitte, dass die Attributnamen in Shapedateien immer Großbuchstaben haben.
- -i
Wandeln Sie alle Ganzzahlen in standard 32-bit Integer um, erzeugen Sie keine 64-bit BigInteger, auch nicht dann wenn der DBF-Header dies unterstellt.
- -I
Einen GIST Index auf die Geometriespalte anlegen.
- -m
-m
a_file_namebestimmt eine Datei, in welcher die Abbildungen der (langen) Spaltennamen in die 10 Zeichen langen DBF Spaltennamen festgelegt sind. Der Inhalt der Datei besteht aus einer oder mehreren Zeilen die jeweils zwei, durch Leerzeichen getrennte Namen enthalten, aber weder vorne noch hinten mit Leerzeichen versehen werden dürfen. Zum Beispiel:COLUMNNAME DBFFIELD1 AVERYLONGCOLUMNNAME DBFFIELD2
- -S
Erzeugt eine Einzel- anstatt einer Mehrfachgeometrie. Ist nur erfolgversprechend, wenn die Geometrie auch tatsächlich eine Einzelgeometrie ist (insbesondere gilt das für ein Mehrfachpolygon/MULTIPOLYGON, dass nur aus einer einzelnen Begrenzung besteht, oder für einen Mehrfachpunkt/MULTIPOINT, der nur einen einzigen Knoten aufweist).
- -t <dimensionality>
Zwingt die Ausgabegeometrie eine bestimmte Dimension anzunehmen. Sie können die folgenden Zeichenfolgen verwenden, um die Dimensionalität anzugeben: 2D, 3DZ, 3DM, 4D.
Wenn die Eingabe weniger Dimensionen aufweist als angegeben, dann werden diese Dimensionen bei der Ausgabe mit Nullen gefüllt. Wenn die Eingabe mehr Dimensionen als angegeben aufweist werden diese abgestreift.
- -w
Ausgabe im Format WKT anstatt WKB. Beachten Sie bitte, dass es hierbei zu Koordinatenverschiebungen infolge von Genauigkeitsverlusten kommen kann.
- -e
Jede Anweisung einzeln und nicht in einer Transaktion ausführen. Dies erlaubt den Großteil auch dann zu laden, also die guten Daten, wenn eine Geometrie dabei ist die Fehler verursacht. Beachten Sie bitte das dies nicht gemeinsam mit der -D Flag angegeben werden kann, da das "dump" Format immer eine Transaktion verwendet.
- -W <encoding>
Gibt die Codierung der Eingabedaten (dbf-Datei) an. Wird die Option verwendet, so werden alle Attribute der dbf-Datei von der angegebenen Codierung nach UTF8 konvertiert. Die resultierende SQL-Ausgabe enthält dann den Befehl
SET CLIENT_ENCODING to UTF8, damit das Back-end wiederum die Möglichkeit hat, von UTF8 in die, für die interne Nutzung konfigurierte Datenbankcodierung zu decodieren.- -N <policy>
Umgang mit NULL-Geometrien (insert*, skip, abort)
- -n
-n Es wird nur die *.dbf-Datei importiert. Wenn das Shapefile nicht Ihren Daten entspricht, wird automatisch auf diesen Modus geschaltet und nur die *.dbf-Datei geladen. Daher müssen Sie diese Flag nur dann setzen, wenn sie einen vollständigen Shapefile-Satz haben und lediglich die Attributdaten, und nicht die Geometrie, laden wollen.
- -G
Verwendung des geographischen Datentyps in WGS84 (SRID=4326), anstelle des geometrischen Datentyps (benötigt Längen- und Breitenangaben).
- -T <tablespace>
Den Tablespace für die neue Tabelle festlegen. Solange der -X Parameter nicht angegeben wird, benutzen die Indizes weiterhin den standardmäßig festgelegten Tablespace. Die PostgreSQL Dokumentation beinhaltet eine gute Beschreibung, wann es sinnvoll ist, eigene Tablespaces zu verwenden.
- -X <tablespace>
Den Tablespace bestimmen, in dem die neuen Tabellenindizes angelegt werden sollen. Gilt für den Primärschlüsselindex und wenn "-l" verwendet wird, auch für den räumlichen GIST-Index.
Eine beispielhafte Sitzung, in welcher der Loader verwendet wird, um eine Eingabedatei zu erzeugen und anschließend hochzuladen, könnte folgendermaßen aussehen:
# shp2pgsql -c -D -s 4269 -i -I shaperoads.shp myschema.roadstable > roads.sql # psql -d roadsdb -f roads.sql
Konvertierung und Import können über UNIX-Pipes in einem Schritt erfolgen:
# shp2pgsql shaperoads.shp myschema.roadstable | psql -d roadsdb
Daten können entweder über SQL oder mit dem Shapefile Loader/Dumper aus der Datenbank entnommen werden. Im Abschnitt über SQL werden einige Operatoren besprochen, die für Vergleiche und Abfragen von Geotabellen zur Verfügung stehen.
Die direkteste Methode, um Daten aus der Datenbank abzurufen, ist eine SQL Select-Anfrage. Dadurch kann die Anzahl der resultierenden Datensätze und Attribute reduziert und in eine lesbare Textdatei überspielt werden:
db=# SELECT road_id, ST_AsText(road_geom) AS geom, road_name FROM roads;
road_id | geom | road_name
--------+-----------------------------------------+-----------
1 | LINESTRING(191232 243118,191108 243242) | Jeff Rd
2 | LINESTRING(189141 244158,189265 244817) | Geordie Rd
3 | LINESTRING(192783 228138,192612 229814) | Paul St
4 | LINESTRING(189412 252431,189631 259122) | Graeme Ave
5 | LINESTRING(190131 224148,190871 228134) | Phil Tce
6 | LINESTRING(198231 263418,198213 268322) | Dave Cres
7 | LINESTRING(218421 284121,224123 241231) | Chris Way
(6 rows)Wie auch immer, manchmal wird eine Einschränkung notwendig sein, um die Anzahl der zurückgegebenen Werte zu reduzieren. Falls es sich um eine Beschränkung auf ein Attribut handelt, können Sie dieselbe SQL-Syntax verwenden wie bei jeder anderen Nicht-Geometrietabelle. Für räumliche Beschränkungen sind folgende Operatoren verfügbar/nützlich:
- ST_Intersects
Diese Funktion bestimmt ob sich zwei geometrische Objekte einen gemeinsamen Raum teilen
- =
Überprüft, ob zwei Geoobjekte geometrisch ident sind. Zum Beispiel, ob 'POLYGON((0 0,1 1,1 0,0 0))' ident mit 'POLYGON((0 0,1 1,1 0,0 0))' ist (ist es).
Beachte: vor PostGIS 2.4 wuden nur die umschreibenden Rechtecke der Geometrie verglichen.
Außerdem können Sie diese Operatoren in Anfragen verwenden. Beachten Sie bitte, wenn Sie eine Geometrie oder eine Box auf der SQL-Befehlszeile eingeben, dass Sie die Zeichensatzdarstellung explizit in eine Geometrie umwandeln müssen. 312 ist ein fiktives Koordinatenreferenzsystem das zu unseren Daten passt. Also, zum Beispiel:
SELECT road_id, road_name FROM roads WHERE roads_geom='SRID=312;LINESTRING(191232 243118,191108 243242)'::geometry;
Die obere Abfrage würde einen einzelnen Datensatz aus der Tabelle "ROADS_GEOM" zurückgeben, in dem die Geometrie gleich dem angegebenen Wert ist.
Überprüfung ob einige der Strassen in die Polygonfläche hineinreichen:
SELECT road_id, road_name FROM roads WHERE ST_Intersects(roads_geom, 'SRID=312;POLYGON((...))');
Die häufigsten räumlichen Abfragen werden vermutlich in einem bestimmten Ausschnitt ausgeführt. Insbesondere von Client-Software, wie Datenbrowsern und Kartendiensten, die auf diese Weise die Daten für die Darstellung eines "Kartenausschnitts" erfassen.
Der Operator "&&" kann entweder mit einer BOX3D oder mit einer Geometrie verwendet werden. Allerdings wird auch bei einer Geometrie nur das Umgebungsrechteck für den Vergleich herangezogen.
Die Abfrage zur Verwendung des "BOX3D" Objekts für einen solchen Ausschnitt sieht folgendermaßen aus:
SELECT ST_AsText(roads_geom) AS geom FROM roads WHERE roads_geom && ST_MakeEnvelope(191232, 243117,191232, 243119,312);
Achten Sie auf die Verwendung von SRID=312, welche die Projektion Einhüllenden/Enveloppe bestimmt.
Der Tabellendumper pgsql2shp verbindet sich direkt mit der Datenbank und konvertiert eine Tabelle (evtl. durch eine Abfrage festgelegt) in eine Shapedatei. Die grundlegende Syntax lautet:
pgsql2shp [<options>] <database> [<schema>.]<table>
pgsql2shp [<options>] <database> <query>
Optionen auf der Befehlszeile:
- -f <filename>
Ausgabe in eine bestimmte Datei.
- -h <host>
Der Datenbankserver, mit dem eine Verbindung aufgebaut werden soll.
- -p <port>
Der Port über den der Verbindungsaufbau mit dem Datenbank Server hergestellt werden soll.
- -P <password>
Das Passwort, das zum Verbindungsaufbau mit der Datenbank verwendet werden soll.
- -u <user>
Das Benutzername, der zum Verbindungsaufbau mit der Datenbank verwendet werden soll.
- -g <geometry column>
Bei Tabellen mit mehreren Geometriespalten jene Geometriespalte, die ins Shapefile geschrieben werden soll.
- -b
Die Verwendung eines binären Cursors macht die Berechnung schneller; funktioniert aber nur, wenn alle nicht-geometrischen Attribute in den Datentyp "text" umgewandelt werden können.
- -r
RAW-Modus. Das Attribut
gidwird nicht verworfen und Spaltennamen werden nicht maskiert.- -m
filename Bildet die Identifikatoren in Namen mit 10 Zeichen ab. Der Inhalt der Datei besteht aus Zeilen von jeweils zwei durch Leerzeichen getrennten Symbolen, jedoch ohne vor- oder nachgestellte Leerzeichen: VERYLONGSYMBOL SHORTONE ANOTHERVERYLONGSYMBOL SHORTER etc.
Indizes ermöglichen das Arbeiten mit großen Datensätzen in einer Geodatenbank. Ohne Indizierung würde jede Featureanfrage einen "Full Table Scan" in der Datenbank benötigen. Die Indizierung beschleunigt die Suche, indem die Daten in einem Suchbaum strukturiert werden, der dann schnell durchlaufen werden kann um einen bestimmten Datensatz zu finden. PostgreSQL unterstützt standardmäßig drei Arten von Indizes: B-Baum, SP-GIST und GIST.
Ein B-Baum wird verwendet, wenn die Daten entlang einer Achse sortiert werden können; wie Zahlen, Buchstaben oder Datumsangaben. Geodaten können entlang einer raumfüllenden Kurve, Z-Kurve oder Hilbert-Kurve sortiert werden. Diese Darstellung erlaubt allerdings keine Beschleunigung der üblichen Operationen.
GiST (Generalized Search Tree) Indizes unterteilen die Daten in "Dinge auf einer Seite", "Dinge die sich überlagern", "Dinge die innerhalb liegen". Sie können auf eine Vielzahl von Datentypen, inklusive Geodaten angewendet werden. Um Geodaten zu indizieren verwendet PostGIS einen R-Baum der auf dem GIST Index aufsetzt.
GIST (Generalized Search Tree) ist eine generische Datenstruktur. Zusätzlich zur Indizierung von Geodaten wird GIST auch zur Beschleunigung von Abfragen auf unregelmäßige Datenstrukturen (Ganzzahl-Felder, Spektraldaten, etc.) verwendet, welche über gewöhnlicher B-Baum Indizierung nicht zugänglich sind.
Sobald eine Geodatentabelle einige tausend Zeilen überschreitet, werden Sie einen Index erzeugen wollen, um die räumlichen Abfragen auf die Daten zu beschleunigen (außer Ihre Suche basiert lediglich auf Attributen, in diesem Fall werden Sie einen gewöhnlichen Index auf die Attribute setzen).
Die Syntax, mit der ein GIST-Index auf eine Geometriespalte gelegt wird, lautet:
CREATE INDEX [indexname] ON [tablename] USING GIST ( [geometryfield] );
Die obere Syntax erzeugt immer einen 2D-Index. Um einen n-dimensionalen Index für den geometrischen Datentyp zu erhalten, können Sie die folgende Syntax verwenden:
CREATE INDEX [indexname] ON [tablename] USING GIST ([geometryfield] gist_geometry_ops_nd);
Die Erstellung eines räumlichen Indizes ist eine rechenintensive Aufgabe. Während der Erstellung wird auch der Schreibzugriff auf die Tabelle blockiert. Bei produktiven Systemen empfiehlt sich daher die langsamere Option CONCURRENTLY:
CREATE INDEX CONCURRENTLY [indexname] ON [tablename] USING GIST ( [geometryfield] );
Nachdem ein Index aufgebaut wurde sollte PostgreSQL gezwungen werden die Tabellenstatistik zu sammeln, da diese zur Optmierung der Auswertungspläne verwendet wird:
VACUUM ANALYZE [table_name] [(column_name)];
Die Bezeichnung BRIN steht für "Block Range Index", eine generische Form des Indizierens und wurde mit PostgreSQL 9.5 eingeführt. BRIN ist ein verlustbehafteter Index, dessen Hauptzweck ist, einen Kompromiss sowohl bei der Lese- als auch bei der Schreibgeschwindigkeit anzubieten. Der Hauptverwendungszweck liegt bei sehr großen Tabellen, in denen einige Spalten einen natürlichen Bezug zu dem physischen Speicherplatz innerhalb der Tabelle haben. Zusätzlich zur Indizierung von GIS-Daten, werden BRIN-Indizes zur Beschleunigung von Suchabfragen auf unterschiedliche regelmäßige und unregelmäßige Datenstrukturen (Ganzzahlen, Felder etc.) verwendet.
Sobald eine Geodatentabelle ein paar tausend Zeilen überschreitet, werden Sie einen Index erzeugen wollen, um die räumlichen Abfragen auf die Daten zu beschleunigen (außer Ihre Suche basiert lediglich auf Attributen, in diesem Fall werden Sie einen gewöhnlichen Index auf die Attribute setzen). GIST Indizes sind sehr performant, solange ihre Dateigröße den verfügbaren Arbeitsspeicher der Datenbank nicht überschreitet, genügend Festplattenspeicher vorhanden ist und die Systembelastung durch Schreibvorgänge akzeptiert werden kann. Andernfalls bietet der BRIN Index eine Alternative.
Die Idee hinter einem BRIN-Index ist, dass nur das Umgebungsrechteck abgespeichert wird, dass die gesamte Geometrie eines oder mehrerer Tabellenblöcke umschließt; dies wird als "Range" bezeichnet. Es ist klar, dass diese Indizierungsmethode nur dann effizient sein kann, wenn die Daten physikalisch so angeordnet sind, dass sich die resultierenden Umgebungsrechtecke der "Block Ranges" gegenseitig ausschließen. Der resultierende Index ist zwar sehr klein, in vielen Fällen allerdings weniger effizient als ein GIST Index.
Die Erstellung eines BRIN-Index benötigt wesentlich weniger Zeit, als die Erstellung eines GIST-Index. Es ist durchaus üblich, dass die Erstellung des BRIN Index mehr als zehnmal so schnell ist, als die eines GIST Index. Da ein BRIN Index nur ein Umgebungsrechteck für einen oder mehrere Tabellenblöcke speichert, benötigt dieser oft bis zu tausendmal weniger Festplattenspeicher.
Sie können die Anzahl der Blöcke festlegen, die zu einen "Range" aufsummiert werden sollen. Wenn Sie die Anzahl verringern, wird der Index zwar größer, höchstwahrscheinlich aber zu einer besseren Performanz verhelfen.
Der Syntax zur Erstellung eines BRIN-Indizes auf eine geometrische Spalte lautet wie folgt:
CREATE INDEX [indexname] ON [tablename] USING BRIN ( [geometryfield] );
Die obere Syntax erzeugt einen 2D-Index. Um einen 3-dimensionalen Index zu erhalten, können Sie die folgende Syntax verwenden:
CREATE INDEX [indexname] ON [tablename] USING BRIN ([geometryfield] brin_geometry_inclusion_ops_3d);
Sie können auch einen 4-dimensionalen Index über die 4D-Operatorklasse erstellen
CREATE INDEX [indexname] ON [tablename] USING BRIN ([geometryfield] brin_geometry_inclusion_ops_4d);
Die oberen Syntaxen verwenden die Standardeinstellung für die Anzahl der Blöcke in einem "Range", nämlich 128. Wenn Sie die Anzahl der Blöcke, die in einem Range zusammengefasst werden sollen, selbst festlegen wollen, verwenden Sie bitte die folgende Syntax
CREATE INDEX [indexname] ON [tablename] USING BRIN ( [geometryfield] ) WITH (pages_per_range = [number]);
Beachten Sie bitte auch, dass ein BRIN Index nur einen Indexwert für eine große Anzahl von Zeilen speichert. Wenn Ihre Tabelle eine Geometrie mit unterschiedlichen Dimensionen speichert, dann ist es wahrscheinlich dass der Index eine schlechte Performanz aufweist. Sie können diesen Performanzrückgang vermeiden, indem Sie die Operatorklasse mit der niedrigsten Dimension der gespeicherten Geometrie wählen.
Der BRIN-Index wird auch vom geographischen Datentyp unterstützt. Die Syntax zur Erstellung eines BRIN-Index auf eine "geographische" Spalte lautet wie folgt:
CREATE INDEX [indexname] ON [tablename] USING BRIN ( [geographyfield] );
Die obere Syntax erzeugt den 2D-Index für Geoobjekte auf dem Referenzellipsoid.
Aktuell wird hierbei nur die "Inklusionsunterstützung" betrachtet; d.h. dass nur die Operatoren &&, ~ und @ für 2D (sowohl für den "geometrischen", als auch für den "geographischen" Datentyp) und nur der Operator &&& für 3D-Geometrie verwendet werden kann. Die kNN-Suche wird zur Zeit nicht unterstützt.
SP-GiST steht als Abkürzung für "Space-Partitioned Generalized Search Tree", ein generischer Indextyp der partitionierte Baumstrukturen, wie Quadtree, k-d Baum und Radix-Trie unterstützt. Diese Datenstrukturen haben die gemeinsame Eigenschaft, dass sie den Suchraum in mehrere Partitionen unterteilen, die unterschiedlich groß sein können. Zusätzlich zur Indizierung von Geodaten wird der SP-GIST Index zur Beschleunigung der Suche von vielen Datentypen verwendet, wie bei Telefon Routing, IP Routing, String-Matching-Algorithmen, etc.
So wie der GiST Index, ist auch der SP-GiST Index insofern nicht verlustfrei, da nur die umschreibenden Rechtecke der Geoobjekte gespeichert werden. Der SP-GiST Index kann als Alternative zum GiST Index gesehen werden. Die Performanztests zeigten, dass der SP-GiST Index insbesondere bei vielen überlappenden Objekten Vorteile haben, wie dies bei sogenannten "Spaghettidaten" der Fall ist.
Sobald eine Geodatentabelle einige tausend Zeilen überschreitet, kann es sinnvoll sein einen SP-GIST Index zu erzeugen, um die räumlichen Abfragen auf die Daten zu beschleunigen. Die Syntax zur Erstellung eines SP-GIST Index auf eine "Geometriespalte" lautet:
CREATE INDEX [indexname] ON [tablename] USING SPGIST ( [geometryfield] );
Die obere Syntax erzeugt einen 2D-Index. Ein 3-dimensionaler Index für den geometrischen Datentyp können Sie mit der 3D Operatorklasse erstellen:
CREATE INDEX [indexname] ON [tablename] USING SPGIST ([geometryfield] spgist_geometry_ops_3d);
Die Erstellung eines räumlichen Indizes ist eine rechenintensive Aufgabe. Während der Erstellung wird auch der Schreibzugriff auf die Tabelle blockiert. Bei produktiven Systemen empfiehlt sich daher die langsamere Option CONCURRENTLY:
CREATE INDEX CONCURRENTLY [indexname] ON [tablename] USING SPGIST ( [geometryfield] );
Nachdem ein Index aufgebaut wurde sollte PostgreSQL gezwungen werden die Tabellenstatistik zu sammeln, da diese zur Optmierung der Auswertungspläne verwendet wird:
VACUUM ANALYZE [table_name] [(column_name)];
Ein SP-GiST Index kann Abfragen mit folgenden Operatoren beschleunigen:
<<, &<, &>, >>, <<|, &<|, |&>, |>>, &&, @>, <@, and ~=, für 2-dimensionale Iindices,
&/&, ~==, @>>, and <<@, für 3-dimensionale Indices.
kNN Suche wird zurzeit nicht unterstützt.
Üblicherweise beschleunigen Indizes den Datenzugriff: Sobald der Index aufgebaut ist, entscheidet der Anfrageoptimierer, ob der Index den Auswertungsplan bescheunigt. Unglücklicherweise optimiert der Anfrageoptimierer von PostgreSQL die Verwendung von GIST Indizes nicht sehr gut, so dass manchmal eine Suche, welche die Verwendung eines räumlichen Index bedingen sollte, über einen Full Table Scan ausgeführt wird.
Wenn Sie bemerken, dass Ihre räumlichen Indizes (oder Ihre Attributindizes) nicht verwendet werden, gibt es mehrere Möglichkeiten:
Zunächst sollten Sie sich den Auswertungsplan ansehen und überprüfen ob Ihre Abfrage tatsächlich das berechnet was Sie benötigen. Eine unkontrollierte Join-Bedingung, entweder vergessen oder auf eine falsche Tabelle gesetzt, kann alle Datensätze Ihrer Tabelle mehrmals hinzuziehen. Fügen Sie das Schlüsselwort EXPLAIN an den Anfang Ihrer bAbfrage, um den Auswertungsplan zu erhalten.
Als nächstes sollten Sie sicherstellen, dass eine Statistik über die Anzahl und die Verteilung der Tabellenwerte erfasst wurde, damit dem Anfrageoptimierer bessere Informationen zur Entscheidungsfindung bezüglich zu verwendender Indizes zur Verfügung steht. VACUUM ANALYZE errechnet beide.
Sie sollten ohnehin regelmäßig ein Vacuum Ihrer Datenbanken durchführen - viele PostgreSQL DBAs führen ein regelmäßigesVACUUM außerhalb der Spitzenzeiten mittels Cronjob aus.
Wenn VACUUM nicht hilft, können Sie den Anfrageoptimierer vorübergehend dazu zwingen den Index zu verwenden, indem Sie den Befehl set enable_seqscan to off; ausführen. Auf diese Weise können Sie feststellen, ob es dem Anfrageoptimierer überhaupt möglich ist, einen indexbeschleunigten Auswertungsplan für Ihre Abfrage zu erstellen. Sie sollten diesen Befehl nur zu Testzwecken: d.h. der Anfrageoptimierer weiß am besten Bescheid wann welcher Index verwendet werden soll. Sobald Sie Ihre Abfrage ausgeführt haben, sollten Sie daher
ENABLE_SEQSCANwieder auf ON stellen, damit weitere Abfragen den Anfrageoptimierer wie üblich nutzen können.Wenn set enable_seqscan to off; bei Ihrer Abfrage hilft, dann ist Ihr Postgres vermutlich nicht mit Ihrer Hardware abgestimmt. Wenn Sie herausfinden, daß sich der Anfrageoptimierer bezüglich der Kosten des Full Table Scan im Verhältnis zum Index Scan irrt, können Sie versuchen den Wert von
randam_page_costin "postgresql.conf" zu reduzieren, oder set random_page_cost to 1.1; ausführen. Der Standardwert des Parameters ist 4, versuchen Sie ihn auf 1 (auf einer SSD) oder auf 2 (auf einem schnellen magnetischen Festplattenlaufwerk) zu setzen. Eine Verringerung des Wertes führt dazu, dass der Anfrageoptimierer eher den Index Scan verwendet.Wennset enable_seqscan to off; bei Ihrer Abfrage nicht hilft, kann es sein, dass Sie ein Konstrukt verwenden das Postgres noch nicht entwirren kann. Eine Unterabfrage mit einem Inlineselect wäre so ein Fall -Sie müssen dies in eine Form bringen, die der Anfrageoptimierer nützen kann, z.B. mit einem LATERAL JOIN.
Sinn und Zweck der Geodatenbankfunktionalität ist, Abfragen innerhalb der Datenbank auszuführen, welche üblicherweise die Funktionalität eines Desktop-GIS benötigen würden. Um PostGIS effizient zu nutzen, müssen Sie die verfügbaren räumlichen Funktionen kennen und sicherstellen, dass die geeigneten Indizes vorhanden sind um eine gute Performanz zu gewährleisten. Die SRID von 312, die in diesen Beispielen verwendet wird, ist für bloße Demonstrationszwecke gedacht. Sie sollten eine ECHTE SRID aus der Tabelle "spatial_ref_sys" verwenden, die auch mit der Projektion Ihrer Daten übereinstimmen muss. Falls Ihren Daten kein Koordinatenreferenzsystem zugewiesen ist, sollten Sie genau eruieren warum dies so ist.
Wenn der Grund darin liegt, dass Sie etwas modellieren, für dass kein Koordinatenreferenzsystem festgelegt ist, wie der innere Aufbau eines Moleküls oder der Grundriss eines noch nicht gebauten Vergnügungsparks, so ist dies in Ordnung. Wenn der Standort des Vergnügungsparks bereits geplant wurde, dann ist die Wahl eines geeigneten Koordinatenreferenzsystems sinnvoll, auch wenn es nur darum geht sicherzustellen, dass der Vergnügungspark keine bereits bestehenden Strukturen überdeckt.
Sogar wenn Sie eine Mars Expedition planen, um die menschliche Rasse nach einem nuklearen Holocaust zu transportieren und Sie den Planeten Mars für die Besiedelung kartieren wollen, können Sie ein Koordinatenreferenzsystem wie Mars 2000 erstellen und dieses in die Tabelle spatial_ref_sys einfügen. Obwohl dieses Koordinatensystem für den Mars nicht planar ist (es ist in Grad des Referenzellipsoids), können Sie den geographischen Datentyp nutzen, um Längen- und Abstandsmessungen in Meter anstatt in Grad anzuzeigen.
Wenn Sie eine Abfrage erstellen, müssen Sie beachten, dass nur die auf den umschreibenden Rechtecken basierenden Operatoren wie && die Vorteile eines räumlichen GIST Index ausnutzen können. Funktionen wie ST_Distance() können den Index nicht zur Optimierung heranziehen. Zum Beispiel würde die folgende Abfrage auf eine große Tabelle ziemlich langsam ablaufen:
SELECT the_geom FROM geom_table WHERE ST_Distance(the_geom, 'SRID=312;POINT(100000 200000)') < 100
Diese Abfrage wählt die geometrischen Objekte der Tabelle "geom_table" aus, die weniger als 100 Einheiten von dem Punkt (100000, 200000) entfernt liegen. Sie ist sehr langsam, da die Entfernung zwischen jedem Punkt in der Tabelle und dem gegebenen Punkt berechnet werden muss, d.h. eine ST_Distance() Berechnung pro Tabellenzeile. Wir können dies vermeiden, indem wir die indexbeschleunigte Einstufenfunktion ST_DWithin verwenden und so die Anzahl der benötigten Entfernungsberechnungen verringern:
SELECT the_geom FROM geom_table WHERE ST_DWithin(the_geom, 'SRID=312;POINT(100000 200000)', 100)
Diese Anfrage wählt dieselben geometrischen Objekte aus, allerdings auf effizientere Weise. Angenommen es existiert ein GIST Index auf der Spalte "the_geom" und der Anfrageoptimierer erkennt, dass der Index angewendet werden kann, um die Zeilenanzahl zu verringern, bevor das Ergebnis durch die Funktion ST_Distance() errechnet wird. Anmerkung: die Geometrie ST_MakeEnvelope, die vom Operator "&&" verwendet wird, ist ein Quadrat mit einer Seitenlänge von 200 Einheiten, dessen Mittelpunkt auf dem ursprünglichen Punkt liegt - dies ist unsere "Abfrage Box". Der Operator "&&" verwendet diesen Index, um die Ergebnismenge rasch auf die Geometrie zu reduzieren, deren Umgebungsrechtecke die "Abfrage Box" überlagern. Falls Unsere "Abfrage Box" wesentlich kleiner als die Gesamtausdehnung der gesamten Geometrietabelle ist, wird dadurch die Anzahl der Entfernungsberechnungen drastisch verringert- dies ist genau das, was wir wollen.
Die Beispiele in diesem Abschnitt verwenden zwei Tabellen, eine Tabelle mit linearen Straßen, und eine Tabelle mit polygonalen Verwaltungsgrenzen. Die Tabellendefinition der Tabelle bc_roads lautet:
Column | Type | Description ------------+-------------------+------------------- gid | integer | Unique ID name | character varying | Road Name the_geom | geometry | Location Geometry (Linestring)
Die Tabellendefinition für die Tabelle bc_municipality lautet:
Column | Type | Description -----------+-------------------+------------------- gid | integer | Unique ID code | integer | Unique ID name | character varying | City / Town Name the_geom | geometry | Location Geometry (Polygon)
- 4.7.2.1. Gesamtlänge aller Straßen in Kilometer?
- 4.7.2.2. Wieviele Hektar hat die Stadt Prince George?
- 4.7.2.3. Welche ist die flächengrößte Gemeinde der Provinz?
- 4.7.2.4. Welche Länge haben die Straßen, die zur Gänze innerhalb einer Gemeinde liegen?
- 4.7.2.5. Eine neue Tabelle erzeugen, die alle Straßen der Stadt Prince George beinhaltet.
- 4.7.2.6. Wie lange ist die "Douglas St" in Victoria in Kilometern?
- 4.7.2.7. Welches ist das größte Gemeindepolygon mit einer Lücke?
- 5.1. Laden und Erstellen von Rastertabellen
- 5.2. Raster Katalog
- 5.3. Eigene Anwendungen mit PostGIS Raster erstellen
- 5.3.1. PHP Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen
- 5.3.2. ASP.NET C# Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen
- 5.3.3. Applikation für die Java-Konsole, welche eine Rasterabfrage als Bilddatei ausgibt
- 5.3.4. Verwenden Sie PLPython um Bilder via SQL herauszuschreiben
- 5.3.5. Faster mit PSQL ausgeben
In den häufigsten Anwendungsfällen werden Sie einen PostGIS-Raster durch das Laden einer bestehenden Rasterdatei, mit Hilfe des Rasterladers raster2pgsql, erstellen.
raster2pgsql ist ein ausführbarer Rasterlader, der die von GDAL unterstützten Rasterformate in SQL umwandelt, um sie anschließend in eine PostGIS Rastertabelle zu laden. Er kann sowohl ganze Verzeichnisse mit Rasterdateien laden, als auch Rasterübersichten erzeugen.
Da "raster2pgsql" meistens als Teil von PostGIS kompiliert ist (solange Sie nicht Ihre eigene GDAL Bibliothek kompilieren), sind die von "raster2pgsql" unterstützten Rastertypen die selben wie in der GDAL Bibliothek. Um eine Liste der Rastertypen, die von Ihrem jeweiligen "raster2pgsql"unterstützt werden, zu erhalten, benutzen Sie bitte den -G Switch. Falls Sie dieselbe GDAL Bibliothek für beide verwenden, sollte diese Liste mit der Ihrer PostGIS Installation, die durch ST_GDALDrivers bereitgestellt wird, ident sein.
| |
Die frühere Version dieses Tools war ein Python Skript. Die lauffähige Version hat das Python Skript ersetzt. Sollten Sie weiterhin das Python Skript benötigen, können Sie unter GDAL PostGIS Raster Driver Usage Beispiele für Python finden. Beachten Sie bitte, dass zukünftige Versionen von PostGIS Raster das "raster2pgsql" Pythonskript nicht mehr unterstützen. |
| |
Bei einem bestimmten Faktor kann es vorkommen, dass die Raster in der Übersicht/Overview nicht bündig angeordnet sind, obwohl sie die Raster selbst dies sind. Siehe http://trac.osgeo.org/postgis/ticket/1764 für ein solches Beispiel. |
ANWENDUNGSBEISPIEL:
raster2pgsqlraster_options_go_hereraster_filesomeschema.sometable> out.sql
- -?
Zeigt die Hilfe an, auch dann, wenn keine Argumente übergeben werden.
- -G
Gibt die unterstützten Rasterformate aus.
- (c|a|d|p) Dies sind sich gegenseitig ausschließende Optionen:
- -c
Eine neue Tabelle anlegen und mit Raster(n) befüllen, this is the default mode
- -a
Raster zu einer bestehende Tabelle hinzufügen.
- -d
Tabelle löschen, eine Neu erzeugen und mit einem oder mehreren Raster befüllen
- -p
Beim vorbereitenden Modus wird ledigliche eine Tabelle erstellt.
- Raster-Verarbeitung: Anwendung von Constraint's zur ordnungsgemäßen Registrierung im Rasterkatalog
- -C
Anwendung von Raster-Constraints, wie SRID, Zellgröße etc., um die ordnungsgemäße Registrierung des Rasters in der
raster_columnsView sicherzustellen.- -x
Unterbindet das Setzen der "Max-Extent" Bedingung. Wird nur angewandt, wenn auch die -C Flag gesetzt ist.
- -r
Setzt die Constraints (räumlich eindeutig und die Coverage-Kachel) der regelmäßigen Blöcke. Wird nur angewandt, wenn auch die -C Flag gesetzt ist.
- Rasterdaten-Verarbeitung: Optionale Parameter zur Manipulation von Input Raster Datensätzen
- -s <SRID>
Dem Output-Raster eine bestimmte SRID zuweisen. Wenn keine SRID oder Null angegeben wird, werden die Raster-Metadaten auf eine geignete SRID hin überprüft.
- -b BAND
Die Kennung (1-basiert) des Bandes, das aus dem Raster entnommen werden soll. Um mehrere Bänder anzugeben, trennen Sie die Kennungen bitte durch ein Komma (,).
- -t TILE_SIZE
Zerlegt den Raster in Kacheln, um eine Kachel pro Tabellenzeile einzufügen.
TILE_SIZEwird entweder in BREITExHöhe ausgedrückt, oder auf den Wert "auto" gesetzt, wodurch der Raster-Lader eine passende Kachelgröße an Hand des ersten Raster's ermittelt und diese dann auf die anderen Raster anwendet.- -P
Die ganz rechts und ganz unten liegenden Kacheln aufstocken, damit für alle Kacheln gleiche Breite und Höhe sichergestellt ist.
- -R, --register
Einen im Dateisystem vorliegenden Raster als (out-db) Raster registrieren.
Es werden nur die Metadaten und der Dateipfad des Rasters abgespeichert (nicht die Rasterzellen).
- -l
OVERVIEW_FACTOR Erzeugt eine Übersicht/Overview des Rasters. Mehrere Faktoren sind durch einen Beistrich(,) zu trennen. Die Benennung der Übersichtstabelle erfolgt dem Muster o_
overview_factor_table, wobeioverview_factorein Platzhalter für den numerischen Wert von "overview_factor" ist undtablefür den zugrundeliegenden Tabellennamen. Die erstellte Übersicht wird in der Datenbank gespeichert, auch wenn die Option -R gesetzt ist. Anmerkung: die erzeugte SQL-Datei enthält sowohl die Haupttabelle, als auch die Übersichtstabellen.- -N
NODATA Der NODATA-Wert, der für Bänder verwendet wird, die keinen NODATA-Wert definiert haben.
- Optionale Parameter zur Manipulation von Datenbankobjekten
- -f COLUMN
Gibt den Spaltennamen des Zielrasters an; standardmäßig wird er 'rast' benannt.
- -F
Eine Spalte mit dem Dateinamen hinzufügen
- -n COLUMN
Gibt die Bezeichnung für die Spalte mit dem Dateinamen an. Schließt -F" mit ein.
- -q
Setzt die PostgreSQL-Identifikatoren unter Anführungszeichen.
- -I
Einen GIST-Index auf die Rasterspalte anlegen.
- -M
VACUUM ANALYZE auf die Rastertabelle.
- -k
Überspringt die Überprüfung von NODATA-Werten für jedes Rasterband.
- -T
tablespace Bestimmt den Tablespace für die neue Tabelle. Beachten Sie bitte, dass Indizes (einschließlich des Primärschlüssels) weiterhin den standardmäßigen Tablespace nutzen, solange nicht die -X Flag benutzt wird.
- -X
tablespace Bestimmt den Tablespace für den neuen Index der Tabelle. Dieser gilt sowohl für den Primärschlüssel als auch für den räumlichen Index, falls die -I Flag gesetzt ist.
- -Y
Verwendung von Kopier- anstelle von Eingabe-Anweisungen.
- -e
Keine Transaktion verwenden, sondern jede Anweisung einzeln ausführen.
- -E ENDIAN
Legt die Byte-Reihenfolge des binär erstellten Rasters fest; geben Sie für XDR 0 und für NDR (Standardwert) 1 an; zurzeit wird nur die Ausgabe von NDR unterstützt.
- -V
version Bestimmt die Version des Ausgabeformats. Voreingestellt ist 0. Zur Zeit wird auch nur 0 unterstützt.
Eine Beispielssitzung, wo mit dem Lader eine Eingabedatei erstellt und stückchenweise als 100x100 Kacheln hochgeladen wird, könnte so aussehen:
| |
Sie können den Schemanamen weglassen z.B. |
raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation > elev.sql psql -d gisdb -f elev.sql
Durch die Verwendung von UNIX-Pipes kann die Konvertierung und der Upload in einem Schritt vollzogen werden:
raster2pgsql -s 4326 -I -C -M *.tif -F -t 100x100 public.demelevation | psql -d gisdb
Luftbildkacheln in "Massachusetts State Plane Meters" in das Schema aerial laden. Einen vollständigen View und Übersichtstabellen mit Faktor 2 und 4 erstellen. Verwendet den Modus "copy" für das Insert (keine dazwischengeschaltete Datei, sondern direkt in die Datenbank). Die Option -e bedingt, dass nicht alles innerhalb einer Transaktion abläuft (nützlich, wenn Sie sofort Daten sehen wollen, ohne zu warten). Die Raster werden in 128x128 Pixel große Kacheln zerlegt und Constraints auf die Raster gesetzt. Verwendet den Modus "copy" anstelle eines Tabellen-Inserts. (-F) Erzeugt das Attribut "filename", welches die Bezeichnung der Ausgangsdateien enthält, aus denen die Rasterkacheln ausgeschnitten wurden.
raster2pgsql -I -C -e -Y -F -s 26986 -t 128x128 -l 2,4 bostonaerials2008/*.jpg aerials.boston | psql -U postgres -d gisdb -h localhost -p 5432
--gibt eine Liste der unterstützten Rasterformate aus: raster2pgsql -G
Der -G Befehl gibt eine ähnliche Liste wie die Folgende aus
Available GDAL raster formats: Virtual Raster GeoTIFF National Imagery Transmission Format Raster Product Format TOC format ECRG TOC format Erdas Imagine Images (.img) CEOS SAR Image CEOS Image JAXA PALSAR Product Reader (Level 1.1/1.5) Ground-based SAR Applications Testbed File Format (.gff) ELAS Arc/Info Binary Grid Arc/Info ASCII Grid GRASS ASCII Grid SDTS Raster DTED Elevation Raster Portable Network Graphics JPEG JFIF In Memory Raster Japanese DEM (.mem) Graphics Interchange Format (.gif) Graphics Interchange Format (.gif) Envisat Image Format Maptech BSB Nautical Charts X11 PixMap Format MS Windows Device Independent Bitmap SPOT DIMAP AirSAR Polarimetric Image RadarSat 2 XML Product PCIDSK Database File PCRaster Raster File ILWIS Raster Map SGI Image File Format 1.0 SRTMHGT File Format Leveller heightfield Terragen heightfield USGS Astrogeology ISIS cube (Version 3) USGS Astrogeology ISIS cube (Version 2) NASA Planetary Data System EarthWatch .TIL ERMapper .ers Labelled NOAA Polar Orbiter Level 1b Data Set FIT Image GRIdded Binary (.grb) Raster Matrix Format EUMETSAT Archive native (.nat) Idrisi Raster A.1 Intergraph Raster Golden Software ASCII Grid (.grd) Golden Software Binary Grid (.grd) Golden Software 7 Binary Grid (.grd) COSAR Annotated Binary Matrix (TerraSAR-X) TerraSAR-X Product DRDC COASP SAR Processor Raster R Object Data Store Portable Pixmap Format (netpbm) USGS DOQ (Old Style) USGS DOQ (New Style) ENVI .hdr Labelled ESRI .hdr Labelled Generic Binary (.hdr Labelled) PCI .aux Labelled Vexcel MFF Raster Vexcel MFF2 (HKV) Raster Fuji BAS Scanner Image GSC Geogrid EOSAT FAST Format VTP .bt (Binary Terrain) 1.3 Format Erdas .LAN/.GIS Convair PolGASP Image Data and Analysis NLAPS Data Format Erdas Imagine Raw DIPEx FARSITE v.4 Landscape File (.lcp) NOAA Vertical Datum .GTX NADCON .los/.las Datum Grid Shift NTv2 Datum Grid Shift ACE2 Snow Data Assimilation System Swedish Grid RIK (.rik) USGS Optional ASCII DEM (and CDED) GeoSoft Grid Exchange Format Northwood Numeric Grid Format .grd/.tab Northwood Classified Grid Format .grc/.tab ARC Digitized Raster Graphics Standard Raster Product (ASRP/USRP) Magellan topo (.blx) SAGA GIS Binary Grid (.sdat) Kml Super Overlay ASCII Gridded XYZ HF2/HFZ heightfield raster OziExplorer Image File USGS LULC Composite Theme Grid Arc/Info Export E00 GRID ZMap Plus Grid NOAA NGS Geoid Height Grids
Oftmals werden Sie die Raster und die Rastertabellen direkt in der Datenbank erzeugen wollen. Dafür existieren eine Unmenge an Funktionen. Dies verlangt im Allgemeinen die folgende Schritte.
Erstellung einer Tabelle mit einer Rasterspalte für die neuen Rasterdatensätze:
CREATE TABLE myrasters(rid serial primary key, rast raster);
Es existieren viele Funktionen die Ihnen helfen dieses Ziel zu erreichen. Wenn Sie einen Raster nicht von anderen Rastern ableiten, sondern selbst erzeugen, können Sie mit ST_MakeEmptyRaster beginnen, gefolgt von ST_AddBand
Sie können Raster auch aus Geometrien erzeugen. Hierzu können Sie ST_AsRaster verwenden, möglicherweise in Verbindung mit anderen Funktionen, wie ST_Union, ST_MapAlgebraFct oder irgendeiner anderen Map Algebra Funktion.
Es gibt sogar noch viele andere Möglichkeiten, um eine neue Rastertabelle aus bestehenden Tabellen zu erzeugen. Sie können zum Beispiel mit ST_Transform einen Raster in eine andere Projektion transformieren und so eine neue Rastertabelle erstellen.
Wenn Sie mit der Erstbefüllung der Tabelle fertig sind, werden Sie einen räumlichen Index auf die Rasterspalte setzen wollen:
CREATE INDEX myrasters_rast_st_convexhull_idx ON myrasters USING gist( ST_ConvexHull(rast) );
Beachten Sie bitte die Verwendung von ST_ConvexHull; der Grund dafür ist, dass die meisten Rasteroperatoren auf der konvexen Hülle des Rasters beruhen.
Vor der Version 2.0 von PostGIS, basierten die Raster auf der Einhüllenden, anstatt auf der konvexen Hülle. Damit die räumlichen Indizes korrekt funktionieren, müssen Sie diese löschen und mit einem auf der konvexen Hülle basierenden Index ersetzen.
Mittels AddRasterConstraints Bedingungen auf den Raster legen.
Mit PostGIS kommen zwei Views des Rasterkatalogs. Beide Views nützen die Information, welche in den Bedingungen/Constraints der Rastertabellen festgelegt ist. Da die Bedingungen zwingend sind, sind die Views des Rasterkatalogs immer konsistent mit den Daten in den Rastertabellen.
raster_columnsdiese View/gespeicherte Abfrage katalogisiert alle Rastertabellenspalten Ihrer Datenbank.raster_overviewsDieser View katalogisiert all jene Spalten einer Rastertabelle in Ihrer Datenbank, die als Übersicht für Rastertabellen mit höherer Auflösung dienen. Tabellen dieses Typs werden mit der-lOption beim Laden erstellt.
raster_columns ist ein Katalog mit allen Rasterspalten Ihrer Datenbanktabellen. Es handelt sich dabei um einen View, der die Constraints auf die Tabellen ausnutzt, um so immer konsistent mit dem aktuellen Stand der Datenbank zu bleiben; sogar dann, wenn Sie den Raster aus einem Backup oder einer anderen Datenbank wiederherstellen. Der raster_columns Katalog beinhaltet die folgenden Spalten.
Falls Sie Ihre Tabellen nicht mit dem Loader erstellt haben, oder vergessen haben, die -C Option während des Ladens anzugeben, können Sie die Constraints auch anschließend erzwingen, indem Sie AddRasterConstraints verwenden, wodurch der raster_columns Katalog die Information über Ihre Rasterkacheln, wie üblich abspeichert.
r_table_catalogDie Datenbank, in der sich die Tabelle befindet. Greift immer auf die aktuelle Datenbank zu.r_table_schemaDas Datenbankschema in dem sich die Rastertabelle befindet.r_table_nameRastertabeller_raster_columnDie Spalte, in der Tabeller_table_name, die den Datentyp Raster aufweist. In PostGIS gibt es nichts, was Sie daran hindert, mehrere Rasterspalten in einer Tabelle zu haben. Somit ist es möglich auf unterschiedliche Raster(spalten) in einer einzigen Rastertabelle zuzugreifen.sridDer Identifikator für das Koordinatensystem in dem der Raster vorliegt. Sollte in Section 4.3.1, “Die SPATIAL_REF_SYS Tabelle und Koordinatenreferenzsysteme” eingetragen sein.scale_xDer Skalierungsfaktor zwischen den Koordinaten der Vektoren und den Pixeln. Dieser steht nur dann zur Verfügung, wenn alle Kacheln der Rasterspalte denselbenscale_xaufweisen und dieser Constraint auch gesetzt ist. Siehe ST_ScaleX für genauere Angaben.scale_yDer Skalierungsfaktor zwischen den Koordinaten der Vektoren und den Pixeln. Dieser steht nur dann zur Verfügung, wenn alle Kacheln der Rasterspalte denselbenscale_yaufweisen und der Constraintscale_yauch gesetzt ist. Siehe ST_ScaleY für genauere Angaben.blocksize_xDie Breite (Anzahl der waagrechten Zellen) einer Rasterkachel. Siehe ST_Width für weitere Details.blocksize_yDie Höhe (Anzahl der senkrechten Zellen) einer Rasterkachel. Siehe ST_Height für weitere Details.same_alignmentEine boolesche Variable, die TRUE ist, wenn alle Rasterkacheln dieselbe Ausrichtung haben. Siehe ST_SameAlignment für genauere Angaben.regular_blockingWenn auf die Rasterspalte die Constraints für die räumliche Eindeutigkeit und für die Coveragekachel gesetzt sind, ist der Wert TRUE, ansonsten FALSE..num_bandsDie Anzahl der Bänder, die jede Kachel des Rasters aufweist. ST_NumBands gibt die gleiche Information aus. ST_NumBandspixel_typesEin Feld das den Pixeltyp für die Bänder festlegt. Die Anzahl der Elemente in diesem Feld entspricht der Anzahl der Rasterbänder. Die "pixel_types" sind unter ST_BandPixelType definiert.nodata_valuesEin Feld mit Double Precision Zahlen, welche dennodata_valuefür jedes Band festlegen. Die Anzahl der Elemente in diesem Feld entspricht der Anzahl der Rasterbänder. Diese Zahlen legen den Pixelwert für jedes Rasterband fest, der bei den meisten Operationen ignoriert wir. Eine ähnliche Information erhalten Sie durch ST_BandNoDataValue.out_dbEin Feld mit booleschen Flags, das anzeigt, ob die Rasterbanddaten außerhalb der Datenbank gehalten werden. Die Anzahl der Elemente in diesem Feld entspricht der Anzahl der Rasterbänder.extentDie Ausdehnung aller Rasterspalten in Ihrem Rasterdatensatz. Falls Sie vor haben Daten zu laden, welche die Ausdehnung des Datensatzes ändern, sollten Sie die Funktion DropRasterConstraints ausführen, bevor Sie die Daten laden und nach dem Laden die Constraints mit der Funktion AddRasterConstraints erneut setzen.spatial_indexEine Boolesche Variable, die TRUE anzeigt, wenn ein räumlicher Index auf das Rasterattribut gelegt ist.
raster_overviews Katalogisiert Information über die Rastertabellenspalten die für die Übersichten/Overviews herangezogen wurden, sowie weitere zusätzliche Information bezüglich Overviews. Die Übersichtstabellen werden sowohl in raster_columns als auch in raster_overviews registriert, da sie sowohl eigene Raster darstellen, als auch, als niedriger aufgelöstes Zerrbild einer höher aufgelösten Tabelle, einem bestimmten Zweck dienen. Wenn Sie den -l Switch beim Laden des Rasters angeben, werden diese gemeinsam mit der Rasterhaupttabelle erstellt; sie können aber auch händisch über AddOverviewConstraints erstellt werden.
Übersichtstabellen enthalten dieselben Constraints wie andere Rastertabellen und zusätzliche informative Constraints, spezifisch für die Übersichten.
| |
Die Information in |
Die zwei Hauptgründe für Übersichtsraster sind:
Eine niedrig aufgelöste Darstellung der Basistabellen; wird im Allgemeinen zum schnellen Hinauszoomen verwendet.
Die Berechnungen laufen grundsätzlich schneller ab, als bei den Stammdaten mit höherer Auflösung, da weniger Datensätze vorhanden sind und die Pixel eine größere Fläche abdecken. Obwohl diese Berechnungen nicht so exakt sind, wie jene auf die hochauflösenden Stammtabellen, sind sie doch für viele Überschlagsrechnunen ausreichend.
Der raster_overviews Katalog enthält folgende Attribute an Information.
o_table_catalogDie Datenbank, in der sich die Übersichtstabelle befindet. Liest immer die aktuelle Datenbank.o_table_schemaDas Datenbankschema dem die Rasterübersichtstabelle angehört.o_table_nameDer Tabellenname der Rasterübersichto_raster_columndas Rasterattribut in der Übersichtstabelle.r_table_catalogDie Datenbank, in der sich die Rastertabelle befindet, für die diese Übersicht gilt. Greift immer auf die aktuelle Datenbank zu.r_table_schemaDas Datenbankschema, in dem sich die Rastertabelle befindet, zu der der Übersichtsdienst gehört.r_table_nameDie Rastertabelle, welche von dieser Übersicht bedient wird.r_raster_columnDie Rasterspalte, die diese Overviewspalte bedient.overview_factor- der Pyramidenlevel der Übersichtstabelle. Umso größer die Zahl ist, desto geringer ist die Auflösung. Wenn ein Ordner für die Bilder angegeben ist, rechnet raster2pgsql eine Übersicht für jede Bilddatei und ladet diese einzeln. Es wird Level 1 und die Ursprungsdatei angenommen. Beim Level 2 repräsentiert jede Kachel 4 Originalkacheln. Angenommen Sie haben einen Ordner mit Bilddateien in einer Auflösung von 5000x5000 Pixel, die Sie auf 125x125 große Kacheln zerlegen wollen. Für jede Bilddattei enthält die Basistabelle (5000*5000)/(125*125) Datensätze = 1600, Ihre (l=2)o_2Tabelle hat dann eine Obergrenze von (1600/Power(2,2)) = 400 Zeilen, Ihre (l=3)o_3(1600/Power(2,3) ) = 200 Zeilen. Wenn sich die Pixel nicht durch die Größe Ihrer Kacheln teilen lassen, erhalten Sie einige Ausschusskacheln (Kacheln die nicht zur Gänze gefüllt sind). Beachten Sie bitte, dass jede durch raster2pgsql erzeugte Übersichtskachel dieselbe Pixelanzahl hat wie die ursprüngliche Kachel, aber eine geringere Auflösung, wo ein Pixel (Power(2,overview_factor) Pixel der Ursprungsdatei) repräsentiert.
- 5.3.1. PHP Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen
- 5.3.2. ASP.NET C# Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen
- 5.3.3. Applikation für die Java-Konsole, welche eine Rasterabfrage als Bilddatei ausgibt
- 5.3.4. Verwenden Sie PLPython um Bilder via SQL herauszuschreiben
- 5.3.5. Faster mit PSQL ausgeben
Da PostGIS-Raster SQL-Funktionen für die bekannten Bildformate zur Verfügung stellt, haben Sie bei der Ausgabe von Rastern eine Reihe von Möglichkeiten. Zum Beispiel können Sie OpenOffice/LibreOffice für die Darstellung nutzen, so wie unter Rendering PostGIS Raster graphics with LibreOffice Base Reports dargestellt. Zusätzlich steht Ihnen eine Vielzahl an Sprachen zur Verfügung, wie in diesem Abschnitt gezeigt wird.
In diesem Abschnitt zeigen wir die Anwendung des PHP PostgreSQL Treibers und der Funktion ST_AsGDALRaster, um die Bänder 1,2,3 eines Rasters an einen PHP Request-Stream zu übergeben. Dieser kann dann in einen "img src" HTML Tag eingebunden werden.
Dieses Beispiel zeigt, wie Sie ein ganzes Bündel von Rasterfunktionen kombinieren können, um jene Kacheln zu erhalten, die ein bestimmtes WGS84 Umgebungsrechteck schneiden. Anschließend werden alle Bänder dieser Kacheln mit ST_Union vereinigt, mit ST_Transform in die vom Benutzer vorgegebene Projektion transformiert und das Ergebnis mit ST_AsPNG als PNG ausgegeben.
Sie können das unten angeführte Programm über
http://mywebserver/test_raster.php?srid=2249
aufrufen, um den Raster in "Massachusetts State Plane Feet" zu erhalten.
<?php
/** Inahlt von test_raster.php **/
$conn_str ='dbname=mydb host=localhost port=5432 user=myuser password=mypwd';
$dbconn = pg_connect($conn_str);
header('Content-Type: image/png');
/**Wenn eine bestimmte Projektion angefragt ist, wird diese verwendet, ansonsten wird "Mass State Plane Meters" verwendet **/
if (!empty( $_REQUEST['srid'] ) && is_numeric( $_REQUEST['srid']) ){
$input_srid = intval($_REQUEST['srid']);
}
else { $input_srid = 26986; }
/** "set bytea_output" für PostgreSQL 9.0+, wird für 8.4 nicht benötigt**/
$sql = "set bytea_output='escape';
SELECT ST_AsPNG(ST_Transform(
ST_AddBand(ST_Union(rast,1), ARRAY[ST_Union(rast,2),ST_Union(rast,3)])
,$input_srid) ) As new_rast
FROM aerials.boston
WHERE
ST_Intersects(rast, ST_Transform(ST_MakeEnvelope(-71.1217, 42.227, -71.1210, 42.218,4326),26986) )";
$result = pg_query($sql);
$row = pg_fetch_row($result);
pg_free_result($result);
if ($row === false) return;
echo pg_unescape_bytea($row[0]);
?>In diesem Abschnitt zeigen wir die Anwendung des Npgsql PostgreSQL .NET Treibers und der Funktion ST_AsGDALRaster, um die Bänder 1,2,3 eines Rasters an einen PHP Request-Stream zu übergeben. Dieser kann dann in einen "img src" HTML Tag eingebunden werden.
Für dieses Beispiel benötigen Sie den npgsql .NET PostgreSQL Treiber. Um loslegen zu können, reicht es aus, dass Sie die neueste Version von http://npgsql.projects.postgresql.org/ in Ihren ASP.NET Ordner laden.
Dieses Beispiel zeigt, wie Sie ein ganzes Bündel von Rasterfunktionen kombinieren können, um jene Kacheln zu erhalten, die ein bestimmtes WGS84 Umgebungsrechteck schneiden. Anschließend werden alle Bänder dieser Kacheln mit ST_Union vereinigt, mit ST_Transform in die vom Benutzer vorgegebene Projektion transformiert und das Ergebnis mit ST_AsPNG als PNG ausgegeben.
Dasselbe Beispiel wie Section 5.3.1, “PHP Beispiel: Ausgabe mittels ST_AsPNG in Verbindung mit anderen Rasterfunktionen” nur in C# implementiert.
Sie können das unten angeführte Programm über
http://mywebserver/TestRaster.ashx?srid=2249
aufrufen, um den Raster in "Massachusetts State Plane Feet" zu bekommen.
-- web.config Verbindungsaufbau --
<connectionStrings>
<add name="DSN"
connectionString="server=localhost;database=mydb;Port=5432;User Id=myuser;password=mypwd"/>
</connectionStrings
>// Code für TestRaster.ashx
<%@ WebHandler Language="C#" Class="TestRaster" %>
using System;
using System.Data;
using System.Web;
using Npgsql;
public class TestRaster : IHttpHandler
{
public void ProcessRequest(HttpContext context)
{
context.Response.ContentType = "image/png";
context.Response.BinaryWrite(GetResults(context));
}
public bool IsReusable {
get { return false; }
}
public byte[] GetResults(HttpContext context)
{
byte[] result = null;
NpgsqlCommand command;
string sql = null;
int input_srid = 26986;
try {
using (NpgsqlConnection conn = new NpgsqlConnection(System.Configuration.ConfigurationManager.ConnectionStrings["DSN"].ConnectionString)) {
conn.Open();
if (context.Request["srid"] != null)
{
input_srid = Convert.ToInt32(context.Request["srid"]);
}
sql = @"SELECT ST_AsPNG(
ST_Transform(
ST_AddBand(
ST_Union(rast,1), ARRAY[ST_Union(rast,2),ST_Union(rast,3)])
,:input_srid) ) As new_rast
FROM aerials.boston
WHERE
ST_Intersects(rast,
ST_Transform(ST_MakeEnvelope(-71.1217, 42.227, -71.1210, 42.218,4326),26986) )";
command = new NpgsqlCommand(sql, conn);
command.Parameters.Add(new NpgsqlParameter("input_srid", input_srid));
result = (byte[]) command.ExecuteScalar();
conn.Close();
}
}
catch (Exception ex)
{
result = null;
context.Response.Write(ex.Message.Trim());
}
return result;
}
}Eine einfache Java Applikation, die eine Abfrage entgegennimmt, ein Bild erzeugt und in eine bestimmte Datei ausgibt.
Sie können die neuesten PostgreSQL JDBC Treiber unter http://jdbc.postgresql.org/download.html herunterladen.
Sie können den unten angegebenen Code mit einem Befehl wie folgt kompilieren:
set env CLASSPATH .:..\postgresql-9.0-801.jdbc4.jar javac SaveQueryImage.java jar cfm SaveQueryImage.jar Manifest.txt *.class
Und ihn von der Befehlszeile wie folgt aufrufen:
java -jar SaveQueryImage.jar "SELECT ST_AsPNG(ST_AsRaster(ST_Buffer(ST_Point(1,5),10, 'quad_segs=2'),150, 150, '8BUI',100));" "test.png"
-- Manifest.txt -- Class-Path: postgresql-9.0-801.jdbc4.jar Main-Class: SaveQueryImage
// Code für SaveQueryImage.java
import java.sql.Connection;
import java.sql.SQLException;
import java.sql.PreparedStatement;
import java.sql.ResultSet;
import java.io.*;
public class SaveQueryImage {
public static void main(String[] argv) {
System.out.println("Checking if Driver is registered with DriverManager.");
try {
//java.sql.DriverManager.registerDriver (new org.postgresql.Driver());
Class.forName("org.postgresql.Driver");
}
catch (ClassNotFoundException cnfe) {
System.out.println("Couldn't find the driver!");
cnfe.printStackTrace();
System.exit(1);
}
Connection conn = null;
try {
conn = DriverManager.getConnection("jdbc:postgresql://localhost:5432/mydb","myuser", "mypwd");
conn.setAutoCommit(false);
PreparedStatement sGetImg = conn.prepareStatement(argv[0]);
ResultSet rs = sGetImg.executeQuery();
FileOutputStream fout;
try
{
rs.next();
/** Output to file name requested by user **/
fout = new FileOutputStream(new File(argv[1]) );
fout.write(rs.getBytes(1));
fout.close();
}
catch(Exception e)
{
System.out.println("Can't create file");
e.printStackTrace();
}
rs.close();
sGetImg.close();
conn.close();
}
catch (SQLException se) {
System.out.println("Couldn't connect: print out a stack trace and exit.");
se.printStackTrace();
System.exit(1);
}
}
}Diese als plpython gespeicherte Prozedur erzeugt eine Datei pro Datensatz im Serververzeichnis. Benötigt die Installation von plpython. Funktioniert sowohl mit plpythonu als auch mit plpython3u.
CREATE OR REPLACE FUNCTION write_file (param_bytes bytea, param_filepath text) RETURNS text AS $$ f = open(param_filepath, 'wb+') f.write(param_bytes) return param_filepath $$ LANGUAGE plpythonu;
-- 5 Bilder in verschiedenen Größen nach PostgreSQL schreiben
-- der Account des PostgreSQL Daemons benötigt Schreibrechte auf den Ordner
-- die Namen der erzeugten Dateien werden ausgegeben;
SELECT write_file(ST_AsPNG(
ST_AsRaster(ST_Buffer(ST_Point(1,5),j*5, 'quad_segs=2'),150*j, 150*j, '8BUI',100)),
'C:/temp/slices'|| j || '.png')
FROM generate_series(1,5) As j;
write_file
---------------------
C:/temp/slices1.png
C:/temp/slices2.png
C:/temp/slices3.png
C:/temp/slices4.png
C:/temp/slices5.png
Leider hat PSQL keine einfach zu benützende Funktion für die Ausgabe von Binärdateien eingebaut. Dieser Hack baut auf der etwas veralteten "Large Object" Unterstützung von PostgreSQL auf. Um ihn anzuwenden verbinden Sie sich bitte zuerst über die Befehlszeile "psql" mit Ihrer Datenbank.
Anders als beim Ansatz mit Python, wird die Datei bei diesem Ansatz auf Ihrem lokalen Rechner erzeugt.
SELECT oid, lowrite(lo_open(oid, 131072), png) As num_bytes
FROM
( VALUES (lo_create(0),
ST_AsPNG( (SELECT rast FROM aerials.boston WHERE rid=1) )
) ) As v(oid,png);
-- die Ausgabe sieht ungefähr so aus --
oid | num_bytes
---------+-----------
2630819 | 74860
-- beachten Sie die OID und ersetzen Sie c:/test.png mit dem tatsächlichen Pfad
-- auf Ihrem Rechner
\lo_export 2630819 'C:/temp/aerial_samp.png'
-- löscht die Datei aus dem "large object" Speicher der Datenbank
SELECT lo_unlink(2630819);
Der Minnesota MapServer ist ein Kartendienstserver für das Internet, der die "OpenGIS Web Map Service (WMS) Implementation Specification" erfüllt.
Die MapServer Homepage finden Sie unter http://mapserver.org.
Die OpenGIS Web Map Spezifikation finden Sie unter http://www.opengeospatial.org/standards/wms.
Um PostGIS mit MapServer zu verwenden müssen Sie wissen, wie Sie MapServer konfigurieren, da dies den Rahmens dieser Dokumentation sprengen würde. Dieser Abschnitt deckt PostGIS-spezifische Themen und Konfigurationsdetails ab.
Um PostGIS mit MapServer zu verwenden, benötigen Sie:
Die PostGIS Version 0.6, oder höher.
Die MapServer Version 3.5, oder höher.
MapServer greift auf die PostGIS/PostgreSQL-Daten, so wie jeder andere PostgreSQL-Client, über die libpq Schnittstelle zu. Dies bedeutet, dass MapServer auf jedem Server, der Netzwerkzugriff auf den PostgreSQL Server hat, installiert werden kann und PostGIS als Datenquelle nutzen kann. Je schneller die Verbindung zwischen den beiden Systemen, desto besser.
Es spielt keine Rolle, mit welchen Optionen Sie MapServer kompilieren, solange sie bei der Konfiguration die "--with-postgis"-Option angeben.
Fügen Sie einen PostGIS Layer zu der MapServer *.map Datei hinzu. Zum Beispiel:
LAYER CONNECTIONTYPE postgis NAME "widehighways" # Verbindung zu einer remote Geodatenbank CONNECTION "user=dbuser dbname=gisdatabase host=bigserver" PROCESSING "CLOSE_CONNECTION=DEFER" # Um die Zeilen der 'geom'-Spalte aus der 'roads'-Tabelle zu erhalten DATA "geom from roads using srid=4326 using unique gid" STATUS ON TYPE LINE # Von den im Ausschnitt vorhandenen Linien nur die breiten Hauptstraßen/Highways FILTER "type = 'highway' and numlanes >= 4" CLASS # Autobahnen heller und 2Pixel stark machen EXPRESSION ([numlanes] >= 6) STYLE COLOR 255 22 22 WIDTH 2 END END CLASS # Der ganze Rest ist dunkler und nur 1 Pixel stark EXPRESSION ([numlanes] < 6) STYLE COLOR 205 92 82 END END ENDIm oberen Beispiel werden folgende PostGIS-spezifische Anweisungen verwendet:
- CONNECTIONTYPE
Für PostGIS Layer ist dies immer "postgis".
- CONNECTION
Die Datenbankverbindung wird durch einen "Connection String" bestimmt, welcher aus einer standardisierten Menge von Schlüsseln und Werten zusammengesetzt ist (Standardwerte zwischen <>):
user=<username> password=<password> dbname=<username> hostname=<server> port=<5432>
Ein leerer "Connection String" ist ebenfalls gültig, sodass jedes Key/Value Paar weggelassen werden kann. Üblicherweise wird man zumindest den Datenbanknamen und den Benutzernamen, mit dem man sich verbinden will, angeben.
- DATA
Dieser Parameter hat die Form "<geocolumn> from <tablename> using srid=<srid> using unique <primary key>", wobei "geocolumn" dem räumlichen Attribut entspricht, mit dem die Bildsynthese/rendern durchgeführt werden soll. "srid" entspricht der SRID des räumlichen Attributs und "primary key" ist der Primärschlüssel der Tabelle (oder ein anderes eindeutiges Attribut mit einem Index).
Sie können sowohl "using srid" als auch "using unique" weglassen. Wenn möglich, bestimmt MapServer die korrekten Werte dann automatisch, allerdings zu den Kosten einiger zusätzlichen serverseitigen Abfragen, die bei jedem Kartenaufruf ausgeführt werden.
- PROCESSING
Wenn Sie mehrere Layer darstellen wollen, fügen Sie CLOSE_CONNECTION=DEFER ein, dadurch wird eine bestehende Verbindung wiederverwendet anstatt geschlossen. Dies erhöht die Geschwindigkeit. Unter MapServer PostGIS Performance Tips findet sich eine detailierte Erklärung.
- FILTER
Der Filter muss ein gültiger SQL-Text sein, welcher der Logik, die normalerweise dem "WHERE" Schlüsselwort in der SQL-Abfrage folgt, entspricht. Z.B.: um nur die Straßen mit 6 oder mehr Spuren zu rendern, können Sie den Filter "num_lanes >= 6" verwenden.
Stellen Sie bitte sicher, das für alle zu zeichnenden Layer, ein räumlicher Index (GIST) in der Geodatenbank angelegt ist.
CREATE INDEX [indexname] ON [tabellenname] USING GIST ( [geometry_spalte] );
Wenn Sie Ihre Layer über MapServer abfragen wollen, benötigen Sie auch die "using unique" Klausel in Ihrer "DATA" Anweisung.
MapServer benötigt für jeden räumlichen Datensatz, der abgefragt werden soll, eindeutige Identifikatoren. Das PostGIS Modul von MapServer benützt den von Ihnen festgelegten, eindeutigen Wert, um diese eindeutige Identifikatoren zur Verfügung zu stellen. Den Primärschlüssel zu verwenden gilt als Erfolgsrezept.
- 6.1.2.1. Wenn Ich EXPRESSION in meiner *.map Datei verwende, gibt die WHERE Bedingung niemals TRUE zurück, obwohl Ich weiß, dass sich die Werte in meiner Tabelle befinden.
- 6.1.2.2. Der FILTER, den ich bei meinen Shapefiles verwende, funktioniert nicht für meine PostGIS Tabelle, obwohl diese die gleichen Daten aufweist.
- 6.1.2.3. Mein PostGIS Layer wird viel langsamer dargestellt als mein Shapefile Layer. Ist das normal?
- 6.1.2.4. Mein PostGIS Layer wird ausgezeichnet dargestellt, aber die Abfragen sind sehr langsam. Was läuft falsch?
- 6.1.2.5. Kann Ich "Geography" Spalten (neu in PostGIS 1.5) als Quelle für MapServer Layer verwenden?
Die SQL-Pseudoklausel USING wird verwendet, um MapServer zusätzliche Information über komplexere Abfragen zukommen zu lassen. Genauer gesagt, wenn entweder ein View oder ein Subselect als Ursprungstabelle verwendet wird (der Ausdruck rechts von "FROM" bei einer DATA Definition) ist es für MapServer schwieriger einen eindeutigen Identifikator für jede Zeile und die SRID der Tabelle automatisch zu bestimmen. Die USINGKlausel kann MapServer die Information über diese beiden Teile wie folgt zukommen lassen:
DATA "geom FROM (
SELECT
table1.geom AS geom,
table1.gid AS gid,
table2.data AS data
FROM table1
LEFT JOIN table2
ON table1.id = table2.id
) AS new_table USING UNIQUE gid USING SRID=4326"- USING UNIQUE <uniqueid>
MapServer benötigt eine eindeutige ID für jede Zeile um die Zeile bei Kartenabfragen identifizieren zu können. Normalerweise wird der Primärschlüssel aus den Systemtabellen ermittelt. Views und Subselects haben jedoch nicht automatisch eine bekannte eindeutige Spalte. Wenn Sie MapServer's Abfragefunktionalität nutzen wollen, müssen Sie sicherstellen, dass Ihr View oder Subselect eine mit eindeutigen Werten versehene Spalte enthält und diese mit
USING UNIQUEgekennzeichnet ist. Zum Beispiel können Sie hierfür die Werte des Primärschlüssels verwenden, oder irgendeine andere Spalte bei der sichergestellt ist dass sie eindeutige Werte für die Ergebnismenge aufweist."eine Karte abfragen" ist jene Aktion, bei der man auf die Karte klickt und nach Information über Kartenfeatures an dieser Stelle fragt. Verwechseln Sie bitte nicht "Kartenabfragen" mit der SQL Abfrage in der
DATADefinition.- USING SRID=<srid>
PostGIS muss wissen, welches Koordinatenreferenzsystem von der Geometrie verwendet wird, um korrekte Daten an MapServer zurückzugeben. Üblicherweise kann man diese Information in der Tabelle "geometry_columns" in der PostGIS Datenbank finden. Dies ist jedoch nicht möglich bei Tabellen die On-the-fly erzeugt wurden, wo wie bei Subselects oder Views. Hierfür erlaubt die Option
USING SRID=die Festlegung der richtigen SRID in derDATADefinition.
Beginnen wir mit einem einfachen Beispiel und arbeiten uns dann langsam vor. Betrachten Sie die nachfolgende MapServer Layerdefinition:
LAYER
CONNECTIONTYPE postgis
NAME "roads"
CONNECTION "user=theuser password=thepass dbname=thedb host=theserver"
DATA "geom from roads"
STATUS ON
TYPE LINE
CLASS
STYLE
COLOR 0 0 0
END
END
ENDDieser Layer stellt alle Straßengeometrien der "roads"-Tabelle schwarz dar.
Angenommen, wir wollen bis zu einem Maßstab von 1:100000 nur die Autobahnen anzeigen - die nächsten zwei Layer erreichen diesen Effekt:
LAYER
CONNECTIONTYPE postgis
CONNECTION "user=theuser password=thepass dbname=thedb host=theserver"
PROCESSING "CLOSE_CONNECTION=DEFER"
DATA "geom from roads"
MINSCALE 100000
STATUS ON
TYPE LINE
FILTER "road_type = 'highway'"
CLASS
COLOR 0 0 0
END
END
LAYER
CONNECTIONTYPE postgis
CONNECTION "user=theuser password=thepass dbname=thedb host=theserver"
PROCESSING "CLOSE_CONNECTION=DEFER"
DATA "geom from roads"
MAXSCALE 100000
STATUS ON
TYPE LINE
CLASSITEM road_type
CLASS
EXPRESSION "highway"
STYLE
WIDTH 2
COLOR 255 0 0
END
END
CLASS
STYLE
COLOR 0 0 0
END
END
ENDDer erste Layer wird verwendet, wenn der Maßstab größer als 1:100000 ist und es werden nur die Straßen vom Typ "highway"/Autobahn als schwarze Linien dargestellt. Die Option FILTER bedingt, dass nur Straßen vom Typ "highway" angezeigt werden.
Der zweite Layer wird angezeigt, wenn der Maßstab kleiner als 1:100000 ist. Er zeigt die Autobahnen als doppelt so dicke rote Linien an, die anderen Straßen als normale schwarze Linien.
Wir haben eine Reihe von interessanten Aufgaben lediglich mit der von MapServer zur Verfügung gestellten Funktionalität durchgeführt, und unsere SQL-Anweisung unter DATA ist trotzdem einfach geblieben. Angenommen, die Namen der Straßen sind in einer anderen Tabelle gespeichert (wieso auch immer) und wir müssen einen Join ausführen, um sie für die Straßenbeschriftung verwenden zu können.
LAYER
CONNECTIONTYPE postgis
CONNECTION "user=theuser password=thepass dbname=thedb host=theserver"
DATA "geom FROM (SELECT roads.gid AS gid, roads.geom AS geom,
road_names.name as name FROM roads LEFT JOIN road_names ON
roads.road_name_id = road_names.road_name_id)
AS named_roads USING UNIQUE gid USING SRID=4326"
MAXSCALE 20000
STATUS ON
TYPE ANNOTATION
LABELITEM name
CLASS
LABEL
ANGLE auto
SIZE 8
COLOR 0 192 0
TYPE truetype
FONT arial
END
END
ENDDieser Beschriftungslayer fügt grüne Beschriftungen zu allen Straßen hinzu, wenn der Maßstab 1:20000 oder weniger wird. Es zeigt auch wie man einen SQL-Join in einer DATA Definition verwenden kann.
Java Clients können auf die PostGIS Geoobjekte in der PostgreSQL Datenbank entweder direkt über die Textdarstellung zugreifen oder über die Objekte der JDBC Erweiterung, die mit PostGIS gebündelt sind. Um die Objekte der Erweiterung zu nutzen, muss sich die Datei "postgis.jar" zusammen mit dem JDBC Treiberpaket "postgresql.jar" in Ihrem CLASSPATH befinden.
import java.sql.*;
import java.util.*;
import java.lang.*;
import org.postgis.*;
public class JavaGIS {
public static void main(String[] args) {
java.sql.Connection conn;
try {
/*
* Den JDBC Treiber laden und eine Verbindung herstellen.
*/
Class.forName("org.postgresql.Driver");
String url = "jdbc:postgresql://localhost:5432/database";
conn = DriverManager.getConnection(url, "postgres", "");
/*
* Die geometrischen Datentypen zu der Verbindung hinzufügen. Beachten Sie bitte,
* dass Sie die Verbindung in eine pgsql-specifische Verbindung umwandeln
* bevor Sie die Methode addDataType() aufrufen.
*/
((org.postgresql.PGConnection)conn).addDataType("geometry",Class.forName("org.postgis.PGgeometry"));
((org.postgresql.PGConnection)conn).addDataType("box3d",Class.forName("org.postgis.PGbox3d"));
/*
* Eine Anweisung erzeugen und eine Select Abfrage ausführen.
*/
Statement s = conn.createStatement();
ResultSet r = s.executeQuery("select geom,id from geomtable");
while( r.next() ) {
/*
* Die Geometrie als Objekt abrufen und es in einen geometrischen Datentyp umwandeln.
* Ausdrucken.
*/
PGgeometry geom = (PGgeometry)r.getObject(1);
int id = r.getInt(2);
System.out.println("Row " + id + ":");
System.out.println(geom.toString());
}
s.close();
conn.close();
}
catch( Exception e ) {
e.printStackTrace();
}
}
}Das Objekt "PGgeometry" ist ein Adapter, der abhängig vom Datentyp ein bestimmtes topologisches Geoobjekt (Unterklassen der abstrakten Klasse "Geometry") enthält: Point, LineString, Polygon, MultiPoint, MultiLineString, MultiPolygon.
PGgeometry geom = (PGgeometry)r.getObject(1);
if( geom.getType() == Geometry.POLYGON ) {
Polygon pl = (Polygon)geom.getGeometry();
for( int r = 0; r < pl.numRings(); r++) {
LinearRing rng = pl.getRing(r);
System.out.println("Ring: " + r);
for( int p = 0; p < rng.numPoints(); p++ ) {
Point pt = rng.getPoint(p);
System.out.println("Point: " + p);
System.out.println(pt.toString());
}
}
}Das JavaDoc der Erweiterung liefert eine Referenz für die verschiedenen Zugriffsfunktionen auf die Geoobjekte.
...
Aktuelle PostgreSQL Versionen (inklusive 9.6) haben eine Schwäche des Optimizers in Bezug auf TOAST Tabellen. TOAST Tabellen bieten eine Art "Erweiterungsraum", der benutzt wird um große Werte (im Sinne der Datengröße), welche nicht in die üblichen Datenspeicherseiten passen (wie lange Texte, Bilder oder eine komplexe Geometrie mit vielen Stützpunkten) auszulagern, siehe the PostgreSQL Documentation for TOAST für mehr Information).
Das Problem tritt bei Tabellen mit relativ großen Geometrien, aber wenigen Zeilen auf (z.B. eine Tabelle welche die europäischen Ländergrenzen in hoher Auflösung beinhaltet). Dann ist die Tabelle selbst klein, aber sie benützt eine Menge an TOAST Speicherplatz. In unserem Beispiel hat die Tabelle um die 80 Zeilen und nutzt dafür nur 3 Speicherseiten, während die TOAST Tabelle 8225 Speicherseiten benützt.
Stellen Sie sich nun eine Abfrage vor, die den geometrischen Operator && verwendet, um ein Umgebungsrechteck mit nur wenigen Zeilen zu ermitteln. Der Abfrageoptimierer stellt fest, dass die Tabelle nur 3 Speicherseiten und 80 Zeilen aufweist. Er nimmt an, das ein sequentieller Scan bei einer derart kleinen Tabelle wesentlich schneller abläuft als die Verwendung eines Indizes. Und so entscheidet er den GIST Index zu ignorieren. Normalerweise stimmt diese Annahme. Aber in unserem Fall, muss der && Operator die gesamte Geometrie von der Festplatte lesen um den BoundingBox-Vergleich durchführen zu können, wodurch auch alle TOAST-Speicherseiten gelesen werden.
Um zu sehen, ob dieses Problem auftritt, können Sie den "EXPLAIN ANALYZE" Befehl von PostgreSQL anwenden. Mehr Information und die technischen Feinheiten entnehmen Sie bitte dem Thread auf der Postgres Performance Mailing List: http://archives.postgresql.org/pgsql-performance/2005-02/msg00030.php
und einem neueren Thread über PostGIS https://lists.osgeo.org/pipermail/postgis-devel/2017-June/026209.html
Die PostgreSQL Entwickler versuchen das Problem zu lösen, indem sie die Abschätzung der Abfragen TOAST-gewahr machen. Zur Überbrückung zwei Workarounds:
Der erste Workaround besteht darin den Query Planer zu zwingen, den Index zu nutzen. Setzen Sie "SET enable_seqscan TO off;" am Server bevor Sie die Abfrage ausführen. Dies zwingt den Query Planer grundsätzlich dazu sequentielle Scans, wann immer möglich, zu vermeiden. Womit der GIST Index wie üblich verwendet wird. Aber dieser Parameter muss bei jeder Verbindung neu gesetzt werden, und er verursacht das der Query Planer Fehleinschätzungen in anderen Fällen macht. Daher sollte "SET enable_seqscan TO on;" nach der Abfrage ausgeführt werden.
Der zweite Workaround besteht darin, den sequentiellen Scan so schnell zu machen wie der Query Planer annimmt. Dies kann durch eine zusätzliche Spalte, welche die BBOX "zwischenspeichert" und über die abgefragt wird, erreicht werden. In Unserem Beispiel sehen die Befehle dazu folgendermaßen aus:
SELECT AddGeometryColumn('myschema','mytable','bbox','4326','GEOMETRY','2');
UPDATE mytable SET bbox = ST_Envelope(ST_Force2D(the_geom));Nun ändern Sie bitte Ihre Abfrage so, das der && Operator gegen die bbox anstelle der geom_column benutzt wird:
SELECT geom_column
FROM mytable
WHERE bbox && ST_SetSRID('BOX3D(0 0,1 1)'::box3d,4326);Selbstverständlich muss man die BBOX synchron halten. Die transparenteste Möglichkeit dies zu erreichen wäre über Trigger. Sie können Ihre Anwendung derart abändern, das die BBOX Spalte aktuell bleibt oder ein UPDATE nach jeder Änderung durchführen.
Für Tabelle die hauptsächlich read-only sind und bei denen ein einzelner Index für die Mehrheit der Abfragen verwendet wird, bietet PostgreSQL den CLUSTER Befehl. Dieser Befehl ordnet alle Datenzeilen in derselben Reihenfolge an wie die Kriterien bei der Indexerstellung, was zu zwei Performance Vorteilen führt: Erstens wird für die Index Range Scans die Anzahl der Suchabfragen über die Datentabelle stark reduziert. Zweitens, wenn sich der Arbeitsbereich auf einige kleine Intervale des Index beschränkt ist das Caching effektiver, da die Datenzeilen über weniger data pages verteilt sind. (Sie dürfen sich nun eingeladen fühlen, die Dokumentation über den CLUSTER Befehl in der PostgreSQL Hilfe nachzulesen.)
Die aktuelle PostgreSQL Version erlaubt allerdings kein clustern an Hand von PostGIS GIST Indizes, da GIST Indizes NULL Werte einfach ignorieren. Sie erhalten eine Fehlermeldung wie:
lwgeom=# CLUSTER my_geom_index ON my_table; ERROR: cannot cluster when index access method does not handle null values HINT: You may be able to work around this by marking column "the_geom" NOT NULL.
Wie die HINT Meldung mitteilt, kann man diesen Mangel umgehen indem man eine "NOT NULL" Bedingung auf die Tabelle setzt:
lwgeom=# ALTER TABLE my_table ALTER COLUMN the_geom SET not null; ALTER TABLE
Dies funktioniert natürlich nicht, wenn Sie tatsächlich NULL Werte in Ihrer Geometriespalte benötigen. Außerdem müssen Sie die obere Methode zum Hinzufügen der Bedingung verwenden. Die Verwendung einer CHECK Bedingung wie "ALTER TABLE blubb ADD CHECK (geometry is not null);" wird nicht klappen.
Manchmal kann es vorkommen, das Sie 3D- oder 4D-Daten in Ihrer Tabelle haben, aber immer mit den OpenGIS compliant ST_AsText() oder ST_AsBinary() Funktionen, die lediglich 2D Geometrien ausgeben, zugreifen. Dies geschieht indem intern die ST_Force2D() Funktion aufgerufen wird, welche einen wesentlichen Overhead für große Geometrien aufweist. Um diesen Overhead zu vermeiden kann es praktikabel sein diese zusätzlichen Dimensionen ein für alle mal im Voraus zu löschen:
UPDATE mytable SET the_geom = ST_Force2D(the_geom); VACUUM FULL ANALYZE mytable;
Beachten Sie bitte, falls Sie die Geometriespalte über AddGeometryColumn() hinzugefügt haben, das dadurch eine Bedingung auf die Dimension der Geometrie gesetzt ist. Um dies zu Überbrücken löschen Sie die Bedingung. Vergessen Sie bitte nicht den Eintrag in die geometry_columns Tabelle zu erneuern und die Bedingung anschließend erneut zu erzeugen.
Bei großen Tabellen kann es vernünftig sein, diese UPDATE in mehrere kleinere Portionen aufzuteilen, indem man das UPDATE mittels WHERE Klausel und eines Primärschlüssels, oder eines anderen passenden Kriteriums, beschränkt und ein einfaches "VACUUM;" zwischen den UPDATEs aufruft. Dies verringert den Bedarf an temporären Festplattenspeicher drastisch. Außerdem, falls die Datenbank gemischte Dimensionen der Geometrie aufweist, kann eine Einschränkung des UPDATES mittels "WHERE dimension(the_geom)>2" das wiederholte Schreiben von Geometrien, welche bereits in 2D sind, vermeiden.
Die Feinabstimmung von PostGIS ist dem Tunen für jeglichen PostgreSQL workload sehr ähnlich. Die einzige zusätzliche Anmerkung, die Sie im Kopf behalten müssen ist, das Geometrien und Raster groß sind, so das auf den Arbeitsspeicher bezogene Optimierungen im allgemeinen einen größeren Einfluß auf PostGIS haben als andere Arten von PostgreSQL Abfragen.
Für allgemeine Details zur PostgreSQL Optimierung, siehe Tuning your PostgreSQL Server.
Für PostgreSQL 9.4+ kann dies alles auf der Serverebene gesetzt werden, ohne das postgresql.conf oder postgresql.auto.conf angerührt werden müssen, indem man den ALTER SYSTEM.. Befehl nützt.
ALTER SYSTEM SET work_mem = '256MB'; -- dies erzwingt die non-startup Konfiguration für neue Verbindungen SELECT pg_reload_conf(); -- zeige aktuelle Einstellungen -- benutzen Sie bitte SHOW ALL um alle Einstellungen anzuzeigen SHOW work_mem;
Zusätzlich zu diesen Einstellungen verfügt PostGIS über einige eigene Einstellungen welche unter Section 8.2, “PostGIS Grand Unified Custom Variables (GUCs)” aufgeführt sind.
Folgende Einstellungen werden in der postgresql.conf konfiguriert:
Default: partition
Dies wird im allgemeinen zur Tabellenpartitionierung verwendet. Die Standardeinstellung ist "partition". Dies ist ideal für PostgreSQL 8.4 oder höher, da es den Query Planer veranlasst nur jene Tabellen, die sich in einer vererbten Hierarchie befinden, in Hinblick auf Bedingungen zu analysieren.
Standard: ~128MB in PostgreSQL 9.6
Auf ca. 25% bis 40% des verfügbaren RAM setzen. Unter Windows können Sie nicht so hoch ansetzen.
max_worker_processes Diese Einstellung ist erst ab PostgreSQL 9.4+ verfügbar. Ab PostgreSQL 9.6+ hat diese Einstellung eine zusätzliche Bedeutung, da sie die maximale Anzahl von Prozessen bestimmt, die bei parallel ablaufenden Abfragen verwendet werden können.
Default: 8
Bestimmt die maximale Anzahl von Hintergrundprozessen die das System unterstützen kann. Dieser Parameter kann nur beim Serverstart gesetzt werden.
work_mem (jener Arbeitsspeicher der für Sortieroperationen und komplexe Abfragen benutzt wird)
Default: 1-4MB
Nach oben setzen für große Datenbanken, komplexe Abfragen und wenn große Mengen an Arbeitsspeicher zur Verfügung stehen.
Nach unten setzen bei vielen gleichzeitigen Anwendern oder wenn wenig Arbeitsspeicher zur Verfügung steht
Falls sie viel Arbeitsspeicher aber wenig Entwickler zur Verfügung haben:
SET work_mem TO '256MB';
maintenance_work_mem (wird für VACUUM, CREATE INDEX, etc. genutzt)
Default: 16-64MB
Ist im allgemeinen zu niedrig gesetzt - bindet I/O, sperrt Objekte während es den Speicher auslagert
Es werden 32MB bis 1GB auf Produktionsservern mit viel Hauptspeicher empfohlen, was allerdings von der Anzahl der Anwender abhängt. Falls Sie eine Menge an Arbeitsspeicher und wenige Entwickler haben:
SET maintenance_work_mem TO '1GB';
max_parallel_workers_per_gather
max_parallel_workers_per_gather Diese Enstellung ist erst ab PostgreSQL 9.6+ verfügbar und wirkt sich erst ab PostGIS 2.3+ aus, da nur PostGIS 2.3+ parallel laufende Abfragen unterstützt. Wenn der Parameter auf einen höheren Wert als 0 gestellt wird können manche Abfragen, wie jene die Relationsfunktionen wie ST_Intersects verwenden, mehrere Prozesse benutzen und mehr als doppelt so schnell ablaufen. Falls Sie eine große Anzahl an Prozessoren zur Verfügung haben, sollten Sie diesen Wert auf die Anzahl der Prozessoren setzen. Stellen Sie bitte auch sicher die max_worker_processes auf zumindest die gleiche Anzahl zu erhöhen.
Default: 0
Setzt die maximale Anzahl von Workern, die durch einen einzelnen
GatherKnoten aufgerufen werden können. Parallele Worker werden aus einem Pool von Prozessen, welche vonmax_worker_processesaufgespannt sind, entnommen. Beachten Sie bitte, das die angeforderte Anzahl von Workern zur Laufzeit nicht tatsächlich zur Verfügung stehen kann. Falls dies auftritt wird der Plan mit weniger Workern als erwartet ausgeführt, was leistungsschwach sein kann. Setzt man den Wert auf 0, was der Standardeinstellung entspricht, wird die parallele Ausführung von Abfragen unterbunden.
- 8.1. PostgreSQL und PostGIS Datentypen - Geometry/Geography/Box
- 8.2. PostGIS Grand Unified Custom Variables (GUCs)
- 8.3. Geometrische Managementfunktionen
- 8.4. Geometrische Konstruktoren
- 8.5. Geometrische Zugriffsfunktionen
- 8.6. Geometrische Editoren
- 8.7. Ausgabe von Geometrie
- 8.8. Operatoren
- 8.9. Measurement Functions
- 8.10. SFCGAL Funktionen
- 8.11. Geometrieverarbeitung
- 8.12. Kilometrierung
- 8.13. Unterstützung von lang andauernden Transaktionen/Long Transactions
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.
Each data type describes its type casting behaviour. 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 behaviour, which allows automatic conversion of a function argument to a type supported by the function.
Some casts have explicit behaviour, 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 — Ein Quader der aus Xmin, Ymin, Zmin, Xmax, Ymax und Zmax gebildet wird. Wird oft verwendet, um die 3D Ausdehnung einer Geometrie oder einer Sammelgeometrie zu erhalten.
- box3d — Ein Quader der aus Xmin, Ymin, Zmin, Xmax, Ymax und Zmax gebildet wird. Wird oft verwendet, um die 3D Ausdehnung einer Geometrie oder einer Sammelgeometrie zu erhalten.
- 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.
Name
box2d — Ein Quader der aus Xmin, Ymin, Zmin, Xmax, Ymax und Zmax gebildet wird. Wird oft verwendet, um die 3D Ausdehnung einer Geometrie oder einer Sammelgeometrie zu erhalten.
Name
box3d — Ein Quader der aus Xmin, Ymin, Zmin, Xmax, Ymax und Zmax gebildet wird. Wird oft verwendet, um die 3D Ausdehnung einer Geometrie oder einer Sammelgeometrie zu erhalten.
Beschreibung
Box3D ist ein geometrischer Datentyp, der den umschreibenden Quader einer oder mehrerer geometrischer Objekte abbildet. ST_3DExtent gibt ein Box3D-Objekt zurück.
The representation contains the values xmin, ymin, zmin, xmax, ymax, zmax. These are the minimum and maxium values of the X, Y and Z extents.
Name
geometry — Der geographische Datentyp "Geography" wird zur Abbildung eines Geoobjektes im geographischen Kugelkoordinatensystem verwendet.
Beschreibung
Der Datentyp "geometry" ist der elementare räumliche Datentyp von PostGIS zur Abbildung eines Geoobjektes in das kartesische Koordinatensystem.
Alle räumlichen Operationen an einer Geometrie verwenden die Einheiten des Koordinatenreferenzsystems in dem die Geometrie vorliegt.
Name
geometry_dump — A composite type used to describe the parts of complex geometry.
Beschreibung
geometry_dump is a composite data type containing the fields:
geom- a references to a component geometrypath[]- a 1-dimensional integer array that defines the navigation path within the dumped geometry to thegeomcomponent. The path array starts at 1 (e.g.path[1]is the first element.)
It is used by the ST_Dump* family of functions as an output type to explode a complex geometry into its constituent parts.
Name
geography — The type representing spatial features with geodetic (ellipsoidal) coordinate systems.
Beschreibung
Der geographische Datentyp "Geography" wird zur Abbildung eines Geoobjektes im geographischen Kugelkoordinatensystem verwendet.
Spatial operations on the geography type provide more accurate results by taking the ellipsoidal model into account.
- 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
Name
postgis.backend — Dieses Backend stellt eine Funktion zur Auswahl zwischen GEOS und SFCGAL zur Verfügung.
Beschreibung
Diese GUC hat nur Bedeutung, wenn Sie PostGIS mit SFCGAL Unterstützung kompiliert haben. Funktionen, welche sowohl bei GEOS als auch bei SFCGAL die gleiche Bezeichnung haben, werden standardmäßig mit dem geos Backend ausgeführt. Die Standardeinstellung wird mit dieser Variablen überschrieben und SFCGAL für den Aufruf verwendet.
Verfügbarkeit: 2.1.0
Name
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.
Beschreibung
Eine PostgreSQL GUC Variable zum setzten von GDAL's GDAL_DATA Option. Der postgis.gdal_datapath Wert sollte dem gesamten physischen Pfad zu den Datendateien von GDAL entsprechen.
Diese Konfigurationsmöglichkeit ist am nützlichsten auf Windows Plattformen, wo der Dateipfad von "data" nicht fest kodiert ist. Diese Option sollte auch gesetzt werden, wenn sich die Datendateien nicht in dem von GDAL erwarteten Pfad befinden.
| |
Diese Option kann in der Konfigurationsdatei "postgresql.conf" gesetzt werden. Sie kann auch pro Verbindung oder pro Transaktion gesetzt werden. |
Verfügbarkeit: 2.2.0
| |
Zusätzliche Informationen über GDAL_DATA ist unter den Konfigurationsmöglichkeiten für GDAL zu finden. |
Name
postgis.gdal_enabled_drivers — Eine Konfigurationsmöglichkeit um einen GDAL Treiber in der PostGIS Umgebung zu aktivieren. Beeinflusst die Konfigurationsvariable GDAL_SKIP von GDAL.
Beschreibung
Eine Konfigurationsmöglichkeit um einen GDAL Treiber in der PostGIS Umgebung zu aktivieren. Beeinflusst die Konfigurationsvariable GDAL_SKIP von GDAL. Diese Option kann in der PostgreSQL Konfigurationsdatei "postgresql.conf" gesetzt werden. Sie kann aber auch pro Verbindung oder pro Transaktion gesetzt werden.
Der Ausgangswert von postgis.gdal_enabled_drivers kann auch beim Startprozess von PostgreSQL gesetzt werden, nämlich durch die Übergabe der Umgebungsvariablen POSTGIS_GDAL_ENABLED_DRIVERS, welche die Liste der aktivierten Treiber enthält.
Aktivierte GDAL Treiber können auch über die Kurzbezeichnung oder den Code des Treibers bestimmt werden. Kurzbezeichnungen und Codes für die Treiber finden sich unter GDAL Raster Formate Es können mehrere, durch Leerzeichen getrennte Treiber angegeben werden.
| |
Für
Falls |
| |
|
| |
Weiterführende Informationen über GDAL_SKIP ist auf GDAL's Configuration Options zu finden. |
Verfügbarkeit: 2.2.0
Beispiele
postgis.gdal_enabled_drivers setzen und zurücksetzen
Bestimmt das Backend, das für alle neuen Verbindungen zur Datenbank verwendet wird
ALTER DATABASE mygisdb SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
Setzt die standardmäßig aktivierten Treiber für alle neuen Verbindungen zum Server. Benötigt Administratorrechte und PostgreSQL 9.4+. Beachten Sie aber bitte, dass die Datenbank-, Sitzungs- und Benutzereinstellungen dies überschreiben.
ALTER SYSTEM SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
SELECT pg_reload_conf();
SET postgis.gdal_enabled_drivers TO 'GTiff PNG JPEG';
SET postgis.gdal_enabled_drivers = default;
Aktiviert alle GDAL-Treiber
SET postgis.gdal_enabled_drivers = 'ENABLE_ALL';
Deaktiviert alle GDAL-Treiber
SET postgis.gdal_enabled_drivers = 'DISABLE_ALL';
Name
postgis.enable_outdb_rasters — Eine boolesche Konfigurationsmöglichkeit um den Zugriff auf out-db Rasterbänder zu ermöglichen
Beschreibung
Eine boolesche Konfigurationsmöglichkeit um den Zugriff auf out-db Rasterbänder zu ermöglichen. Diese Option kann in der PostgreSQL Konfigurationsdatei "postgresql.conf" gesetzt werden. Kann aber auch pro Verbindung oder pro Transaktion gesetzt werden.
Der Ausgangswert von postgis.enable_outdb_rasters kann auch beim Startprozess von PostgreSQL gesetzt werden, nämlich durch die Übergabe der Umgebungsvariablen POSTGIS_ENABLE_OUTDB_RASTERS, welche ungleich null sein muss.
| |
Auch wenn |
| |
Bei der Standardinstallation von PostGIS ist |
Verfügbarkeit: 2.2.0
- 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.
Name
AddGeometryColumn — Entfernt eine Geometriespalte aus einer räumlichen Tabelle.
Synopsis
text AddGeometryColumn(varchar table_name, varchar column_name, integer srid, varchar type, integer dimension, boolean use_typmod=true);
text AddGeometryColumn(varchar schema_name, varchar table_name, varchar column_name, integer srid, varchar type, integer dimension, boolean use_typmod=true);
text AddGeometryColumn(varchar catalog_name, varchar schema_name, varchar table_name, varchar column_name, integer srid, varchar type, integer dimension, boolean use_typmod=true);
Beschreibung
Fügt eine Geometriespalte zu den Attributen einer bestehende Tabelle hinzu. Der schema_name ist der Name des Schemas, in dem sich die Tabelle befindet. Bei der srid handelt es sich um eine Ganzzahl, welche auf einen entsprechenden Eintrag in der SPATIAL_REF_SYS Tabelle verweist. Beim type handelt es sich um eine Zeichenkette, welche dem Geometrietyp entsprechen muss, z.B.: 'POLYGON' oder 'MULTILINESTRING'. Falls der Name des Schemas nicht existiert (oder im aktuellen search_path nicht sichtbar ist), oder die angegebene SRID, der Geometrietyp, oder die Dimension ungültig sind, wird ein Fehler angezeigt.
| |
Änderung: 2.0.0 Diese Funktion aktualisiert die geometry_columns Tabelle nicht mehr, da geometry_columns jetzt ein View ist, welcher den Systemkatalog ausliest. Standardmäßig werden auch keine Bedingungen/constraints erzeugt, sondern es wird der in PostgreSQL integrierte Typmodifikaor verwendet. So entspricht zum Beispiel die Erzeugung einer wgs84 POINT Spalte mit dieser Funktion: Änderung: 2.0.0 Falls Sie das alte Verhalten mit Constraints wünschen, setzen Sie bitte |
| |
Änderung: 2.0.0 Views können nicht mehr händisch in "geometry_columns" registriert werden. Views auf eine Geometrie in Typmod-Tabellen, bei denen keine Adapterfunktion verwendet wird, registrieren sich selbst auf korrekte Weise, da sie die Typmod-Verhaltensweise von der Spalte der Stammtabelle erben. Views die ein geometrische Funktion ausführen die eine andere Geometrie ausgibt, benötigen die Umwandlung in eine Typmod-Geometrie, damit die Geometrie des Views korrekt in "geometry_columns" registriert wird. Siehe Section 4.3.4, “Geometrische Spalten in "geometry_columns" händisch registrieren”. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Verbesserung: 2.0.0 use_typmod Argument eingeführt. Standardmäßig wird eine typmod Geometrie anstelle einer Constraint-basierten Geometrie erzeugt.
Beispiele
-- Ein Schema für die Daten erzeugen
CREATE SCHEMA my_schema;
-- Eine neue einfache PostgreSQL Tabelle ersellen
CREATE TABLE my_schema.my_spatial_table (id serial);
-- Die Beschreibung der Tabelle zeigt eine einfache Tabelle mit einer einzigen "id" Spalte Describing the table shows a simple table with a single "id" column.
postgis=# \d my_schema.my_spatial_table
Table "my_schema.my_spatial_table"
Column | Type | Modifiers
--------+---------+-------------------------------------------------------------------------
id | integer | not null default nextval('my_schema.my_spatial_table_id_seq'::regclass)
-- Fügt eine Geometriespalte an die Tabelle an
SELECT AddGeometryColumn ('my_schema','my_spatial_table','geom',4326,'POINT',2);
-- Hinzufügen einer Punktgeometrie mit dem alten, auf Bedingungen basierten Verhalten/old constraint behavior
SELECT AddGeometryColumn ('my_schema','my_spatial_table','geom_c',4326,'POINT',2, false);
--Hinzufügen eines Kurvenpolygons/curvepolygon mittels old constraint behavior
SELECT AddGeometryColumn ('my_schema','my_spatial_table','geomcp_c',4326,'CURVEPOLYGON',2, false);
-- Die neuerliche Beschreibung der Tabelle zeigt die hinzugefügten Geometriespalten an.
\d my_schema.my_spatial_table
addgeometrycolumn
-------------------------------------------------------------------------
my_schema.my_spatial_table.geomcp_c SRID:4326 TYPE:CURVEPOLYGON DIMS:2
(1 row)
Table "my_schema.my_spatial_table"
Column | Type | Modifiers
----------+----------------------+-------------------------------------------------------------------------
id | integer | not null default nextval('my_schema.my_spatial_table_id_seq'::regclass)
geom | geometry(Point,4326) |
geom_c | geometry |
geomcp_c | geometry |
Check constraints:
"enforce_dims_geom_c" CHECK (st_ndims(geom_c) = 2)
"enforce_dims_geomcp_c" CHECK (st_ndims(geomcp_c) = 2)
"enforce_geotype_geom_c" CHECK (geometrytype(geom_c) = 'POINT'::text OR geom_c IS NULL)
"enforce_geotype_geomcp_c" CHECK (geometrytype(geomcp_c) = 'CURVEPOLYGON'::text OR geomcp_c IS NULL)
"enforce_srid_geom_c" CHECK (st_srid(geom_c) = 4326)
"enforce_srid_geomcp_c" CHECK (st_srid(geomcp_c) = 4326)
-- Der geometry_columns View registriert die neuen Spalten --
SELECT f_geometry_column As col_name, type, srid, coord_dimension As ndims
FROM geometry_columns
WHERE f_table_name = 'my_spatial_table' AND f_table_schema = 'my_schema';
col_name | type | srid | ndims
----------+--------------+------+-------
geom | Point | 4326 | 2
geom_c | Point | 4326 | 2
geomcp_c | CurvePolygon | 4326 | 2
Name
DropGeometryColumn — Entfernt eine Geometriespalte aus einer räumlichen Tabelle.
Synopsis
text DropGeometryColumn(varchar table_name, varchar column_name);
text DropGeometryColumn(varchar schema_name, varchar table_name, varchar column_name);
text DropGeometryColumn(varchar catalog_name, varchar schema_name, varchar table_name, varchar column_name);
Beschreibung
Entfernt eine geometrische Spalte aus der Geometrietabelle. Der "schema_name" muss mit dem Feld "f_table_schema" in der Tabelle "geometry_columns" übereinstimmen.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
| |
Änderung: 2.0.0 Diese Funktion wurde zwecks Abwärtskompatibilität eingeführt. Seit geometry_columns ein View auf den Systemkatalog ist, können Sie die Geometriespalte, so wie jede andere Tabellenspalte, mit |
Beispiele
SELECT DropGeometryColumn ('my_schema','my_spatial_table','geom');
----RESULT output ---
dropgeometrycolumn
------------------------------------------------------
my_schema.my_spatial_table.geom effectively removed.
-- In PostGIS 2.0+ entspricht das oben angeführte Aufruf ebenfalls dem Standard
-- Der standardmäßige ALTER TABLE Aufruf. Beide Aufrufe entfernen die Tabelle aus dem geometry_columns Register.
ALTER TABLE my_schema.my_spatial_table DROP column geom;
Name
DropGeometryTable — Löscht eine Tabelle und alle Referenzen in dem geometry_columns View.
Synopsis
boolean DropGeometryTable(varchar table_name);
boolean DropGeometryTable(varchar schema_name, varchar table_name);
boolean DropGeometryTable(varchar catalog_name, varchar schema_name, varchar table_name);
Beschreibung
Löscht eine Tabelle und deren Verweise in "geometry_columns". Anmerkung: verwendet current_schema() wenn kein Schema angegeben wird, eine Schema erkennende pgsql Installation vorausgesetzt.
| |
Änderung: 2.0.0 Diese Funktion wurde zwecks Abwärtskompatibilität eingeführt. Seit geometry_columns ein View auf den Systemkatalog ist, können Sie eine Tabelle mit einer Geometriespalte, so wie jede andere Tabelle, mit |
Name
Find_SRID — Returns the SRID defined for a geometry column.
Synopsis
text Populate_Geometry_Columns(boolean use_typmod=true);
int Populate_Geometry_Columns(oid relation_oid, boolean use_typmod=true);
Beschreibung
Returns the integer SRID of the specified geometry column by searching through the GEOMETRY_COLUMNS table. If the geometry column has not been properly added (e.g. with the AddGeometryColumn function), this function will not work.
Name
Populate_Geometry_Columns — Ensures geometry columns are defined with type modifiers or have appropriate spatial constraints.
Synopsis
text Populate_Geometry_Columns(boolean use_typmod=true);
int Populate_Geometry_Columns(oid relation_oid, boolean use_typmod=true);
Beschreibung
Sorgt dafür, dass die Geometriespalten mit Typmodifikatoren oder mit passenden räumlichen Constraints versehen sind. Dadurch wird die korrekte Registrierung im View geometry_columns sichergestellt. Standardmäßig werden alle Geometriespalten, die keinen Typmodifikator aufweisen, mit Typmodifikatoren versehen. Für die alte Verhaltensweise setzen Sie bitte use_typmod=false
Aus Gründen der Abwärtskompatibilität und für räumliche Anwendungen, wie eine Tabellenvererbung bei denen jede Kindtabelle einen anderen geometrischen Datentyp aufweist, wird die alte Verhaltensweise mit Check-Constraints weiter unterstützt. Wenn Sie diese alte Verhaltensweise benötigen, können Sie den neuen Übergabewert auf FALSE setzen - use_typmod=false. Wenn Sie dies tun, so werden die Geometriespalten anstelle von Typmodifikatoren mit 3 Constraints erstellt. Insbesondere bedeutet dies, dass jede Geometriespalte, die zu einer Tabelle gehört, mindestens drei Constraints aufweist:
enforce_dims_the_geom- stellt sicher, dass jede Geometrie dieselbe Dimension hat (siehe ST_NDims)enforce_geotype_the_geom- stellt sicher, dass jede Geometrie vom selben Datentyp ist (siehe GeometryType)enforce_srid_the_geom- stellt sicher, dass jede Geometrie die selbe Projektion hat (siehe ???)
Wenn die oid einer Tabelle übergeben wird, so versucht diese Funktion, die SRID, die Dimension und den Datentyp der Geometrie in der Tabelle zu bestimmen und fügt, falls notwendig, Constraints hinzu. Bei Erfolg wird eine entsprechende Spalte in die Tabelle "geometry_columns" eingefügt, andernfalls wird der Fehler abgefangen und eine Fehlermeldung ausgegeben, die das Problem beschreibt.
Wenn die oid eines Views übergeben wird, so versucht diese Funktion, die SRID, die Dimension und den Datentyp der Geometrie in dem View zu bestimmen und die entsprechenden Einträge in die Tabelle geometry_columns vorzunehmen. Constraints werden allerdings nicht erzwungen.
Die parameterlose Variante ist ein einfacher Adapter für die parametrisierte Variante, welche die Tabelle "geometry_columns" zuerst entleert und dann für jede räumliche Tabelle oder View in der Datenbank wiederbefüllt. Wo es passend ist, werden räumliche Constraints auf die Tabellen gelegt. Es wird die Anzahl der in der Datenbank gefundenen Geometriespalten und die Anzahl der in die Tabelle geometry_columns eingefügten Zeilen ausgegeben. Die parametrisierte Version gibt lediglich die Anzahl der Zeilen aus, die in die Tabelle geometry_columns eingefügt wurden.
Verfügbarkeit: 1.4.0
Änderung: 2.0.0 Standardmäßig werden nun Typmodifikatoren anstelle von Check-Constraints für die Beschränkung des Geometrietyps verwendet. Sie können nach wie vor stattdessen die Verhaltensweise mit Check-Constraints verwenden, indem Sie die neu eingeführte Variable use_typmod auf FALSE setzen.
Erweiterung: 2.0.0 Der optionale Übergabewert use_typmod wurde eingeführt, um bestimmen zu können, ob die Spalten mit Typmodifikatoren oder mit Check-Constraints erstellt werden sollen.
Beispiele
CREATE TABLE public.myspatial_table(gid serial, geom geometry);
INSERT INTO myspatial_table(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, 3 4)',4326) );
-- Hier werden nun Typmodifikatoren verwendet. Damit dies funktioniert, müssen Daten vorhanden sein
SELECT Populate_Geometry_Columns('public.myspatial_table'::regclass);
populate_geometry_columns
--------------------------
1
\d myspatial_table
Table "public.myspatial_table"
Column | Type | Modifiers
--------+---------------------------+---------------------------------------------------------------
gid | integer | not null default nextval('myspatial_table_gid_seq'::regclass)
geom | geometry(LineString,4326) |
-- Dies stellt die Geometriespalten auf die Verwendung von Constraints um. Allerdings nur, wenn sie sich nicht in typmod befinden oder nicht bereits Constraints aufweisen.
-- Damit dies funktioniert müssen Daten vorhanden sein
CREATE TABLE public.myspatial_table_cs(gid serial, geom geometry);
INSERT INTO myspatial_table_cs(geom) VALUES(ST_GeomFromText('LINESTRING(1 2, 3 4)',4326) );
SELECT Populate_Geometry_Columns('public.myspatial_table_cs'::regclass, false);
populate_geometry_columns
--------------------------
1
\d myspatial_table_cs
Table "public.myspatial_table_cs"
Column | Type | Modifiers
--------+----------+------------------------------------------------------------------
gid | integer | not null default nextval('myspatial_table_cs_gid_seq'::regclass)
geom | geometry |
Check constraints:
"enforce_dims_geom" CHECK (st_ndims(geom) = 2)
"enforce_geotype_geom" CHECK (geometrytype(geom) = 'LINESTRING'::text OR geom IS NULL)
"enforce_srid_geom" CHECK (st_srid(geom) = 4326)Name
UpdateGeometrySRID — Updates the SRID of all features in a geometry column, and the table metadata.
Synopsis
text UpdateGeometrySRID(varchar table_name, varchar column_name, integer srid);
text UpdateGeometrySRID(varchar schema_name, varchar table_name, varchar column_name, integer srid);
text UpdateGeometrySRID(varchar catalog_name, varchar schema_name, varchar table_name, varchar column_name, integer srid);
Beschreibung
Erneuert die SRID aller Features in einer Geometriespalte; erneuert die Constraints und die Referenz in "geometry_columns". Anmerkung: verwendet current_schema() wenn kein Schema angegeben wird, eine Schema erkennende pgsql Installation vorausgesetzt.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
Insert geometries into roads table with a SRID set already using EWKT format:
COPY roads (geom) FROM STDIN;
SRID=4326;LINESTRING(0 0, 10 10)
SRID=4326;LINESTRING(10 10, 15 0)
\.
Ändert die SRID der Straßentabelle auf 4326
SELECT UpdateGeometrySRID('roads','geom',4326);Das vorhergegangene Beispiel ist gleichbedeutend mit diesr DDL Anweisung
ALTER TABLE roads
ALTER COLUMN geom TYPE geometry(MULTILINESTRING, 4326)
USING ST_SetSRID(geom,4326);Falls Sie sich in der Projektion geirrt haben (oder sie als "unknown" importiert haben) und sie in einem Aufwaschen in die Web Mercator Projektion transformieren wollen, so können Sie dies mit DDL bewerkstelligen. Es gibt jedoch keine äquivalente PostGIS Managementfunktion, die dies in einem Schritt bewerkstelligen könnte.
ALTER TABLE roads ALTER COLUMN geom TYPE geometry(MULTILINESTRING, 3857) USING ST_Transform(ST_SetSRID(geom,4326),3857) ;
- ST_GeomCollFromText — 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 — Gibt einen ST_Point mit den gegebenen Koordinatenwerten aus. Ein OGC-Alias für ST_MakePoint.
- ST_Polygon — Creates a Polygon from a LineString with a specified SRID.
- ST_MakeEnvelope — Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.
Name
ST_GeomCollFromText — Creates a GeometryCollection or Multi* geometry from a set of geometries.
Synopsis
geometry ST_GeomFromGeoJSON(text geomjson);
geometry ST_GeomFromGeoJSON(json geomjson);
geometry ST_GeomFromGeoJSON(jsonb geomjson);
Beschreibung
Collects geometries into a geometry collection. The result is either a Multi* or a GeometryCollection, depending on whether the input geometries have the same or different types (homogeneous or heterogeneous). The input geometries are left unchanged within the collection.
Variant 1: accepts two input geometries
Variant 2: accepts an array of geometries
Variant 3: aggregate function accepting a rowset of geometries.
| |
If any of the input geometries are collections (Multi* or GeometryCollection) ST_Collect returns a GeometryCollection (since that is the only type which can contain nested collections). To prevent this, use ST_Dump in a subquery to expand the input collections to their atomic elements (see example below). |
| |
ST_Collect and ST_Union appear similar, but in fact operate quite differently. ST_Collect aggregates geometries into a collection without changing them in any way. ST_Union geometrically merges geometries where they overlap, and splits linestrings at intersections. It may return single geometries when it dissolves boundaries. |
Verfügbarkeit: 1.4.0 - ST_MakeLine(geomarray) wurde eingeführt. ST_MakeLine Aggregatfunktion wurde verbessert, um mehr Punkte schneller handhaben zu können.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele - Verwendung von XLink
Collect 2D points.
SELECT ST_AsText( ST_Collect( ST_GeomFromText('POINT(1 2)'),
ST_GeomFromText('POINT(-2 3)') ));
st_astext
----------
MULTIPOINT(1 2,-2 3)
Collect 3D points.
SELECT ST_AsEWKT( ST_Collect( ST_GeomFromEWKT('POINT(1 2 3)'),
ST_GeomFromEWKT('POINT(1 2 4)') ) );
st_asewkt
-------------------------
MULTIPOINT(1 2 3,1 2 4)
Collect curves.
SELECT ST_AsText( ST_Collect( 'CIRCULARSTRING(220268 150415,220227 150505,220227 150406)',
'CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)'));
st_astext
------------------------------------------------------------------------------------
MULTICURVE(CIRCULARSTRING(220268 150415,220227 150505,220227 150406),
CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))
Beispiele: Verwendung der Feld-Version
Using an array constructor for a subquery.
SELECT ST_Collect( ARRAY( SELECT the_geom FROM sometable ) );
Using an array constructor for values.
SELECT ST_AsText( ST_Collect(
ARRAY[ ST_GeomFromText('LINESTRING(1 2, 3 4)'),
ST_GeomFromText('LINESTRING(3 4, 4 5)') ] )) As wktcollect;
--wkt collect --
MULTILINESTRING((1 2,3 4),(3 4,4 5))
Name
ST_LineFromMultiPoint — Erzeugt einen LineString aus einer MultiPoint Geometrie.
Synopsis
geometry ST_LineFromMultiPoint(geometry aMultiPoint);
Beschreibung
Erzeugt einen LineString aus einer MultiPoint Geometrie.
Für Punkt mit X-, Y- und M-Koordinaten verwenden Sie bitte ST_MakePointM .
This function supports 3d and will not drop the z-index.
Name
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.
Synopsis
geometry ST_MakeEnvelope(double precision xmin, double precision ymin, double precision xmax, double precision ymax, integer srid=unknown);
Beschreibung
Erzeugt ein rechteckiges Polygon das durch die Minima und Maxima angegeben wird. durch die gegebene Hülle. Die Eingabewerte müssen in dem Koordinatenreferenzsystem sein, welches durch die SRID angegeben wird. Wenn keine SRID angegeben ist, so wird das Koordinatenreferenzsystem "unknown" angenommen
Verfügbarkeit: 1.5
Erweiterung: 2.0: es wurde die Möglichkeit eingeführt, eine Einhüllende/Envelope festzulegen, ohne dass die SRID spezifiziert ist.
Name
ST_MakeLine — Erzeugt einen Linienzug aus einer Punkt-, Mehrfachpunkt- oder Liniengeometrie.
Synopsis
geometry ST_MakeLine(geometry set geoms);
geometry ST_MakeLine(geometry geom1, geometry geom2);
geometry ST_MakeLine(geometry[] geoms_array);
Beschreibung
Creates a LineString containing the points of Point, MultiPoint, or LineString geometries. Other geometry types cause an error.
Variant 1: accepts two input geometries
Variant 2: accepts an array of geometries
Variant 3: aggregate function accepting a rowset of geometries. To ensure the order of the input geometries use ORDER BY in the function call, or a subquery with an ORDER BY clause.
Repeated nodes at the beginning of input LineStrings are collapsed to a single point. Repeated points in Point and MultiPoint inputs are not collapsed. ST_RemoveRepeatedPoints can be used to collapse repeated points from the output LineString.
This function supports 3d and will not drop the z-index.
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung zur Eingabe von MultiPoint Elementen eingeführt
Verfügbarkeit: 2.0.0 - Unterstützung zur Eingabe von LineString Elementen eingeführt
Verfügbarkeit: 1.4.0 - ST_MakeLine(geomarray) wurde eingeführt. ST_MakeLine Aggregatfunktion wurde verbessert, um mehr Punkte schneller handhaben zu können.
Beispiele: Verwendung der Feld-Version
Create a line composed of two points.
SELECT ST_AsText( ST_MakeLine(ST_MakePoint(1,2), ST_MakePoint(3,4)) );
st_astext
---------------------
LINESTRING(1 2,3 4)
Erzeugt eine BOX3D, die durch 2 geometrische 3D-Punkte definiert wird.
SELECT ST_AsEWKT( ST_MakeLine(ST_MakePoint(1,2,3), ST_MakePoint(3,4,5) ));
st_asewkt
-------------------------
LINESTRING(1 2 3,3 4 5)
Erzeugt einen Linienzug aus einer Punkt-, Mehrfachpunkt- oder Liniengeometrie.
select ST_AsText( ST_MakeLine( 'LINESTRING(0 0, 1 1)', 'LINESTRING(2 2, 3 3)' ) );
st_astext
-----------------------------
LINESTRING(0 0,1 1,2 2,3 3)
Beispiele: Verwendung der Feld-Version
Create a line from an array formed by a subquery with ordering.
SELECT ST_MakeLine( ARRAY( SELECT ST_Centroid(the_geom) FROM visit_locations ORDER BY visit_time) );
Create a 3D line from an array of 3D points
SELECT ST_MakeLine(ARRAY(SELECT ST_Centroid(the_geom) FROM visit_locations ORDER BY visit_time));
--Making a 3d line with 3 3-d points
SELECT ST_AsEWKT(ST_MakeLine(ARRAY[ST_MakePoint(1,2,3),
ST_MakePoint(3,4,5), ST_MakePoint(6,6,6)]));
st_asewkt
-------------------------
LINESTRING(1 2 3,3 4 5,6 6 6)
Beispiele: Spatiale Aggregatversion
Diese Beispiel nimmt eine Abfolge von GPS Punkten entgegen und erzeugt einen Datensatz für jeden GPS Pfad, wobei das Geometriefeld ein Linienzug ist, welcher in der Reihenfolge der Aufnahmeroute aus den GPS Punkten zusammengesetzt wird.
Using aggregate ORDER BY provides a correctly-ordered linestring.
SELECT gps.track_id, ST_MakeLine(gps.geom ORDER BY gps_time) As geom
FROM gps_points As gps
GROUP BY track_id;Prior to PostgreSQL 9, ordering in a subquery can be used. However, sometimes the query plan may not respect the order of the subquery.
-- Bei Vorgängerversionen von PostgreSQL 9.0 funktioniert dies üblicherweise,
-- allerdings kann es der Anfrageoptimierer gelegentlich vorziehen, die Reihenfolge der Unterabfrage zu missachten.
SELECT gps.gps_track, ST_MakeLine(gps.the_geom) As newgeom
FROM (SELECT gps_track,gps_time, the_geom
FROM gps_points ORDER BY gps_track, gps_time) As gps
GROUP BY gps.gps_track;Name
ST_MakePoint — Erzeugt eine 2D-, 3DZ- oder 4D-Punktgeometrie.
Synopsis
geometry ST_Point(float x_lon, float y_lat);
geometry ST_MakePointM(float x, float y, float m);
geometry ST_MakePoint(double precision x, double precision y, double precision z, double precision m);
Beschreibung
Erzeugt eine 2D-, 3DZ- oder 4D-Punktgeometrie.
Für Punkt mit X-, Y- und M-Koordinaten verwenden Sie bitte ST_MakePointM .
Erzeugt eine 2D-, 3DZ- oder 4D-Punktgeometrie (Geometrie mit Kilometrierung). ST_MakePoint ist zwar nicht OGC-konform, ist aber im Allgemeinen schneller und genauer als ??? oder??? und auch leichter anzuwenden wenn Sie mit rohen Koordinaten anstatt mit WKT arbeiten.
| |
For geodetic coordinates, |
This function supports 3d and will not drop the z-index.
Beispiele
--Gibt einen Punkt mit unbekannter SRID aus SELECT ST_MakePoint(-71.1043443253471, 42.3150676015829); --Gibt einen Punkt in geographischer Länge und Breite im WGS84 aus SELECT ST_SetSRID(ST_MakePoint(-71.1043443253471, 42.3150676015829),4326); --Gibt einen 3D-Punkt zurück (z.B.: wenn der Punkt eine Höhe aufweist) SELECT ST_MakePoint(1, 2,1.5); --Gibt die Z-Koordinate des Punktes zurück SELECT ST_Z(ST_MakePoint(1, 2,1.5)); result ------- 1.5
Name
ST_MakePointM — Erzeugt einen Punkt mit x, y und measure/Kilometrierungs Koordinaten.
Synopsis
geometry ST_MakePointM(float x, float y, float m);
Beschreibung
Erzeugt einen Punkt mit x, y und measure/Kilometrierungs Koordinaten.
Für Punkt mit X-, Y- und M-Koordinaten verwenden Sie bitte ST_MakePointM .
| |
For geodetic coordinates, |
Beispiele
Create point with unknown SRID.
SELECT ST_AsEWKT( ST_MakePointM(-71.1043443253471, 42.3150676015829, 10) );
st_asewkt
-----------------------------------------------
POINTM(-71.1043443253471 42.3150676015829 10)
Erzeugt einen Punkt mit x, y und measure/Kilometrierungs Koordinaten.
SELECT ST_AsEWKT( ST_SetSRID( ST_MakePointM(-71.104, 42.315, 10), 4326));
st_asewkt
---------------------------------------------------------
SRID=4326;POINTM(-71.104 42.315 10)
Get measure of created point.
SELECT ST_M( ST_MakePointM(-71.104, 42.315, 10) ); result ------- 10
Name
ST_MakePolygon — Creates a Polygon from a shell and optional list of holes.
Synopsis
geometry ST_MakePolygon(geometry linestring);
geometry ST_MakePolygon(geometry outerlinestring, geometry[] interiorlinestrings);
Beschreibung
Erzeugt ein Polygon, das durch die gegebene Hülle gebildet wird. Die Eingabegeometrie muss aus geschlossenen Linienzügen bestehen.
Variant 1: Accepts one shell LineString.
Variant 2: Accepts a shell LineString and an array of inner (hole) LineStrings. A geometry array can be constructed using the PostgreSQL array_agg(), ARRAY[] or ARRAY() constructs.
| |
Diese Funktion akzeptiert keine MULTILINESTRINGs. Verwenden Sie bitte ST_LineMerge oder ST_Dump um Linienzüge zu erzeugen. |
This function supports 3d and will not drop the z-index.
Beispiele: Verwendung der Feld-Version
Erzeugt einen LineString aus einem codierten Linienzug.
SELECT ST_MLineFromText('MULTILINESTRING((1 2, 3 4), (4 5, 6 7))');
Create a Polygon from an open LineString, using ST_StartPoint and ST_AddPoint to close it.
SELECT ST_MakePolygon( ST_AddPoint(foo.open_line, ST_StartPoint(foo.open_line)) )
FROM (
SELECT ST_GeomFromText('LINESTRING(75 29,77 29,77 29, 75 29)') As open_line) As foo;
Erzeugt einen LineString aus einem codierten Linienzug.
SELECT ST_AsEWKT( ST_MakePolygon( 'LINESTRING(75.15 29.53 1,77 29 1,77.6 29.5 1, 75.15 29.53 1)')); st_asewkt ----------- POLYGON((75.15 29.53 1,77 29 1,77.6 29.5 1,75.15 29.53 1))
Create a Polygon from a LineString with measures
SELECT ST_AsEWKT( ST_MakePolygon( 'LINESTRINGM(75.15 29.53 1,77 29 1,77.6 29.5 2, 75.15 29.53 2)' )); st_asewkt ---------- POLYGONM((75.15 29.53 1,77 29 1,77.6 29.5 2,75.15 29.53 2))
Beispiele: Außenhülle mit inneren Ringen
Erzeugung eines Donuts mit einem Ameisenloch
SELECT ST_MakePolygon(
ST_ExteriorRing(ST_Buffer(foo.line,10)),
ARRAY[ST_Translate(foo.line,1,1),
ST_ExteriorRing(ST_Buffer(ST_MakePoint(20,20),1)) ]
)
FROM
(SELECT ST_ExteriorRing(ST_Buffer(ST_MakePoint(10,10),10,10))
As line )
As foo;
Ausgehend von Polygonen/Mehrfachpolygonen der Provinz und Linienzügen für die Gewässer werden die Landesgrenzen erzeugt, wobei Lücken die Seen des Gebietes darstellen. Dies ist ein Beispiel für die Verwendung von ST_Accum in PostGIS.
| |
Das Konstrukt mit CASE wird verwendet, da die Übergabe eines NULL-Feldes an ST_MakePolygon NULL ergibt. |
SELECT p.gid, p.province_name,
CASE WHEN array_agg(w.the_geom) IS NULL
THEN p.the_geom
ELSE ST_MakePolygon( ST_LineMerge(ST_Boundary(p.the_geom)), array_agg(w.the_geom)) END
FROM
provinces p LEFT JOIN waterlines w
ON (ST_Within(w.the_geom, p.the_geom) AND ST_IsClosed(w.the_geom))
GROUP BY p.gid, p.province_name, p.the_geom;
Another technique is to utilize a correlated subquery and the ARRAY() constructor that converts a row set to an array.
SELECT p.gid, p.province_name,
CASE WHEN
ST_Accum(w.the_geom) IS NULL THEN p.the_geom
ELSE ST_MakePolygon(ST_LineMerge(ST_Boundary(p.the_geom)), ST_Accum(w.the_geom)) END
FROM
provinces p LEFT JOIN waterlines w
ON (ST_Within(w.the_geom, p.the_geom) AND ST_IsClosed(w.the_geom))
GROUP BY p.gid, p.province_name, p.the_geom;
--Gleiches Beispiel wie oben, nur mit einer korrespondierenden Unterabfrage
--und der PostgreSQL interen ARRAY() Funktion, welche eine Menge von Zeilen in ein Feld/Array umwandelt
SELECT p.gid, p.province_name, CASE WHEN
EXISTS(SELECT w.the_geom
FROM waterlines w
WHERE ST_Within(w.the_geom, p.the_geom)
AND ST_IsClosed(w.the_geom))
THEN
ST_MakePolygon(ST_LineMerge(ST_Boundary(p.the_geom)),
ARRAY(SELECT w.the_geom
FROM waterlines w
WHERE ST_Within(w.the_geom, p.the_geom)
AND ST_IsClosed(w.the_geom)))
ELSE p.the_geom END As the_geom
FROM
provinces p;
Name
ST_Point — Gibt einen ST_Point mit den gegebenen Koordinatenwerten aus. Ein OGC-Alias für ST_MakePoint.
Synopsis
geometry ST_Point(float x_lon, float y_lat);
Beschreibung
Gibt einen ST_Point mit den gegebenen Koordinatenwerten aus. Ein SQL/MM kompatibler Alias für ST_MakePoint, der nur ein X und ein Y entgegennimmt.
| |
For geodetic coordinates, |
This method implements the SQL/MM specification. SQL-MM 3: 6.1.2
Beispiele: Geographie
SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) As geography);
PostgreSQL also provides the :: short-hand for casting
SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) As geography);
If the point coordinates are not in a geodetic coordinate system (such as WGS84), then they must be reprojected before casting to a geography. In this example a point in Pennsylvania State Plane feet (SRID 2273) is projected to WGS84 (SRID 4326).
SELECT CAST(ST_SetSRID(ST_Point(-71.1043443253471, 42.3150676015829),4326) As geography);
Name
ST_Polygon — Creates a Polygon from a LineString with a specified SRID.
Synopsis
geometry ST_Polygon(geometry aLineString, integer srid);
Beschreibung
Returns a polygon built from the given LineString and sets the spatial reference system from the srid.
ST_Polygon is similar to ST_MakePolygon Variant 1 with the addition of setting the SRID.
, ST_MakePoint, ???
| |
Diese Funktion akzeptiert keine MULTILINESTRINGs. Verwenden Sie bitte ST_LineMerge oder ST_Dump um Linienzüge zu erzeugen. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 8.3.2
This function supports 3d and will not drop the z-index.
Beispiele
Create a 2D polygon.
SELECT ST_AsText( ST_Polygon('LINESTRING(75 29, 77 29, 77 29, 75 29)'::geometry, 4326) );
-- result --
POLYGON((75 29, 77 29, 77 29, 75 29))
Create a 3D polygon.
SELECT ST_AsEWKT( ST_Polygon( ST_GeomFromEWKT('LINESTRING(75 29 1, 77 29 2, 77 29 3, 75 29 1)'), 4326) );
-- result --
SRID=4326;POLYGON((75 29 1, 77 29 2, 77 29 3, 75 29 1))
Name
ST_MakeEnvelope — Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system.
Synopsis
geometry ST_MakePoint(double precision x, double precision y, double precision z, double precision m);
Beschreibung
Creates a rectangular Polygon in Web Mercator (SRID:3857) using the XYZ tile system. By default, the bounds are the in EPSG:3857 using the standard range of the Web Mercator system (-20037508.342789, 20037508.342789). The optional bounds parameter can be used to generate envelopes for any tiling scheme: provide a geometry that has the SRID and extent of the initial "zoom level zero" square within which the tile system is to be inscribed.
Verfügbarkeit: 2.1.0
Beispiel: Ein Umgebungsrechteck Polygon erzeugen
SELECT ST_AsText( ST_TileEnvelope(2, 1, 1) );
st_astext
------------------------------
POLYGON((-10018754.1713945 0,-10018754.1713945 10018754.1713945,0 10018754.1713945,0 0,-10018754.1713945 0))
SELECT ST_AsText( ST_TileEnvelope(3, 1, 1, ST_MakeEnvelope(-180, -90, 180, 90, 4326) ) );
st_astext
------------------------------------------------------
POLYGON((-135 45,-135 67.5,-90 67.5,-90 45,-135 45))
- 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_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_dumprows for the components of a geometry. - ST_NumPoints — Returns a set of
geometry_dumprows for the points in a geometry. - ST_NRings — Returns a set of
geometry_dumprows 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_BoundingDiagonal — Gibt die Diagonale des Umgebungsdreiecks der angegebenen Geometrie zurück.
- 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_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_IsClosed — Gibt den Wert
TRUEzurück, wenn die Anfangs- und Endpunkte desLINESTRING'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_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.
Name
GeometryType — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
Synopsis
text GeometryType(geometry geomA);
Beschreibung
Gibt den Geometrietyp als Zeichenkette zurück. z.B.: 'LINESTRING', 'POLYGON', 'MULTIPOINT', etc.
OGC SPEC s2.1.1.1 - Gibt den Namen des instanziierbaren Subtyps der Geometrie zurück, von dem die geometrische Instanz ein Mitglied ist. Der Name des instanziierbaren Subtyps der Geometrie wird als Zeichenkette ausgegeben.
| |
Die Funktion zeigt auch an ob die Geometrie eine Maßzahl aufweist, indem eine Zeichenkette wie 'POINTM' zurückgegeben wird. |
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method supports Circular Strings and Curves
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
SELECT GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
geometrytype
--------------
LINESTRING
SELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
--result
POLYHEDRALSURFACE
SELECT GeometryType(geom) as result
FROM
(SELECT
ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)') AS geom
) AS g;
result
--------
TIN Name
ST_Boundary — Gibt die abgeschlossene Hülle aus der kombinierten Begrenzung der Geometrie zurück.
Synopsis
geometry ST_Boundary(geometry geomA);
Beschreibung
Gibt die abgeschlossene Hülle aus der kombinierten Begrenzung der Geometrie zurück. Die Definition der kombinierte Begrenzung ist in Abschnitt 3.12.3.2 der OGC SPEC beschrieben. Da das Ergebnis dieser Funktion eine abgeschlossene Hülle und daher topologisch geschlossen ist, kann die resultierende Begrenzung durch geometrische Primitive, wie in Abschnitt 3.12.2. der OGC SPEC erörtert, dargestellt werden.
Wird durch das GEOS Modul ausgeführt
| |
Vor 2.0.0 meldete diese Funktion einen Fehler, falls sie auf eine |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. OGC SPEC s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3: 5.1.14
This function supports 3d and will not drop the z-index.
Erweiterung: mit 2.1.0 wurde die Unterstützung von Dreiecken eingeführt
Beispiele
 Linienzug mit überlagerten Begrenzungspunkten
SELECT ST_Boundary(geom)
FROM (SELECT 'LINESTRING(100 150,50 60, 70 80, 160 170)'::geometry As geom) As f;
-- Ausgabe als ST_AsText MULTIPOINT(100 150,160 170)
|  Polygon mit Lücke und der Abgrenzung/Boundary als Multilinestring
SELECT ST_Boundary(geom)
FROM (SELECT
'POLYGON (( 10 130, 50 190, 110 190, 140 150, 150 80, 100 10, 20 40, 10 130 ),
( 70 40, 100 50, 120 80, 80 110, 50 90, 70 40 ))'::geometry As geom) As f;
-- Ausgabe als ST_AsText
MULTILINESTRING((10 130,50 190,110 190,140 150,150 80,100 10,20 40,10 130),
(70 40,100 50,120 80,80 110,50 90,70 40))
|
SELECT ST_AsText(ST_Boundary(ST_GeomFromText('LINESTRING(1 1,0 0, -1 1)')));
st_astext
-----------
MULTIPOINT(1 1,-1 1)
SELECT ST_AsText(ST_Boundary(ST_GeomFromText('POLYGON((1 1,0 0, -1 1, 1 1))')));
st_astext
----------
LINESTRING(1 1,0 0,-1 1,1 1)
--Verwendung eines 3D Polygons
SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('POLYGON((1 1 1,0 0 1, -1 1 1, 1 1 1))')));
st_asewkt
-----------------------------------
LINESTRING(1 1 1,0 0 1,-1 1 1,1 1 1)
--Verwendung eines 3D Multilinestrings
SELECT ST_AsEWKT(ST_Boundary(ST_GeomFromEWKT('MULTILINESTRING((1 1 1,0 0 0.5, -1 1 1),(1 1 0.5,0 0 0.5, -1 1 0.5, 1 1 0.5) )')));
st_asewkt
----------
MULTIPOINT(-1 1 1,1 1 0.75)
Name
ST_CoordDim —
Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
Synopsis
integer ST_CoordDim(geometry geomA);
Beschreibung
Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
Dies ist der MM konforme Alias für ST_NDims
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 5.1.3
This method supports Circular Strings and Curves
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Name
ST_Dimension —
Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
Synopsis
integer ST_Dimension(geometry g);
Beschreibung
Die inhärente Dimension eines geometrischen Objektes, welche kleiner oder gleich der Dimension der Koordinaten sein muss. Nach OGC SPEC s2.1.1.1 wird 0 für POINT, 1 für LINESTRING, 2 for POLYGON, und die größte Dimension der Teile einer GEOMETRYCOLLECTION zurückgegeben. Wenn die Dimension nicht bekannt ist (leereGEOMETRYCOLLECTION) wird 0 zurückgegeben.
This method implements the SQL/MM specification. SQL-MM 3: 5.1.2
Erweiterung: 2.0.0 - Unterstützung für polyedrische Oberflächen und TIN eingeführt.
| |
Vor 2.0.0 meldete diese Funktion einen Fehler, falls sie auf eine leere Geometrie angewandt wurde. |
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Name
ST_Dump — Returns a set of geometry_dump rows for the components of a geometry.
Synopsis
geometry ST_Envelope(geometry g1);
Beschreibung
This is a set-returning function (SRF). It returns a set of geometry_dump rows, formed by a geometry (geom) and an array of integers (path). When the input geometry is a simple type (POINT,LINESTRING,POLYGON) a single record will be returned with an empty path array and the input geometry as geom. When the input geometry is a collection or multi it will return a record for each of the collection components, and the path will express the position of the component inside the collection.
ST_Dump is useful for expanding geometries. It is the reverse of a GROUP BY in that it creates new rows. For example it can be use to expand MULTIPOLYGONS into POLYGONS.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
Availability: PostGIS 1.0.0RC1. Requires PostgreSQL 7.3 or higher.
| |
Vor 1.3.4 ist diese Funktion abgestürzt, wenn die Geometrien CURVES enthalten. Dies wurde mit 1.3.4+ behoben |
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Standard Beispiele
SELECT sometable.field1, sometable.field1,
(ST_Dump(sometable.the_geom)).geom AS the_geom
FROM sometable;
-- Break a compound curve into its constituent linestrings and circularstrings
SELECT ST_AsEWKT(a.geom), ST_HasArc(a.geom)
FROM ( SELECT (ST_Dump(p_geom)).geom AS geom
FROM (SELECT ST_GeomFromEWKT('COMPOUNDCURVE(CIRCULARSTRING(0 0, 1 1, 1 0),(1 0, 0 1))') AS p_geom) AS b
) AS a;
st_asewkt | st_hasarc
-----------------------------+----------
CIRCULARSTRING(0 0,1 1,1 0) | t
LINESTRING(1 0,0 1) | f
(2 rows)Beispiele für polyedrische Oberflächen, TIN und Dreieck
-- Beispiel für eine polyedrische Oberfläche
-- Auftrennung einer polyedrischen Oberfläche in Teilflächen/Faces
SELECT ST_AsEWKT(ST_GeometryN(p_geom,3)) As geom_ewkt
FROM (SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE(
((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1))
)') AS p_geom ) AS a;
geom_ewkt
------------------------------------------
POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))-- TIN --
SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt
FROM
(SELECT
ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)') AS geom
) AS g;
-- result --
wkt
-------------------------------------
TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))
Name
ST_NumPoints — Returns a set of geometry_dump rows for the points in a geometry.
Synopsis
geometry ST_Points( geometry geom );
Beschreibung
This set-returning function (SRF) returns a set of geometry_dump rows formed by a geometry (geom) and an array of integers (path).
The geom component of geometry_dump are all the POINTs that make up the supplied geometry
The path component of geometry_dump (an integer[]) is an index reference enumerating the POINTs of the supplied geometry. For example, if a LINESTRING is supplied, a path of {i} is returned where i is the nth coordinate in the LINESTRING. If a POLYGON is supplied, a path of {i,j} is returned where i is the ring number (1 is outer; inner rings follow) and j enumerates the POINTs (again 1-based index).
Enhanced: 2.1.0 Faster speed. Reimplemented as native-C.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
Verfügbarkeit: 1.2.2
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Classic Explode a Table of LineStrings into nodes
SELECT edge_id, (dp).path[1] As index, ST_AsText((dp).geom) As wktnode
FROM (SELECT 1 As edge_id
, ST_DumpPoints(ST_GeomFromText('LINESTRING(1 2, 3 4, 10 10)')) AS dp
UNION ALL
SELECT 2 As edge_id
, ST_DumpPoints(ST_GeomFromText('LINESTRING(3 5, 5 6, 9 10)')) AS dp
) As foo;
edge_id | index | wktnode
---------+-------+--------------
1 | 1 | POINT(1 2)
1 | 2 | POINT(3 4)
1 | 3 | POINT(10 10)
2 | 1 | POINT(3 5)
2 | 2 | POINT(5 6)
2 | 3 | POINT(9 10)Standard Beispiele
SELECT path, ST_AsText(geom)
FROM (
SELECT (ST_DumpPoints(g.geom)).*
FROM
(SELECT
'GEOMETRYCOLLECTION(
POINT ( 0 1 ),
LINESTRING ( 0 3, 3 4 ),
POLYGON (( 2 0, 2 3, 0 2, 2 0 )),
POLYGON (( 3 0, 3 3, 6 3, 6 0, 3 0 ),
( 5 1, 4 2, 5 2, 5 1 )),
MULTIPOLYGON (
(( 0 5, 0 8, 4 8, 4 5, 0 5 ),
( 1 6, 3 6, 2 7, 1 6 )),
(( 5 4, 5 8, 6 7, 5 4 ))
)
)'::geometry AS geom
) AS g
) j;
path | st_astext
-----------+------------
{1,1} | POINT(0 1)
{2,1} | POINT(0 3)
{2,2} | POINT(3 4)
{3,1,1} | POINT(2 0)
{3,1,2} | POINT(2 3)
{3,1,3} | POINT(0 2)
{3,1,4} | POINT(2 0)
{4,1,1} | POINT(3 0)
{4,1,2} | POINT(3 3)
{4,1,3} | POINT(6 3)
{4,1,4} | POINT(6 0)
{4,1,5} | POINT(3 0)
{4,2,1} | POINT(5 1)
{4,2,2} | POINT(4 2)
{4,2,3} | POINT(5 2)
{4,2,4} | POINT(5 1)
{5,1,1,1} | POINT(0 5)
{5,1,1,2} | POINT(0 8)
{5,1,1,3} | POINT(4 8)
{5,1,1,4} | POINT(4 5)
{5,1,1,5} | POINT(0 5)
{5,1,2,1} | POINT(1 6)
{5,1,2,2} | POINT(3 6)
{5,1,2,3} | POINT(2 7)
{5,1,2,4} | POINT(1 6)
{5,2,1,1} | POINT(5 4)
{5,2,1,2} | POINT(5 8)
{5,2,1,3} | POINT(6 7)
{5,2,1,4} | POINT(5 4)
(29 rows)Beispiele für polyedrische Oberflächen, TIN und Dreieck
-- Polyhedral surface cube --
SELECT (g.gdump).path, ST_AsEWKT((g.gdump).geom) as wkt
FROM
(SELECT
ST_DumpPoints(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )') ) AS gdump
) AS g;
-- result --
path | wkt
---------+--------------
{1,1,1} | POINT(0 0 0)
{1,1,2} | POINT(0 0 1)
{1,1,3} | POINT(0 1 1)
{1,1,4} | POINT(0 1 0)
{1,1,5} | POINT(0 0 0)
{2,1,1} | POINT(0 0 0)
{2,1,2} | POINT(0 1 0)
{2,1,3} | POINT(1 1 0)
{2,1,4} | POINT(1 0 0)
{2,1,5} | POINT(0 0 0)
{3,1,1} | POINT(0 0 0)
{3,1,2} | POINT(1 0 0)
{3,1,3} | POINT(1 0 1)
{3,1,4} | POINT(0 0 1)
{3,1,5} | POINT(0 0 0)
{4,1,1} | POINT(1 1 0)
{4,1,2} | POINT(1 1 1)
{4,1,3} | POINT(1 0 1)
{4,1,4} | POINT(1 0 0)
{4,1,5} | POINT(1 1 0)
{5,1,1} | POINT(0 1 0)
{5,1,2} | POINT(0 1 1)
{5,1,3} | POINT(1 1 1)
{5,1,4} | POINT(1 1 0)
{5,1,5} | POINT(0 1 0)
{6,1,1} | POINT(0 0 1)
{6,1,2} | POINT(1 0 1)
{6,1,3} | POINT(1 1 1)
{6,1,4} | POINT(0 1 1)
{6,1,5} | POINT(0 0 1)
(30 rows)-- TIN --
SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt
FROM
(SELECT
ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)') AS geom
) AS g;
-- result --
wkt
-------------------------------------
TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))
-- TIN --
SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt
FROM
(SELECT
ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)') AS geom
) AS g;
-- result --
wkt
-------------------------------------
TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))
Name
ST_NRings — Returns a set of geometry_dump rows for the exterior and interior rings of a Polygon.
Synopsis
geometry ST_ExteriorRing(geometry a_polygon);
Beschreibung
This is a set-returning function (SRF). It returns a set of geometry_dump rows, defined as an integer[] and a geometry, aliased "path" and "geom" respectively. The "path" field holds the polygon ring index containing a single integer: 0 for the shell,
>0 for holes. The "geom" field contains the corresponding ring as a polygon.
Availability: PostGIS 1.1.3. Requires PostgreSQL 7.3 or higher.
| |
Dies funktioniert nicht mit MULTIPOLYGONen. Verwenden Sie die Funktion bitte in Zusammenhang mit ST_Dump um sie auf MULTIPOLYGONe anzuwenden. |
This function supports 3d and will not drop the z-index.
Beispiele
SELECT sometable.field1, sometable.field1,
(ST_DumpRings(sometable.the_geom)).geom As the_geom
FROM sometableOfpolys;
SELECT ST_AsEWKT(geom) As the_geom, path
FROM ST_DumpRings(
ST_GeomFromEWKT('POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,-8148941 5132466 1,-8148924 5132394 1,
-8148903 5132210 1,-8148930 5131967 1,-8148992 5131978 1,-8149237 5132093 1,-8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 1,
-8150305 5132788 1,-8149064 5133092 1),
(-8149362 5132394 1,-8149446 5132501 1,-8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 1))')
) as foo;
path | the_geom
----------------------------------------------------------------------------------------------------------------
{0} | POLYGON((-8149064 5133092 1,-8149064 5132986 1,-8148996 5132839 1,-8148972 5132767 1,-8148958 5132508 1,
| -8148941 5132466 1,-8148924 5132394 1,
| -8148903 5132210 1,-8148930 5131967 1,
| -8148992 5131978 1,-8149237 5132093 1,
| -8149404 5132211 1,-8149647 5132310 1,-8149757 5132394 1,-8150305 5132788 1,-8149064 5133092 1))
{1} | POLYGON((-8149362 5132394 1,-8149446 5132501 1,
| -8149548 5132597 1,-8149695 5132675 1,-8149362 5132394 1))Name
ST_EndPoint — Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
Synopsis
geometry ST_Points( geometry geom );
Beschreibung
Gibt den Endpunkt einer LINESTRING Geometrie als POINT oder NULL zurück, falls der Eingabewert nicht ein LINESTRING ist.
This method implements the SQL/MM specification. SQL-MM 3: 7.1.4
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
| |
Änderung: 2.0.0 unterstützt die Verarbeitung von MultiLinestring's die nur aus einer einzelnen Geometrie bestehen, nicht mehr. In früheren Versionen von PostGIS gab die Funktion bei einem aus einer einzelnen Linie bestehender MultiLinestring den Anfangspunkt zurück. Ab 2.0.0 gibt sie nur NULL zurück, so wie bei jedem anderen MultiLinestring. Die alte Verhaltensweise war undokumentiert, aber Anwender, die annahmen, dass Sie Ihre Daten als LINESTRING vorliegen haben, könnten in 2.0 dieses zurückgegebene NULL bemerken. |
Beispiele
postgis=# SELECT ST_AsText(ST_EndPoint('LINESTRING(1 1, 2 2, 3 3)'::geometry));
st_astext
------------
POINT(3 3)
(1 row)
postgis=# SELECT ST_EndPoint('POINT(1 1)'::geometry) IS NULL AS is_null;
is_null
----------
t
(1 row)
--3D Endpunkt
SELECT ST_AsEWKT(ST_EndPoint('LINESTRING(1 1 2, 1 2 3, 0 0 5)'));
st_asewkt
--------------
POINT(0 0 5)
(1 row)Name
ST_Envelope — Gibt eine Geometrie in doppelter Genauigkeit (float8) zurück, welche das Umgebungsrechteck der beigestellten Geometrie darstellt.
Synopsis
geometry ST_Envelope(geometry g1);
Beschreibung
Gibt das kleinstmögliche Umgebungsrechteck der bereitgestellten Geometrie als Geometrie im Float8-Format zurück. Das Polygon wird durch die Eckpunkte des Umgebungsrechteckes beschrieben ((MINX, MINY), (MINX, MAXY), (MAXX, MAXY), (MAXX, MINY), (MINX, MINY)). (PostGIS fügt auch die ZMIN/ZMAX Koordinaten hinzu).
Spezialfälle (vertikale Linien, Punkte) geben eine Geometrie geringerer Dimension zurück als POLYGON, insbesondere POINT oder LINESTRING.
Verfügbarkeit: 1.5.0 Änderung der Verhaltensweise insofern, das die Ausgabe in Double Precision anstelle von Float4 erfolgt
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3: 5.1.15
Beispiele
SELECT ST_AsText(ST_Envelope('POINT(1 3)'::geometry));
st_astext
------------
POINT(1 3)
(1 row)
SELECT ST_AsText(ST_Envelope('LINESTRING(0 0, 1 3)'::geometry));
st_astext
--------------------------------
POLYGON((0 0,0 3,1 3,1 0,0 0))
(1 row)
SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000001 1, 1.0000001 0, 0 0))'::geometry));
st_astext
--------------------------------------------------------------
POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
(1 row)
SELECT ST_AsText(ST_Envelope('POLYGON((0 0, 0 1, 1.0000000001 1, 1.0000000001 0, 0 0))'::geometry));
st_astext
--------------------------------------------------------------
POLYGON((0 0,0 1,1.00000011920929 1,1.00000011920929 0,0 0))
(1 row)
SELECT Box3D(geom), Box2D(geom), ST_AsText(ST_Envelope(geom)) As envelopewkt
FROM (SELECT 'POLYGON((0 0, 0 1000012333334.34545678, 1.0000001 1, 1.0000001 0, 0 0))'::geometry As geom) As foo;
Einhüllende von Punkt und Linienzug.
SELECT ST_AsText(ST_Envelope(
ST_Collect(
ST_GeomFromText('LINESTRING(55 75,125 150)'),
ST_Point(20, 80))
)) As wktenv;
wktenv
-----------
POLYGON((20 75,20 150,125 150,125 75,20 75))Name
ST_BoundingDiagonal — Gibt die Diagonale des Umgebungsdreiecks der angegebenen Geometrie zurück.
Synopsis
geometry ST_BoundingDiagonal(geometry geom, boolean fits=false);
Beschreibung
Gibt für eine angegebenen Geometrie die Diagonale des Umgebungsrechtecks als Linienzug zurück. Wenn die Geometrie leer ist, so ist auch die Diagonale Linie leer. Anderenfalls wird ein Linienzug aus 2 Punkten mit den kleinsten xy-Werten am Anfangspunkt und den größten xy-Werten am Endpunkt ausgegeben.
Die zurückgegebene Linienzug-Geometrie beinhaltet immer die SRID und die Dimensionalität (Anwesenheit von Z und M) der eingegebenen Geometrie.
Der fits Parameter bestimmt ob die bestmögliche Anpassung notwendig ist. Wenn er FALSE ist, so kann auch die Diagonale eines etwas größeren Umgebungsrechtecks akzeptiert werden (dies ist für Geometrien mit vielen Knoten schneller). Auf jeden Fall wird immer die gesamte Eingabegeometrie durch das von der Diagonale bestimmten Umgebungsrechtecks abgedeckt.
| |
Bei Spezialfällen (ein einzelner Knoten als Eingabewert) ist der zurückgegebene Linienzug topologisch ungültig (kein Inneres/Interior). Das Ergebnis ist dadurch jedoch nicht semantisch ungültig. |
Verfügbarkeit: 2.2.0
This function supports 3d and will not drop the z-index.
This function supports M coordinates.
Name
ST_ExteriorRing — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
Synopsis
geometry ST_ExteriorRing(geometry a_polygon);
Beschreibung
Gibt einen Linienzug zurück, welcher den äußeren Ring der POLYGON Geometrie darstellt. Gibt NULL zurück wenn es sich bei der Geometrie um kein Polygon handelt.
| |
Funktioniert nur mit dem Geometrietyp POLYGON |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. 2.1.5.1
This method implements the SQL/MM specification. SQL-MM 3: 8.2.3, 8.3.3
This function supports 3d and will not drop the z-index.
Beispiele
--Wenn Sie eine Tabelle mit Polygonen haben
SELECT gid, ST_ExteriorRing(the_geom) AS ering
FROM sometable;
--Wenn Sie eine Tabelle mit MULTIPOLYGONen haben
--und Sie wollen als Ergebnis einen MULTILINESTRING der aus Außenringen der Polygone zusammengesetzt ist
SELECT gid, ST_Collect(ST_ExteriorRing(the_geom)) AS erings
FROM (SELECT gid, (ST_Dump(the_geom)).geom As the_geom
FROM sometable) As foo
GROUP BY gid;
--3D Beispiel
SELECT ST_AsEWKT(
ST_ExteriorRing(
ST_GeomFromEWKT('POLYGON((0 0 1, 1 1 1, 1 2 1, 1 1 1, 0 0 1))')
)
);
st_asewkt
---------
LINESTRING(0 0 1,1 1 1,1 2 1,1 1 1,0 0 1)
Name
ST_GeometryN — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
Synopsis
geometry ST_GeometryN(geometry geomA, integer n);
Beschreibung
Gibt die auf 1-basierende n-te Geometrie zurück, wenn es sich bei der Geometrie um eine GEOMETRYCOLLECTION, (MULTI)POINT, (MULTI)LINESTRING, MULTICURVE oder (MULTI)POLYGON, POLYHEDRALSURFACE handelt. Anderenfalls wird NULL zurückgegeben.
| |
Seit Version 0.8.0 basiert der Index auf 1, so wie in der OGC Spezifikation. Vorhergegangene Versionen waren 0-basiert. |
| |
Falls Sie alle Geometrien einer Geometrie entnehmen wollen, so ist ST_Dump wesentlich leistungsfähiger und es funktioniert auch mit Einzelgeometrien. |
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
Änderung: 2.0.0 Vorangegangene Versionen geben bei Einzelgeometrien NULL zurück. Dies wurde geändert um die Geometrie für den ST_GeometrieN(..,1) Fall zurückzugeben.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 9.1.5
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Standard Beispiele
--Entnahme einer Teilmenge von Punkten aus einem 3D Multipoint
SELECT n, ST_AsEWKT(ST_GeometryN(the_geom, n)) As geomewkt
FROM (
VALUES (ST_GeomFromEWKT('MULTIPOINT(1 2 7, 3 4 7, 5 6 7, 8 9 10)') ),
( ST_GeomFromEWKT('MULTICURVE(CIRCULARSTRING(2.5 2.5,4.5 2.5, 3.5 3.5), (10 11, 12 11))') )
)As foo(the_geom)
CROSS JOIN generate_series(1,100) n
WHERE n <= ST_NumGeometries(the_geom);
n | geomewkt
---+-----------------------------------------
1 | POINT(1 2 7)
2 | POINT(3 4 7)
3 | POINT(5 6 7)
4 | POINT(8 9 10)
1 | CIRCULARSTRING(2.5 2.5,4.5 2.5,3.5 3.5)
2 | LINESTRING(10 11,12 11)
--Entnahme aller Geometrien (sinnvoll, wenn Sie einen Schlüssel/ID zuweisen wollen)
SELECT gid, n, ST_GeometryN(the_geom, n)
FROM sometable CROSS JOIN generate_series(1,100) n
WHERE n <= ST_NumGeometries(the_geom);Beispiele für polyedrische Oberflächen, TIN und Dreieck
-- Beispiel für eine polyedrische Oberfläche
-- Auftrennung einer polyedrischen Oberfläche in Teilflächen/Faces
SELECT ST_AsEWKT(ST_GeometryN(p_geom,3)) As geom_ewkt
FROM (SELECT ST_GeomFromEWKT('POLYHEDRALSURFACE(
((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1))
)') AS p_geom ) AS a;
geom_ewkt
------------------------------------------
POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0))-- TIN --
SELECT ST_AsEWKT(ST_GeometryN(geom,2)) as wkt
FROM
(SELECT
ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)') AS geom
) AS g;
-- result --
wkt
-------------------------------------
TRIANGLE((0 0 0,0 1 0,1 1 0,0 0 0))Name
ST_GeometryType — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
Synopsis
text ST_GeometryType(geometry g1);
Beschreibung
Gibt den Geometrietyp als Zeichenkette zurück. Z.B.: 'ST_Linestring', 'ST_Polygon','ST_MultiPolygon' etc. Diese Funktion unterscheidet sich von GeometryType(geometry) durch den Präfix ST_ und dadurch, das nicht angezeigt wird, ob die Geometrie eine Maßzahl besitzt.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
This method implements the SQL/MM specification. SQL-MM 3: 5.1.4
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Beispiele
SELECT ST_GeometryType(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
--result
ST_LineStringSELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
--result
ST_PolyhedralSurfaceSELECT ST_GeometryType(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
--result
ST_PolyhedralSurfaceSELECT ST_GeometryType(geom) as result
FROM
(SELECT
ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)') AS geom
) AS g;
result
--------
ST_Tin Name
ST_HasArc — Tests if a geometry contains a circular arc
Synopsis
boolean ST_IsEmpty(geometry geomA);
Beschreibung
Gibt den Wert TRUE zurück, falls es sich bei der Geometrie um eine leere GeometryCollection, Polygon, Point etc. handelt.
Verfügbarkeit: 1.2.2
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Name
ST_InteriorRingN — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
Synopsis
geometry ST_InteriorRingN(geometry a_polygon, integer n);
Beschreibung
Gibt den Nten innenliegenden Linienzug des Ringes der Polygongeometrie zurück. Gibt NULL zurück, falls es sich bei der Geometrie nicht um ein Polygon handelt, oder sich das angegebene N außerhalb des zulässigen Bereiches befindet. Der Zeiger beginnt mit der Zahl 1.
| |
Dies funktioniert nicht mit MULTIPOLYGONen. Verwenden Sie die Funktion bitte in Zusammenhang mit ST_Dump um sie auf MULTIPOLYGONe anzuwenden. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 8.2.6, 8.3.5
This function supports 3d and will not drop the z-index.
Name
ST_IsPolygonCCW — Gibt TRUE zurück, wenn alle äußeren Ringe gegen den Uhrzeigersinn orientiert sind und alle inneren Ringe im Uhrzeigersinn ausgerichtet sind.
Synopsis
boolean ST_IsPolygonCCW ( geometry geom );
Beschreibung
Gibt TRUE zurück, wenn für alle Bestandteile der angegebenen Geometrie gilt: die äußeren Ringe sind gegen den Uhrzeigersinn und die inneren Ringe im Uhrzeigersinn ausgerichtet.
Gibt TRUE zurück, wenn die Geometrie keine Polygonbestandteile aufweist.
| |
Da geschlossene Linienzüge nicht als Polygonbestandteile betrachtet werden, erhalten Sie auch dann TRUE, wenn Sie einen einzelnen geschlossenen Linienzug eingeben und zwar unabhängig von dessen Ausrichtung. |
| |
Wenn bei einer Polygongeometrie die inneren Ringe nicht entgegengesetzt orientiert sind (insbesondere, wenn einer oder mehrere innere Ringe die selbe Ausrichtung wie die äußeren Ringe haben), dann geben sowohl ST_IsPolygonCW als auch ST_IsPolygonCCW den Wert FALSE zurück. |
Verfügbarkeit: 2.2.0
This function supports 3d and will not drop the z-index.
This function supports M coordinates.
Name
ST_IsPolygonCW — Gibt den Wert TRUE zurück, wenn alle äußeren Ringe im Uhrzeigersinn und alle inneren Ringe gegen den Uhrzeigersinn ausgerichtet sind.
Synopsis
boolean ST_IsPolygonCW ( geometry geom );
Beschreibung
Gibt den Wert TRUE zurück, wenn für alle Polygonbestandteile der eingegebenen Geometrie gilt: die äußeren Ringe sind im Uhrzeigersinn orientiert, die inneren Ringe entgegen dem Uhrzeigersinn.
Gibt TRUE zurück, wenn die Geometrie keine Polygonbestandteile aufweist.
| |
Da geschlossene Linienzüge nicht als Polygonbestandteile betrachtet werden, erhalten Sie auch dann TRUE, wenn Sie einen einzelnen geschlossenen Linienzug eingeben und zwar unabhängig von dessen Ausrichtung. |
| |
Wenn bei einer Polygongeometrie die inneren Ringe nicht entgegengesetzt orientiert sind (insbesondere, wenn einer oder mehrere innere Ringe die selbe Ausrichtung wie die äußeren Ringe haben), dann geben sowohl ST_IsPolygonCW als auch ST_IsPolygonCCW den Wert FALSE zurück. |
Verfügbarkeit: 2.2.0
This function supports 3d and will not drop the z-index.
This function supports M coordinates.
Name
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.
Synopsis
boolean ST_IsClosed(geometry g);
Beschreibung
Gibt den Wert TRUE zurück, wenn die Anfangs- und Endpunkte des LINESTRING's zusammenfallen. Bei polyedrischen Oberflächen wird angezeigt, ob die Oberfläche eine Fläche (offen) oder ein Volumen (geschlossen) beschreibt.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 7.1.5, 9.3.3
| |
SQL-MM gibt vor, daß das Ergebnis von |
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
This function supports Polyhedral surfaces.
Beispiele für Linienzüge und Punkte
postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 1 1)'::geometry);
st_isclosed
-------------
f
(1 row)
postgis=# SELECT ST_IsClosed('LINESTRING(0 0, 0 1, 1 1, 0 0)'::geometry);
st_isclosed
-------------
t
(1 row)
postgis=# SELECT ST_IsClosed('MULTILINESTRING((0 0, 0 1, 1 1, 0 0),(0 0, 1 1))'::geometry);
st_isclosed
-------------
f
(1 row)
postgis=# SELECT ST_IsClosed('POINT(0 0)'::geometry);
st_isclosed
-------------
t
(1 row)
postgis=# SELECT ST_IsClosed('MULTIPOINT((0 0), (1 1))'::geometry);
st_isclosed
-------------
t
(1 row)Beispiel für eine polyedrische Oberfläche
-- Ein Würfel --
SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
st_isclosed
-------------
t
-- Ein Würfel, bei dem eine Seite fehlt --
SELECT ST_IsClosed(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)) )'));
st_isclosed
-------------
f
Name
ST_IsCollection — Gibt den Wert TRUE zurück, falls es sich bei der Geometrie um eine leere GeometryCollection, Polygon, Point etc. handelt.
Synopsis
boolean ST_IsCollection(geometry g);
Beschreibung
Gibt den Wert TRUE zurück, wenn der Geometrietyp einer der folgenden Gemetrietypen entspricht:
GEOMETRYCOLLECTION
MULTI{POINT,POLYGON,LINESTRING,CURVE,SURFACE}
COMPOUNDCURVE
| |
Diese Funktion wertet den Geometrietyp aus. D.h.: sie gibt den Wert |
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
postgis=# SELECT ST_IsCollection('LINESTRING(0 0, 1 1)'::geometry);
st_iscollection
-------------
f
(1 row)
postgis=# SELECT ST_IsCollection('MULTIPOINT EMPTY'::geometry);
st_iscollection
-------------
t
(1 row)
postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0))'::geometry);
st_iscollection
-------------
t
(1 row)
postgis=# SELECT ST_IsCollection('MULTIPOINT((0 0), (42 42))'::geometry);
st_iscollection
-------------
t
(1 row)
postgis=# SELECT ST_IsCollection('GEOMETRYCOLLECTION(POINT(0 0))'::geometry);
st_iscollection
-------------
t
(1 row)Name
ST_IsEmpty — Tests if a geometry is empty.
Synopsis
boolean ST_IsEmpty(geometry geomA);
Beschreibung
Gibt den Wert TRUE zurück, wenn es sich um eine leere Geometrie handelt. Falls TRUE, dann repräsentiert diese Geometrie eine leere GeometryCollection, Polygon, Point etc.
| |
SQL-MM gibt vor, daß das Ergebnis von ST_IsEmpty(NULL) der Wert 0 ist, während PostGIS den Wert NULL zurückgibt. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3: 5.1.7
This method supports Circular Strings and Curves
| |
Änderung: 2.0.0 - In Vorgängerversionen von PostGIS war ST_GeomFromText('GEOMETRYCOLLECTION(EMPTY)') erlaubt. Um eine bessere Übereinstimmung mit der SQL/MM Norm zu erreichen, ist dies nun nicht mehr gestattet. |
Beispiele
SELECT ST_IsEmpty(ST_GeomFromText('GEOMETRYCOLLECTION EMPTY'));
st_isempty
------------
t
(1 row)
SELECT ST_IsEmpty(ST_GeomFromText('POLYGON EMPTY'));
st_isempty
------------
t
(1 row)
SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))'));
st_isempty
------------
f
(1 row)
SELECT ST_IsEmpty(ST_GeomFromText('POLYGON((1 2, 3 4, 5 6, 1 2))')) = false;
?column?
----------
t
(1 row)
SELECT ST_IsEmpty(ST_GeomFromText('CIRCULARSTRING EMPTY'));
st_isempty
------------
t
(1 row)
Name
ST_IsRing — Tests if a LineString is closed and simple.
Synopsis
boolean ST_IsRing(geometry g);
Beschreibung
Gibt den Wert TRUE zurück, wenn der LINESTRING sowohl ST_IsClosed (ST_StartPoint( g)~= ST_Endpoint() als auch ST_IsSimple (sich nicht selbst überschneidet) ist.g)
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. 2.1.5.1
This method implements the SQL/MM specification. SQL-MM 3: 7.1.6
| |
SQL-MM gibt vor, daß das Ergebnis von |
Beispiele
SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom) FROM (SELECT 'LINESTRING(0 0, 0 1, 1 1, 1 0, 0 0)'::geometry AS the_geom) AS foo; st_isring | st_isclosed | st_issimple -----------+-------------+------------- t | t | t (1 row) SELECT ST_IsRing(the_geom), ST_IsClosed(the_geom), ST_IsSimple(the_geom) FROM (SELECT 'LINESTRING(0 0, 0 1, 1 0, 1 1, 0 0)'::geometry AS the_geom) AS foo; st_isring | st_isclosed | st_issimple -----------+-------------+------------- f | t | f (1 row)
Name
ST_IsSimple — Gibt den Wert (TRUE) zurück, wenn die Geometrie keine irregulären Stellen, wie Selbstüberschneidungen oder Selbstberührungen, aufweist.
Synopsis
boolean ST_IsSimple(geometry geomA);
Beschreibung
Gibt TRUE zurück, wenn keine regelwidrigen geometrischen Merkmale, wie Geometrien die sich selbst kreuzen oder berühren, auftreten. Für weiterführende Information zur OGC-Definition von Simplizität und Gültigkeit von Geometrien, siehe "Ensuring OpenGIS compliancy of geometries"
| |
SQL-MM definiert das Ergebnis von ST_IsSimple(NULL) als 0, während PostGIS NULL zurückgibt. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3: 5.1.8
This function supports 3d and will not drop the z-index.
Name
ST_M — Returns the M coordinate of a Point.
Synopsis
float ST_M(geometry a_point);
Beschreibung
Gibt die M-Koordinate des Punktes zurück, oder NULL wenn keine vorhanden ist. Der Einabewert muss ein Punkt sein.
| |
Dies ist (noch) kein Teil der OGC Spezifikation, wird aber hier aufgeführt um die Liste von Funktionen zum Auslesen von Punktkoordinaten zu vervollständigen. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification.
This function supports 3d and will not drop the z-index.
Name
ST_MemSize — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
Synopsis
integer ST_NRings(geometry geomA);
Beschreibung
Gibt den Geometrietyp des ST_Geometry Wertes zurück.
This complements the PostgreSQL built-in database object functions pg_column_size, pg_size_pretty, pg_relation_size, pg_total_relation_size.
| |
pg_relation_size which gives the byte size of a table may return byte size lower than ST_MemSize. This is because pg_relation_size does not add toasted table contribution and large geometries are stored in TOAST tables. pg_total_relation_size - includes, the table, the toasted tables, and the indexes. pg_column_size returns how much space a geometry would take in a column considering compression, so may be lower than ST_MemSize |
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
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.
Beispiele
--Return how much byte space Boston takes up in our Mass data set
SELECT pg_size_pretty(SUM(ST_MemSize(the_geom))) as totgeomsum,
pg_size_pretty(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(the_geom) ELSE 0 END)) As bossum,
CAST(SUM(CASE WHEN town = 'BOSTON' THEN ST_MemSize(the_geom) ELSE 0 END)*1.00 /
SUM(ST_MemSize(the_geom))*100 As numeric(10,2)) As perbos
FROM towns;
totgeomsum bossum perbos
---------- ------ ------
1522 kB 30 kB 1.99
SELECT ST_MemSize(ST_GeomFromText('CIRCULARSTRING(220268 150415,220227 150505,220227 150406)'));
---
73
--What percentage of our table is taken up by just the geometry
SELECT pg_total_relation_size('public.neighborhoods') As fulltable_size, sum(ST_MemSize(the_geom)) As geomsize,
sum(ST_MemSize(the_geom))*1.00/pg_total_relation_size('public.neighborhoods')*100 As pergeom
FROM neighborhoods;
fulltable_size geomsize pergeom
------------------------------------------------
262144 96238 36.71188354492187500000
Name
ST_NDims —
Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
Synopsis
integer ST_NDims(geometry g1);
Beschreibung
Gibt die Koordinatendimension der Geometrie zurück. PostGIS unterstützt 2- (x,y), 3- (x,y,z) oder 2D mit Kilometrierung - x,y,m, und 4- dimensionalen Raum - 3D mit Kilometrierung x,y,z,m .
This function supports 3d and will not drop the z-index.
Name
ST_NPoints — Gibt die Anzahl der Punkte (Knoten) einer Geometrie zurück.
Synopsis
integer ST_NPoints(geometry g1);
Beschreibung
Gibt die Anzahl der Punkte einer Geometrie zurück. Funktioniert für alle Geometrien.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
| |
Vor 1.3.4 ist diese Funktion abgestürzt, wenn die Geometrien CURVES enthalten. Dies wurde mit 1.3.4+ behoben |
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
ST_NRings — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
Synopsis
integer ST_NRings(geometry geomA);
Beschreibung
Wenn es sich bei der Geometrie um ein Polygon oder um ein MultiPolygon handelt, wird die Anzahl der Ringe zurückgegeben. Anders als NumInteriorRings werden auch die äußeren Ringe gezählt.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Name
ST_NumGeometries — Gibt die Anzahl der Punkte einer Geometrie zurück. Funktioniert für alle Geometrien.
Synopsis
integer ST_NumGeometries(geometry geom);
Beschreibung
Gibt die Anzahl an Geometrien aus. Wenn es sich bei der Geometrie um eine GEOMETRYCOLLECTION (oder MULTI*) handelt, wird die Anzahl der Geometrien zurückgegeben, bei Einzelgeometrien wird 1, ansonsten NULL zurückgegeben.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
Änderung: 2.0.0 Bei früheren Versionen wurde NULL zurückgegeben, wenn die Geometrie nicht vom Typ GEOMETRYCOLLECTION/MULTI war. 2.0.0+ gibt nun 1 für Einzelgeometrien, wie POLYGON, LINESTRING, POINT zurück.
This method implements the SQL/MM specification. SQL-MM 3: 9.1.4
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
--Frühere Versionen gaben hier den Wert NULL zurück -- ab 2.0.0 wird der Wert 1 zurückgegeben
SELECT ST_NumGeometries(ST_GeomFromText('LINESTRING(77.29 29.07,77.42 29.26,77.27 29.31,77.29 29.07)'));
--result
1
--Beispiel einer Geometriekollektion - Multis zählen als eine Geometrie in einer Kollektion
SELECT ST_NumGeometries(ST_GeomFromEWKT('GEOMETRYCOLLECTION(MULTIPOINT(-2 3 , -2 2),
LINESTRING(5 5 ,10 10),
POLYGON((-7 4.2,-7.1 5,-7.1 4.3,-7 4.2)))'));
--result
3
Name
ST_NumInteriorRings — Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus.
Synopsis
integer ST_NumInteriorRings(geometry a_polygon);
Beschreibung
Gibt die Anzahl der inneren Ringe einer Polygongeometrie aus. Gibt NULL zurück, wenn die Geometrie kein Polygon ist.
This method implements the SQL/MM specification. SQL-MM 3: 8.2.5
Änderung: 2.0.0 - In füheren Versionen war ein MULTIPOLYGON als Eingabe erlaubt, wobei die Anzahl der inneren Ringe des ersten Polygons ausgegeben wurde.
Beispiele
--Falls Sie ein normales Polygon haben
SELECT gid, field1, field2, ST_NumInteriorRings(the_geom) AS numholes
FROM sometable;
--Falls Sie Multipolygone haben
--und die Gesamtzahl der inneren Ringe im MULTIPOLYGON wissen wollen
SELECT gid, field1, field2, SUM(ST_NumInteriorRings(the_geom)) AS numholes
FROM (SELECT gid, field1, field2, (ST_Dump(the_geom)).geom As the_geom
FROM sometable) As foo
GROUP BY gid, field1,field2;
Name
ST_NumInteriorRing — Gibt die Anzahl der inneren Ringe eines Polygons in der Geometrie aus. Ist ein Synonym für ST_NumInteriorRings.
Synopsis
integer ST_NumInteriorRing(geometry a_polygon);
Name
ST_NumPatches — Gibt die Anzahl der Maschen einer polyedrischen Oberfläche aus. Gibt NULL zurück, wenn es sich nicht um polyedrische Geometrien handelt.
Synopsis
integer ST_NumPatches(geometry g1);
Beschreibung
Gibt die Anzahl der Maschen einer polyedrischen Oberfläche aus. Gibt NULL zurück, wenn es sich um keine polyedrische Geometrie handelt. Ist ein Synonym für ST_NumGeometries zur Unterstützung der MM Namensgebung. Wenn Ihnen die MM-Konvention egal ist, so ist die Verwendung von ST_NumGeometries schneller.
Verfügbarkeit: 2.0.0
This function supports 3d and will not drop the z-index.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: ?
This function supports Polyhedral surfaces.
Beispiele
SELECT ST_NumPatches(ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
--result
6
Name
ST_NumPoints — Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
Synopsis
integer ST_NumPoints(geometry g1);
Beschreibung
Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück. Vor 1.4 funktionierte dies nur mit ST_LineString, wie von der Spezifikation festgelegt. Ab 1.4 aufwärts handelt es sich um einen Alias für ST_NPoints, das die Anzahl der Knoten nicht nur für Linienzüge ausgibt. Erwägen Sie stattdessen die Verwendung von ST_NPoints, das vielseitig ist und mit vielen Geometrietypen funktioniert.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 7.2.4
Name
ST_PatchN — Gibt den Geometrietyp des ST_Geometry Wertes zurück.
Synopsis
geometry ST_PatchN(geometry geomA, integer n);
Beschreibung
>Gibt die auf 1-basierende n-te Geometrie (Masche) zurück, wenn es sich bei der Geometrie um ein POLYHEDRALSURFACE, oder ein POLYHEDRALSURFACEM handelt. Anderenfalls wird NULL zurückgegeben. Gibt bei polyedrischen Oberflächen das selbe Ergebnis wie ST_GeometryN. Die Verwendung von ST_GeometryN ist schneller.
| |
Der Index ist auf 1 basiert. |
| |
Falls Sie alle Geometrien einer Geometrie entnehmen wollen, so ist ST_Dump wesentlich leistungsfähiger. |
Verfügbarkeit: 2.0.0
This method implements the SQL/MM specification. SQL-MM 3: ?
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Beispiele
--Entnimmt die 2te Fläche einer polyedrischen Oberfläche
SELECT ST_AsEWKT(ST_PatchN(geom, 2)) As geomewkt
FROM (
VALUES (ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )')) ) As foo(geom);
geomewkt
---+-----------------------------------------
POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0))
Name
ST_PointN — Gibt die Anzahl der Stützpunkte eines ST_LineString oder eines ST_CircularString zurück.
Synopsis
geometry ST_PointN(geometry a_linestring, integer n);
Beschreibung
Gibt den n-ten Punkt des ersten LineString's oder des kreisförmigen LineStrings's einer Geometrie zurück. Negative Werte werden rückwärts, vom Ende des LineString's her gezählt, sodass -1 der Endpunkt ist. Gibt NULL aus, wenn die Geometrie keinen LineString enthält.
| |
Seit Version 0.8.0 ist der Index 1-basiert, so wie in der OGC Spezifikation. Rückwärtiges Indizieren (negativer Index) findet sich nicht in der OGC Spezifikation. Vorhergegangene Versionen waren 0-basiert. |
| |
Falls Sie den n-ten Punkt eines jeden LineString's in einem MultiLinestring wollen, nutzen Sie diese Funktion gemeinsam mit ST_Dump. |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 7.2.5, 7.3.5
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
| |
Änderung: 2.0.0 arbeitet nicht mehr mit MultiLinestring's, die nur eine einzelne Geometrie enthalten. In früheren Versionen von PostGIS gab die Funktion bei einem, aus einer einzelnen Linie bestehender MultiLinestring, den Anfangspunkt zurück. Ab 2.0.0 wird, so wie bei jedem anderen MultiLinestring auch, NULL zurückgegeben. Änderung: 2.3.0 : negatives Indizieren verfügbar (-1 entspricht dem Endpunkt) |
Beispiele
-- Entnimmt alle POINTs eines LINESTRINGs
SELECT ST_AsText(
ST_PointN(
column1,
generate_series(1, ST_NPoints(column1))
))
FROM ( VALUES ('LINESTRING(0 0, 1 1, 2 2)'::geometry) ) AS foo;
st_astext
------------
POINT(0 0)
POINT(1 1)
POINT(2 2)
(3 rows)
--Beispiel für einen Kreisbogen
SELECT ST_AsText(ST_PointN(ST_GeomFromText('CIRCULARSTRING(1 2, 3 2, 1 2)'),2));
st_astext
----------
POINT(3 2)
SELECT st_astext(f)
FROM ST_GeometryFromtext('LINESTRING(0 0 0, 1 1 1, 2 2 2)') as g
,ST_PointN(g, -2) AS f -- 1 based index
st_astext
----------
"POINT Z (1 1 1)"
Name
ST_Points — Gibt einen MultiPoint zurück, welcher alle Koordinaten einer Geometrie enthält.
Synopsis
geometry ST_Points( geometry geom );
Beschreibung
Gibt einen MultiPoint zurück, welcher alle Koordinaten einer Geometrie enthält. Duplizierte Punkte in der Eingabegeometrie, einschließlich der Anfangs- und Endpunkte von Ringgeometrien, werden nicht entfernt. (Wenn diese Verhaltensweise unerwünscht ist, können die Duplikate mit ST_RemoveRepeatedPoints entfernt werden).
Vorhandene M- und Z-Ordinaten werden erhalten.
This method supports Circular Strings and Curves
This function supports 3d and will not drop the z-index.
Verfügbarkeit: 2.3.0
Name
ST_StartPoint — Returns the first point of a LineString.
Synopsis
geometry ST_StartPoint(geometry geomA);
Beschreibung
Gibt den Anfangspunkt einer LINESTRING oder CIRCULARLINESTRING Geometrie als POINT oder NULL zurück, falls es sich beim Eingabewert nicht um einen LINESTRING oder CIRCULARLINESTRING handelt.
This method implements the SQL/MM specification. SQL-MM 3: 7.1.3
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
| |
Änderung: 2.0.0 unterstützt die Verarbeitung von MultiLinestring's die nur aus einer einzelnen Geometrie bestehen, nicht mehr. In früheren Versionen von PostGIS gab die Funktion bei einem aus einer einzelnen Linie bestehender MultiLinestring den Anfangspunkt zurück. Ab 2.0.0 gibt sie nur NULL zurück, so wie bei jedem anderen MultiLinestring. Die alte Verhaltensweise war undokumentiert, aber Anwender, die annahmen, dass Sie Ihre Daten als LINESTRING vorliegen haben, könnten in 2.0 dieses zurückgegebene NULL bemerken. |
Beispiele
SELECT ST_AsText(ST_StartPoint('LINESTRING(0 1, 0 2)'::geometry));
st_astext
------------
POINT(0 1)
(1 row)
SELECT ST_StartPoint('POINT(0 1)'::geometry) IS NULL AS is_null;
is_null
----------
t
(1 row)
--3D Linie
SELECT ST_AsEWKT(ST_StartPoint('LINESTRING(0 1 1, 0 2 2)'::geometry));
st_asewkt
------------
POINT(0 1 1)
(1 row)
-- kreisförmiger Linienzug --
SELECT ST_AsText(ST_StartPoint('CIRCULARSTRING(5 2,-3 1.999999, -2 1, -4 2, 5 2)'::geometry));
st_astext
------------
POINT(5 2)
Name
ST_Summary —
Gibt eine Zusammenfassung des Inhalts einer Geometrie wieder.
Synopsis
text ST_Summary(geometry g);
text ST_Summary(geography g);
Beschreibung
Gibt eine Zusammenfassung des Inhalts einer Geometrie wieder.
Die Bedeutung der Flags, welche in eckigen Klammern hinter dem Geometrietyp angezeigt werden, ist wie folgt:
M: besitzt eine M-Ordinate
Z: besitzt eine Z-Ordinate
B: besitzt ein zwischengespeichertes Umgebungsrechteck
G: ist geodätisch (Geographie)
S: besitzt ein räumliches Koordinatenreferenzsystem
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Verfügbarkeit: 1.2.2
Erweiterung: 2.0.0 Unterstützung für geographische Koordinaten hinzugefügt
Erweiterung: 2.1.0 S-Flag, diese zeigt an ob das Koordinatenreferenzsystem bekannt ist
Erweiterung: 2.2.0 Unterstützung für TIN und Kurven
Beispiele
=# SELECT ST_Summary(ST_GeomFromText('LINESTRING(0 0, 1 1)')) as geom,
ST_Summary(ST_GeogFromText('POLYGON((0 0, 1 1, 1 2, 1 1, 0 0))')) geog;
geom | geog
-----------------------------+--------------------------
LineString[B] with 2 points | Polygon[BGS] with 1 rings
| ring 0 has 5 points
:
(1 row)
=# SELECT ST_Summary(ST_GeogFromText('LINESTRING(0 0 1, 1 1 1)')) As geog_line,
ST_Summary(ST_GeomFromText('SRID=4326;POLYGON((0 0 1, 1 1 2, 1 2 3, 1 1 1, 0 0 1))')) As geom_poly;
;
geog_line | geom_poly
-------------------------------- +--------------------------
LineString[ZBGS] with 2 points | Polygon[ZBS] with 1 rings
: ring 0 has 5 points
:
(1 row)
Name
ST_X — Returns the X coordinate of a Point.
Synopsis
float ST_X(geometry a_point);
Beschreibung
Gibt die X-Koordinate eines Punktes, oder NULL wenn diese nicht vorhanden ist, zurück. Die Eingabe muss ein Punkt sein.
This method implements the SQL/MM specification. SQL-MM 3: 6.1.3
This function supports 3d and will not drop the z-index.
Name
ST_Y — Returns the Y coordinate of a Point.
Synopsis
float ST_Y(geometry a_point);
Beschreibung
Gibt die Y-Koordinate eines Punktes, oder NULL wenn diese nicht vorhanden ist, zurück. Die Eingabe muss ein Punkt sein.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 6.1.4
This function supports 3d and will not drop the z-index.
Name
ST_Z — Returns the Z coordinate of a Point.
Synopsis
float ST_Z(geometry a_point);
Name
ST_Zmflag — Gibt die Dimension der Koordinaten von ST_Geometry zurück.
Synopsis
smallint ST_Zmflag(geometry geomA);
Beschreibung
Gibt die Dimension der Koordinaten für den Wert von ST_Geometry zurück.
Values are: 0 = 2D, 1 = 3D-M, 2 = 3D-Z, 3 = 4D.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRING(1 2, 3 4)'));
st_zmflag
-----------
0
SELECT ST_Zmflag(ST_GeomFromEWKT('LINESTRINGM(1 2 3, 3 4 3)'));
st_zmflag
-----------
1
SELECT ST_Zmflag(ST_GeomFromEWKT('CIRCULARSTRING(1 2 3, 3 4 3, 5 6 3)'));
st_zmflag
-----------
2
SELECT ST_Zmflag(ST_GeomFromEWKT('POINT(1 2 3 4)'));
st_zmflag
-----------
3
- ST_AddPoint — Fügt einem Linienzug einen Punkt hinzu.
- ST_CollectionExtract — Von einer gegebenen (Sammel)Geometrie wird eine (Sammel)Geometrie zurückgegeben, welche nur die Elemente des vorgegebenen Datentyps enthält.
- ST_CollectionHomogenize — Von einer gegebenen Sammelgeometrie wird die "einfachste" Darstellung der Inhalte zurückgegeben.
- 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_LineMerge — Gibt einen (Satz von) LineString(s) zurück, der aus einem MultiLinestring "zusammengebastelt" wird.
- ST_Multi — Gibt die Geometrie als MULTI* Geometrie zurück.
- ST_Normalize — Gibt die Geometrie in Normalform zurück.
- ST_QuantizeCoordinates — Setzt die niedrigwertigsten Bits der Koordinaten auf Null
- ST_RemovePoint — Entfernt einen Punkt aus einem Linienzug.
- ST_Reverse — Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
- ST_Segmentize — Gibt eine veränderte Geometrie/Geographie zurück, bei der kein Sement länger als der gegebene Abstand ist.
- ST_SetPoint — Einen Punkt eines Linienzuges durch einen gegebenen Punkt ersetzen.
- 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_QuantizeCoordinates — Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
Name
ST_AddPoint — Fügt einem Linienzug einen Punkt hinzu.
Synopsis
geometry ST_AddPoint(geometry linestring, geometry point);
geometry ST_AddPoint(geometry linestring, geometry point, integer position);
Beschreibung
Fügt einen Punkt zu einem Linienzug hinzu; vor point <position> (Index zählt von 0 weg). Der dritte Parameter kann weggelassen werden oder zum Anhängen auf -1 gesetzt werden.
Verfügbarkeit: 1.1.0
This function supports 3d and will not drop the z-index.
Beispiele
--sicherstellen, das alle Linienzüge in einer Tabelle geschlossen sind,
--indem zu jedem nicht geschlossenen Linienzug, der Anfangspunkt als Endpunkt hinzugefügt wird
UPDATE sometable
SET the_geom = ST_AddPoint(the_geom, ST_StartPoint(the_geom))
FROM sometable
WHERE ST_IsClosed(the_geom) = false;
--Einen Punkt zu einer 3-D Linie hinzufügen
SELECT ST_AsEWKT(ST_AddPoint(ST_GeomFromEWKT('LINESTRING(0 0 1, 1 1 1)'), ST_MakePoint(1, 2, 3)));
--result
st_asewkt
----------
LINESTRING(0 0 1,1 1 1,1 2 3)
Name
ST_CollectionExtract — Von einer gegebenen (Sammel)Geometrie wird eine (Sammel)Geometrie zurückgegeben, welche nur die Elemente des vorgegebenen Datentyps enthält.
Synopsis
geometry ST_CollectionExtract(geometry collection, integer type);
Beschreibung
Von einer (Sammel)Geometrie wird eine (Mehrfach)Geometrie zurückgegeben, welche nur die Elemente des vorgegebenen Datentyps enthält. Teilgeometrien, die nicht dem vorgegebenen Datentyp entsprechen, werden ausgelassen. Wenn keine der Teilgeometrien den richtigen Datentyp aufweist, wird eine LEERE Geometrie zurückgegeben. Es werden nur Punkte, Linien und Polygone unterstützt. Die Kennungen sind 1 == POINT, 2 == LINESTRING, 3 == POLYGON.
Verfügbarkeit: 1.5.0
| |
Vor 1.5.3 gab diese Funktion, wenn die Eingabe keine Sammelgeometrie war, diese unabhängig vom Datentyp unangetastet zurück. Bei 1.5.3 wurde bei unpassenden Einzelgeometrien NULL zurückgegeben. Ab 2.0.0 wird bei fehlender Übereinstimmung immer eine LEERE Ausgabe zurückgegeben. |
| |
Wenn 3 == POLYGON angegeben ist, wird ein Mehrfachpolygon zurückgegeben, sogar dann wenn die Kanten gemeinsam genutzt werden. Dies endet in vielen Fällen einem invaliden Mehrfachpolygon, zum Beispiel wenn diese Funktion auf ein ST_Split Ergebnis angewendet wird. |
Beispiele
-- Konstante: 1 == POINT, 2 == LINESTRING, 3 == POLYGON
SELECT ST_AsText(ST_CollectionExtract(ST_GeomFromText('GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(POINT(0 0)))'),1));
st_astext
---------------
MULTIPOINT(0 0)
(1 row)
SELECT ST_AsText(ST_CollectionExtract(ST_GeomFromText('GEOMETRYCOLLECTION(GEOMETRYCOLLECTION(LINESTRING(0 0, 1 1)),LINESTRING(2 2, 3 3))'),2));
st_astext
---------------
MULTILINESTRING((0 0, 1 1), (2 2, 3 3))
(1 row)
Name
ST_CollectionHomogenize — Von einer gegebenen Sammelgeometrie wird die "einfachste" Darstellung der Inhalte zurückgegeben.
Synopsis
geometry ST_CollectionHomogenize(geometry collection);
Beschreibung
Von einer Sammelgeometrie wird die "einfachste" Darstellung der Inhalte zurückgegeben. Einelementige Geometrien werden ebenso zurückgegeben. Einheitliche Sammelgeometrien werden, entsprechend dem Datentyp, als Mehrfachgeometrien ausgegeben
| |
Wenn 3 == POLYGON angegeben ist, wird ein Mehrfachpolygon zurückgegeben, sogar dann wenn die Kanten gemeinsam genutzt werden. Dies endet in vielen Fällen einem invaliden Mehrfachpolygon, zum Beispiel wenn diese Funktion auf ein ST_Split Ergebnis angewendet wird. |
Verfügbarkeit: 2.0.0
Name
ST_Force2D — Die Geometrien in einen "2-dimensionalen Modus" zwingen.
Synopsis
geometry ST_Force2D(geometry geomA);
Beschreibung
Zwingt die Geometrien in einen "2-dimensionalen Modus", sodass in der Ausgabe nur die X- und Y-Koordinaten dargestellt werden. Nützlich um eine OGC-konforme Ausgabe zu erhalten (da OGC nur 2-D Geometrien spezifiziert).
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
Änderung: 2.1.0. Bis zu 2.0.x wurde diese Funktion mit ST_Force_2D bezeichnet.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports 3d and will not drop the z-index.
Beispiele
SELECT ST_AsEWKT(ST_Force2D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
st_asewkt
-------------------------------------
CIRCULARSTRING(1 1,2 3,4 5,6 7,5 6)
SELECT ST_AsEWKT(ST_Force2D('POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 2,1 3 2,1 1 2))'));
st_asewkt
----------------------------------------------
POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))
Name
ST_Force3D — Zwingt die Geometrien in einen XYZ Modus. Dies ist ein Alias für ST_Force3DZ.
Synopsis
geometry ST_Force3D(geometry geomA);
Beschreibung
Zwingt die Geometrien in einen XYZ Modus. Dies ist ein Alias für ST_Force3DZ. Wenn die Geometrie keine Z-Komponente aufweist, wird eine Z-Koordinate mit dem Wert 0 angeheftet.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
Änderung: 2.1.0. Bis zu 2.0.x wurde diese Funktion mit ST_Force_3D bezeichnet.
This function supports Polyhedral surfaces.
This method supports Circular Strings and Curves
This function supports 3d and will not drop the z-index.
Beispiele
--Wenn bereits eine 3D-Geometrie vorliegt, geschieht nichts
SELECT ST_AsEWKT(ST_Force3D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
st_asewkt
-----------------------------------------------
CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)
SELECT ST_AsEWKT(ST_Force3D('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));
st_asewkt
--------------------------------------------------------------
POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))
Name
ST_Force3DZ — Zwingt die Geometrien in einen XYZ Modus.
Synopsis
geometry ST_Force3DZ(geometry geomA);
Beschreibung
Zwingt die Geometrien in einen XYZ Modus. Dies ist ein Alias für ST_Force3DZ. Wenn die Geometrie keine Z-Komponente aufweist, wird eine Z-Koordinate mit dem Wert 0 angeheftet.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
Änderung: 2.1.0. Bis zu 2.0.x wurde diese Funktion mit ST_Force_3DZ bezeichnet.
This function supports Polyhedral surfaces.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
--Wenn bereits eine 3D-Geometrie vorliegt, geschieht nichts
SELECT ST_AsEWKT(ST_Force3DZ(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
st_asewkt
-----------------------------------------------
CIRCULARSTRING(1 1 2,2 3 2,4 5 2,6 7 2,5 6 2)
SELECT ST_AsEWKT(ST_Force3DZ('POLYGON((0 0,0 5,5 0,0 0),(1 1,3 1,1 3,1 1))'));
st_asewkt
--------------------------------------------------------------
POLYGON((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))
Name
ST_Force3DM — Zwingt die Geometrien in einen XYM Modus.
Synopsis
geometry ST_Force3DM(geometry geomA);
Beschreibung
Zwingt die Geometrien in einen XYM Modus. Wenn die Geometrie keine M-Komponente aufweist, wird eine M-Koordinate mit dem Wert 0 angeheftet. Falls die Geometrie eine Z-Komponente aufweist, wird diese gelöscht.
Änderung: 2.1.0. Bis zu 2.0.x wurde diese Funktion mit ST_Force_3DM bezeichnet.
This method supports Circular Strings and Curves
Beispiele
----Wenn bereits eine 3D-Geometrie vorliegt, geschieht nichts
SELECT ST_AsEWKT(ST_Force3DM(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
st_asewkt
------------------------------------------------
CIRCULARSTRINGM(1 1 0,2 3 0,4 5 0,6 7 0,5 6 0)
SELECT ST_AsEWKT(ST_Force3DM('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1))'));
st_asewkt
---------------------------------------------------------------
POLYGONM((0 0 0,0 5 0,5 0 0,0 0 0),(1 1 0,3 1 0,1 3 0,1 1 0))
Name
ST_Force4D — Zwingt die Geometrien in einen XYZM Modus.
Synopsis
geometry ST_Force4D(geometry geomA);
Beschreibung
Zwingt die Geometrien in einen XYZM Modus. Fehlenden Z- und M-Dimensionen wird eine 0 angeheftet.
Änderung: 2.1.0. Bis zu 2.0.x wurde diese Funktion mit ST_Force_4D bezeichnet.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
--Wenn bereits eine 3D-Geometrie vorliegt, geschieht nichts
SELECT ST_AsEWKT(ST_Force4D(ST_GeomFromEWKT('CIRCULARSTRING(1 1 2, 2 3 2, 4 5 2, 6 7 2, 5 6 2)')));
st_asewkt
---------------------------------------------------------
CIRCULARSTRING(1 1 2 0,2 3 2 0,4 5 2 0,6 7 2 0,5 6 2 0)
SELECT ST_AsEWKT(ST_Force4D('MULTILINESTRINGM((0 0 1,0 5 2,5 0 3,0 0 4),(1 1 1,3 1 1,1 3 1,1 1 1))'));
st_asewkt
--------------------------------------------------------------------------------------
MULTILINESTRING((0 0 0 1,0 5 0 2,5 0 0 3,0 0 0 4),(1 1 0 1,3 1 0 1,1 3 0 1,1 1 0 1))
Name
ST_ForcePolygonCCW — Richtet alle äußeren Ringe gegen den Uhrzeigersinn und alle inneren Ringe mit dem Uhrzeigersinn aus.
Synopsis
geometry ST_ForcePolygonCCW ( geometry geom );
Beschreibung
Zwingt (Multi)Polygone, den äusseren Ring gegen den Uhrzeigersinn und die inneren Ringe im Uhrzeigersinn zu orientieren. Andere Geometrien werden unverändert zurückgegeben.
Verfügbarkeit: 2.0.0
This function supports 3d and will not drop the z-index.
This function supports M coordinates.
Name
ST_ForceCollection — Wandelt eine Geometrie in eine GEOMETRYCOLLECTION um.
Synopsis
geometry ST_ForceCollection(geometry geomA);
Beschreibung
Wandelt eine Geometrie in eine GEOMETRYCOLLECTION um. Nützlich um eine WKB-Darstellung zu vereinfachen.
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
Verfügbarkeit: 1.2.2, Vor 1.3.4 ist diese Funktion bei CURVES abgestürzt. Dies wurde mit 1.3.4+ behoben
Änderung: 2.1.0. Bis zu 2.0.x wurde diese Funktion mit ST_Force_Collection bezeichnet.
This function supports Polyhedral surfaces.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
SELECT ST_AsEWKT(ST_ForceCollection('POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1))'));
st_asewkt
----------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POLYGON((0 0 1,0 5 1,5 0 1,0 0 1),(1 1 1,3 1 1,1 3 1,1 1 1)))
SELECT ST_AsText(ST_ForceCollection('CIRCULARSTRING(220227 150406,2220227 150407,220227 150406)'));
st_astext
--------------------------------------------------------------------------------
GEOMETRYCOLLECTION(CIRCULARSTRING(220227 150406,2220227 150407,220227 150406))
(1 row)
-- Beispiel für eine polyedrische Oberfläche --
SELECT ST_AsEWKT(ST_ForceCollection('POLYHEDRALSURFACE(((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),
((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),
((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),
((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),
((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),
((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1)))'))
st_asewkt
----------------------------------------------------------------------------------
GEOMETRYCOLLECTION(
POLYGON((0 0 0,0 0 1,0 1 1,0 1 0,0 0 0)),
POLYGON((0 0 0,0 1 0,1 1 0,1 0 0,0 0 0)),
POLYGON((0 0 0,1 0 0,1 0 1,0 0 1,0 0 0)),
POLYGON((1 1 0,1 1 1,1 0 1,1 0 0,1 1 0)),
POLYGON((0 1 0,0 1 1,1 1 1,1 1 0,0 1 0)),
POLYGON((0 0 1,1 0 1,1 1 1,0 1 1,0 0 1))
)
Name
ST_ForcePolygonCW — Richtet alle äußeren Ringe im Uhrzeigersinn und alle inneren Ringe gegen den Uhrzeigersinn aus.
Synopsis
geometry ST_ForcePolygonCW ( geometry geom );
Beschreibung
Zwingt (Multi)Polygone, den äusseren Ring im Uhrzeigersinn und die inneren Ringe gegen den Uhrzeigersinn zu orientieren. Andere Geometrien werden unverändert zurückgegeben.
Verfügbarkeit: 2.0.0
This function supports 3d and will not drop the z-index.
This function supports M coordinates.
Name
ST_ForceSFS — Erzwingt, dass Geometrien nur vom Typ SFS 1.1 sind.
Synopsis
geometry ST_ForceSFS(geometry geomA);
geometry ST_ForceSFS(geometry geomA, text version);
Name
ST_ForceRHR — Orientiert die Knoten in einem Polygon so, dass sie der Drei-Finger-Regel folgen.
Synopsis
geometry ST_ForceRHR(geometry g);
Beschreibung
Orientiert die Knoten in einem Polygon so, dass sie der Drei-Finger-Regel folgen. Dadurch kommt die durch das Polygon begrenzte Fläche auf der rechten Seite der Begrenzung zu liegen. Insbesondere sind der äussere Ring im Uhrzeigersinn und die inneren Ringe gegen den Uhrzeigersinn orientiert. Diese Funktion ist ein Synonym für ST_ForcePolygonCW
| |
Die obere Definition mit der Drei-Finger-Regel widerspricht den Definitionen, die in anderen Zusammenhängen verwendet werden. Um Verwirrung zu vermeiden, wird die Verwendung von ST_ForcePolygonCW empfohlen. |
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Beispiele
SELECT ST_AsEWKT(
ST_ForceRHR(
'POLYGON((0 0 2, 5 0 2, 0 5 2, 0 0 2),(1 1 2, 1 3 2, 3 1 2, 1 1 2))'
)
);
st_asewkt
--------------------------------------------------------------
POLYGON((0 0 2,0 5 2,5 0 2,0 0 2),(1 1 2,3 1 2,1 3 2,1 1 2))
(1 row)Siehe auch
ST_ForcePolygonCCW , ST_ForcePolygonCW , ST_IsPolygonCCW , ST_IsPolygonCW , ST_BuildArea, ST_Polygonize, ST_Reverse
Name
ST_ForceCurve — Wandelt einen geometrischen in einen Kurven Datentyp um, soweit anwendbar.
Synopsis
geometry ST_ForceCurve(geometry g);
Beschreibung
Wandelt eine Geometrie in eine Kurvendarstellung um, soweit anwendbar: Linien werden CompundCurves, MultiLines werden MultiCurves, Polygone werden zu CurvePolygons, Multipolygons werden MultiSurfaces. Wenn die Geometrie bereits in Kurvendarstellung vorliegt, wird sie unverändert zurückgegeben.
Verfügbarkeit: 2.2.0
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Name
ST_LineMerge — Gibt einen (Satz von) LineString(s) zurück, der aus einem MultiLinestring "zusammengebastelt" wird.
Synopsis
geometry ST_LineMerge(geometry amultilinestring);
Beschreibung
Gibt einen (Satz von) LineString(s) zurück, der aus den Bestandteilen eines MultiLinestring zusammengesetzt wird.
| |
Ist nur mit MULTILINESTRING/LINESTRING verwendbar. Wenn Sie ein Polygon oder eine Sammelgeometrie in diese Funktion einspeisen, wird eine leere GEOMETRYCOLLECTION zurückgegeben |
Performed by the GEOS module.
Verfügbarkeit: 1.1.0
| |
Schneidet die Dimension M ab. |
Beispiele
SELECT ST_AsText(ST_LineMerge(
ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 -33,-46 -32))')
)
);
st_astext
--------------------------------------------------------------------------------------------------
LINESTRING(-29 -27,-30 -29.7,-36 -31,-45 -33,-46 -32)
(1 row)
--Wenn eine Vereinigung nicht möglich ist, wird der urspüngliche MULTILINESTRING zurückgegeben
SELECT ST_AsText(ST_LineMerge(
ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45.2 -33.2,-46 -32))')
)
);
st_astext
----------------
MULTILINESTRING((-45.2 -33.2,-46 -32),(-29 -27,-30 -29.7,-36 -31,-45 -33))
-- Beispiel mit Dimension Z
SELECT ST_AsText(ST_LineMerge(
ST_GeomFromText('MULTILINESTRING((-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 6), (-29 -27 12,-30 -29.7 5), (-45 -33 1,-46 -32 11))')
)
);
st_astext
--------------------------------------------------------------------------------------------------
LINESTRING Z (-30 -29.7 5,-29 -27 11,-30 -29.7 10,-36 -31 5,-45 -33 1,-46 -32 11)
(1 row)
Name
ST_Multi — Gibt die Geometrie als MULTI* Geometrie zurück.
Synopsis
geometry ST_Multi(geometry g1);
Beschreibung
Gibt die Geometrie als MULTI* Geometrie zurück. Falls es sich bereits um eine MULTI* Geometrie handelt, bleibt diese unverändert.
Beispiele
SELECT ST_AsText(ST_Multi(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,
743265 2967450,743265.625 2967416,743238 2967416))')));
st_astext
--------------------------------------------------------------------------------------------------
MULTIPOLYGON(((743238 2967416,743238 2967450,743265 2967450,743265.625 2967416,
743238 2967416)))
(1 row)
Name
ST_Normalize — Gibt die Geometrie in Normalform zurück.
Synopsis
geometry ST_Normalize(geometry geom);
Beschreibung
Gibt die Geometrie in Normalform aus. Möglicherweise werden die Knoten der Polygonringe, die Ringe eines Polygons oder die Elemente eines Komplexes von Mehrfachgeometrien neu gereiht.
Hauptsächlich für Testzwecke sinnvoll (zum Vergleich von erwarteten und erhaltenen Ergebnissen).
Verfügbarkeit: 2.3.0
Beispiele
SELECT ST_AsText(ST_Normalize(ST_GeomFromText(
'GEOMETRYCOLLECTION(
POINT(2 3),
MULTILINESTRING((0 0, 1 1),(2 2, 3 3)),
POLYGON(
(0 10,0 0,10 0,10 10,0 10),
(4 2,2 2,2 4,4 4,4 2),
(6 8,8 8,8 6,6 6,6 8)
)
)'
)));
st_astext
----------------------------------------------------------------------------------------------------------------------------------------------------
GEOMETRYCOLLECTION(POLYGON((0 0,0 10,10 10,10 0,0 0),(6 6,8 6,8 8,6 8,6 6),(2 2,4 2,4 4,2 4,2 2)),MULTILINESTRING((2 2,3 3),(0 0,1 1)),POINT(2 3))
(1 row)
Name
ST_QuantizeCoordinates — Setzt die niedrigwertigsten Bits der Koordinaten auf Null
Synopsis
geometry ST_QuantizeCoordinates ( geometry g , int prec_x , int prec_y , int prec_z , int prec_m );
Beschreibung
ST_QuantizeCoordinates bestimmt die Anzahl der Bits ( N ), die zur Darstellung eines Koordinatenwerts mit einer angegebenen Anzahl von Stellen nach dem Dezimalpunkt erforderlich sind, und setzt dann alle außer dem N höchstwertige Bits zu Null. Der resultierende Koordinatenwert wird immer noch auf den ursprünglichen Wert abgerundet, hat jedoch eine verbesserte Komprimierbarkeit. Dies kann zu einer erheblichen Reduzierung der Festplattenbelegung führen, wenn die Geometrie-Spalte einen komprimierbarer Speichertyp verwendet. Die Funktion ermöglicht unterschiedliche Angabe für die Anzahl von Nachkommastellen je Dimension. Bei nicht angegebenen Dimensionen wird davon ausgegangen, dass sie die Dimension x haben. Negative Ziffern werden so interpretiert, dass sie die Ziffern vor dem Komma geziehen (d. h. prec_x = -2 rundet auf die nächste Hundert).
Die von ST_QuantizeCoordinates erzeugten Koordinaten sind unabhängig von der Geometrie, die diese Koordinaten und die relative Position dieser Koordinaten in der Geometrie enthält. Daher sind vorhandene topologische Beziehungen zwischen Geometrien durch die Verwendung dieser Funktion nicht betroffen. Die Funktion erzeugt möglicherweise ungültige Geometrie, wenn sie mit einer Anzahl von Stellen aufgerufen wird, die Koordinaten innerhalb der Geometrie zusammenfallen lassen.
Verfügbarkeit: 2.5.0
Technischer Hintergrund
PostGIS speichert alle Koordinatenwerte als Gleitkommazahlen mit doppelter Genauigkeit, die 15 signifikante Stellen zuverlässig darstellen können. PostGIS kann jedoch verwendet werden, um Daten zu verwalten, die weniger als 15 signifikante Ziffern enthalten. Ein Beispiel sind TIGER-Daten, die als geografische Koordinaten mit sechs Nachkommastellen zur Verfügung gestellt werden (so dass nur neun signifikante Ziffern des Längengrads und acht signifikante Breitengrade erforderlich sind).
Wenn 15 signifikante Ziffern verfügbar sind, gibt es viele mögliche Darstellungen einer Zahl mit 9 signifikanten Ziffern. Eine Gleitkommazahl mit doppelter Genauigkeit verwendet 52 explizite Bits, um den Mantisse der Koordinate darzustellen. Nur 30 Bits werden benötigt, um eine Mantisse mit 9 signifikanten Ziffern darzustellen, wobei 22 unbedeutende Bits übrig bleiben; Wir können ihren Wert auf alles setzen, was wir wollen, und erhalten trotzdem eine zum Eingabewert passende Zahl. Beispielsweise kann der Wert 100.123456 durch die nächstliegenden Zahlen 100.123456000000, 100.123456000001 und 100.123456432199 dargestellt werden. Alle sind gleichermaßen gültig, da ST_AsText (geom, 6) bei allen dieser Eingaben das gleiche Ergebnis liefert. Da wir diese Bits auf einen beliebigen Wert setzen können, setzt ST_QuantizeCoordinates die 22 nicht signifikanten Bits auf Null. Für eine lange Koordinatensequenz wird dadurch ein Muster aus Blöcken von aufeinanderfolgenden Nullen erzeugt, das von PostgreSQL effizienter komprimiert wird.
| |
Von |
Beispiele
SELECT ST_AsText(ST_QuantizeCoordinates('POINT (100.123456 0)'::geometry, 4));
st_astext
-------------------------
POINT(100.123455047607 0)
WITH test AS (SELECT 'POINT (123.456789123456 123.456789123456)'::geometry AS geom) SELECT digits, encode(ST_QuantizeCoordinates(geom, digits), 'hex'), ST_AsText(ST_QuantizeCoordinates(geom, digits)) FROM test, generate_series(15, -15, -1) AS digits; digits | encode | st_astext --------+--------------------------------------------+------------------------------------------ 15 | 01010000005f9a72083cdd5e405f9a72083cdd5e40 | POINT(123.456789123456 123.456789123456) 14 | 01010000005f9a72083cdd5e405f9a72083cdd5e40 | POINT(123.456789123456 123.456789123456) 13 | 01010000005f9a72083cdd5e405f9a72083cdd5e40 | POINT(123.456789123456 123.456789123456) 12 | 01010000005c9a72083cdd5e405c9a72083cdd5e40 | POINT(123.456789123456 123.456789123456) 11 | 0101000000409a72083cdd5e40409a72083cdd5e40 | POINT(123.456789123456 123.456789123456) 10 | 0101000000009a72083cdd5e40009a72083cdd5e40 | POINT(123.456789123455 123.456789123455) 9 | 0101000000009072083cdd5e40009072083cdd5e40 | POINT(123.456789123418 123.456789123418) 8 | 0101000000008072083cdd5e40008072083cdd5e40 | POINT(123.45678912336 123.45678912336) 7 | 0101000000000070083cdd5e40000070083cdd5e40 | POINT(123.456789121032 123.456789121032) 6 | 0101000000000040083cdd5e40000040083cdd5e40 | POINT(123.456789076328 123.456789076328) 5 | 0101000000000000083cdd5e40000000083cdd5e40 | POINT(123.456789016724 123.456789016724) 4 | 0101000000000000003cdd5e40000000003cdd5e40 | POINT(123.456787109375 123.456787109375) 3 | 0101000000000000003cdd5e40000000003cdd5e40 | POINT(123.456787109375 123.456787109375) 2 | 01010000000000000038dd5e400000000038dd5e40 | POINT(123.45654296875 123.45654296875) 1 | 01010000000000000000dd5e400000000000dd5e40 | POINT(123.453125 123.453125) 0 | 01010000000000000000dc5e400000000000dc5e40 | POINT(123.4375 123.4375) -1 | 01010000000000000000c05e400000000000c05e40 | POINT(123 123) -2 | 01010000000000000000005e400000000000005e40 | POINT(120 120) -3 | 010100000000000000000058400000000000005840 | POINT(96 96) -4 | 010100000000000000000058400000000000005840 | POINT(96 96) -5 | 010100000000000000000058400000000000005840 | POINT(96 96) -6 | 010100000000000000000058400000000000005840 | POINT(96 96) -7 | 010100000000000000000058400000000000005840 | POINT(96 96) -8 | 010100000000000000000058400000000000005840 | POINT(96 96) -9 | 010100000000000000000058400000000000005840 | POINT(96 96) -10 | 010100000000000000000058400000000000005840 | POINT(96 96) -11 | 010100000000000000000058400000000000005840 | POINT(96 96) -12 | 010100000000000000000058400000000000005840 | POINT(96 96) -13 | 010100000000000000000058400000000000005840 | POINT(96 96) -14 | 010100000000000000000058400000000000005840 | POINT(96 96) -15 | 010100000000000000000058400000000000005840 | POINT(96 96)
Name
ST_RemovePoint — Entfernt einen Punkt aus einem Linienzug.
Synopsis
geometry ST_RemovePoint(geometry linestring, integer offset);
Beschreibung
Entfernt einen Punkt aus einem LineString; der Index beginnt mit 0. Nützlich, um einen geschlossenen Ring in einen offenen Linienzug umzuwandeln
Verfügbarkeit: 1.1.0
This function supports 3d and will not drop the z-index.
Beispiele
--stellt sicher, dass keine LINESTRINGS geschlossen sind,
--indem der Endpunkt entfernt wird. Unten wird angenommen, dass the_geom vom Datentyp LINESTRING ist
UPDATE sometable
SET the_geom = ST_RemovePoint(the_geom, ST_NPoints(the_geom) - 1)
FROM sometable
WHERE ST_IsClosed(the_geom) = true;
Name
ST_Reverse — Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
Synopsis
geometry ST_Reverse(geometry g1);
Name
ST_Segmentize — Gibt eine veränderte Geometrie/Geographie zurück, bei der kein Sement länger als der gegebene Abstand ist.
Synopsis
geometry ST_Segmentize(geometry geom, float max_segment_length);
geography ST_Segmentize(geography geog, float max_segment_length);
Beschreibung
Gibt eine veränderte Geometrie/Geographie zurück, bei der kein Sement länger als die gegebene max_segment_length ist. Die Entfernungsberechnung wird nur in 2D ausgeführt. Beim geometrischen Datentyp ist die Längeneinheit die Einheit des Koordinatenreferenzsystems. Beim geographischen Datentyp ist die Einheit Meter.
Verfügbarkeit: 1.2.2
Erweiterung: 3.0.0 - Das Segmentieren des geometrischen Datentyps ergibt nun Segmente gleicher Länge
Erweiterung: 2.3.0 - Das Segmentieren des geographischen Datentyps ergibt nun Segmente gleicher Länge
Erweiterung: mit 2.1.0 wurde die Unterstützung des geographischen Datentyps eingeführt.
Änderung: 2.1.0 Als Ergebnis der eingeführten Unterstützung für den geographischen Datentyp: Das Konstrukt SELECT ST_Segmentize('LINESTRING(1 2, 3 4)',0.5); resultiert in einen Funktionsfehler aufgrund von Mehrdeutigkeit. Sie benötigen korrekt typisierte Geoobjekte; Verwenden Sie z.B. ST_GeomFromText, ST_GeogFromText oder SELECT ST_Segmentize('LINESTRING(1 2, 3 4)'::geometry,0.5); für Ihre Geometrie-/Geographiespalte.
| |
Segmente werden lediglich verlängert. Die Länge von Segmenten, die kürzer als max_segment_length sind, wird nicht verändert. |
Beispiele
SELECT ST_AsText(ST_Segmentize(
ST_GeomFromText('MULTILINESTRING((-29 -27,-30 -29.7,-36 -31,-45 -33),(-45 -33,-46 -32))')
,5)
);
st_astext
--------------------------------------------------------------------------------------------------
MULTILINESTRING((-29 -27,-30 -29.7,-34.886615700134 -30.758766735029,-36 -31,
-40.8809353009198 -32.0846522890933,-45 -33),
(-45 -33,-46 -32))
(1 row)
SELECT ST_AsText(ST_Segmentize(ST_GeomFromText('POLYGON((-29 28, -30 40, -29 28))'),10));
st_astext
-----------------------
POLYGON((-29 28,-29.8304547985374 37.9654575824488,-30 40,-29.1695452014626 30.0345424175512,-29 28))
(1 row)
Name
ST_SetPoint — Einen Punkt eines Linienzuges durch einen gegebenen Punkt ersetzen.
Synopsis
geometry ST_SetPoint(geometry linestring, integer zerobasedposition, geometry point);
Beschreibung
Ersetzt den Punkt N eines Linienzuges mit dem gegebenen Punkt. Der Index beginnt mit 0. Negative Indizes werden rückwärts gezählt, sodasss -1 der letzte Punkt ist. Dies findet insbesondere bei Triggern verwendung, wenn man die Beziehung zwischen den Verbindungsstücken beim Verschieben von Knoten erhalten will
Verfügbarkeit: 1.1.0
Änderung: 2.3.0 : negatives Indizieren
This function supports 3d and will not drop the z-index.
Beispiele
--Ändert den ersten Punkt eines Linienzuges von -1 3 auf -1 1
SELECT ST_AsText(ST_SetPoint('LINESTRING(-1 2,-1 3)', 0, 'POINT(-1 1)'));
st_astext
-----------------------
LINESTRING(-1 1,-1 3)
---Ändert den Endpunkt eines Linienzuges (diesmal ein 3D-Linienzug)
SELECT ST_AsEWKT(ST_SetPoint(foo.the_geom, ST_NumPoints(foo.the_geom) - 1, ST_GeomFromEWKT('POINT(-1 1 3)')))
FROM (SELECT ST_GeomFromEWKT('LINESTRING(-1 2 3,-1 3 4, 5 6 7)') As the_geom) As foo;
st_asewkt
-----------------------
LINESTRING(-1 2 3,-1 3 4,-1 1 3)
SELECT ST_AsText(ST_SetPoint(g, -3, p))
FROM ST_GEomFromText('LINESTRING(0 0, 1 1, 2 2, 3 3, 4 4)') AS g
, ST_PointN(g,1) as p;
st_astext
-----------------------
LINESTRING(0 0,1 1,0 0,3 3,4 4)
Name
ST_SnapToGrid — Fängt alle Punkte der Eingabegeometrie auf einem regelmäßigen Gitter.
Synopsis
geometry ST_SnapToGrid(geometry geomA, float originX, float originY, float sizeX, float sizeY);
geometry ST_SnapToGrid(geometry geomA, float sizeX, float sizeY);
geometry ST_SnapToGrid(geometry geomA, float size);
geometry ST_SnapToGrid(geometry geomA, geometry pointOrigin, float sizeX, float sizeY, float sizeZ, float sizeM);
Beschreibung
Variante 1, 2 und 3: Fängt alle Punkte der Eingabegeometrie auf den Gitterpunkten, die durch Ursprung und Gitterkästchengröße festgelegt sind. Aufeinanderfolgende Punkte, die in dasselbe Gitterkästchen fallen, werden gelöscht, wobei NULL zurückgegeben wird, wenn nicht mehr genug Punkte für den jeweiligen geometrischen Datentyp vorhanden sind. Collapsed geometries in a collection are stripped from it. Kollabierte Geometrien einer Kollektion werden von dieser entfernt. Nützlich um die Genauigkeit zu verringern.
Variante 4: wurde mit 1.1.0 eingeführt - Fängt alle Punkte der Eingabegeometrie auf den Gitterpunkten, welche durch den Ursprung des Gitters (der zweite Übergabewert muss ein Punkt sein) und die Gitterkästchengröße bestimmt sind. Geben Sie 0 als Größe für jene Dimension an, die nicht auf den Gitterpunkten gefangen werden soll.
| |
Die zurückgegebene Geometrie kann ihre Simplizität verlieren (siehe ST_IsSimple). |
| |
Vor Release 1.1.0 gab diese Funktion immer eine 2D-Geometrie zurück. Ab 1.1.0 hat die zurückgegebene Geometrie dieselbe Dimensionalität wie die Eingabegemetrie, wobei höhere Dimensionen unangetastet bleiben. Verwenden Sie die Version, welche einen zweiten geometrischen Übergabewert annimmt, um sämtliche Grid-Dimensionen zu bestimmen. |
Verfügbarkeit: 1.0.0RC1
Verfügbarkeit: 1.1.0, Unterstützung für Z und M
This function supports 3d and will not drop the z-index.
Beispiele
--Fängt die Geometrien an einem Gitter mit einer Genauigkeit von 10^-3
UPDATE mytable
SET the_geom = ST_SnapToGrid(the_geom, 0.001);
SELECT ST_AsText(ST_SnapToGrid(
ST_GeomFromText('LINESTRING(1.1115678 2.123, 4.111111 3.2374897, 4.11112 3.23748667)'),
0.001)
);
st_astext
-------------------------------------
LINESTRING(1.112 2.123,4.111 3.237)
--Fängt eine 4D-Geometrie
SELECT ST_AsEWKT(ST_SnapToGrid(
ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 2.3456 1.11111,
4.111111 3.2374897 3.1234 1.1111, -1.11111112 2.123 2.3456 1.1111112)'),
ST_GeomFromEWKT('POINT(1.12 2.22 3.2 4.4444)'),
0.1, 0.1, 0.1, 0.01) );
st_asewkt
------------------------------------------------------------------------------
LINESTRING(-1.08 2.12 2.3 1.1144,4.12 3.22 3.1 1.1144,-1.08 2.12 2.3 1.1144)
--Bei einer 4D-Geometrie - ST_SnapToGrid(geom,size) behandelt nur die X- und Y-Koordinaten und belässt die M- und Z-Koordinaten
SELECT ST_AsEWKT(ST_SnapToGrid(ST_GeomFromEWKT('LINESTRING(-1.1115678 2.123 3 2.3456,
4.111111 3.2374897 3.1234 1.1111)'),
0.01) );
st_asewkt
---------------------------------------------------------
LINESTRING(-1.11 2.12 3 2.3456,4.11 3.24 3.1234 1.1111)
Name
ST_Snap — Fängt die Segmente und Knoten einer Eingabegeometrie an den Knoten einer Referenzgeometrie.
Synopsis
geometry ST_Snap(geometry input, geometry reference, float tolerance);
Beschreibung
Fängt die Knoten und Segmente einer Geometrie an den Knoten einer anderen Geometrie. Eine Entfernungstoleranz bestimmt, wo das Fangen durchgeführt wird. Die Ergebnisgeometrie ist die Eingabegeometrie mit gefangenen Knoten. Wenn kein Fangen auftritt, wird die Eingabegeometrie unverändert ausgegeben..
Eine Geometrie an einer anderen zu fangen, kann die Robustheit von Überlagerungs-Operationen verbessern, indem nahe zusammenfallende Kanten beseitigt werden (diese verursachen Probleme bei der Knoten- und Verschneidungsberechnung).
Übermäßiges Fangen kann zu einer invaliden Topologie führen. Die Anzahl und der Ort an dem Knoten sicher gefangen werden können wird mittels Heuristik bestimmt. Dies kann allerdings dazu führen, dass einige potentielle Knoten nicht gefangen werden.
| |
Die zurückgegebene Geometrie kann ihre Simplizität (see ST_IsSimple) und Valididät (see ???) verlieren. |
Performed by the GEOS module.
Verfügbarkeit: 2.0.0
Beispiele
 Ein Mehrfachpolygon mit einem Linienzug (vor dem Fangen) | |
 Ein Mehrfachpolygon das an einem Linienzug gefangen wird; die Toleranz beträgt 1.01 der Entfernung. Das neue Mehrfachpolygon wird mit dem betreffenden Linienzug angezeigt.
SELECT ST_AsText(ST_Snap(poly,line, ST_Distance(poly,line)*1.01)) AS polysnapped
FROM (SELECT
ST_GeomFromText('MULTIPOLYGON(
((26 125, 26 200, 126 200, 126 125, 26 125 ),
( 51 150, 101 150, 76 175, 51 150 )),
(( 151 100, 151 200, 176 175, 151 100 )))') As poly,
ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
) As foo;
polysnapped
---------------------------------------------------------------------
MULTIPOLYGON(((26 125,26 200,126 200,126 125,101 100,26 125),
(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))
|  Ein Mehrfachpolygon das an einem Linienzug gefangen wird; die Toleranz beträgt 1.25 der Entfernung. Das neue Mehrfachpolygon wird mit dem betreffenden Linienzug angezeigt.
SELECT ST_AsText(
ST_Snap(poly,line, ST_Distance(poly,line)*1.25)
) AS polysnapped
FROM (SELECT
ST_GeomFromText('MULTIPOLYGON(
(( 26 125, 26 200, 126 200, 126 125, 26 125 ),
( 51 150, 101 150, 76 175, 51 150 )),
(( 151 100, 151 200, 176 175, 151 100 )))') As poly,
ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
) As foo;
polysnapped
---------------------------------------------------------------------
MULTIPOLYGON(((5 107,26 200,126 200,126 125,101 100,54 84,5 107),
(51 150,101 150,76 175,51 150)),((151 100,151 200,176 175,151 100)))
|
 Ein Linienzug der an dem ursprünglichen Mehrfachpolygon gefangen wird; die Toleranz beträgt 1.01 der Entfernung. Das neue Linienzug wird mit dem betreffenden Mehrfachpolygon angezeigt.
SELECT ST_AsText(
ST_Snap(line, poly, ST_Distance(poly,line)*1.01)
) AS linesnapped
FROM (SELECT
ST_GeomFromText('MULTIPOLYGON(
((26 125, 26 200, 126 200, 126 125, 26 125),
(51 150, 101 150, 76 175, 51 150 )),
((151 100, 151 200, 176 175, 151 100)))') As poly,
ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
) As foo;
linesnapped
----------------------------------------
LINESTRING(5 107,26 125,54 84,101 100)
|  Ein Linienzug der an dem ursprünglichen Mehrfachpolygon gefangen wird; die Toleranz beträgt 1.25 der Entfernung. Das neue Linienzug wird mit dem betreffenden Mehrfachpolygon angezeigt.
SELECT ST_AsText(
ST_Snap(line, poly, ST_Distance(poly,line)*1.25)
) AS linesnapped
FROM (SELECT
ST_GeomFromText('MULTIPOLYGON(
(( 26 125, 26 200, 126 200, 126 125, 26 125 ),
(51 150, 101 150, 76 175, 51 150 )),
((151 100, 151 200, 176 175, 151 100 )))') As poly,
ST_GeomFromText('LINESTRING (5 107, 54 84, 101 100)') As line
) As foo;
linesnapped
---------------------------------------
LINESTRING(26 125,54 84,101 100)
|
Name
ST_QuantizeCoordinates — Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
Synopsis
geometry ST_SetSRID(geometry geom, integer srid);
Beschreibung
Gibt die Geometrie in umgekehrter Knotenreihenfolge zurück.
The ords parameter is a 2-characters string naming the ordinates to swap. Valid names are: x,y,z and m.
Verfügbarkeit: 2.2.0
This method supports Circular Strings and Curves
This function supports 3d and will not drop the z-index.
This function supports M coordinates.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Name
ST_AsEWKT — Gibt die Well-known-Text(WKT) Darstellung der Geometrie mit den SRID-Metadaten zurück.
Synopsis
text ST_AsEWKT(geometry g1);
text ST_AsEWKT(geography g1);
Beschreibung
Gibt die Well-known-Text Darstellung der Geometrie mit vorausgestellter SRID zurück.
| |
Die WKT Spezifikation bezieht die SRID nicht mit ein. Für die OGC WKT-Darstellung verwenden Sie bitte ST_AsText. |
| |
Das WKT Format erhält die Genauigkeit von Fließpunktzahlen nicht. Um das Abschneiden von Kommastellen zu verhindern, benutzen Sie bitte das ST_AsBinary oder das ST_AsEWBK Format für die Übertragung. |
| |
ST_AsEWKT ist die Umkehrfunktion von ???. Verwenden Sie bitte ??? um eine PostGIS Geometrie aus einer ST_AsEWKT Darstellung zu erstellen. |
Erweiterung: Mit 2.0.0 wurde die Unterstützung für den geographischen Datentyp, polyedrische Oberflächen, Dreiecke und TIN eingeführt.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
SELECT ST_AsEWKT('0103000020E61000000100000005000000000000
000000000000000000000000000000000000000000000000000000
F03F000000000000F03F000000000000F03F000000000000F03
F000000000000000000000000000000000000000000000000'::geometry);
st_asewkt
--------------------------------
SRID=4326;POLYGON((0 0,0 1,1 1,1 0,0 0))
(1 row)
SELECT ST_AsEWKT('0108000080030000000000000060E30A4100000000785C0241000000000000F03F0000000018
E20A4100000000485F024100000000000000400000000018
E20A4100000000305C02410000000000000840')
--st_asewkt---
CIRCULARSTRING(220268 150415 1,220227 150505 2,220227 150406 3)
Name
ST_AsText — Gibt die Well-known-Text(WKT) Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
Synopsis
bytea ST_AsBinary(geometry g1);
bytea ST_AsBinary(geometry g1, text NDR_or_XDR);
bytea ST_AsBinary(geography g1);
bytea ST_AsBinary(geography g1, text NDR_or_XDR);
Beschreibung
Das dritte Argument kann verwendet werden um die maximale Anzahl der Dezimalstellen in der Ausgabe zu beschränken (Sandardwert ist 15).
| |
Die WKT Spezifikation bezieht die SRID nicht mit ein. Um SRID als einen Teil der Daten zu erhalten, verwenden Sie bitte die nicht standardkonforme PostGIS Funktion ST_AsEWKT |
| |
Das WKT Format erhält die Genauigkeit von Fließpunktzahlen nicht. Um das Abschneiden von Kommastellen zu verhindern, benutzen Sie bitte das ST_AsBinary oder das ST_AsEWBK Format für die Übertragung. |
| |
ST_AsText ist die Umkehrfunktion von ???. Verwenden Sie bitte ??? um eine PostGIS Geometrie aus einer ST_AsText Darstellung zu konvertieren. |
Verfügbarkeit: 1.5 - Unterstützung von geograpischen Koordinaten.
Erweiterung: 2.0.0 - Unterstützung für höherdimensionale Koordinatensysteme eingeführt.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3: 5.1.25
This method supports Circular Strings and Curves
Beispiele
SELECT ST_AsText('01030000000100000005000000000000000000
000000000000000000000000000000000000000000000000
F03F000000000000F03F000000000000F03F000000000000F03
F000000000000000000000000000000000000000000000000');
st_astext
--------------------------------
POLYGON((0 0,0 1,1 1,1 0,0 0))
(1 row)Providing the precision is optional.
SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'))
st_astext
------------------------------
POINT(111.1111111 1.1111111)
(1 row)SELECT ST_AsText(GeomFromEWKT('SRID=4326;POINT(111.1111111 1.1111111)'),2)
st_astext
--------------------
POINT(111.11 1.11)
(1 row)- 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_AsHEXEWKB — Gibt eine Geometrie im HEXEWKB Format (als Text) aus; verwendet entweder die Little-Endian (NDR) oder die Big-Endian (XDR) Zeichenkodierung.
Name
ST_AsBinary — Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie/Geographie ohne die SRID Metadaten zurück.
Synopsis
bytea ST_AsBinary(geometry g1);
bytea ST_AsBinary(geometry g1, text NDR_or_XDR);
bytea ST_AsBinary(geography g1);
bytea ST_AsBinary(geography g1, text NDR_or_XDR);
Beschreibung
Gibt die Well-known Binary Darstellung der Geometrie aus. Die Funktion hat 2 Varianten. Die erste Variante nimmt einen nicht als Endian kodierten Parameter entgegen und setzt diesen in das Endian der Rechnerarchitektur um. Die zweite Variante nimmt ein zweites Argument, welches die Zeichenkodierung festlegt - nämlich Little-Endian ('NDR') oder Big-Endian ('XDR') Zeichenkodierung.
Dies ist nützlich mit binären Cursor, um Daten aus der Datenbank zu holen ohne dass diese in eine Zeichenkette-Darstellung konvertiert werden.
| |
Die WKB Spezifikation bezieht die SRID nicht mit ein. Um eine WKB-Darstellung im SRID-Format zu erhalten verwenden Sie bitte ST_AsEWKB. |
| |
ST_AsBinary ist das Gegenstück von ??? für Geometrie. Verwenden Sie ??? um eine ST_AsBinary Darstellung in eine PostGIS Geometrie zu konvertieren. |
| |
Das Standardverhalten von PostgreSQL 9.0 wurde dahingegen geändert, dass die Ausgabe von BYTEA jetzt in hexadezimaler Kodierung erfolgt. ST_AsBinary ist das Gegenteil von ??? für Geometrie. Falls Ihre graphischen Werkzeuge die alte Verhaltensweise benötigen, dann führen Sie bitte SET bytea_output='excape' in Ihrer Datenbank aus. |
Erweiterung: 2.0.0 - Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
Erweiterung: 2.0.0 - Unterstützung für höherdimensionale Koordinatensysteme eingeführt.
Erweiterung: 2.0.0 Unterstützung zum Festlegen des Endian beim geographischen Datentyp eingeführt.
Verfügbarkeit: 1.5.0 Unterstützung von geograpischen Koordinaten.
Änderung: 2.0.0 - Eingabewerte für diese Funktion dürfen nicht "unknown" sein -- es muss sich um eine Geometrie handeln. Konstrukte, wie ST_AsBinary('POINT(1 2)'), sind nicht länger gültig und geben folgende Fehlermeldung aus: n st_asbinary(unknown) is not unique error. Dieser Code muss in ST_AsBinary('POINT(1 2)'::geometry); geändert werden. Falls dies nicht möglich ist, so installieren Sie bitte legacy.sql.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.1.1
This method implements the SQL/MM specification. SQL-MM 3: 5.1.37
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Beispiele
SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_asbinary
--------------------------------
\001\003\000\000\000\001\000\000\000\005
\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000
\000\000\000\360?\000\000\000\000\000\000
\360?\000\000\000\000\000\000\360?\000\000
\000\000\000\000\360?\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000
(1 row)SELECT ST_AsBinary(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), 'XDR');
st_asbinary
--------------------------------
\000\000\000\000\003\000\000\000\001\000\000\000\005\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000
\000?\360\000\000\000\000\000\000?\360\000\000\000\000\000\000?\360\000\000
\000\000\000\000?\360\000\000\000\000\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000
(1 row)Name
ST_AsEWKB — Gibt die Well-known-Binary(WKB)-Darstellung der Geometrie mit den SRID Metadaten zurück.
Synopsis
bytea ST_AsEWKB(geometry g1);
bytea ST_AsEWKB(geometry g1, text NDR_or_XDR);
Beschreibung
Gibt die Well-known Binary Darstellung der Geometrie mit den SRID Metadaten aus. Die Funktion hat 2 Varianten. Die erste Variante nimmt einen nicht als Endian kodierten Parameter entgegen und setzt diesen auf Little-Endian. Die zweite Variante nimmt ein zweites Argument, welches die Zeichenkodierung festlegt - nämlich Little-Endian ('NDR') oder Big-Endian ('XDR') Zeichenkodierung.
Dies ist nützlich mit binären Cursor, um Daten aus der Datenbank zu holen ohne dass diese in eine Zeichenkette-Darstellung konvertiert werden.
| |
Die WKT Spezifikation bezieht die SRID nicht mit ein. Für die OGC WKB-Darstellung verwenden Sie bitte ST_AsBinary. |
| |
ST_AsEWKB ist das Gegenstück von ST_GeomFromEWKB.. Verwenden Sie ST_GeomFromEWKB um eine ST_AsEWKB Darstellung in eine PostGIS Geometrie zu konvertieren. |
Erweiterung: 2.0.0 - Unterstützung für polyedrische Oberflächen, Dreiecke und TIN eingeführt.
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_asewkb
--------------------------------
\001\003\000\000 \346\020\000\000\001\000
\000\000\005\000\000\000\000
\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000
\000\000\360?\000\000\000\000\000\000\360?
\000\000\000\000\000\000\360?\000\000\000\000\000
\000\360?\000\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000\000\000
(1 row)SELECT ST_AsEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326), 'XDR');
st_asewkb
--------------------------------
\000 \000\000\003\000\000\020\346\000\000\000\001\000\000\000\005\000\000\000\000\
000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000?
\360\000\000\000\000\000\000?\360\000\000\000\000\000\000?\360\000\000\000\000
\000\000?\360\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000\000
\000\000\000\000\000\000\000\000\000\000\000\000\000
Name
ST_AsHEXEWKB — Gibt eine Geometrie im HEXEWKB Format (als Text) aus; verwendet entweder die Little-Endian (NDR) oder die Big-Endian (XDR) Zeichenkodierung.
Synopsis
text ST_AsHEXEWKB(geometry g1, text NDRorXDR);
text ST_AsHEXEWKB(geometry g1);
Beschreibung
Gibt eine Geometrie im HEXEWKB Format (als Text) aus; verwendet entweder die Little-Endian (NDR) oder die Big-Endian (XDR) Zeichenkodierung. Wenn keine Zeichenkodierung angegeben wurde, wird NDR verwendet.
| |
Verfügbarkeit: 1.2.2 |
This function supports 3d and will not drop the z-index.
This method supports Circular Strings and Curves
Beispiele
SELECT ST_AsHEXEWKB(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
--gibt die selbe Antword wie
SELECT ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326)::text;
st_ashexewkb
--------
0103000020E6100000010000000500
00000000000000000000000000000000
00000000000000000000000000000000F03F
000000000000F03F000000000000F03F000000000000F03
F000000000000000000000000000000000000000000000000- ST_AsEncodedPolyline — Erzeugt eine codierte Polylinie aus einer LineString Geometrie.
- ST_AsGeobuf — Gibt eine Menge an Zeilen in der Geobuf Darstellung aus.
- ST_AsGeoJSON — Gibt die Geometrie eines GeoJSON Elements zurück.
- ST_AsGML — Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
- ST_AsKML — Gibt die Geometrie als ein KML Element aus. Mehrere Varianten. Standardmäßig ist version=2 und precision=15
- ST_AsLatLonText — Gibt die "Grad, Minuten, Sekunden"-Darstellung für den angegebenen Punkt aus.
- ST_AsMVTGeom — Transformiert eine Geometrie in das Koordinatensystem eines Mapbox Vector Tiles.
- ST_AsMVT — Gibt eine Menge an Zeilen in der Geobuf Darstellung aus.
- ST_AsSVG — Gibt ein Geoobjekt als SVG-Pfadgeometrie zurück. Unterstützt den geometrischen und den geographischen Datentyp.
- 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.
Name
ST_AsEncodedPolyline — Erzeugt eine codierte Polylinie aus einer LineString Geometrie.
Synopsis
text ST_AsEncodedPolyline(geometry geom, integer precision=5);
Beschreibung
Gibt die Geometrie als codierte Polylinie zurück. Dieses Format ist geeignet, wenn Sie Google Maps verwenden.
Optional precision specifies how many decimal places will be preserved in Encoded Polyline. Value should be the same on encoding and decoding, or coordinates will be incorrect.
Verfügbarkeit: 2.2.0
Beispiele
Grundlegendes
SELECT ST_AsEncodedPolyline(GeomFromEWKT('SRID=4326;LINESTRING(-120.2 38.5,-120.95 40.7,-126.453 43.252)'));
--result--
|_p~iF~ps|U_ulLnnqC_mqNvxq`@
Anwendung in Verbindung mit LINESTRING und ST_Segmentize für den geographischen Datentyp, und auf Google Maps stellen
-- das SQL von Boston nach San Francisco, segmentiert alle 100 KM
SELECT ST_AsEncodedPolyline(
ST_Segmentize(
ST_GeogFromText('LINESTRING(-71.0519 42.4935,-122.4483 37.64)'),
100000)::geometry) As encodedFlightPath;In JavaScript sieht dies ungefähr wie folgt aus, wobei die $ Variable durch das Abfrageergebnis ersetzt wird
<script type="text/javascript" src="http://maps.googleapis.com/maps/api/js?libraries=geometry"
></script>
<script type="text/javascript">
flightPath = new google.maps.Polyline({
path: google.maps.geometry.encoding.decodePath("$encodedFlightPath"),
map: map,
strokeColor: '#0000CC',
strokeOpacity: 1.0,
strokeWeight: 4
});
</script>
Name
ST_AsGeobuf — Gibt eine Menge an Zeilen in der Geobuf Darstellung aus.
Synopsis
bytea ST_AsGeobuf(anyelement set row);
bytea ST_AsGeobuf(anyelement row, text geom_name);
Beschreibung
Gibt Zeilen einer FeatureCollection in der Geobuf Darstellung (https://github.com/mapbox/geobuf) aus. Von jeder Eingabegeometrie wird die maximale Genauigkeit analysiert, um eine optimale Speicherung zu erreichen. Anmerkung: In der jetzigen Form kann Geobuf nicht "gestreamt" werden, wodurch die gesamte Ausgabe im Arbeitsspeicher zusammengestellt wird.
row Datenzeilen mit zumindest einer Geometriespalte.
geom_name ist die Bezeichnung der Geometriespalte in den Datenzeilen. Wenn NULL, dann wird standardmäßig die erste aufgefundene Geometriespalte verwendet.
Verfügbarkeit: 2.4.0
Name
ST_AsGeoJSON — Gibt die Geometrie eines GeoJSON Elements zurück.
Synopsis
text ST_AsGeoJSON(geometry geom, integer maxdecimaldigits=15, integer options=0);
text ST_AsGeoJSON(geography geog, integer maxdecimaldigits=15, integer options=0);
text ST_AsGeoJSON(integer gj_version, geometry geom, integer maxdecimaldigits=15, integer options=0);
text ST_AsGeoJSON(integer gj_version, geography geog, integer maxdecimaldigits=15, integer options=0);
Beschreibung
Gibt die Geometrie als Geometrische Javascript Objekt Notation (GeoJSON) Element aus. (Vggl. GeoJSON specifications 1.0). Es werden sowohl 2D- als auch 3D-Geometrien unterstützt. GeoJSON unterstützt lediglich den geometrischer Datentyp SFS 1.1 (hat z.B. keine Unterstützung für Kurven).
The maxdecimaldigits argument may be used to reduce the maximum number of decimal places used in output (defaults to 9). If you are using EPSG:4326 and are outputting the geometry only for display, maxdecimaldigits=6 can be a good choice for many maps.
Mit dem letzten 'options' Argument kann eine BBox oder ein CRS zur GeoJSON Ausgabe hinzugefügt werden:
0: bedeutet keine Option (Standardwert)
1: GeoJSON Bbox
2: GeoJSON CRS-Kurzform (z.B. EPSG:4326)
4: GeoJSON CRS-Langform (z.B. urn:ogc:def:crs:EPSG::4326)
2: GeoJSON CRS-Kurzform (z.B. EPSG:4326)
Verfügbarkeit: 1.3.4
Verfügbarkeit: 1.5.0 Unterstützung von geograpischen Koordinaten.
Änderung: 2.0.0 Unterstützung für Standardargumente und benannte Argumente.
Änderung: 2.0.0 Unterstützung für Standardargumente und benannte Argumente.
Changed: 3.0.0 output SRID if not EPSG:4326.
This function supports 3d and will not drop the z-index.
Beispiele
GeoJSON format is popular among web mapping frameworks.
You can test and view your GeoJSON data online on geojson.io.
To build FeatureCollection:
select json_build_object(
'type', 'FeatureCollection',
'features', json_agg(ST_AsGeoJSON(t.*)::json)
)
from ( values (1, 'one', 'POINT(1 1)'::geometry),
(2, 'two', 'POINT(2 2)'),
(3, 'three', 'POINT(3 3)')
) as t(id, name, geom);{"type" : "FeatureCollection", "features" : [{"type": "Feature", "geometry": {"type":"Point","coordinates":[1,1]}, "properties": {"id": 1, "name": "one"}}, {"type": "Feature", "geometry": {"type":"Point","coordinates":[2,2]}, "properties": {"id": 2, "name": "two"}}, {"type": "Feature", "geometry": {"type":"Point","coordinates":[3,3]}, "properties": {"id": 3, "name": "three"}}]}To get Features as records:
SELECT ST_AsGeoJSON(t.*) FROM (VALUES (1, 'one', 'POINT(1 1)'::geometry), (2, 'two', 'POINT(2 2)'), (3, 'three', 'POINT(3 3)')) AS t(id, name, geom);
st_asgeojson
-----------------------------------------------------------------------------------------------------------------
{"type": "Feature", "geometry": {"type":"Point","coordinates":[1,1]}, "properties": {"id": 1, "name": "one"}}
{"type": "Feature", "geometry": {"type":"Point","coordinates":[2,2]}, "properties": {"id": 2, "name": "two"}}
{"type": "Feature", "geometry": {"type":"Point","coordinates":[3,3]}, "properties": {"id": 3, "name": "three"}}
Don't forget to transform your data to WGS84 longitude, latitude to conform with RFC7946:
SELECT ST_AsGeoJSON(ST_Transform(geom,4326)) from fe_edges limit 1;
SELECT ST_AsGeoJSON(the_geom) from fe_edges limit 1;
st_asgeojson
-----------------------------------------------------------------------------------------------------------
{"type":"MultiLineString","coordinates":[[[-89.734634999999997,31.492072000000000],
[-89.734955999999997,31.492237999999997]]]}
(1 row)
--3d point
SELECT ST_AsGeoJSON('LINESTRING(1 2 3, 4 5 6)');
st_asgeojson
-----------------------------------------------------------------------------------------
{"type":"LineString","coordinates":[[1,2,3],[4,5,6]]}You can also use it with 3D geometries:
SELECT ST_AsGeoJSON('LINESTRING(1 2 3, 4 5 6)');{"type":"LineString","coordinates":[[1,2,3],[4,5,6]]}Name
ST_AsGML — Gibt die Geometrie als GML-Element - Version 2 oder 3 - zurück.
Synopsis
text ST_AsGML(geometry geom, integer maxdecimaldigits=15, integer options=0);
text ST_AsGML(geography geog, integer maxdecimaldigits=15, integer options=0);
text ST_AsGML(integer version, geometry geom, integer maxdecimaldigits=15, integer options=0, text nprefix=null, text id=null);
text ST_AsGML(integer version, geography geog, integer maxdecimaldigits=15, integer options=0, text nprefix=null, text id=null);
Beschreibung
Gibt die Geometrie als ein Geography Markup Language (GML) Element zurück. Der Versionsparameter kann 2 oder 3 sein, falls angegeben. Wenn kein Versionsparameter angegeben ist, wird dieser standardmäßig mit 2 angenommen. Das Genauigkeitsargument "precision" kann verwendet werden, um die Anzahl der Dezimalstellen (maxdecimaldigits) bei der Ausgabe zu reduzieren (standardmäßig 15).
GML 2 verweist auf Version 2.1.2, GML 3 auf Version 3.1.1
Der Übergabewert "options" ist ein Bitfeld. Es kann verwendet werden um das Koordinatenreferenzsystem bei der GML Ausgabe zu bestimmen und um die Daten in Länge/Breite anzugeben.
0: GML Kurzform für das CRS (z.B. EPSG:4326), Standardwert
1: GML Langform für das CRS (z.B. urn:ogc:def:crs:EPSG::4326)
2: Nur für GML 3, entfernt das srsDimension Attribut von der Ausgabe.
4: Nur für GML 3, Für Linien verwenden Sie bitte den Tag <LineString> anstatt <Curve>.
16: Deklarieren, dass die Daten in Breite/Länge (z.B. SRID=4326) vorliegen. Standardmäßig wird angenommen, dass die Daten planar sind. Diese Option ist nur bei Ausgabe in GML 3.1.1, in Bezug auf die Anordnung der Achsen sinnvoll. Falls Sie diese setzen, werden die Koordinaten von Länge/Breite auf Breite/Länge vertauscht.
32: Ausgabe der BBox der Geometrie (Umhüllende/Envelope).
Der Übergabewert 'namespace prefix' kann verwendet werden, um ein benutzerdefiniertes Präfix für den Namensraum anzugeben, oder kein Präfix (wenn leer). Wenn Null oder weggelassen, so wird das Präfix "gml" verwendet.
Verfügbarkeit: 1.3.2
Verfügbarkeit: 1.5.0 Unterstützung von geograpischen Koordinaten.
Erweiterung: 2.0.0 Unterstützung durch Präfix eingeführt. Für GML3 wurde die Option 4 eingeführt, um die Verwendung von LineString anstatt von Kurven für Linien zu erlauben. Ebenfalls wurde die GML3 Unterstützung für polyedrische Oberflächen und TINS eingeführt, sowie die Option 32 zur Ausgabe der BBox.
Änderung: 2.0.0 verwendet standardmäßig benannte Argumente.
Erweiterung: 2.1.0 Für GML 3 wurde die Unterstützung einer ID eingeführt.
| |
Nur die Version 3+ von ST_AsGML unterstützt polyedrische Oberflächen und TINs. |
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele: Version 2
SELECT ST_AsGML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_asgml
--------
<gml:Polygon srsName="EPSG:4326"
><gml:outerBoundaryIs
><gml:LinearRing
><gml:coordinates
>0,0 0,1 1,1 1,0 0,0</gml:coordinates
></gml:LinearRing
></gml:outerBoundaryIs
></gml:Polygon
>
Beispiele: Version 3
-- Koordinaten umdrehen und Ausgabe in erweitertem EPSG (16 | 1)--
SELECT ST_AsGML(3, ST_GeomFromText('POINT(5.234234233242 6.34534534534)',4326), 5, 17);
st_asgml
--------
<gml:Point srsName="urn:ogc:def:crs:EPSG::4326"
><gml:pos
>6.34535 5.23423</gml:pos
></gml:Point
>
-- Die Umhüllende/Envelope ausgeben (32) --
SELECT ST_AsGML(3, ST_GeomFromText('LINESTRING(1 2, 3 4, 10 20)',4326), 5, 32);
st_asgml
--------
<gml:Envelope srsName="EPSG:4326">
<gml:lowerCorner
>1 2</gml:lowerCorner>
<gml:upperCorner
>10 20</gml:upperCorner>
</gml:Envelope
>
-- Die Umhüllende (32) ausgeben, umgedreht (Breite/Länge anstatt Länge/Bereite) (16), long srs (1)= 32 | 16 | 1 = 49 --
SELECT ST_AsGML(3, ST_GeomFromText('LINESTRING(1 2, 3 4, 10 20)',4326), 5, 49);
st_asgml
--------
<gml:Envelope srsName="urn:ogc:def:crs:EPSG::4326">
<gml:lowerCorner
>2 1</gml:lowerCorner>
<gml:upperCorner
>20 10</gml:upperCorner>
</gml:Envelope
>
-- Polyeder Beispiel --
SELECT ST_AsGML(3, ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
st_asgml
--------
<gml:PolyhedralSurface>
<gml:polygonPatches>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3"
>0 0 0 0 0 1 0 1 1 0 1 0 0 0 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3"
>0 0 0 0 1 0 1 1 0 1 0 0 0 0 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3"
>0 0 0 1 0 0 1 0 1 0 0 1 0 0 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3"
>1 1 0 1 1 1 1 0 1 1 0 0 1 1 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3"
>0 1 0 0 1 1 1 1 1 1 1 0 0 1 0</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
<gml:PolygonPatch>
<gml:exterior>
<gml:LinearRing>
<gml:posList srsDimension="3"
>0 0 1 1 0 1 1 1 1 0 1 1 0 0 1</gml:posList>
</gml:LinearRing>
</gml:exterior>
</gml:PolygonPatch>
</gml:polygonPatches>
</gml:PolyhedralSurface
>
Name
ST_AsKML — Gibt die Geometrie als ein KML Element aus. Mehrere Varianten. Standardmäßig ist version=2 und precision=15
Synopsis
text ST_AsSVG(geometry geom, integer rel=0, integer maxdecimaldigits=15);
text ST_AsSVG(geography geog, integer rel=0, integer maxdecimaldigits=15);
Beschreibung
Gibt die Geometrie als ein Keyhole Markup Language (KML) Element zurück. Diese Funktion verfügt über mehrere Varianten. Die maximale Anzahl der Dezimalstellen die bei der Ausgabe verwendet wird (standardmäßig 15), die Version ist standardmäßig 2 und der Standardnamensraum hat kein Präfix.
Version 1: ST_AsKML(geom_or_geog, maxdecimaldigits) / version=2 / maxdecimaldigits=15
Version 2: ST_AsKML(version, geom_or_geog, maxdecimaldigits, nprefix) maxdecimaldigits=15 / nprefix=NULL
| |
Setzt voraus, dass PostGIS mit Proj-Unterstützung kompiliert wurde. Verwenden Sie bitte ???, um festzustellen ob mit proj kompiliert wurde. |
| |
Verfügbarkeit: 1.2.2 - spätere Varianten ab 1.3.2 nehmen den Versionsparameter mit auf |
| |
Erweiterung: 2.0.0 - Präfix Namensraum hinzugefügt. Standardmäßig kein Präfix |
| |
Änderung: 2.0.0 verwendet Standardargumente und unterstützt benannte Argumente. |
| |
Die Ausgabe AsKML funktioniert nicht bei Geometrien ohne SRID |
This function supports 3d and will not drop the z-index.
Beispiele
SELECT ST_AsKML(ST_GeomFromText('POLYGON((0 0,0 1,1 1,1 0,0 0))',4326));
st_askml
--------
<Polygon
><outerBoundaryIs
><LinearRing
><coordinates
>0,0 0,1 1,1 1,0 0,0</coordinates
></LinearRing
></outerBoundaryIs
></Polygon>
--3D Linienzug
SELECT ST_AsKML('SRID=4326;LINESTRING(1 2 3, 4 5 6)');
<LineString
><coordinates
>1,2,3 4,5,6</coordinates
></LineString>
Name
ST_AsLatLonText — Gibt die "Grad, Minuten, Sekunden"-Darstellung für den angegebenen Punkt aus.
Synopsis
text ST_AsLatLonText(geometry pt, text format='');
Beschreibung
Gibt die "Grad, Minuten, Sekunden"-Darstellung des Punktes aus.
| |
Es wird angenommen, dass der Punkt in einer Breite/Länge-Projektion vorliegt. Die X (Länge) und Y (Breite) Koordinaten werden bei der Ausgabe in den "üblichen" Bereich (-180 to +180 für die Länge, -90 to +90 für die Breite) normalisiert. |
Der Textparameter ist eine Zeichenkette für die Formatierung der Ausgabe, ähnlich wie die Zeichenkette für die Formatierung der Datumsausgabe. Gültige Zeichen sind "D" für Grad/Degrees, "M" für Minuten, "S" für Sekunden, und "C" für die Himmelsrichtung (NSEW). DMS Zeichen können wiederholt werden, um die gewünschte Zeichenbreite und Genauigkeit anzugeben ("SSS.SSSS" bedeutet z.B. " 1.0023").
"M", "S", und "C" sind optional. Wenn "C" weggelassen wird, werden Grad mit einem "-" Zeichen versehen, wenn Süd oder West. Wenn "S" weggelassen wird, werden die Minuten als Dezimalzahl mit der vorgegebenen Anzahl an Kommastellen angezeigt. Wenn "M" wegggelassen wird, werden die Grad als Dezimalzahl mit der vorgegebenen Anzahl an Kommastellen angezeigt.
Wenn die Zeichenkette für das Ausgabeformat weggelassen wird (oder leer ist) wird ein Standardformat verwendet.
Verfügbarkeit: 2.0
Beispiele
Standardformat.
SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)'));
st_aslatlontext
----------------------------
2°19'29.928"S 3°14'3.243"W
Ein Format angeben (identisch mit Standardformat).
SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS"C'));
st_aslatlontext
----------------------------
2°19'29.928"S 3°14'3.243"W
Andere Zeichen als D, M, S, C und "." werden lediglich durchgereicht.
SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D degrees, M minutes, S seconds to the C'));
st_aslatlontext
--------------------------------------------------------------------------------------
2 degrees, 19 minutes, 30 seconds to the S 3 degrees, 14 minutes, 3 seconds to the W
Grad mit einem Vorzeichen versehen - anstatt der Himmelsrichtung.
SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D°M''S.SSS"'));
st_aslatlontext
----------------------------
-2°19'29.928" -3°14'3.243"
Dezimalgrad.
SELECT (ST_AsLatLonText('POINT (-3.2342342 -2.32498)', 'D.DDDD degrees C'));
st_aslatlontext
-----------------------------------
2.3250 degrees S 3.2342 degrees W
Überhöhte Werte werden normalisiert.
SELECT (ST_AsLatLonText('POINT (-302.2342342 -792.32498)'));
st_aslatlontext
-------------------------------
72°19'29.928"S 57°45'56.757"E
Name
ST_AsMVTGeom — Transformiert eine Geometrie in das Koordinatensystem eines Mapbox Vector Tiles.
Synopsis
geometry ST_AsMVTGeom(geometry geom, box2d bounds, int4 extent=4096, int4 buffer=256, bool clip_geom=true);
Beschreibung
Transformiert eine Geometrie in das Koordinatensystem eines Mapbox Vector Tiles aus Zeilen die einem Layer entsprechen. Unternimmt alle Anstrengungen, damit die Geometrie valide bleibt oder korrigiert sie eventuell sogar. Bei diesem Prozess kann es vorkommen, dass die Geometrie in eine niedrigere Dimension übergeführt wird.
geom Die zu Transformierende Geometrie.
bounds ist die geometrische Abgrenzung des Inhalts der Kachel ohne Puffer.
extent ist die Größe der Kachel, angegeben im Koordinatensystem der Vektorkacheln und so wie in der Spezifikation festgelegt. Wenn dieser Wert NULL ist, wird der Standardwert 4096 angenommen.
buffer ist die Puffergröße im Koordinatensystem der Vektorkacheln, an der die Geometrie optional ausgeschnitten werden kann. Wenn NULL, dann wird der Standardwert 256 angenommen.
clip_geom ist ein boolescher Eingabewert, der bestimmt ob die Geometrie ausgeschnitten werden soll, oder so wie sie vorliegt codiert wird. Wenn der Wert NULL ist, wird der Standardwert TRUE angenommen.
Verfügbarkeit: 2.4.0
| |
From 3.0, Wagyu can be chosen at configure time to clip and validate MVT polygons. This library is faster and produces more correct results than the GEOS default, but it might drop small polygons. |
Beispiele
SELECT ST_AsText(ST_AsMVTGeom(
ST_GeomFromText('POLYGON ((0 0, 10 0, 10 5, 0 -5, 0 0))'),
ST_MakeBox2D(ST_Point(0, 0), ST_Point(4096, 4096)),
4096, 0, false));
st_astext
--------------------------------------------------------------------
MULTIPOLYGON(((5 4096,10 4096,10 4091,5 4096)),((5 4096,0 4096,0 4101,5 4096)))
Name
ST_AsMVT — Gibt eine Menge an Zeilen in der Geobuf Darstellung aus.
Synopsis
bytea ST_AsMVT(anyelement set row);
bytea ST_AsMVT(anyelement row, text name);
bytea ST_AsMVT(anyelement row, text name, int4 extent);
bytea ST_AsMVT(anyelement row, text name, int4 extent, text geom_name);
Beschreibung
Gibt eine Menge an Zeilen, die einem Layer entsprechen, in der Mapbox Vector Tile Darstellung aus. Mehrere Aufrufe können aneinandergereiht werden, um eine Kachel mit mehreren Layern zu erstellen. Es wird angenommen, dass die Geometrie im Koordinatensystem der Vektorkacheln vorliegt und entsprechend derSpezifikation valide ist. Üblicherweise wird ST_AsMVTGeom verwendet, um die Geometrie in das Koordinatensystem der Vektorkacheln zu transformieren. Die übrigen Daten werden als Attribute codiert.
Das Mapbox Vector Tile Format kann Geoobjekte mit unterschiedlichen Attributen pro Feature speichern. Um dies zu nutzen, legen Sie bitte eine JSONB-Spalte mit JSON-Objekten in den Rohdaten an. Die Schlüssel und Werte in dem Objekt werden in die Feature-Attribute zerlegt.
Tiles with multiple layers can be created by concatenating multiple calls to this function using ||.
![[Important]](images/important.png) | |
Do not call with a |
row Datenzeilen mit zumindest einer Geometriespalte.
name ist der Name des Layers. Wenn NULL, dann wird die Zeichenfolge "default" verwendet.
extent ist die Kachelausdehnung in Bildschirmeinheiten, so wie in der Spezifikation festgelegt. Wenn NULL, wird der Standardwert 4096 angenommen.
geom_name ist die Bezeichnung der Geometriespalte in den Datenzeilen. Wenn NULL, dann wird standardmäßig die erste aufgefundene Geometriespalte verwendet.
feature_id_name is the name of the Feature ID column in the row data. If NULL or negative the Feature ID is not set. The first column matching name and valid type (smallint, integer, bigint) will be used as Feature ID, and any subsequent column will be added as a property. JSON properties are not supported.
Enhanced: 3.0 - added support for Feature ID.
Erweiterung: 2.1.0 Für GML 3 wurde die Unterstützung einer ID eingeführt.
Verfügbarkeit: 2.4.0
Name
ST_AsSVG — Gibt ein Geoobjekt als SVG-Pfadgeometrie zurück. Unterstützt den geometrischen und den geographischen Datentyp.
Synopsis
text ST_AsSVG(geometry geom, integer rel=0, integer maxdecimaldigits=15);
text ST_AsSVG(geography geog, integer rel=0, integer maxdecimaldigits=15);
Beschreibung
Gibt die Geometrie als Skalare Vektor Graphik (SVG-Pfadgeometrie) aus. Verwenden Sie 1 als zweiten Übergabewert um die Pfadgeometrie in relativen Schritten zu implementieren; Standardmäßig (oder 0) verwendet absolute Schritte. Der dritte Übergabewert kann verwendet werden, um die maximale Anzahl der Dezimalstellen bei der Ausgabe einzuschränken (standardmäßig 15). Punktgeometrie wird als cx/cy übersetzt wenn der Übergabewert 'rel' gleich 0 ist, x/y wenn 'rel' 1 ist. Mehrfachgeometrie wird durch Beistriche (",") getrennt, Sammelgeometrie wird durch Strichpunkt (";") getrennt.
| |
Verfügbarkeit: 1.2.2. Änderung: 1.4.0 L-Befehl beim absoluten Pfad aufgenommen, um mit http://www.w3.org/TR/SVG/paths.html#PathDataBNF konform zu sein. |
Änderung: 2.0.0 verwendet Standardargumente und unterstützt benannte Argumente.
Name
ST_AsTWKB — Gibt die Geometrie als TWKB, aka "Tiny Well-known Binary" zurück
Synopsis
bytea ST_AsTWKB(geometry g1, integer decimaldigits_xy=0, integer decimaldigits_z=0, integer decimaldigits_m=0, boolean include_sizes=false, boolean include_bounding boxes=false);
bytea ST_AsTWKB(geometry[] geometries, bigint[] unique_ids, integer decimaldigits_xy=0, integer decimaldigits_z=0, integer decimaldigits_m=0, boolean include_sizes=false, boolean include_bounding_boxes=false);
Beschreibung
Gibt die Geometrie im TWKB ("Tiny Well-Known Binary") Format aus. TWKB ist ein komprimiertes binäres Format mit dem Schwerpunkt, die Ausgabegröße zu minimieren.
Der Parameter 'decimaldigits' bestimmt die Anzahl der Dezimalstellen bei der Ausgabe. Standardmäßig werden die Werte vor der Zeichenkodierung auf die Einserstelle gerundet. Wenn Sie die Daten mit höherer Genauigkeit übergeben wollen, erhöhen Sie bitte die Anzahl der Dezimalstellen. Zum Beispiel bedeutet ein Wert von 1, dass die erste Dezimalstelle erhalten bleibt.
Die Parameter "sizes" und "bounding_boxes" bestimmen ob zusätzliche Information über die kodierte Länge und die Abgrenzung des Objektes in der Ausgabe eingebunden werden. Standardmäßig passiert dies nicht. Drehen Sie diese bitte nicht auf, solange dies nicht von Ihrer Client-Software benötigt wird, da dies nur unnötig Speicherplatz verbraucht (Einsparen von Speicherplatz ist der Sinn von TWKB).
Das Feld-Eingabeformat dieser Funktion wird verwendet um eine Sammelgeometriee und eindeutige Identifikatoren in eine TWKB-Collection zu konvertieren, welche die Identifikatoren erhält. Dies ist nützlich für Clients, die davon ausgehen, eine Sammelgeometrie auszupacken, um so auf zusätzliche Information über die internen Objekte zuzugreifen. Sie können das Feld mit der Funktion array_agg erstellen. Die anderen Parameter bewirken dasselbe wie bei dem einfachen Format dieser Funktion.
| |
Die Formatspezifikation steht Online unter https://github.com/TWKB/Specification zur Verfügung, und Code zum Aufbau eines JavaScript Clints findet sich unter https://github.com/TWKB/twkb.js. |
Enhanced: 2.4.0 memory and speed improvements.
Verfügbarkeit: 2.2.0
Beispiele
SELECT ST_AsTWKB('LINESTRING(1 1,5 5)'::geometry);
st_astwkb
--------------------------------------------
\x02000202020808
Um ein aggregiertes TWKB-Objekt inklusive Identifikatoren zu erzeugen, fassen Sie bitte die gewünschte Geometrie und Objekte zuerst mittels "array_agg()" zusammen und rufen anschließend die passende TWKB Funktion auf.
SELECT ST_AsTWKB(array_agg(geom), array_agg(gid)) FROM mytable;
st_astwkb
--------------------------------------------
\x040402020400000202
Name
ST_AsX3D — Gibt eine Geometrie im X3D XML Knotenelement-Format zurück: ISO-IEC-19776-1.2-X3DEncodings-XML
Synopsis
text ST_AsX3D(geometry g1, integer maxdecimaldigits=15, integer options=0);
Beschreibung
Gibt eine Geometrie als X3D knotenformatiertes XML Element zurück http://www.web3d.org/standards/number/19776-1. Falls maxdecimaldigits (Genauigkeit) nicht angegeben ist, wird sie standardmäßig 15.
| |
Es gibt verschiedene Möglichkeiten eine PostGIS Geometrie in X3D zu übersetzen, da sich der X3D Geometrietyp nicht direkt in den geometrischen Datentyp von PostGIS abbilden lässt. Einige neuere X3D Datentypen, die sich besser abbilden lassen könnten haben wir vermieden, da diese von den meisten Rendering-Tools zurzeit nicht untestützt werden. Dies sind die Abbildungen für die wir uns entschieden haben. Falls Sie Ideen haben, wie wir es den Anwendern ermöglichen können ihre bevorzugten Abbildungen anzugeben, können Sie gerne ein Bug-Ticket senden. Im Folgenden wird beschrieben, wie der PostGIS 2D/3D Datentyp derzeit in den X3D Datentyp abgebildet wird |
Das Argument 'options' ist ein Bitfeld. Ab PostGIS 2.2+ wird dieses verwendet, um anzuzeigen ob die Koordinaten als X3D geospatiale Knoten in GeoKoordinaten dargestellt werden und auch ob X- und Y-Achse vertauscht werden sollen. Standardmäßig erfolgt die Ausgabe durch ST_AsX3D im Datenbankformat (Länge, Breite oder X,Y), aber es kann auch der X3D Standard mit Breite/Länge oder Y/X bevorzugt werden.
0: X/Y in der Datenbankreihenfolge (z.B. ist Länge/Breite = X,Y die standardmäßige Datenbankreihenfolge), Standardwert, und nicht-spatiale Koordinaten (nur der normale alte Koordinaten-Tag).
1: X und Y umdrehen. In Verbindung mit der Option für GeoKoordinaten wird bei der Standardausgabe die Breite zuerst/"latitude_first" ausgegeben und die Koordinaten umgedreht.
2: Die Koordinaten werden als geospatiale GeoKoordinaten ausgegeben. Diese Option gibt eine Fehlermeldung aus, falls die Geometrie nicht in WGS 84 Länge/Breite (SRID: 4326) vorliegt. Dies ist zurzeit der einzige GeoKoordinaten-Typ der unterstützt wird.Siehe die X3D Spezifikation für Koordinatenreferenzsysteme. Die Standardausgabe ist
GeoCoordinate geoSystem='"GD" "WE" "longitude_first"'. Wenn Sie den X3D Standard bevorzugenGeoCoordinate geoSystem='"GD" "WE" "latitude_first"'verwenden Sie bitte(2+1)=3
| PostGIS Datentyp | 2D X3D Datentyp | 3D X3D Datentyp |
|---|---|---|
| LINESTRING | zurzeit nicht implementiert - wird PolyLine2D | LineSet |
| MULTILINESTRING | zurzeit nicht implementiert - wird PolyLine2D | IndexedLineSet |
| MULTIPOINT | Polypoint2D | PointSet |
| POINT | gibt leerzeichengetrennte Koordinaten aus | gibt leerzeichengetrennte Koordinaten aus |
| (MULTI) POLYGON, POLYHEDRALSURFACE | Ungültiges X3D Markup | IndexedFaceSet (die inneren Ringe werden zurzeit als ein weiteres FaceSet abgebildet) |
| TIN | TriangleSet2D (zurzeit nicht implementiert) | IndexedTriangleSet |
| |
Die Unterstützung von 2D-Geometrie ist noch nicht vollständig. Die inneren Ringe werden zur Zeit lediglich als gesonderte Polygone abgebildet. Wir arbeiten daran. |
Bezüglich 3D sind viele Weiterentwicklungen im Gange, insbesondere in Bezug auf X3D Integration mit HTML5
Es gibt auch einen feinen OpenSource X3D Viewer, den Sie benützen können, um Geometrien darzustellen. Free Wrl http://freewrl.sourceforge.net/ Binärdateien sind für Mac, Linux und Windows verfügbar. Sie können den mitgelieferten FreeWRL_Launcher verwenden, um Gemetrien darzustellen.
Riskieren Sie auch einen Blick auf PostGIS minimalist X3D viewer, der diese Funktionalität einsetzt und auf x3dDom HTML/JS OpenSource Toolkit.
Verfügbarkeit: 2.0.0: ISO-IEC-19776-1.2-X3DEncodings-XML
Erweiterung: 2.2.0: Unterstützung für geographische Koordinaten und Vertauschen der Achsen (x/y, Länge/Breite). Für nähere Details siehe Optionen.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiel: Erzeugung eines voll funktionsfähigen X3D Dokuments - Dieses erzeugt einen Würfel, den man sich mit FreeWrl und anderen X3D-Viewern ansehen kann.
SELECT '<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.0//EN" "http://www.web3d.org/specifications/x3d-3.0.dtd">
<X3D>
<Scene>
<Transform>
<Shape>
<Appearance>
<Material emissiveColor=''0 0 1''/>
</Appearance
> ' ||
ST_AsX3D( ST_GeomFromEWKT('POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )')) ||
'</Shape>
</Transform>
</Scene>
</X3D
>' As x3ddoc;
x3ddoc
--------
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE X3D PUBLIC "ISO//Web3D//DTD X3D 3.0//EN" "http://www.web3d.org/specifications/x3d-3.0.dtd">
<X3D>
<Scene>
<Transform>
<Shape>
<Appearance>
<Material emissiveColor='0 0 1'/>
</Appearance>
<IndexedFaceSet coordIndex='0 1 2 3 -1 4 5 6 7 -1 8 9 10 11 -1 12 13 14 15 -1 16 17 18 19 -1 20 21 22 23'>
<Coordinate point='0 0 0 0 0 1 0 1 1 0 1 0 0 0 0 0 1 0 1 1 0 1 0 0 0 0 0 1 0 0 1 0 1 0 0 1 1 1 0 1 1 1 1 0 1 1 0 0 0 1 0 0 1 1 1 1 1 1 1 0 0 0 1 1 0 1 1 1 1 0 1 1' />
</IndexedFaceSet>
</Shape>
</Transform>
</Scene>
</X3D
>Beispiel: Ein Achteck, um 3 Einheiten gehoben und mit einer dezimalen Genauigkeit von 6
SELECT ST_AsX3D(
ST_Translate(
ST_Force_3d(
ST_Buffer(ST_Point(10,10),5, 'quad_segs=2')), 0,0,
3)
,6) As x3dfrag;
x3dfrag
--------
<IndexedFaceSet coordIndex="0 1 2 3 4 5 6 7">
<Coordinate point="15 10 3 13.535534 6.464466 3 10 5 3 6.464466 6.464466 3 5 10 3 6.464466 13.535534 3 10 15 3 13.535534 13.535534 3 " />
</IndexedFaceSet
>Beispiel: TIN
SELECT ST_AsX3D(ST_GeomFromEWKT('TIN (((
0 0 0,
0 0 1,
0 1 0,
0 0 0
)), ((
0 0 0,
0 1 0,
1 1 0,
0 0 0
))
)')) As x3dfrag;
x3dfrag
--------
<IndexedTriangleSet index='0 1 2 3 4 5'
><Coordinate point='0 0 0 0 0 1 0 1 0 0 0 0 0 1 0 1 1 0'/></IndexedTriangleSet
>Beispiel: Geschlossener MultiLinestring (die Begrenzung eines Polygons mit Lücken)
SELECT ST_AsX3D(
ST_GeomFromEWKT('MULTILINESTRING((20 0 10,16 -12 10,0 -16 10,-12 -12 10,-20 0 10,-12 16 10,0 24 10,16 16 10,20 0 10),
(12 0 10,8 8 10,0 12 10,-8 8 10,-8 0 10,-8 -4 10,0 -8 10,8 -4 10,12 0 10))')
) As x3dfrag;
x3dfrag
--------
<IndexedLineSet coordIndex='0 1 2 3 4 5 6 7 0 -1 8 9 10 11 12 13 14 15 8'>
<Coordinate point='20 0 10 16 -12 10 0 -16 10 -12 -12 10 -20 0 10 -12 16 10 0 24 10 16 16 10 12 0 10 8 8 10 0 12 10 -8 8 10 -8 0 10 -8 -4 10 0 -8 10 8 -4 10 ' />
</IndexedLineSet
>Name
ST_GeoHash — Gibt die Geometrie in der GeoHash Darstellung aus.
Synopsis
text ST_GeoHash(geometry geom, integer maxchars=full_precision_of_point);
Beschreibung
Gibt die Geometrie in der GeoHash-Darstellung (http://en.wikipedia.org/wiki/Geohash) aus. Ein GeoHash codiert einen Punkt in einem Textformat, das über Präfixe sortierbar und durchsuchbar ist. Ein kürzer codierter GeoHash ergibt eine ungenauere Darstellung des Punktes. Man kann sich einen GeoHash auch als eine Box vorstellen, welche den tatsächlichen Punkt enthält.
Wenn maxchars nicht angegeben wird, gibt ST_GeoHash einen GeoHash mit der vollen Genauigkeit der Eingabegeometrie zurück. Punkte ergeben so einen GeoHash mit einer Genauigkeit von 20 Zeichen (dies sollte ausreichen um die Eingabe in Double Precision zur Gänze abzuspeichern). Andere Varianten geben einen Geohash, basierend auf der Größe des Geoobjektes, mit veränderlicher Genauigkeit zurück, Größere Geoobjekte werden mit geringerer, kleinere Geoobjekte mit höherer Genauigkeit dargestellt. Die Idee dahinter ist, dass die durch den GeoHash implizierte Box immer das gegebene Geoobjekt beinhaltet.
Wenn maxchars angegeben wird, gibt ST_GeoHash einen GeoHash zurück, der maximal die Anzahl dieser Zeichen aufweist. Auf diese Weise ist es möglich die Eingabegeometrie mit einer geringeren Präzision darzustellen. Bei Nicht-Punkten befindet sich der Anfangspunkt der Berechnung im Mittelpunkt des Umgebungsrechtecks der Geometrie.
Verfügbarkeit: 1.4.0
| |
ST_GeoHash funktioniert nicht, wenn die Geometrien nicht in geographischen (Länge/Breite) Koordinaten vorliegen. |
This method supports Circular Strings and Curves
- && — Gibt
TRUEzurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B schneidet. - &&(geometry,box2df) — Gibt
TRUEzurück, wenn sich die 2D Bounding Box (cached) einer Geometrie mit einer 2D Bounding Box mit Gleitpunktgenauigkeit (BOX2DF) überschneidet. - &&(box2df,geometry) — Gibt
TRUEzurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet. - &&(box2df,box2df) — Gibt
TRUEzurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden. - &&& — Gibt
TRUEzurück, wenn A's n-D bounding box B's n-D bounding box schneidet. - &&&(geometry,gidx) — Gibt
TRUEzurück, wenn die (cached) n-D bounding box einer Geometrie eine n-D float precision bounding box (GIDX) schneidet. - &&&(gidx,geometry) — Gibt
TRUEzurück, wenn eine n-D float precision bounding box (GIDX) eine (cached) n-D bounding box einer Geometrie schneidet. - &&&(gidx,gidx) — Gibt
TRUEzurück, wenn sich zwei n-D float precision bounding boxes (GIDX) gegenseitig überschneiden. - &< — Gibt
TRUEzurück, wenn die bounding box der Geometrie A, die bounding box der Geometrie B überlagert oder links davon liegt. - &<| — Gibt
TRUEzurück, wenn die bounding box von A jene von B überlagert oder unterhalb liegt. - &> — Gibt
TRUEzurück, wenn die Bounding Box von A jene von B überlagert oder rechts davon liegt. - << — Gibt
TRUEzurück, wenn die Bounding Box von A zur Gänze links von der von B liegt. - <<| — Gibt
TRUEzurück, wenn A's Bounding Box zur Gänze unterhalb von der von B liegt. - = — Gibt
TRUEzurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind. - >> — Gibt
TRUEzurück, wenn A's bounding box zur Gänze rechts von der von B liegt. - @ — Gibt
TRUEzurück, wenn die Bounding Box von A in jener von B enthalten ist. - @(geometry,box2df) — Gibt
TRUEzurück, wenn die 2D Bounding Box einer Geometrie in einer 2D float precision Bbounding Box (BOX2DF) enthalten ist. - @(box2df,geometry) — Gibt
TRUEzurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist.. - @(box2df,box2df) — Gibt
TRUEzurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist. - |&> — Gibt
TRUEzurück, wenn A's bounding box diejenige von B überlagert oder oberhalb von B liegt. - |>> — Gibt
TRUEzurück, wenn A's bounding box is zur Gänze oberhalb der von B liegt. - ~ — Gibt
TRUEzurück, wenn A's bounding box die von B enthält. - ~(geometry,box2df) — Gibt
TRUEzurück, wenn die 2D bounding box einer Geometrie eine 2D float precision bounding box (GIDX) enthält. - ~(box2df,geometry) — Gibt
TRUEzurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält. - ~(box2df,box2df) — Gibt
TRUEzurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält. - ~= — Gibt
TRUEzurück, wenn die bounding box von A ident mit jener von B ist.
Name
&& — Gibt TRUE zurück, wenn die 2D Bounding Box von A die 2D Bounding Box von B schneidet.
Synopsis
boolean &&( geometry A , geometry B );
boolean &&( geography A , geography B );
Beschreibung
Der && Operator gibt TRUE zurück, wenn die 2D Bounding Box von Geometrie A die 2D Bounding Box der Geometrie von B schneidet.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Erweiterung: Mit 2.0.0 wurde die Unterstützung für polyedrische Oberflächen eingeführt.
Verfügbarkeit: Mit 1.5.0 wurde die Unterstützung von geograpischen Koordinaten eingeführt
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 && tbl2.column2 AS overlaps
FROM ( VALUES
(1, 'LINESTRING(0 0, 3 3)'::geometry),
(2, 'LINESTRING(0 1, 0 5)'::geometry)) AS tbl1,
( VALUES
(3, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;
column1 | column1 | overlaps
---------+---------+----------
1 | 3 | t
2 | 3 | f
(2 rows)Name
&&(geometry,box2df) — Gibt TRUE zurück, wenn sich die 2D Bounding Box (cached) einer Geometrie mit einer 2D Bounding Box mit Gleitpunktgenauigkeit (BOX2DF) überschneidet.
Synopsis
boolean &&( geometry A , box2df B );
Beschreibung
Der && Operator gibt TRUE zurück, wenn die im Cache befindliche 2D Bounding Box der Geometrie A sich mit der 2D Bounding Box von B, unter Verwendung von Gleitpunktgenauigkeit überschneidet. D.h.: falls B eine (double precision) box2d ist, wird diese intern in eine auf Gleitpunkt genaue 2D Bounding Box (BOX2DF) umgewandelt.
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
&&(box2df,geometry) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine Geometrie (cached) 2D bounding box schneidet.
Synopsis
boolean &&( box2df A , geometry B );
Beschreibung
Der && Operator gibt TRUE zurück, wenn die 2D Bounding Box A die zwischengespeicherte 2D Bounding Box der Geometrie B, unter Benutzung von Fließpunktgenauigkeit, schneidet. D.h.: wenn A eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) umgewandelt.
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
&&(box2df,box2df) — Gibt TRUE zurück, wenn sich zwei 2D float precision Bounding Boxes (BOX2DF) überschneiden.
Synopsis
boolean &&( box2df A , box2df B );
Beschreibung
Der && Operator gibt TRUE zurück, wenn sich zwei 2D Bounding Boxes A und B, unter Benutzung von float precision, gegenseitig überschneiden. D.h.: Wenn A (oder B) eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) umgewandelt
| |
Dieser Operator ist für die interne Nutzung durch BRIN Indizes, und nicht so sehr durch Anwender, vorgesehen. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
&&& — Gibt TRUE zurück, wenn A's n-D bounding box B's n-D bounding box schneidet.
Synopsis
boolean &&&( geometry A , geometry B );
Beschreibung
Der &&& Operator gibt TRUE zurück, wenn die n-D bounding box der Geometrie A die n-D bounding box der Geometrie B schneidet.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Verfügbarkeit: 2.0.0
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Beispiele: 3D LineStrings
SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 AS overlaps_3d,
tbl1.column2 && tbl2.column2 AS overlaps_2d
FROM ( VALUES
(1, 'LINESTRING Z(0 0 1, 3 3 2)'::geometry),
(2, 'LINESTRING Z(1 2 0, 0 5 -1)'::geometry)) AS tbl1,
( VALUES
(3, 'LINESTRING Z(1 2 1, 4 6 1)'::geometry)) AS tbl2;
column1 | column1 | overlaps_3d | overlaps_2d
---------+---------+-------------+-------------
1 | 3 | t | t
2 | 3 | f | t
Beispele: 3M LineStrings
SELECT tbl1.column1, tbl2.column1, tbl1.column2 &&& tbl2.column2 AS overlaps_3zm,
tbl1.column2 && tbl2.column2 AS overlaps_2d
FROM ( VALUES
(1, 'LINESTRING M(0 0 1, 3 3 2)'::geometry),
(2, 'LINESTRING M(1 2 0, 0 5 -1)'::geometry)) AS tbl1,
( VALUES
(3, 'LINESTRING M(1 2 1, 4 6 1)'::geometry)) AS tbl2;
column1 | column1 | overlaps_3zm | overlaps_2d
---------+---------+-------------+-------------
1 | 3 | t | t
2 | 3 | f | t
Name
&&&(geometry,gidx) — Gibt TRUE zurück, wenn die (cached) n-D bounding box einer Geometrie eine n-D float precision bounding box (GIDX) schneidet.
Synopsis
boolean &&&( geometry A , gidx B );
Beschreibung
Der &&& Operator gibt TRUE zurück, wenn die zwischengespeicherte n-D bounding box der Geometrie A die n-D bounding box B, unter Benutzung von float precision, schneidet. D.h.: Wenn B eine (double precision) box3d ist, wird diese intern in eine float precision 3D bounding box (GIDX) umgewandelt
| |
Dieser Operator ist für die interne Nutzung durch BRIN Indizes, und nicht so sehr durch Anwender, vorgesehen. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Name
&&&(gidx,geometry) — Gibt TRUE zurück, wenn eine n-D float precision bounding box (GIDX) eine (cached) n-D bounding box einer Geometrie schneidet.
Synopsis
boolean &&&( gidx A , geometry B );
Beschreibung
Der &&& Operator gibt TRUE zurück, wenn die n-D bounding box A die cached n-D bounding box der Geometrie B, unter Benutzung von float precision, schneidet. D.h.: wenn A eine (double precision) box3d ist, wir diese intern in eine float precision 3D bounding box (GIDX) umgewandelt
| |
Dieser Operator ist für die interne Nutzung durch BRIN Indizes, und nicht so sehr durch Anwender, vorgesehen. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Name
&&&(gidx,gidx) — Gibt TRUE zurück, wenn sich zwei n-D float precision bounding boxes (GIDX) gegenseitig überschneiden.
Synopsis
boolean &&&( gidx A , gidx B );
Beschreibung
Der &&& Operator gibt TRUE zurück, wenn sich zwei n-D bounding boxes A und B, unter Benutzung von float precision, gegenseitig überschneiden. D.h.: wenn A (oder B) eine (double precision) box3d ist, wird diese intern in eine float precision 3D bounding box (GIDX) umgewandelt
| |
Dieser Operator ist für die interne Nutzung durch BRIN Indizes, und nicht so sehr durch Anwender, vorgesehen. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
This function supports 3d and will not drop the z-index.
Name
&< — Gibt TRUE zurück, wenn die bounding box der Geometrie A, die bounding box der Geometrie B überlagert oder links davon liegt.
Synopsis
boolean &<( geometry A , geometry B );
Beschreibung
Der &< Operator gibt TRUE zurück, wenn die bounding box der Geometrie A die bounding box der Geometrie B überlagert oder links davon liegt, oder präziser, überlagert und NICHT rechts von der bounding box der Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 &< tbl2.column2 AS overleft
FROM
( VALUES
(1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING(0 0, 3 3)'::geometry),
(3, 'LINESTRING(0 1, 0 5)'::geometry),
(4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;
column1 | column1 | overleft
---------+---------+----------
1 | 2 | f
1 | 3 | f
1 | 4 | t
(3 rows)Name
&<| — Gibt TRUE zurück, wenn die bounding box von A jene von B überlagert oder unterhalb liegt.
Synopsis
boolean &<|( geometry A , geometry B );
Beschreibung
Der &<| Operator gibt TRUE zurück, wenn die Bounding Box der Geometrie A die Bounding Box der Geometrie B überlagert oder unterhalb liegt, oder präziser, überlagert oder NICHT oberhalb der Bounding der Geometrie B liegt.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 &<| tbl2.column2 AS overbelow
FROM
( VALUES
(1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING(0 0, 3 3)'::geometry),
(3, 'LINESTRING(0 1, 0 5)'::geometry),
(4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;
column1 | column1 | overbelow
---------+---------+-----------
1 | 2 | f
1 | 3 | t
1 | 4 | t
(3 rows)Name
&> — Gibt TRUE zurück, wenn die Bounding Box von A jene von B überlagert oder rechts davon liegt.
Synopsis
boolean &>( geometry A , geometry B );
Beschreibung
Der &> Operator gibt TRUE zurück, wenn die Bounding Box der Geometrie A die Bounding Box der Geometrie B überlagert oder rechts von ihr liegt, oder präziser, überlagert und NICHT links von der Bounding Box der Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 &> tbl2.column2 AS overright
FROM
( VALUES
(1, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING(0 0, 3 3)'::geometry),
(3, 'LINESTRING(0 1, 0 5)'::geometry),
(4, 'LINESTRING(6 0, 6 1)'::geometry)) AS tbl2;
column1 | column1 | overright
---------+---------+-----------
1 | 2 | t
1 | 3 | t
1 | 4 | f
(3 rows)Name
<< — Gibt TRUE zurück, wenn die Bounding Box von A zur Gänze links von der von B liegt.
Synopsis
boolean <<( geometry A , geometry B );
Beschreibung
Der << Operator gibt TRUE zurück, wenn die Bounding Box der Geometrie A zur Gänze links der Bounding Box der Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 << tbl2.column2 AS left
FROM
( VALUES
(1, 'LINESTRING (1 2, 1 5)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING (0 0, 4 3)'::geometry),
(3, 'LINESTRING (6 0, 6 5)'::geometry),
(4, 'LINESTRING (2 2, 5 6)'::geometry)) AS tbl2;
column1 | column1 | left
---------+---------+------
1 | 2 | f
1 | 3 | t
1 | 4 | t
(3 rows)Name
<<| — Gibt TRUE zurück, wenn A's Bounding Box zur Gänze unterhalb von der von B liegt.
Synopsis
boolean <<|( geometry A , geometry B );
Beschreibung
Der <<| Operator gibt TRUE zurück, wenn die Bounding Box der Geometrie A zur Gänze unterhalb der Bounding Box von Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 <<| tbl2.column2 AS below
FROM
( VALUES
(1, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING (1 4, 1 7)'::geometry),
(3, 'LINESTRING (6 1, 6 5)'::geometry),
(4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;
column1 | column1 | below
---------+---------+-------
1 | 2 | t
1 | 3 | f
1 | 4 | f
(3 rows)Name
= — Gibt TRUE zurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind.
Synopsis
boolean =( geometry A , geometry B );
boolean =( geography A , geography B );
Beschreibung
Der Operator = gibt TRUE zurück, wenn die Koordinaten und die Reihenfolge der Koordinaten der Geometrie/Geographie A und der Geometrie/Geographie B ident sind. PostgreSQL verwendet die =, <, und > Operatoren um die interne Sortierung und den Vergleich von Geometrien durchzuführen (z.B.: in einer GROUP BY oder ORDER BY Klausel).
| |
Nur die Geometrie/Geographie die in allen Gesichtspunkten übereinstimmt, d.h. mit den selben Koordinaten in der gleichen Reihenfolge, werden von diesem Operator als gleich betrachtet. Für "räumliche Gleichheit", bei der Dinge wie die Reihenfolge der Koordinaten außer Acht gelassen werden, und die es ermöglicht Geoobjekte zu erfassen, die denselben räumlichen Bereich mit unterschiedlicher Darstellung abdecken, verwenden Sie bitte ??? oder ??? |
| |
Dieser Operator verwendet NICHT die Indizes, welche für die Geometrien vorhanden sind. Um eine Überprüfung auf exakte Gleichheit indexgestützt durchzuführen, kombinieren Sie bitte = mit &&. |
Änderung: 2.4.0, in Vorgängerversionen war dies die Gleichheit der umschreibenden Rechtecke, nicht die geometrische Gleichheit. Falls Sie auf Gleichheit der umschreibenden Rechtecke prüfen wollen, verwenden Sie stattdesse bitte ~=.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Beispiele
SELECT 'LINESTRING(0 0, 0 1, 1 0)'::geometry = 'LINESTRING(1 1, 0 0)'::geometry;
?column?
----------
f
(1 row)
SELECT ST_AsText(column1)
FROM ( VALUES
('LINESTRING(0 0, 1 1)'::geometry),
('LINESTRING(1 1, 0 0)'::geometry)) AS foo;
st_astext
---------------------
LINESTRING(0 0,1 1)
LINESTRING(1 1,0 0)
(2 rows)
-- Anmerkung: die Klausel GROUP BY berwendet "=" um auf geometrische Gleichwertigkeit zu prüfen.
SELECT ST_AsText(column1)
FROM ( VALUES
('LINESTRING(0 0, 1 1)'::geometry),
('LINESTRING(1 1, 0 0)'::geometry)) AS foo
GROUP BY column1;
st_astext
---------------------
LINESTRING(0 0,1 1)
LINESTRING(1 1,0 0)
(2 rows)
-- In Vorgängerversionen von 2.0 wurde hier üblicherweise TRUE zurückgegeben --
SELECT ST_GeomFromText('POINT(1707296.37 4820536.77)') =
ST_GeomFromText('POINT(1707296.27 4820536.87)') As pt_intersect;
--pt_intersect --
f
Name
>> — Gibt TRUE zurück, wenn A's bounding box zur Gänze rechts von der von B liegt.
Synopsis
boolean >>( geometry A , geometry B );
Beschreibung
Der >> Operator gibt TRUE zurück, wenn die Bounding Box von Geometrie A zur Gänze rechts der Bounding Box von Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 >> tbl2.column2 AS right
FROM
( VALUES
(1, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING (1 4, 1 7)'::geometry),
(3, 'LINESTRING (6 1, 6 5)'::geometry),
(4, 'LINESTRING (0 0, 4 3)'::geometry)) AS tbl2;
column1 | column1 | right
---------+---------+-------
1 | 2 | t
1 | 3 | f
1 | 4 | f
(3 rows)Name
@ — Gibt TRUE zurück, wenn die Bounding Box von A in jener von B enthalten ist.
Synopsis
boolean @( geometry A , geometry B );
Beschreibung
Der @ Operator gibt TRUE zurück, wenn die Bounding Box der Geometrie A vollstänig in der Bounding Box der Geometrie B enthalten ist.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 @ tbl2.column2 AS contained
FROM
( VALUES
(1, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING (0 0, 4 4)'::geometry),
(3, 'LINESTRING (2 2, 4 4)'::geometry),
(4, 'LINESTRING (1 1, 3 3)'::geometry)) AS tbl2;
column1 | column1 | contained
---------+---------+-----------
1 | 2 | t
1 | 3 | f
1 | 4 | t
(3 rows)Name
@(geometry,box2df) — Gibt TRUE zurück, wenn die 2D Bounding Box einer Geometrie in einer 2D float precision Bbounding Box (BOX2DF) enthalten ist.
Synopsis
boolean @( geometry A , box2df B );
Beschreibung
Der @ Operator gibt TRUE zurück, wenn die 2D Bounding Box der Geometrie A in der 2D Bounding Box der Geometrie B , unter Benutzung von float precision, enthalten ist. D.h.: wenn B eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) übersetzt.
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
@(box2df,geometry) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) in der 2D Bounding Box einer Geometrie enthalten ist..
Synopsis
boolean @( box2df A , geometry B );
Beschreibung
Der @ Operator gibt TRUE zurück, wenn die 2D bounding box A in der 2D bounding box der Geometrie B, unter Verwendung von float precision, enthalten ist. D.h.: wenn B eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) umgewandelt
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
@(box2df,box2df) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) innerhalb einer anderen 2D float precision bounding box enthalten ist.
Synopsis
boolean @( box2df A , box2df B );
Beschreibung
Der @ Operator gibt TRUE zurück, wenn die 2D bounding box A innerhalb der 2D bounding box B, unter Verwendung von float precision, enthalten ist. D.h.: wenn A (oder B) eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) umgewandelt.
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
|&> — Gibt TRUE zurück, wenn A's bounding box diejenige von B überlagert oder oberhalb von B liegt.
Synopsis
boolean |&>( geometry A , geometry B );
Beschreibung
Der |&> Operator gibt TRUE zurück, wenn die bounding box der Geometrie A die bounding box der Geometrie B überlagert oder oberhalb liegt, oder präziser, überlagert oder NICHT unterhalb der Bounding Box der Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 |&> tbl2.column2 AS overabove
FROM
( VALUES
(1, 'LINESTRING(6 0, 6 4)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING(0 0, 3 3)'::geometry),
(3, 'LINESTRING(0 1, 0 5)'::geometry),
(4, 'LINESTRING(1 2, 4 6)'::geometry)) AS tbl2;
column1 | column1 | overabove
---------+---------+-----------
1 | 2 | t
1 | 3 | f
1 | 4 | f
(3 rows)Name
|>> — Gibt TRUE zurück, wenn A's bounding box is zur Gänze oberhalb der von B liegt.
Synopsis
boolean |>>( geometry A , geometry B );
Beschreibung
Der Operator |>> gibt TRUE zurück, wenn die Bounding Box der Geometrie A zur Gänze oberhalb der Bounding Box von Geometrie B liegt.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 |>> tbl2.column2 AS above
FROM
( VALUES
(1, 'LINESTRING (1 4, 1 7)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING (0 0, 4 2)'::geometry),
(3, 'LINESTRING (6 1, 6 5)'::geometry),
(4, 'LINESTRING (2 3, 5 6)'::geometry)) AS tbl2;
column1 | column1 | above
---------+---------+-------
1 | 2 | t
1 | 3 | f
1 | 4 | f
(3 rows)Name
~ — Gibt TRUE zurück, wenn A's bounding box die von B enthält.
Synopsis
boolean ~( geometry A , geometry B );
Beschreibung
Der ~ Operator gibt TRUE zurück, wenn die bounding box der Geometrie A zur Gänze die bounding box der Geometrie B enthält.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Beispiele
SELECT tbl1.column1, tbl2.column1, tbl1.column2 ~ tbl2.column2 AS contains
FROM
( VALUES
(1, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl1,
( VALUES
(2, 'LINESTRING (0 0, 4 4)'::geometry),
(3, 'LINESTRING (1 1, 2 2)'::geometry),
(4, 'LINESTRING (0 0, 3 3)'::geometry)) AS tbl2;
column1 | column1 | contains
---------+---------+----------
1 | 2 | f
1 | 3 | t
1 | 4 | t
(3 rows)Name
~(geometry,box2df) — Gibt TRUE zurück, wenn die 2D bounding box einer Geometrie eine 2D float precision bounding box (GIDX) enthält.
Synopsis
boolean ~( geometry A , box2df B );
Beschreibung
Der ~ Operator gibt TRUE zurück, wenn die 2D bounding box einer Geometrie A die 2D bounding box B, unter Verwendung von float precision, enthält. D.h.: wenn B eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) übersetzt
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
~(box2df,geometry) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) die 2D Bounding Box einer Geometrie enthält.
Synopsis
boolean ~( box2df A , geometry B );
Beschreibung
Der ~ Operator gibt TRUE zurück, wenn die 2D bounding box A die Bounding Box der Geometrie B, unter Verwendung von float precision, enthält. D.h.: wenn A eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) umgewandelt.
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
~(box2df,box2df) — Gibt TRUE zurück, wenn eine 2D float precision bounding box (BOX2DF) eine andere 2D float precision bounding box (BOX2DF) enthält.
Synopsis
boolean ~( box2df A , box2df B );
Beschreibung
Der ~ Operator gibt TRUE zurück, wenn die 2D bounding box A die 2D bounding box B, unter Verwendung von float precision, enthält. D.h.: wenn A eine (double precision) box2d ist, wird diese intern in eine float precision 2D bounding box (BOX2DF) umgewandelt
| |
Dieser Operand ist eher für die interne Nutzung durch BRIN Indizes, als durch die Anwender, gedacht. |
Verfügbarkeit: Mit 2.3.0 wurde die Unterstützung von Block Range INdexes (BRIN) eingeführt. Erfordert PostgreSQL 9.5+.
This method supports Circular Strings and Curves
This function supports Polyhedral surfaces.
Name
~= — Gibt TRUE zurück, wenn die bounding box von A ident mit jener von B ist.
Synopsis
boolean ~=( geometry A , geometry B );
Beschreibung
Der ~= Operator gibt TRUE zurück, wenn die bounding box der Geometrie/Geographie A ident mit der bounding box der Geometrie/Geographie B ist.
| |
Dieser Operand benützt jeden Index, der für die Geometrie zur Verfügung stellt. |
Verfügbarkeit: 1.5.0 "Verhaltensänderung"
This function supports Polyhedral surfaces.
| |
Dieser Operator verhält sich ab PostGIS 1.5 insofern anders, als er vom Prüfen der Übereinstimmung der tatsächlichen Geometrie auf eine ledigliche Überprüfung der Gleichheit der Bounding Boxes abgeändert wurde. Um die Sache noch weiter zu komplizieren, hängt dieses Verhalten der Datenbank davon ab, ob ein hard oder soft upgrade durchgeführt wurde. Um herauszufinden, wie sich die Datenbank in dieser Beziehung verhält, führen Sie bitte die untere Abfrage aus. Um auf exakte Gleichheit zu prüfen benutzen Sie bitte ??? oder ???. |
- <-> — 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.
Name
<-> — Gibt die 2D Entfernung zwischen A und B zurück.
Synopsis
double precision <->( geometry A , geometry B );
double precision <->( geography A , geography B );
Beschreibung
Der <-> Operator gibt die 2D Entfernung zwischen zwei Geometrien zurück. Wird er in einer "ORDER BY" Klausel verwendet, so liefert er Index-unterstützte nearest-neighbor Ergebnismengen. PostgreSQL Versionen unter 9.5 geben jedoch lediglich die Entfernung der Centroide der bounding boxes zurück, während PostgreSQL 9.5+ mittels KNN-Methode die tatsächliche Entfernung zwischen den Geometrien, bei geographischen Koordinaten die Entfernung auf der Späre, widergibt.
| |
Dieser Operand verwendet 2D GiST Indizes, falls diese für die Geometrien vorhanden sind. Er unterscheidet sich insofern von anderen Operatoren, die räumliche Indizes verwenden, indem der räumliche Index nur dann verwendet wird, wenn sich der Operator in einer ORDER BY Klausel befindet. |
| |
Der Index kommt nur zum Tragen, wenn eine der Geometrien eine Konstante ist (sich nicht in einer Subquery/CTE befindet). Z.B. 'SRID=3005;POINT(1011102 450541)'::geometry und nicht a.geom |
Siehe OpenGeo workshop: Nearest-Neighbour Searching für ein praxisbezogenes Anwendungsbeispiel.
Verbesserung: 2.2.0 -- Echtes KNN ("K nearest neighbor") Verhalten für Geometrie und Geographie ab PostgreSQL 9.5+. Beachten Sie bitte, das KNN für Geographie auf der Späre und nicht auf dem Sphäroid beruht. Für PostgreSQL 9.4 und darunter, wird die Berechnung nur auf Basis des Centroids der Box unterstützt.
Änderung: 2.2.0 -- Da für Anwender von PostgreSQL 9.5 der alte hybride Syntax langsamer sein kann, möchten sie diesen Hack eventuell loswerden, falls der Code nur auf PostGIS 2.2+ 9.5+ läuft. Siehe die unteren Beispiele.
Verfügbarkeit: 2.0.0 -- Weak KNN liefert nearest neighbors, welche sich auf die Entfernung der Centroide der Geometrien, anstatt auf den tatsächlichen Entfernungen, stützen. Genaue Ergebnisse für Punkte, ungenau für alle anderen Geometrietypen. Verfügbar ab PostgreSQL 9.1+.
Beispiele
SELECT ST_Distance(geom, 'SRID=3005;POINT(1011102 450541)'::geometry) as d,edabbr, vaabbr
FROM va2005
ORDER BY d limit 10;
d | edabbr | vaabbr
------------------+--------+--------
0 | ALQ | 128
5541.57712511724 | ALQ | 129A
5579.67450712005 | ALQ | 001
6083.4207708641 | ALQ | 131
7691.2205404848 | ALQ | 003
7900.75451037313 | ALQ | 122
8694.20710669982 | ALQ | 129B
9564.24289057111 | ALQ | 130
12089.665931705 | ALQ | 127
18472.5531479404 | ALQ | 002
(10 rows)
Then the KNN raw answer:
SELECT st_distance(geom, 'SRID=3005;POINT(1011102 450541)'::geometry) as d,edabbr, vaabbr
FROM va2005
ORDER BY geom <-> 'SRID=3005;POINT(1011102 450541)'::geometry limit 10;
d | edabbr | vaabbr
------------------+--------+--------
0 | ALQ | 128
5541.57712511724 | ALQ | 129A
5579.67450712005 | ALQ | 001
6083.4207708641 | ALQ | 131
7691.2205404848 | ALQ | 003
7900.75451037313 | ALQ | 122
8694.20710669982 | ALQ | 129B
9564.24289057111 | ALQ | 130
12089.665931705 | ALQ | 127
18472.5531479404 | ALQ | 002
(10 rows)
Wenn Sie "EXPLAIN ANALYZE" an den zwei Abfragen ausführen, sollte eine Performance Verbesserung im Ausmaß von einer Sekunde auftreten.
Anwender von PostgreSQL < 9.5 können eine hybride Abfrage erstellen, um die echten nearest neighbors aufzufinden. Zuerst eine CTE-Abfrage, welche die Index-unterstützten KNN-Methode anwendet, dann eine exakte Abfrage um eine korrekte Sortierung zu erhalten:
WITH index_query AS (
SELECT ST_Distance(geom, 'SRID=3005;POINT(1011102 450541)'::geometry) as d,edabbr, vaabbr
FROM va2005
ORDER BY geom <-> 'SRID=3005;POINT(1011102 450541)'::geometry LIMIT 100)
SELECT *
FROM index_query
ORDER BY d limit 10;
d | edabbr | vaabbr
------------------+--------+--------
0 | ALQ | 128
5541.57712511724 | ALQ | 129A
5579.67450712005 | ALQ | 001
6083.4207708641 | ALQ | 131
7691.2205404848 | ALQ | 003
7900.75451037313 | ALQ | 122
8694.20710669982 | ALQ | 129B
9564.24289057111 | ALQ | 130
12089.665931705 | ALQ | 127
18472.5531479404 | ALQ | 002
(10 rows)
Name
|=| — Gibt die Entfernung zwischen den Trajektorien A und B, am Ort der dichtesten Annäherung, an.
Synopsis
double precision |=|( geometry A , geometry B );
Beschreibung
Der |=| Operator gibt die 3D Entfernung zwischen zwei Trajektorien (Siehe ???). Dieser entspricht ???, da es sich jedoch um einen Operator handelt, kann dieser für nearest neightbor searches mittels eines N-dimensionalen Index verwendet werden (verlangt PostgreSQL 9.5.0 oder höher).
| |
Dieser Operand verwendet die ND GiST Indizes, welche für Geometrien vorhanden sein können. Er unterscheidet sich insofern von anderen Operatoren, die ebenfalls räumliche Indizes verwenden, als der räumliche Index nur dann angewandt wird, wenn sich der Operand in einer ORDER BY Klausel befindet. |
| |
Der Index kommt nur zum Tragen, wenn eine der Geometrien eine Konstante ist (sich nicht in einer Subquery/CTE befindet). Z.B. 'SRID=3005;LINESTRINGM(0 0 0,0 0 1)'::geometry und nicht a.geom |
Verfügbarkeit: 2.2.0. Index-unterstützt steht erst ab PostgreSQL 9.5+ zur Verfügung.
Beispiele
-- Save a literal query trajectory in a psql variable...
\set qt 'ST_AddMeasure(ST_MakeLine(ST_MakePointM(-350,300,0),ST_MakePointM(-410,490,0)),10,20)'
-- Run the query !
SELECT track_id, dist FROM (
SELECT track_id, ST_DistanceCPA(tr,:qt) dist
FROM trajectories
ORDER BY tr |=| :qt
LIMIT 5
) foo;
track_id dist
----------+-------------------
395 | 0.576496831518066
380 | 5.06797130410151
390 | 7.72262293958322
385 | 9.8004461358071
405 | 10.9534397988433
(5 rows)
Name
<#> — Gibt die 2D Entfernung zwischen den Bounding Boxes von A und B zurück
Synopsis
double precision <#>( geometry A , geometry B );
Beschreibung
Der <#> Operator gibt die Entfernung zwischen zwei floating point bounding boxes zurück, wobei diese eventuell vom räumlichen Index ausgelesen wird (PostgreSQL 9.1+ vorausgesetzt). Praktikabel falls man eine nearest neighbor Abfrage approximate nach der Entfernung sortieren will.
| |
Dieser Operand verwendet sämtliche Indizes, welche für die Geometrien vorhanden sind. Er unterscheidet sich insofern von anderen Operatoren, welche ebenfalls räumliche Indizes verwenden, als der räumliche Index nur dann verwendet wird, falls sich der Operand in einer ORDER BY Klausel befindet. |
| |
Der Index kommt nur zum Tragen, wenn eine der Geometrien eine Konstante ist; z.B.: ORDER BY (ST_GeomFromText('POINT(1 2)') <#> geom) anstatt g1.geom <#>. |
Verfügbarkeit: 2.0.0 -- KNN steht erst ab PostgreSQL 9.1+ zur Verfügung
Beispiele
SELECT *
FROM (
SELECT b.tlid, b.mtfcc,
b.geom <#
> ST_GeomFromText('LINESTRING(746149 2948672,745954 2948576,
745787 2948499,745740 2948468,745712 2948438,
745690 2948384,745677 2948319)',2249) As b_dist,
ST_Distance(b.geom, ST_GeomFromText('LINESTRING(746149 2948672,745954 2948576,
745787 2948499,745740 2948468,745712 2948438,
745690 2948384,745677 2948319)',2249)) As act_dist
FROM bos_roads As b
ORDER BY b_dist, b.tlid
LIMIT 100) As foo
ORDER BY act_dist, tlid LIMIT 10;
tlid | mtfcc | b_dist | act_dist
-----------+-------+------------------+------------------
85732027 | S1400 | 0 | 0
85732029 | S1400 | 0 | 0
85732031 | S1400 | 0 | 0
85734335 | S1400 | 0 | 0
85736037 | S1400 | 0 | 0
624683742 | S1400 | 0 | 128.528874268666
85719343 | S1400 | 260.839270432962 | 260.839270432962
85741826 | S1400 | 164.759294123275 | 260.839270432962
85732032 | S1400 | 277.75 | 311.830282365264
85735592 | S1400 | 222.25 | 311.830282365264
(10 rows)
Name
<<->> — Gibt die n-D Entfernung zwischen den geometrischen Schwerpunkten der Begrenzungsrechtecke/Bounding Boxes von A und B zurück.
Synopsis
double precision <<->>( geometry A , geometry B );
Beschreibung
Der <<->> Operator gibt die n-D (euklidische) Entfernung zwischen den geometrischen Schwerpunkten der Begrenzungsrechtecke zweier Geometrien zurück. Praktikabel für nearest neighbor approximate distance ordering.
| |
Dieser Operator verwendet n-D GiST Indizes, falls diese für die Geometrien vorhanden sind. Er unterscheidet sich insofern von anderen Operatoren, die räumliche Indizes verwenden, indem der räumliche Index nur dann verwendet wird, wenn sich der Operator in einer ORDER BY Klausel befindet. |
| |
Der Index kommt nur zum Tragen, wenn eine der Geometrien eine Konstante ist (sich nicht in einer Subquery/CTE befindet). Z.B. 'SRID=3005;POINT(1011102 450541)'::geometry und nicht a.geom |
Verfügbarkeit: 2.2.0 -- KNN steht erst ab PostgreSQL 9.1+ zur Verfügung.
Name
<<#>> — Gibt die n-D Entfernung zwischen den Bounding Boxes von A und B zurück.
Synopsis
double precision <<#>>( geometry A , geometry B );
Beschreibung
Der <<#>> Operator gibt die Entfernung zwischen zwei floating point bounding boxes zurück, wobei diese eventuell vom räumlichen Index ausgelesen wird (PostgreSQL 9.1+ vorausgesetzt). Praktikabel falls man eine nearest neighbor Abfrage nach der Entfernung sortieren will / approximate distance ordering.
| |
Dieser Operand verwendet sämtliche Indizes, welche für die Geometrien vorhanden sind. Er unterscheidet sich insofern von anderen Operatoren, welche ebenfalls räumliche Indizes verwenden, als der räumliche Index nur dann verwendet wird, falls sich der Operand in einer ORDER BY Klausel befindet. |
| |
Der Index kommt nur zum Tragen, wenn eine der Geometrien eine Konstante ist; z.B.: ORDER BY (ST_GeomFromText('POINT(1 2)') <<#>> geom) anstatt g1.geom <<#>>. |
Verfügbarkeit: 2.2.0 -- KNN steht erst ab PostgreSQL 9.1+ zur Verfügung.
- ST_Area — Gibt den geometrischen Schwerpunkt einer Geometrie 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_Angle — Gibt den Winkel zwischen 3 Punkten oder zwischen 2 Vektoren (4 Punkte oder 2 Linien) zurück.
- ST_ClosestPoint — 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_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_Project — Gibt einen
POINTzurück, der von einem Anfangspunkt weg, entsprechend einer Distanz in Meter und einer Peilung (Azimut) in Radiant, projiziert wird. - 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
Name
ST_Area — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
Synopsis
float ST_Area(geometry g1);
float ST_Area(geography geog, boolean use_spheroid=true);
Beschreibung
Gibt den Flächeninhalt von Polygonen und Mehrfachpolygonen zurück. Gibt den Flächeninhalt der Datentypen "ST_Surface" und "ST_MultiSurface" zurück. Beim geometrischen Datentyp wird die kartesische 2D-Fläche ermittelt und in den Einheiten des SRID ausgegeben. Beim geographischen Datentyp wird die Fläche standardmäßig auf einem Referenzellipsoid ermittelt und in Quadratmeter ausgegeben. Mit ST_Area(geog,false) kann der Flächeninhalt auf einer Kugel ermittelt werden; dies ist zwar schneller aber auch weniger genau.
Erweiterung: Mit 2.0.0 wurde 2D-Unterstützung für polyedrische Oberflächen eingeführt.
Erweiterung: 2.2.0 - die Messung auf dem Referenzellipsoid wird mit der Bibliothek "GeographicLib" durchgeführt. Dadurch wurde die Genauigkeit und die Robustheit erhöht. Um die Vorteile dieser neuen Funktionalität zu nutzen, benötigen Sie Proj >= 4.9.0.
Changed: 3.0.0 - does not depend on SFCGAL anymore.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 8.1.2, 9.5.3
This function supports Polyhedral surfaces.
| |
Bei polyedrischen Oberflächen wird nur 2D (nicht 2.5D) unterstützt. Bei 2.5D kann ein Ergebnis ungleich null geliefert werden, wenn die Oberflächen vollständig in der XY-Ebene liegen. |
Beispiele
Gibt den Flächeninhalt eines Grundstücks in Massachusetts - in Quadratfuß und konvertiert in Quadratmeter - zurück. Anmerkung: Wegen "Massachusetts State Plane Feet" (EPSG:2249) wird der Flächeninhalt in Quadratfuß ausgegeben
select ST_Area(geom) sqft,
ST_Area(geom) * 0.3048 ^ 2 sqm
from (
select 'SRID=2249;POLYGON((743238 2967416,743238 2967450,
743265 2967450,743265.625 2967416,743238 2967416))' :: geometry geom
) subquery;
┌─────────┬─────────────┐
│ sqft │ sqm │
├─────────┼─────────────┤
│ 928.625 │ 86.27208552 │
└─────────┴─────────────┘
Gibt den Flächeninhalt in Quadratfuß aus und transformiert nach "Massachusetts state plane meters" (EPSG:26986) um Quadratmeter zu erhalten. Da die Fläche in "Massachusetts State Plane Feet" (EPSG:2249) vorliegt, wird der Flächeninhalt in Quadratfuß ausgegeben. Die transformierte Fläche ist in Quadratmeter, da sie in EPSG:26986 "Massachusetts state plane meters" (EPSG:26986) vorliegt.
select ST_Area(geom) sqft,
ST_Area(ST_Transform(geom, 26986)) As sqm
from (
select
'SRID=2249;POLYGON((743238 2967416,743238 2967450,
743265 2967450,743265.625 2967416,743238 2967416))' :: geometry geom
) subquery;
┌─────────┬─────────────────┐
│ sqft │ sqm │
├─────────┼─────────────────┤
│ 928.625 │ 86.272430607008 │
└─────────┴─────────────────┘
Gibt den Flächeninhalt in Quadratfuß und in Quadratmeter für den geographischen Datentyp zurück. Beachten Sie bitte, dass wir den geometrischen in den geographischen Datentyp umwandeln (dafür muss die Geometrie in WGS84 lon lat 4326 vorliegen). Beim geographischen Datentyp wird immer in Meter gemessen. Dies ist nur für Vergleichszwecke gedacht, da Ihre Tabelle üblicherweise bereits den geographischen Datentyp aufweisen wird.
select ST_Area(geog) / 0.3048 ^ 2 sqft_spheroid,
ST_Area(geog, false) / 0.3048 ^ 2 sqft_sphere,
ST_Area(geog) sqm_spheroid
from (
select ST_Transform(
'SRID=2249;POLYGON((743238 2967416,743238 2967450,743265 2967450,743265.625 2967416,743238 2967416))'::geometry,
4326
) :: geography geog
) as subquery;
┌──────────────────┬──────────────────┬──────────────────┐
│ sqft_spheroid │ sqft_sphere │ sqm_spheroid │
├──────────────────┼──────────────────┼──────────────────┤
│ 928.684405784452 │ 927.049336105925 │ 86.2776044979692 │
└──────────────────┴──────────────────┴──────────────────┘
If your data is in geography already:
select ST_Area(geog) / 0.3048 ^ 2 sqft,
ST_Area(the_geog) sqm
from somegeogtable;Name
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.
Synopsis
float ST_Azimuth(geometry pointA, geometry pointB);
float ST_Azimuth(geography pointA, geography pointB);
Beschreibung
Gibt den Azimut des Kreisbogens in Radiant zurück, der durch die gegebenen Punkte bestimmt ist. Wenn sich die beiden Punkte decken, wird NULL zurückgegeben. Der Azimut ist der auf die Nordrichtung bezogene Winkel; er ist im Uhrzeigersinn positiv: Norden = 0; Osten = π/2; Süden = π; Westen = 3π/2.
Beim geographischen Datentyp wird der vorwärtsgerichtete Azimuth als Teil der zweiten geodätischen Hauptaufgabe gelöst.
Der mathematische Begriff Azimut ist als Winkel zwischen einer Referenzebene und einem Punkt definiert, wobei das Winkelmaß in Radiant angegeben wird. Wie im folgenden Beispiel gezeigt, kann mit der in PostgreSQL integrierten Funktion "degrees()" von der Einheit Radiant auf die Einheit Grad umgerechnet werden.
Verfügbarkeit: 1.1.0
Erweiterung: mit 2.0.0 wurde die Unterstützung des geographischen Datentyps eingeführt.
Erweiterung: 2.2.0 die Messungen auf dem Referenzellipsoid werden mit der Bibliothek "GeographicLib" durchgeführt. Dadurch wurde die Genauigkeit und die Robustheit erhöht. Um die Vorteile dieser neuen Funktionalität zu nutzen, benötigen Sie Proj >= 4.9.0.
Der Azimut ist in Verbindung mit ST_Translate besonders nützlich, weil damit ein Objekt entlang seiner rechtwinkeligen Achse verschoben werden kann. Siehe dazu die Funktion "upgis_lineshift", in dem Abschnitt Plpgsqlfunctions des PostGIS Wiki, für ein Beispiel.
Beispiele
Geometrischer Datentyp - Azimut in Grad
SELECT degrees(ST_Azimuth(ST_Point(25, 45), ST_Point(75, 100))) AS degA_B,
degrees(ST_Azimuth(ST_Point(75, 100), ST_Point(25, 45))) AS degB_A;
dega_b | degb_a
------------------+------------------
42.2736890060937 | 222.273689006094
 Grün: der Anfangspunkt Point(25,45) mit der Senkrechten darauf. Gelb: der zu durchlaufende Pfad "degA_B" (Azimut).
|  Grün: der Anfangspunkt Point(75,100) mit der Senkrechten darauf. Gelb: der zu durchlaufende Pfad "degB_A" (Azimut).
|
Name
ST_Angle — Gibt den Winkel zwischen 3 Punkten oder zwischen 2 Vektoren (4 Punkte oder 2 Linien) zurück.
Synopsis
float ST_Angle(geometry point1, geometry point2, geometry point3, geometry point4);
float ST_Angle(geometry line1, geometry line2);
Beschreibung
Fpr 3 Punkte wird der Winkel im Uhrzeigersinn von P1P2P3 errechnet. Bei der Eingabe von 2 Linien werden 4 Punkte aus den Anfangs- und Endpunkten der Linien ermittelt. Für die 4 Punkte wird der Winkel im Uhrzeigersinn von P1P2,P3P4 berechnet. Das ergebnis ist immer positiv, zwischen 0 und 2*Pi Radiant. Verwendet den Azimut von Linienpaaren oder Punkten.
ST_Angle(P1,P2,P3) = ST_Angle(P2,P1,P2,P3)
Das Ergebnis wird in Radiant ausgegeben. Wie im folgenden Beispiel gezeigt, kann mit der in PostgreSQL integrierten Funktion "degrees()" von der Einheit Radiant auf die Einheit Grad umgerechnet werden.
Verfügbarkeit: 2.5.0
Beispiele
Geometrischer Datentyp - Azimut in Grad
WITH rand AS (
SELECT s, random() * 2 * PI() AS rad1
, random() * 2 * PI() AS rad2
FROM generate_series(1,2,2) AS s
)
, points AS (
SELECT s, rad1,rad2, ST_MakePoint(cos1+s,sin1+s) as p1, ST_MakePoint(s,s) AS p2, ST_MakePoint(cos2+s,sin2+s) as p3
FROM rand
,cos(rad1) cos1, sin(rad1) sin1
,cos(rad2) cos2, sin(rad2) sin2
)
SELECT s, ST_AsText(ST_SnapToGrid(ST_MakeLine(ARRAY[p1,p2,p3]),0.001)) AS line
, degrees(ST_Angle(p1,p2,p3)) as computed_angle
, round(degrees(2*PI()-rad2 -2*PI()+rad1+2*PI()))::int%360 AS reference
, round(degrees(2*PI()-rad2 -2*PI()+rad1+2*PI()))::int%360 AS reference
FROM points ;
1 | line | computed_angle | reference
------------------+------------------
1 | LINESTRING(1.511 1.86,1 1,0.896 0.005) | 155.27033848688 | 155
Name
ST_ClosestPoint — 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.
Synopsis
geometry ST_ClosestPoint(geometry g1, geometry g2);
Beschreibung
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.
| |
Falls es sich um eine 3D-Geometrie handelt, sollten Sie ST_3DClosestPoint vorziehen. |
Verfügbarkeit: 1.5.0
Beispiele
 Der nächstliegende Punkt zwischen einem Punkt und einem Linienzug ist der Punkt selbst. Aber der nächstliegende Punkt zwischen einem Linienzug und einem Punkt ist der Punkt auf dem Linienzug mit dem geringsten Abstand.
SELECT ST_AsText(ST_ClosestPoint(pt,line)) AS cp_pt_line,
ST_AsText(ST_ClosestPoint(line,pt)) As cp_line_pt
FROM (SELECT 'POINT(100 100)'::geometry As pt,
'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry As line
) As foo;
cp_pt_line | cp_line_pt
----------------+------------------------------------------
POINT(100 100) | POINT(73.0769230769231 115.384615384615)
|  Der Punkt des Polygons A der am nähesten beim Polygon B liegt
SELECT ST_AsText(
ST_ClosestPoint(
ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'),
ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)
)
) As ptwkt;
ptwkt
------------------------------------------
POINT(140.752120669087 125.695053378061)
|
Name
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.
Synopsis
geometry ST_3DClosestPoint(geometry g1, geometry g2);
Beschreibung
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. Die Länge des kürzesten Abstands in 3D ergibt sich aus der 3D-Distanz.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Verfügbarkeit: 2.0.0
Änderung: 2.2.0 - Wenn 2 geometrische Objekte in 2D übergegeben werden, wird ein 2D-Punkt zurückgegeben (anstelle wie früher 0 für ein fehlendes Z). Im Falle von 2D und 3D, wird für fehlende Z nicht länger 0 angenommen.
Beispiele
Linienstück und Punkt -- Punkt mit kürzestem Abstand; in 3D und in 2D SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt,
ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt
FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
) As foo;
cp3d_line_pt | cp2d_line_pt
-----------------------------------------------------------+------------------------------------------
POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(73.0769230769231 115.384615384615)
|
Linienstück und Mehrfachpunkt - Punkt mit kürzestem Abstand; in 3D und in 2D SELECT ST_AsEWKT(ST_3DClosestPoint(line,pt)) AS cp3d_line_pt,
ST_AsEWKT(ST_ClosestPoint(line,pt)) As cp2d_line_pt
FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
) As foo;
cp3d_line_pt | cp2d_line_pt
-----------------------------------------------------------+--------------
POINT(54.6993798867619 128.935022917228 11.5475869506606) | POINT(50 75)
|
Mehrfachlinie und Polygon - Punkt mit kürzestem Abstand; in 3D und in 2D SELECT ST_AsEWKT(ST_3DClosestPoint(poly, mline)) As cp3d,
ST_AsEWKT(ST_ClosestPoint(poly, mline)) As cp2d
FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
(1 10 2, 5 20 1))') As mline ) As foo;
cp3d | cp2d
-------------------------------------------+--------------
POINT(39.993580415989 54.1889925532825 5) | POINT(20 40)
|
Name
ST_Distance — Gibt die größte 3-dimensionale Distanz zwischen zwei geometrischen Objekten als Linie zurück
Synopsis
float ST_HausdorffDistance(geometry g1, geometry g2);
float ST_HausdorffDistance(geometry g1, geometry g2, float densifyFrac);
Beschreibung
Für den geometrischen Datentyp. Es wird der geringste 3-dimensionale kartesische Abstand zwischen zwei geometrischen Objekten in projizierten Einheiten (Einheiten des Koordinatenreferenzsystem) zurückgegeben.
Beim geometrischen Datentyp geometry wird die geringste kartesische Distanz in 2D zwischen zwei geometrischen Objekten - in projizierten Einheiten (Einheiten des Koordinatenreferenzsystem) - zurückgegeben. Beim geographischen Datentyp geography wird standardmäßig die geringste geodätische Distanz zwischen zwei geographischen Objekten in Meter zurückgegeben. Wenn use_speroid FALSE ist, erfolgt eine schnellere Berechnung auf einer Kugel anstatt auf dem Referenzellipsoid.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 5.1.23
This method supports Circular Strings and Curves
Verfügbarkeit: 1.5.0 die Unterstützung des geograpischen Datentyps wurde eingeführt. Geschwindigkeitsverbesserungen bei einer umfangreichen Geometrie und bei einer Geometrie mit vielen Knoten
Enhanced: 2.1.0 Geschwindigkeitsverbesserung beim geographischen Datentyp. Siehe Making Geography faster für Details.
Erweiterung: 2.1.0 - Unterstützung für Kurven beim geometrischen Datentyp eingeführt.
Erweiterung: 2.2.0 - die Messung auf dem Referenzellipsoid wird mit der Bibliothek "GeographicLib" durchgeführt. Dadurch wurde die Genauigkeit und die Robustheit erhöht. Um die Vorteile dieser neuen Funktionalität zu nutzen, benötigen Sie Proj >= 4.9.0.
Changed: 3.0.0 - does not depend on SFCGAL anymore.
Standardbeispiele Geometrie
Geometry example - units in planar degrees 4326 is WGS 84 long lat, units are degrees.
SELECT ST_AsText(
ST_LongestLine('POINT(100 100)'::geometry,
'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)
) As lline;
lline
-----------------
LINESTRING(100 100,98 190)Geometry example - units in meters (SRID: 3857, proportional to pixels on popular web maps). Although the value is off, nearby ones can be compared correctly, which makes it a good choice for algorithms like KNN or KMeans.
SELECT ST_Intersects(
ST_GeographyFromText('SRID=4326;LINESTRING(-43.23456 72.4567,-43.23456 72.4568)'),
ST_GeographyFromText('SRID=4326;POINT(-43.23456 72.4567772)')
);
st_intersects
---------------
tGeometry example - units in meters (SRID: 3857 as above, but corrected by cos(lat) to account for distortion)
SELECT ST_Intersects(
ST_GeographyFromText('SRID=4326;LINESTRING(-43.23456 72.4567,-43.23456 72.4568)'),
ST_GeographyFromText('SRID=4326;POINT(-43.23456 72.4567772)')
);
st_intersects
---------------
tGeometry example - units in meters (SRID: 26986 Massachusetts state plane meters) (most accurate for Massachusetts)
SELECT ST_Intersects(
ST_GeographyFromText('SRID=4326;LINESTRING(-43.23456 72.4567,-43.23456 72.4568)'),
ST_GeographyFromText('SRID=4326;POINT(-43.23456 72.4567772)')
);
st_intersects
---------------
tGeometry example - units in meters (SRID: 2163 US National Atlas Equal area) (least accurate)
SELECT ST_Intersects(
ST_GeographyFromText('SRID=4326;LINESTRING(-43.23456 72.4567,-43.23456 72.4568)'),
ST_GeographyFromText('SRID=4326;POINT(-43.23456 72.4567772)')
);
st_intersects
---------------
tBeispiele für den geographischen Datentyp
Same as geometry example but note units in meters - use sphere for slightly faster and less accurate computation.
-- gleich wie das Beispiel mit dem geometrischen Datentyp, aber Einheiten in Meter - verwendet Kugel für eine geringfügige Geschwindigkeitsverbesserung, allerdings ungenauer
SELECT ST_Distance(gg1, gg2) As spheroid_dist, ST_Distance(gg1, gg2, false) As sphere_dist
FROM (SELECT
'SRID=4326;POINT(-72.1235 42.3521)'::geography as gg1,
'SRID=4326;LINESTRING(-72.1260 42.45, -72.123 42.1546)'::geography as gg2
) As foo ;
spheroid_dist | sphere_dist
------------------+------------------
123.802076746848 | 123.475736916397Name
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.
Synopsis
float ST_3DDistance(geometry g1, geometry g2);
Beschreibung
Für den geometrischen Datentyp. Es wird der geringste 3-dimensionale kartesische Abstand zwischen zwei geometrischen Objekten in projizierten Einheiten (Einheiten des Koordinatenreferenzsystem) zurückgegeben.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This method implements the SQL/MM specification. SQL-MM ?
Verfügbarkeit: 2.0.0
Änderung: 2.2.0 - Im Falle von 2D und 3D wird für ein fehlendes Z nicht mehr 0 angenommen.
Changed: 3.0.0 - SFCGAL version removed
Beispiele
-- Beispiel Geometrie - Einheiten in Meter (SRID: 2163 US National Atlas Equal area) (Abstand zwischen Punkt und Linie; Vergleich zwischen 3D und 2D)
-- Anmerkung: zur Zeit gibt es keine Unterstützung für ein Höhendatum, daher wird Z unverändert übernommen und nicht transformiert.
SELECT ST_3DDistance(
ST_Transform(ST_GeomFromEWKT('SRID=4326;POINT(-72.1235 42.3521 4)'),2163),
ST_Transform(ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)
) As dist_3d,
ST_Distance(
ST_Transform(ST_GeomFromText('POINT(-72.1235 42.3521)',4326),2163),
ST_Transform(ST_GeomFromText('LINESTRING(-72.1260 42.45, -72.123 42.1546)', 4326),2163)
) As dist_2d;
dist_3d | dist_2d
------------------+-----------------
127.295059324629 | 126.66425605671
-- MultiLinestring und Polygon, Distanz in 3D und in 2D
-- Gleiches Beispiel wie das mit dem nächstliegenden Punkt in 3D
SELECT ST_3DDistance(poly, mline) As dist3d,
ST_Distance(poly, mline) As dist2d
FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
(1 10 2, 5 20 1))') As mline ) As foo;
dist3d | dist2d
-------------------+--------
0.716635696066337 | 0
Name
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.
Synopsis
float ST_DistanceSphere(geometry geomlonlatA, geometry geomlonlatB);
Beschreibung
Gibt die kürzeste Distanz zwischen zwei Punkten zurück, die über Länge und Breite gegeben sind. Verwendet die Kugelform für die Erde und den Radius des Referenzellipsoids, der durch die SRID festgelegt ist. Ist schneller als ST_DistanceSpheroid, aber weniger genau. Vorgängerversionen von PostGIS 1.5 unterstützten nur Punkte.
Verfügbarkeit: 1.5 die Unterstützung für weitere geometrische Datentypen neben Punkten eingeführt. Bei Vorgängerversionen wurden nur Punkte unterstützt.
Änderung: 2.2.0 In Vorgängerversionen als ST_Distance_Sphere bezeichet.
Beispiele
SELECT round(CAST(ST_DistanceSphere(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters,
round(CAST(ST_Distance(ST_Transform(ST_Centroid(the_geom),32611),
ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) As numeric),2) As dist_utm11_meters,
round(CAST(ST_Distance(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)', 4326)) As numeric),5) As dist_degrees,
round(CAST(ST_Distance(ST_Transform(the_geom,32611),
ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) As numeric),2) As min_dist_line_point_meters
FROM
(SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', 4326) As the_geom) as foo;
dist_meters | dist_utm11_meters | dist_degrees | min_dist_line_point_meters
-------------+-------------------+--------------+----------------------------
70424.47 | 70438.00 | 0.72900 | 65871.18
Name
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.
Synopsis
float ST_DistanceSpheroid(geometry geomlonlatA, geometry geomlonlatB, spheroid measurement_spheroid);
Beschreibung
Gibt die kürzeste Distanz zwischen zwei geometrischen Objekten in Meter zurück, die über Länge, Breite und ein bestimmtes Referenzellipsoid gegeben sind. Siehe die Erklärung zu Referenzellipsoiden unter ST_LengthSpheroid. Vorgängerversionen von PostGIS 1.5 unterstützten nur Punkte.
| |
Aktuell schaut diese Funktion nicht auf die SRID der Geometrie, sondern nimmt an, dass die Geometrie in den Koordinaten des gegebenen Referenzellipsoids vorliegt. Vorgängerversionen von PostGIS 1.5 unterstützten nur Punkte. |
Verfügbarkeit: 1.5 die Unterstützung für weitere geometrische Datentypen neben Punkten eingeführt. Bei Vorgängerversionen wurden nur Punkte unterstützt.
Änderung: 2.2.0 In Vorgängerversionen als ST_Distance_Spheroid bezeichet.
Beispiele
SELECT round(CAST(
ST_DistanceSpheroid(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)',4326), 'SPHEROID["WGS 84",6378137,298.257223563]')
As numeric),2) As dist_meters_spheroid,
round(CAST(ST_DistanceSphere(ST_Centroid(the_geom), ST_GeomFromText('POINT(-118 38)',4326)) As numeric),2) As dist_meters_sphere,
round(CAST(ST_Distance(ST_Transform(ST_Centroid(the_geom),32611),
ST_Transform(ST_GeomFromText('POINT(-118 38)', 4326),32611)) As numeric),2) As dist_utm11_meters
FROM
(SELECT ST_GeomFromText('LINESTRING(-118.584 38.374,-118.583 38.5)', 4326) As the_geom) as foo;
dist_meters_spheroid | dist_meters_sphere | dist_utm11_meters
----------------------+--------------------+-------------------
70454.92 | 70424.47 | 70438.00
Name
ST_FrechetDistance — Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück
Synopsis
float ST_FrechetDistance(geometry g1, geometry g2, float densifyFrac = -1);
Beschreibung
Implementiert einen Algorithmus zur Berechnung der Fréchet-Metrik, der für beide geometrischen Objekte auf diskrete Punkte beschränkt ist und auf Computing Discrete Fréchet Distance beruht. Die Fréchet-Metrik ist ein Maß für die Ähnlichkeit von Kurven, welches die Position und die Reihenfolge der Kurvenstützpunkte mit einbezieht. Daher ist sie oft besser geeignet als die Hausdorff-Metrik.
Wenn der optionale Parameter "densifyFrac" vorgegeben wird, dann führt diese Funktion eine Verdichtung der Linienstücke durch, bevor die diskrete Fréchet-Metrik berechnet wird. Der Parameter "densifyFrac" bestimmt um welchen Anteil die Linienstücke verdichtet werden. Jedes Linienstück wird in gleichlange Teilsegmente zerlegt, deren Anteil an der Gesamtlänge am nächsten an den vorgegebenen Anteil herankommt.
Units are in the units of the spatial reference system of the geometries.
| |
Bei der aktuellen Implementierung können die diskreten Punkte nur Knoten sein. Dies könnte erweitert werden, um eine beliebige Punktdichte zu ermöglichen. |
| |
Umso kleiner wir densifyFrac wählen, umso genauer wird die Fréchet-Metrik. Aber die Rechenzeit und der Speicherplatzbedarf steigen quadratisch mit der Anzahl der Teilabschnitte. |
Wird durch das GEOS Modul ausgeführt
Verfügbarkeit: 2.4.0 - benötigt GEOS >= 3.7.0
Beispiele
postgres=# SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, 'LINESTRING (0 0, 50 50, 100 0)'::geometry);
st_frechetdistance
--------------------
70.7106781186548
(1 row)
SELECT st_frechetdistance('LINESTRING (0 0, 100 0)'::geometry, 'LINESTRING (0 0, 50 50, 100 0)'::geometry, 0.5);
st_frechetdistance
--------------------
50
(1 row)
Name
ST_HausdorffDistance — Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück
Synopsis
float ST_HausdorffDistance(geometry g1, geometry g2);
float ST_HausdorffDistance(geometry g1, geometry g2, float densifyFrac);
Beschreibung
Gibt die Hausdorff-Metrik von zwei geometrischen Objekten zurück. Dies ist ein grundsätzliches Maß für die Ähnlichkeit oder Unähnlichkeit von 2 geometrischen Objekten. Die Einheiten sind in den Einheiten des Koordinatenreferenzsystems der Geometrie.
Implementiert einen Algorithmus zur Berechnung einer Abstandsmetrik, welche als "Diskrete Hausdorff-Metrik" gedacht werden kann. Dabei handelt es sich um eine Hausdorff-Metrik, die auf diskrete Punkte einer Geometrie beschränkt ist.Wikipedia article on Hausdorff distance Martin Davis Notizen wie die Hausdorff-Metrik zur Überprüfung der Korrektheit des CascadePolygonUnion Ansatzes verwendet wurde.
Wenn densifyFrac vorgegeben wird, dann führt diese Funktion eine Verdichtung der Linienstücke durch, bevor die diskrete Hausdorff-Metrik berechnet wird. Der Parameter "densifyFrac" bestimmt um welchen Anteil die Linienstücke verdichtet werden. Jedes Linienstück wird in gleichlange Teilsegmente zerlegt, deren Anteil an der Gesamtlänge am nächsten an den vorgegebenen Anteil herankommt.
Units are in the units of the spatial reference system of the geometries.
| |
Bei der aktuellen Implementierung können die diskreten Punkte nur Knoten sein. Dies könnte erweitert werden, um eine beliebige Punktdichte zu ermöglichen. |
| |
Dieser Algorithmus ist NICHT gleichwertig mit der normalen Hausdorff-Metrik. Er führt aber eine Näherungsberechnung durch, die für eine große Zahl von Anwendungsfällen korrekt ist. Ein wichtiger Anwendungsfall sind Linienstücke, die ungefähr parallel sind und etwa die gleiche Länge haben. Diese Funktion bietet eine wertvolle Metrik zum Anpassen von Linien. |
Verfügbarkeit: 1.5.0
Beispiele
Finde zu jedem Bauwerk das Grundstück, das am besten dazu passt. Zuerst verlangen wir, dass sich das Grundstück mit dem Bauwerk schneidet. DISTINCT ON stellt sicher, dass wir jedes Bauwerk nur einmal aufgelistet bekommen, ORDER BY .. ST_HausdorffDistance bevorzugt die Grundstücke, die dem Bauwerk am ähnlichsten sind.
SELECT DISTINCT ON(buildings.gid) buildings.gid, parcels.parcel_id
FROM buildings INNER JOIN parcels ON ST_Intersects(buildings.geom,parcels.geom)
ORDER BY buildings.gid, ST_HausdorffDistance(buildings.geom, parcels.geom);postgis=# SELECT ST_HausdorffDistance(
'LINESTRING (0 0, 2 0)'::geometry,
'MULTIPOINT (0 1, 1 0, 2 1)'::geometry);
st_hausdorffdistance
----------------------
1
(1 row)
postgis=# SELECT st_hausdorffdistance('LINESTRING (130 0, 0 0, 0 150)'::geometry, 'LINESTRING (10 10, 10 150, 130 10)'::geometry, 0.5);
st_hausdorffdistance
----------------------
70
(1 row)
Name
ST_Length — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
Synopsis
float ST_Length(geometry a_2dlinestring);
float ST_Length(geography geog, boolean use_spheroid=true);
Beschreibung
Beim geometrischen Datentyp wird die kartesische 2D Länge der Geometrie zurückgegeben. Dabei muss es sich um einen LineString, einen MultiLineString, eine ST_Curve oder eine ST_MultiCurve handeln. Bei einer flächigen Geometrie wird 0 zurückgegeben. Für eine flächige Geometrie können Sie ST_Perimeter verwenden. Bei den geometrischen Datentypen sind die Einheiten für die Längenmessungen durch das Koordinatenreferenzsystem festgelegt.
Beim geographischen Datentyp werden die Berechnungen über die zweite geodätische Hauptaufgabe mit der Längeneinheit Meter durchgeführt. Wenn PostGIS mit PROJ Version 4.8.0 oder höher kompiliert wurde, dann ist das Referenzellipsoid durch die SRID bestimmt; sonst ist es ausschließlich WGS84. Wenn use_spheroid=false ist, dann werden die Berechnungen auf einer Kugel anstatt auf einem Referenzellipsoid ausgeführt.
Zur Zeit ein Synonym für ST_Length2D; dies kann sich allerdings ändern, wenn höhere Dimensionen unterstützt werden.
| |
Änderung: 2.0.0 Wesentliche Änderung -- In früheren Versionen ergab die Anwendung auf ein MULTI/POLYGON vom geographischen Datentyp den Umfang des POLYGON/MULTIPOLYGON. In 2.0.0 wurde dies geändert und es wird jetzt 0 zurückgegeben, damit es mit der Verhaltensweise beim geometrischen Datentyp übereinstimmt. Verwenden Sie bitte ST_Perimeter, wenn Sie den Umfang eines Polygons wissen wollen |
| |
Beim geographischer Datentyp werden die Messungen standardmäßig am Referenzellipsoid durchgeführt. Für die schnellere, aber ungenauere Berechnung auf einer Kugel können Sie ST_Length(gg,false) verwenden; |
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.5.1
This method implements the SQL/MM specification. SQL-MM 3: 7.1.2, 9.3.4
Verfügbarkeit: 1.5.0 Unterstützung von geograpischen Koordinaten.
This method is also provided by SFCGAL backend.
Beispiele mit geometrischem Datentyp
Gibt die Länge eines Linienstücks zurück. Beachten Sie, dass die Einheit Fuß ist, da EPSG:2249 "Massachusetts State Plane Feet" ist
SELECT ST_Length(ST_GeomFromText('LINESTRING(743238 2967416,743238 2967450,743265 2967450,
743265.625 2967416,743238 2967416)',2249));
st_length
---------
122.630744000095
--Koordinatentransformation eines Linienzuges von "WGS 84" nach "Massachusetts state plane meters"
SELECT ST_Length(
ST_Transform(
ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45, -72.1240 42.45666, -72.123 42.1546)'),
26986
)
);
st_length
---------
34309.4563576191
Beispiele für den geographischen Datentyp
Gibt die Länge einer Linie zurück, die in geographischen WGS 84 Koordinaten vorliegt.
-- standardmäßig wird die Berechnung auf einer Kugel anstatt auf dem Referenzellipsoid ausgeführt
SELECT ST_Length(the_geog) As length_spheroid, ST_Length(the_geog,false) As length_sphere
FROM (SELECT ST_GeographyFromText(
'SRID=4326;LINESTRING(-72.1260 42.45, -72.1240 42.45666, -72.123 42.1546)') As the_geog)
As foo;
length_spheroid | length_sphere
------------------+------------------
34310.5703627288 | 34346.2060960742
Name
ST_Length2D —
Gibt die 2-dimensionale Länge einer Linie oder einer Mehrfachlinie zurück. Dies ist ein Alias für ST_Length
Synopsis
float ST_Length2D(geometry a_2dlinestring);
Name
ST_3DLength — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
Synopsis
float ST_3DLength(geometry a_3dlinestring);
Beschreibung
Gibt die 2- oder 3-dimensionale Länge einer Linie oder einer Mehrfachlinie zurück. Bei einer 2-D Linie wird die Länge nur in 2D zurückgegeben (gleich wie ST_Length und ST_Length2D)
This function supports 3d and will not drop the z-index.
Änderung: 2.0.0 In Vorgängerversionen als ST_Length3D bezeichet.
Beispiele
Gibt die Länge eines 3D-Kabels zurück. Beachten Sie, dass die Einheit Fuß ist, da EPSG:2249 "Massachusetts State Plane Feet" ist
SELECT ST_3DLength(ST_GeomFromText('LINESTRING(743238 2967416 1,743238 2967450 1,743265 2967450 3,
743265.625 2967416 3,743238 2967416 3)',2249));
ST_3DLength
-----------
122.704716741457
Name
ST_LengthSpheroid — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
Synopsis
float ST_LengthSpheroid(geometry a_geometry, spheroid a_spheroid);
Beschreibung
Berechnet die/den Länge/Umfang einer Geometrie auf einem Ellipsoid. Dies ist nützlich wenn die Koordinaten der Geometrie in Länge und Breite vorliegen, und die Länge der Geometrie ohne benötigt wird, ohne dass umprojiziert werden muss. Das Ellipsoid ist ein eigener Datentyp und kann wie folgt erstellt werden:
SPHEROID[<NAME>,<SEMI-MAJOR AXIS>,<INVERSE FLATTENING>]
Geometrie Beispiel
SPHEROID["GRS_1980",6378137,298.257222101]
Verfügbarkeit: 1.2.2
Änderung: 2.2.0 In Vorgängerversionen als ST_Length_Spheroid bezeichet.und mit dem Alias "ST_3DLength_Spheroid" versehen
This function supports 3d and will not drop the z-index.
Beispiele
SELECT ST_LengthSpheroid( geometry_column,
'SPHEROID["GRS_1980",6378137,298.257222101]' )
FROM geometry_table;
SELECT ST_LengthSpheroid( the_geom, sph_m ) As tot_len,
ST_LengthSpheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,
ST_LengthSpheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2
FROM (SELECT ST_GeomFromText('MULTILINESTRING((-118.584 38.374,-118.583 38.5),
(-71.05957 42.3589 , -71.061 43))') As the_geom,
CAST('SPHEROID["GRS_1980",6378137,298.257222101]' As spheroid) As sph_m) as foo;
tot_len | len_line1 | len_line2
------------------+------------------+------------------
85204.5207562955 | 13986.8725229309 | 71217.6482333646
--3D
SELECT ST_LengthSpheroid( the_geom, sph_m ) As tot_len,
ST_LengthSpheroid(ST_GeometryN(the_geom,1), sph_m) As len_line1,
ST_LengthSpheroid(ST_GeometryN(the_geom,2), sph_m) As len_line2
FROM (SELECT ST_GeomFromEWKT('MULTILINESTRING((-118.584 38.374 20,-118.583 38.5 30),
(-71.05957 42.3589 75, -71.061 43 90))') As the_geom,
CAST('SPHEROID["GRS_1980",6378137,298.257222101]' As spheroid) As sph_m) as foo;
tot_len | len_line1 | len_line2
------------------+-----------------+------------------
85204.5259107402 | 13986.876097711 | 71217.6498130292
Name
ST_LongestLine — Gibt die größte 3-dimensionale Distanz zwischen zwei geometrischen Objekten als Linie zurück
Synopsis
geometry ST_LongestLine(geometry g1, geometry g2);
Beschreibung
Gibt die längste 2-dimensionale Linie zwischen den Punkten zweier Geometrien zurück.
Gibt den größten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück. Wenn es mehr als einen größten Abstand gibt, dann wird nur die erste zurückgegeben. Die zurückgegebene Linie fängt immer mit "g1" an und endet mit "g2". Die Länge der 3D-Linie die von dieser Funktion zurückgegeben wird ist immer ident mit der von ST_3DMaxDistance für "g1" und "g2" zurückgegebenen Distanz.
Verfügbarkeit: 1.5.0
Beispiele
 Längste Strecke zwischen Punkt und Linie
SELECT ST_AsText(
ST_LongestLine('POINT(100 100)'::geometry,
'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)
) As lline;
lline
-----------------
LINESTRING(100 100,98 190)
|  Längste Strecke zwischen Polygon und Polygon
SELECT ST_AsText(
ST_LongestLine(
ST_GeomFromText('POLYGON((175 150, 20 40,
50 60, 125 100, 175 150))'),
ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)
)
) As llinewkt;
lline
-----------------
LINESTRING(20 40,121.111404660392 186.629392246051)
|
 Die längste Luftlinie um von einer Seite einer eleganten Stadt auf die andere zu wechseln. Beachten Sie, dass das Ergebnis von ST_MaxDistance ident mit der Länge von ST_LongestLine ist.
SELECT ST_AsText(ST_LongestLine(c.the_geom, c.the_geom)) As llinewkt,
ST_MaxDistance(c.the_geom,c.the_geom) As max_dist,
ST_Length(ST_LongestLine(c.the_geom, c.the_geom)) As lenll
FROM (SELECT ST_BuildArea(ST_Collect(the_geom)) As the_geom
FROM (SELECT ST_Translate(ST_SnapToGrid(ST_Buffer(ST_Point(50 ,generate_series(50,190, 50)
),40, 'quad_segs=2'),1), x, 0) As the_geom
FROM generate_series(1,100,50) As x) AS foo
) As c;
llinewkt | max_dist | lenll
---------------------------+------------------+------------------
LINESTRING(23 22,129 178) | 188.605408193933 | 188.605408193933
|
Name
ST_3DLongestLine — Gibt die größte 3-dimensionale Distanz zwischen zwei geometrischen Objekten als Linie zurück
Synopsis
geometry ST_3DLongestLine(geometry g1, geometry g2);
Beschreibung
Gibt den größten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück. Wenn es mehr als einen größten Abstand gibt, dann wird nur die erste zurückgegeben. Die zurückgegebene Linie fängt immer mit "g1" an und endet mit "g2". Die Länge der 3D-Linie die von dieser Funktion zurückgegeben wird ist immer ident mit der von ST_3DMaxDistance für "g1" und "g2" zurückgegebenen Distanz.
Verfügbarkeit: 2.0.0
Änderung: 2.2.0 - Wenn 2 geometrische Objekte in 2D übergegeben werden, wird ein 2D-Punkt zurückgegeben (anstelle wie früher 0 für ein fehlendes Z). Im Falle von 2D und 3D, wird für fehlende Z nicht länger 0 angenommen.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Beispiele
Linienstück und Punkt -- größter Abstand in 3D und in 2D SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt,
ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt
FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
) As foo;
lol3d_line_pt | lol2d_line_pt
-----------------------------------+----------------------------
LINESTRING(50 75 1000,100 100 30) | LINESTRING(98 190,100 100)
|
Linienstück und Mehrfachpunkt -- größter Abstand in 3D und in 2D SELECT ST_AsEWKT(ST_3DLongestLine(line,pt)) AS lol3d_line_pt,
ST_AsEWKT(ST_LongestLine(line,pt)) As lol2d_line_pt
FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
) As foo;
lol3d_line_pt | lol2d_line_pt
---------------------------------+--------------------------
LINESTRING(98 190 1,50 74 1000) | LINESTRING(98 190,50 74)
|
Mehrfachlinie und Polygon - größter Abstand in 3D und in 2D SELECT ST_AsEWKT(ST_3DLongestLine(poly, mline)) As lol3d,
ST_AsEWKT(ST_LongestLine(poly, mline)) As lol2d
FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
(1 10 2, 5 20 1))') As mline ) As foo;
lol3d | lol2d
------------------------------+--------------------------
LINESTRING(175 150 5,1 10 2) | LINESTRING(175 150,1 10)
|
Name
ST_MaxDistance — Gibt die größte 2-dimensionale Distanz zwischen zwei geometrischen Objekten in projizierten Einheiten zurück.
Synopsis
float ST_MaxDistance(geometry g1, geometry g2);
Beschreibung
| |
Gibt die größte 2-dimensionale Distanz zwischen zwei geometrischen Objekten in projizierten Einheiten zurück. Wenn g1 und g2 dieselbe Geometrie sind, dann gibt die Funktion die Distanz zwischen den beiden am weitesten entfernten Knoten in dieser Geometrie zurück. |
Verfügbarkeit: 1.5.0
Beispiele
Größte Distanz zwischen dem Punkt und irgendeinem Teil der Linie
postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 0, 0 2 )'::geometry);
st_maxdistance
-----------------
2
(1 row)
postgis=# SELECT ST_MaxDistance('POINT(0 0)'::geometry, 'LINESTRING ( 2 2, 2 2 )'::geometry);
st_maxdistance
------------------
2.82842712474619
(1 row)Name
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.
Synopsis
float ST_3DMaxDistance(geometry g1, geometry g2);
Beschreibung
Für den geometrischen Datentyp. Gibt die maximale 3-dimensionale kartesische Distanz zwischen zwei geometrischen Objekten in projizierten Einheiten (Einheiten des Koordinatenreferenzsystem) zurück.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Verfügbarkeit: 2.0.0
Änderung: 2.2.0 - Im Falle von 2D und 3D wird für ein fehlendes Z nicht mehr 0 angenommen.
Beispiele
-- Beispiel Geometrie - Einheiten in Meter (SRID: 2163 US National Atlas Equal area) (Vergleich von 3D-Punkt und Linie mit 2D-Punkt und Linie)
-- Anmerkung: zur Zeit gibt es keine Unterstützung für ein Höhendatum, daher wird Z unverändert übernommen und nicht transformiert.
SELECT ST_3DMaxDistance(
ST_Transform(ST_GeomFromEWKT('SRID=4326;POINT(-72.1235 42.3521 10000)'),2163),
ST_Transform(ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)
) As dist_3d,
ST_MaxDistance(
ST_Transform(ST_GeomFromEWKT('SRID=4326;POINT(-72.1235 42.3521 10000)'),2163),
ST_Transform(ST_GeomFromEWKT('SRID=4326;LINESTRING(-72.1260 42.45 15, -72.123 42.1546 20)'),2163)
) As dist_2d;
dist_3d | dist_2d
------------------+------------------
24383.7467488441 | 22247.8472107251
Name
ST_MinimumClearance — Gibt das Mindestabstandsmaß für eine Geometrie zurück; ein Maß für die Robustheit einer Geometrie.
Synopsis
float ST_MinimumClearance(geometry g);
Beschreibung
Es ist nicht ungewöhnlich dass eine Geometrie, welche die Kriterien für Validität gemäß ST_IsValid (Polygone) oder ST_IsSimple (Linien) erfüllt, durch eine geringe Verschiebung von einem Knoten invalid wird. Dies kann während einer Konvertierung in Textformate (wie WKT, KML, GML und GeoJSON) vorkommen, oder bei binären Formaten, welche die Koordinaten nicht als Gleitpunkt-Zahl mit doppelter Genauigkeit (double-precision floating point) abspeichern (MapInfo TAB).
Das "Mindestabstandsmaß" einer Geometrie entspricht der kürzesten Strecke, um die ein Knoten der Geometrie bewegt werden kann, ohne dass die Geometrie invalid wird. Es kann als quantitative Maßzahl für die Robustheit einer Geometrie gesehen werden, wobei steigende Werte zunehmende Robustheit anzeigen.
Wenn eine Geometrie ein Mindestabstandsmaß von e hat, dann gilt:
Zwei sich unterscheidende Knoten der Geometrie sind nicht weniger als
evoneinander entfernt.Kein Knoten liegt näher als
ebei einem Liniensegment, außer es ist ein Endpunkt.
Wenn für eine Geometrie kein Mindestabstandsmaß existiert (zum Beispiel ein einzelner Punkt, oder ein Mehrfachpunkt, dessen Punkte identisch sind), dann gibt ST_MinimumClearance unendlich zurück.
Verfügbarkeit: 2.3.0
Name
ST_MinimumClearanceLine — Gibt ein Linienstück mit zwei Punkten zurück, welche sich über das Mindestabstandsmaß erstreckt.
Synopsis
Geometry ST_MinimumClearanceLine(geometry g);
Beschreibung
Gibt ein Zwei-Punkt-Linienstück zurück, welches sich über das Mindestabstandsmaß erstreckt. Wenn die Geometrie kein Mindestabstandsmaß aufweist, dann wird LINESTRING EMPTY zurückgegeben.
Wird durch das GEOS Modul ausgeführt
Verfügbarkeit: 2.3.0 - benötigt GEOS >= 3.6.0
Name
ST_Perimeter — Returns the length of the boundary of a polygonal geometry or geography.
Synopsis
float ST_Perimeter(geometry g1);
float ST_Perimeter(geography geog, boolean use_spheroid=true);
Beschreibung
Gibt für die geometrischen/geographischen Datentypen ST_Surface, ST_MultiSurface (Polygon, MultiPolygon) den Umfang in 2D zurück. Bei einer nicht flächigen Geometrie wird 0 zurückgegeben. Für eine lineare Geometrie können Sie ST_Length verwenden. Beim geometrischen Datentyp sind die Einheiten der Umfangsmessung durch das Koordinatenreferenzsystem der Geometrie festgelegt.
Beim geographischen Datentyp werden die Berechnungen über die zweite geodätische Hauptaufgabe durchgeführt, wobei die Einheit für den Umfang Meter ist. Wenn PostGIS mit PROJ Version 4.8.0 oder höher kompiliert wurde, dann ist das Referenzellipsoid durch die SRID bestimmt; sonst ist es ausschließlich WGS84. Wenn use_spheroid=false ist, dann werden die Berechnungen auf einer Kugel anstatt auf einem Referenzellipsoid ausgeführt.
Zur Zeit ein Synonym für ST_Perimeter2D; dies kann sich allerdings ändern, wenn höhere Dimensionen unterstützt werden.
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.5.1
This method implements the SQL/MM specification. SQL-MM 3: 8.1.3, 9.5.4
Verfügbarkeit: Mit 2.0.0 wurde die Unterstützung für geograpischen Koordinaten eingeführt
Beispiele: geometrischer Datentyp
Den Umfang eines Polygons und eines Mehrfachpolygons in Fuß ausgeben. Beachten Sie bitte, dass die Einheit Fuß ist, da EPSG:2249 "Massachusetts State Plane Feet" ist
SELECT ST_Perimeter(ST_GeomFromText('POLYGON((743238 2967416,743238 2967450,743265 2967450,
743265.625 2967416,743238 2967416))', 2249));
st_perimeter
---------
122.630744000095
(1 row)
SELECT ST_Perimeter(ST_GeomFromText('MULTIPOLYGON(((763104.471273676 2949418.44119003,
763104.477769673 2949418.42538203,
763104.189609677 2949418.22343004,763104.471273676 2949418.44119003)),
((763104.471273676 2949418.44119003,763095.804579742 2949436.33850239,
763086.132105649 2949451.46730207,763078.452329651 2949462.11549407,
763075.354136904 2949466.17407812,763064.362142565 2949477.64291974,
763059.953961626 2949481.28983009,762994.637609571 2949532.04103014,
762990.568508415 2949535.06640477,762986.710889563 2949539.61421415,
763117.237897679 2949709.50493431,763235.236617789 2949617.95619822,
763287.718121842 2949562.20592617,763111.553321674 2949423.91664605,
763104.471273676 2949418.44119003)))', 2249));
st_perimeter
---------
845.227713366825
(1 row)
Beispiele: geographischer Datentyp
Gibt den Umfang eines Polygons und eines Mehrfachpolygons in Meter und in Fuß aus. Beachten Sie, dass diese in geographischen Koordinaten (WGS 84 Länge/Breite) vorliegen.
SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog)/0.3048 As per_ft
FROM ST_GeogFromText('POLYGON((-71.1776848522251 42.3902896512902,-71.1776843766326 42.3903829478009,
-71.1775844305465 42.3903826677917,-71.1775825927231 42.3902893647987,-71.1776848522251 42.3902896512902))') As geog;
per_meters | per_ft
-----------------+------------------
37.3790462565251 | 122.634666195949
-- Beispiel MultiPolygon --
SELECT ST_Perimeter(geog) As per_meters, ST_Perimeter(geog,false) As per_sphere_meters, ST_Perimeter(geog)/0.3048 As per_ft
FROM ST_GeogFromText('MULTIPOLYGON(((-71.1044543107478 42.340674480411,-71.1044542869917 42.3406744369506,
-71.1044553562977 42.340673886454,-71.1044543107478 42.340674480411)),
((-71.1044543107478 42.340674480411,-71.1044860600303 42.3407237015564,-71.1045215770124 42.3407653385914,
-71.1045498002983 42.3407946553165,-71.1045611902745 42.3408058316308,-71.1046016507427 42.340837442371,
-71.104617893173 42.3408475056957,-71.1048586153981 42.3409875993595,-71.1048736143677 42.3409959528211,
-71.1048878050242 42.3410084812078,-71.1044020965803 42.3414730072048,
-71.1039672113619 42.3412202916693,-71.1037740497748 42.3410666421308,
-71.1044280218456 42.3406894151355,-71.1044543107478 42.340674480411)))') As geog;
per_meters | per_sphere_meters | per_ft
------------------+-------------------+------------------
257.634283683311 | 257.412311446337 | 845.256836231335
Name
ST_Perimeter2D — Returns the 2D perimeter of a polygonal geometry. Alias for ST_Perimeter.
Synopsis
float ST_Perimeter2D(geometry geomA);
Name
ST_3DPerimeter — Gibt den geometrischen Schwerpunkt einer Geometrie zurück.
Synopsis
float ST_3DPerimeter(geometry geomA);
Beschreibung
Gibt den 3-dimensionalen Umfang eines Polygons oder eines Mehrfachpolygons zurück. Wenn es sich um eine 2-dimensionale Geometrie handelt wird der 2-dimensionale Umfang zurückgegeben.
This function supports 3d and will not drop the z-index.
Änderung: 2.0.0 In Vorgängerversionen als ST_Perimeter3D bezeichet.
Beispiele
Umfang eines leicht erhöhten Polygons in "Massachusetts state plane feet"
SELECT ST_3DPerimeter(the_geom), ST_Perimeter2d(the_geom), ST_Perimeter(the_geom) FROM
(SELECT ST_GeomFromEWKT('SRID=2249;POLYGON((743238 2967416 2,743238 2967450 1,
743265.625 2967416 1,743238 2967416 2))') As the_geom) As foo;
ST_3DPerimeter | st_perimeter2d | st_perimeter
------------------+------------------+------------------
105.465793597674 | 105.432997272188 | 105.432997272188
Name
ST_Project — Gibt einen POINT zurück, der von einem Anfangspunkt weg, entsprechend einer Distanz in Meter und einer Peilung (Azimut) in Radiant, projiziert wird.
Synopsis
geography ST_Project(geography g1, float distance, float azimuth);
Beschreibung
Gibt einen POINT zurück, der sich von einem Standpunkt aus durch den Azimut (Pelilung) in Radiant und die Distanz in Meter zum Zielpunkt ergibt. Dies wird auch als erste geodätische Hauptaufgabe bezeichnet.
Die Entfernung wird in Meter angegeben.
In der Navigation wird das Azimut auch manchmal als Kurs oder Peilung bezeichnet. Es wird relativ zur Nordrichtung (Azimut null) gemessen. Osten hat ein Azimut von 90 (π/2), Süden 180 (π) und Westen 270 (3π/2).
Verfügbarkeit: 2.0.0
Erweiterung: 2.4.0 Erlaubt negative Distanzen und nicht normalisierten Azimut.
Name
ST_ShortestLine — Gibt die 2-dimenionale kürzeste Strecke zwischen zwei Geometrien als Linie zurück
Synopsis
geometry ST_ShortestLine(geometry g1, geometry g2);
Beschreibung
Gibt den kürzesten 2-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück. Wenn es mehrere kürzeste Abstände gibt, dann wird nur der erste zurückgegeben, der von der Funktion gefunden wurde. Wenn sich g1 und g2 nur in einem Punkt schneiden, dann gibt die Funktion eine Linie zurück, die ihren Anfang und ihr Ende in dem Schnittpunkt hat. Wenn sich g1 und g2 in mehreren Punkten schneiden, dann gibt die Funktion eine Linie zurück, die Anfang und Ende in irgendeinem der Schnittpunkte hat. Die zurückgegebene Linie beginnt immer mit g1 und endet mit g2. Die Länge der 2D-Linie die von dieser Funktion zurückgegeben wird ist immer gleich der von ST_Distance für g1 und g2 zurückgegebenen Distanz.
Verfügbarkeit: 1.5.0
Beispiele
 Kürzeste Strecke zwischen Punkt und Linienzug
SELECT ST_AsText(
ST_ShortestLine('POINT(100 100)'::geometry,
'LINESTRING (20 80, 98 190, 110 180, 50 75 )'::geometry)
) As sline;
sline
-----------------
LINESTRING(100 100,73.0769230769231 115.384615384615)
|  kürzeste Strecke zwischen Polygon und Polygon
SELECT ST_AsText(
ST_ShortestLine(
ST_GeomFromText('POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'),
ST_Buffer(ST_GeomFromText('POINT(110 170)'), 20)
)
) As slinewkt;
LINESTRING(140.752120669087 125.695053378061,121.111404660392 153.370607753949)
|
Name
ST_3DShortestLine — Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück
Synopsis
geometry ST_3DShortestLine(geometry g1, geometry g2);
Beschreibung
Gibt den kürzesten 3-dimensionalen Abstand zwischen zwei geometrischen Objekten als Linie zurück. Wenn es mehrere kürzeste Abstände gibt, dann wird nur der erste zurückgegeben, der von der Funktion gefunden wurde. Wenn sich g1 und g2 nur in einem Punkt schneiden, dann gibt die Funktion eine Linie zurück, die ihren Anfang und ihr Ende in dem Schnittpunkt hat. Wenn sich g1 und g2 in mehreren Punkten schneiden, dann gibt die Funktion eine Linie zurück, die Anfang und Ende in irgendeinem der Schnittpunkte hat. Die zurückgegebene Linie beginnt immer mit g1 und endet mit g2. Die Länge der 3D-Linie die von dieser Funktion zurückgegeben wird ist immer ident mit der von ST_3DDistance für g1 und g2 zurückgegebenen Distanz.
Verfügbarkeit: 2.0.0
Änderung: 2.2.0 - Wenn 2 geometrische Objekte in 2D übergegeben werden, wird ein 2D-Punkt zurückgegeben (anstelle wie früher 0 für ein fehlendes Z). Im Falle von 2D und 3D, wird für fehlende Z nicht länger 0 angenommen.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
Beispiele
Linienzug und Punkt -- kürzester Abstand in 3D und in 2D SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt,
ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt
FROM (SELECT 'POINT(100 100 30)'::geometry As pt,
'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 1000)'::geometry As line
) As foo;
shl3d_line_pt | shl2d_line_pt
----------------------------------------------------------------------------+------------------------------------------------------
LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) | LINESTRING(73.0769230769231 115.384615384615,100 100)
|
Linienstück und Mehrfachpunkt -- kürzester Abstand in 3D und in 2D SELECT ST_AsEWKT(ST_3DShortestLine(line,pt)) AS shl3d_line_pt,
ST_AsEWKT(ST_ShortestLine(line,pt)) As shl2d_line_pt
FROM (SELECT 'MULTIPOINT(100 100 30, 50 74 1000)'::geometry As pt,
'LINESTRING (20 80 20, 98 190 1, 110 180 3, 50 75 900)'::geometry As line
) As foo;
shl3d_line_pt | shl2d_line_pt
---------------------------------------------------------------------------+------------------------
LINESTRING(54.6993798867619 128.935022917228 11.5475869506606,100 100 30) | LINESTRING(50 75,50 74)
|
Mehrfachlinienzug und Polygon - kürzester Abstand in 3D und in 2D SELECT ST_AsEWKT(ST_3DShortestLine(poly, mline)) As shl3d,
ST_AsEWKT(ST_ShortestLine(poly, mline)) As shl2d
FROM (SELECT ST_GeomFromEWKT('POLYGON((175 150 5, 20 40 5, 35 45 5, 50 60 5, 100 100 5, 175 150 5))') As poly,
ST_GeomFromEWKT('MULTILINESTRING((175 155 2, 20 40 20, 50 60 -2, 125 100 1, 175 155 1),
(1 10 2, 5 20 1))') As mline ) As foo;
shl3d | shl2d
---------------------------------------------------------------------------------------------------+------------------------
LINESTRING(39.993580415989 54.1889925532825 5,40.4078575708294 53.6052383805529 5.03423778139177) | LINESTRING(20 40,20 40)
|
SFCGAL ist ein C++ Adapter für CGAL, welches fortgeschrittene Funktionen in 2D und in 3D zur Verfügung stellt. Aus Gründen der Robustheit liegen die geometrischen Koordinaten in einer fehlerfreien rationalen Zahlendarstellung vor.
Eine Anleitung zur Installation der Bibliothek finden Sie auf der SFCGAL Homepage http://www.sfcgal.org. Um die Funktionen zu laden, müssen Sie die Anweisung "CREATE EXTENSION postgis_sfscal;" ausführen.
- postgis_sfcgal_version — Gibt die verwendete Version von SFCGAL aus
- ST_Extrude — Weitet eine Oberfläche auf ein entsprechendes Volumen aus
- ST_StraightSkeleton — Berechnet aus einer Geometrie ein "Gerippe" aus Geraden.
- ST_ApproximateMedialAxis — Errechnet die genäherte Mediale Achse einer Flächengeometrie.
- ST_IsPlanar — Überprüft ob es sich um eine ebene Oberfläche handelt oder nicht
- ST_Orientation — Bestimmt die Ausrichtung der Fläche
- ST_ForceLHR — Erzwingt LHR Orientierung
- ST_MinkowskiSum — Berechnet die Minkowski-Summe
- ST_ConstrainedDelaunayTriangles — Return a constrained Delaunay triangulation around the given input geometry.
- ST_3DIntersection — Führt eine Verschneidung in 3D aus
- ST_3DDifference — Errechnet die Differenzmenge in 3D
- ST_3DUnion — Führt eine Vereinigung/Union in 3D aus
- ST_3DArea — Berechnet die Fläche von 3D-Oberflächengeometrien. Gibt 0 für Solids zurück.
- 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_Volume — Berechnet das Volumen eines 3D-Solids. Auf Oberflächengeometrien (auch auf geschlossene) angewandt wird 0 zurückgegeben.
- 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_IsSolid — Überprüft ob die Geometrie ein Solid ist. Es wird keine Plausibilitätsprüfung durchgeführt.
Name
postgis_sfcgal_version — Gibt die verwendete Version von SFCGAL aus
Synopsis
text postgis_sfcgal_version(void);
Name
ST_Extrude — Weitet eine Oberfläche auf ein entsprechendes Volumen aus
Synopsis
geometry ST_Extrude(geometry geom, float x, float y, float z);
Beschreibung
Verfügbarkeit: 2.1.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
Die 3D Bilder sind mit PostGIS ST_AsX3D erzeugt und das Rendern in HTML mit X3Dom HTML Javascript rendering library.
SELECT ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30);
 Ursprüngliches Achteck aus einem gepufferten Punkt gebildet |
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30);
 Ein Achteck, um 30 Einheiten entlang der Z-Achse ausgeweitet, ergibt ein PolyhedralSurfaceZ |
SELECT ST_GeomFromText('LINESTRING(50 50, 100 90, 95 150)')
 Ursprünglicher Linienzug |
SELECT ST_Extrude(
ST_GeomFromText('LINESTRING(50 50, 100 90, 95 150)'),0,0,10));
 Ein Linienzug, entlang der Z Achse ausgeweitet, ergibt ein PolyhedralSurfaceZ |
Name
ST_StraightSkeleton — Berechnet aus einer Geometrie ein "Gerippe" aus Geraden.
Synopsis
geometry ST_StraightSkeleton(geometry geom);
Name
ST_ApproximateMedialAxis — Errechnet die genäherte Mediale Achse einer Flächengeometrie.
Synopsis
geometry ST_ApproximateMedialAxis(geometry geom);
Beschreibung
Gibt die genäherte mediale Achse einer Flächeneingabe als eine Art Gerippe an Geraden zurück. Wenn mit einer geeigneten Version (1.2.0+) kompiliert wurde, wird die SFCGAL-eigene API ausgeführt. Sonst verhält sich die Funktion nur wie ein Adapter für ST_StraightSkeleton (langsamerer Fall).
Verfügbarkeit: 2.2.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Name
ST_IsPlanar — Überprüft ob es sich um eine ebene Oberfläche handelt oder nicht
Synopsis
boolean ST_IsPlanar(geometry geom);
Beschreibung
Verfügbarkeit: 2.2.0: Wurde zwar für 2.1.0 dokumentiert, aber unabsichtlich in der Version 2.1 weggelassen.
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Name
ST_Orientation — Bestimmt die Ausrichtung der Fläche
Synopsis
integer ST_Orientation(geometry geom);
Beschreibung
Die Funktion ist nur auf Polygone anwendbar. Sie gibt -1 zurück, wenn das Polygon gegen den Uhrzeigersinn ausgerichttet ist und 1, wenn das Polygon im Uhrzeigersinn ausgerichtet ist.
Verfügbarkeit: 2.1.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
Name
ST_MinkowskiSum — Berechnet die Minkowski-Summe
Synopsis
geometry ST_MinkowskiSum(geometry geom1, geometry geom2);
Beschreibung
Diese Funktion errechnet die Minkowski-Summe eines Punktes, einer Linie oder eines Polygons mit einem Polygon in 2D.
Die Minkowski-Summe zweier Geometrien A und B ist die Menge aller Punkte, die die Summe aller Punkte von A und B sind. Minkowski-Summen werden häufig zur Planung von Bewegungsabläufen und im CAD-Bereich eingesetzt. Weitere Einzelheiten finden Sie unter Wikipedia Minkowski addition.
Der erste Parameter kann irgendeine 2D-Geometrie (Punkt, Linienzug, Polygon) sein. Wenn eine 3D-Geometrie eingegeben wird, so wird diese in 2D umgewandelt, indem Z auf 0 gesetzt wird. Dies kann zu ungültigen Spezialfällen führen. Der zweite Parameter muss ein 2D-Polygon sein.
Die Umsetzung nützt CGAL 2D Minkowskisum.
Verfügbarkeit: 2.1.0
This method needs SFCGAL backend.
Beispiele
Die Minkowski-Summe eines LineString's, der ein Kreispolygon schneidet
|
 Vor dem Aufsummieren
|
 Nach dem Aufsummieren
|
SELECT ST_MinkowskiSum(line, circle))
FROM (SELECT
ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(100, 100)) As line,
ST_Buffer(ST_GeomFromText('POINT(50 50)'), 30) As circle) As foo;
-- wkt --
MULTIPOLYGON(((30 59.9999999999999,30.5764415879031 54.1472903395161,32.2836140246614 48.5194970290472,35.0559116309237 43.3328930094119,38.7867965644036 38.7867965644035,43.332893009412 35.0559116309236,48.5194970290474 32.2836140246614,54.1472903395162 30.5764415879031,60.0000000000001 30,65.8527096604839 30.5764415879031,71.4805029709527 32.2836140246614,76.6671069905881 35.0559116309237,81.2132034355964 38.7867965644036,171.213203435596 128.786796564404,174.944088369076 133.332893009412,177.716385975339 138.519497029047,179.423558412097 144.147290339516,180 150,179.423558412097 155.852709660484,177.716385975339 161.480502970953,174.944088369076 166.667106990588,171.213203435596 171.213203435596,166.667106990588 174.944088369076,
161.480502970953 177.716385975339,155.852709660484 179.423558412097,150 180,144.147290339516 179.423558412097,138.519497029047 177.716385975339,133.332893009412 174.944088369076,128.786796564403 171.213203435596,38.7867965644035 81.2132034355963,35.0559116309236 76.667106990588,32.2836140246614 71.4805029709526,30.5764415879031 65.8527096604838,30 59.9999999999999)))
Minkowski Summe von einem Polygon mit einem MultiPoint
|
 Vor dem Aufsummieren
|
 Nach der Aufsummierung: das Polygon ist dupliziert und in Punktlagen übersetzt
|
SELECT ST_MinkowskiSum(mp, poly)
FROM (SELECT 'MULTIPOINT(25 50,70 25)'::geometry As mp,
'POLYGON((130 150, 20 40, 50 60, 125 100, 130 150))'::geometry As poly
) As foo
-- wkt --
MULTIPOLYGON(
((70 115,100 135,175 175,225 225,70 115)),
((120 65,150 85,225 125,275 175,120 65))
)
Name
ST_ConstrainedDelaunayTriangles — Return a constrained Delaunay triangulation around the given input geometry.
Synopsis
geometry ST_Tesselate(geometry geom);
Beschreibung
Return a Constrained Delaunay triangulation around the vertices of the input geometry. Output is a TIN.
This method needs SFCGAL backend.
Verfügbarkeit: 2.1.0
This function supports 3d and will not drop the z-index.
Beispiele
 ST_ConstrainedDelaunayTriangles of 2 polygons
select ST_ConstrainedDelaunayTriangles(
ST_Union(
'POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'::geometry,
ST_Buffer('POINT(110 170)'::geometry, 20)
)
);
|  ST_DelaunayTriangles of 2 polygons. Triangle edges cross polygon boundaries.
select ST_DelaunayTriangles(
ST_Union(
'POLYGON((175 150, 20 40, 50 60, 125 100, 175 150))'::geometry,
ST_Buffer('POINT(110 170)'::geometry, 20)
)
);
|
Name
ST_3DIntersection — Führt eine Verschneidung in 3D aus
Synopsis
geometry ST_3DIntersection(geometry geom1, geometry geom2);
Beschreibung
Gibt die Schnittmenge von geom1 und geom2 als Geometrie zurück.
Verfügbarkeit: 2.1.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
Die 3D Bilder sind mit PostGIS ST_AsX3D erzeugt und das Rendern in HTML mit X3Dom HTML Javascript rendering library.
SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30) AS geom1,
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
50, 'quad_segs=1'),0,0,30) AS geom2;
 Ursprüngliche 3D-Geometrien überlagert. geom2 wird halbtransparent angezeigt |
SELECT ST_3DIntersection(geom1,geom2)
FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30) AS geom1,
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;
 Schnittmenge von geom1 und geom2 |
Linienzüge und Polygone in 3D
SELECT ST_AsText(ST_3DIntersection(linestring, polygon)) As wkt
FROM ST_GeomFromText('LINESTRING Z (2 2 6,1.5 1.5 7,1 1 8,0.5 0.5 8,0 0 10)') AS linestring
CROSS JOIN ST_GeomFromText('POLYGON((0 0 8, 0 1 8, 1 1 8, 1 0 8, 0 0 8))') AS polygon;
wkt
--------------------------------
LINESTRING Z (1 1 8,0.5 0.5 8)
Würfel (geschlossene polyedrische Oberfläche) und Polygon Z
SELECT ST_AsText(ST_3DIntersection(
ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'),
'POLYGON Z ((0 0 0, 0 0 0.5, 0 0.5 0.5, 0 0.5 0, 0 0 0))'::geometry))TIN Z (((0 0 0,0 0 0.5,0 0.5 0.5,0 0 0)),((0 0.5 0,0 0 0,0 0.5 0.5,0 0.5 0)))
Die Verschneidung von 2 Solids, die sich volumetrisch überschneiden, ist ebenfalls ein Solid (ST_Dimension liefert 3)
SELECT ST_AsText(ST_3DIntersection( ST_Extrude(ST_Buffer('POINT(10 20)'::geometry,10,1),0,0,30),
ST_Extrude(ST_Buffer('POINT(10 20)'::geometry,10,1),2,0,10) ));POLYHEDRALSURFACE Z (((13.3333333333333 13.3333333333333 10,20 20 0,20 20 10,13.3333333333333 13.3333333333333 10)),
((20 20 10,16.6666666666667 23.3333333333333 10,13.3333333333333 13.3333333333333 10,20 20 10)),
((20 20 0,16.6666666666667 23.3333333333333 10,20 20 10,20 20 0)),
((13.3333333333333 13.3333333333333 10,10 10 0,20 20 0,13.3333333333333 13.3333333333333 10)),
((16.6666666666667 23.3333333333333 10,12 28 10,13.3333333333333 13.3333333333333 10,16.6666666666667 23.3333333333333 10)),
((20 20 0,9.99999999999995 30 0,16.6666666666667 23.3333333333333 10,20 20 0)),
((10 10 0,9.99999999999995 30 0,20 20 0,10 10 0)),((13.3333333333333 13.3333333333333 10,12 12 10,10 10 0,13.3333333333333 13.3333333333333 10)),
((12 28 10,12 12 10,13.3333333333333 13.3333333333333 10,12 28 10)),
((16.6666666666667 23.3333333333333 10,9.99999999999995 30 0,12 28 10,16.6666666666667 23.3333333333333 10)),
((10 10 0,0 20 0,9.99999999999995 30 0,10 10 0)),
((12 12 10,11 11 10,10 10 0,12 12 10)),((12 28 10,11 11 10,12 12 10,12 28 10)),
((9.99999999999995 30 0,11 29 10,12 28 10,9.99999999999995 30 0)),((0 20 0,2 20 10,9.99999999999995 30 0,0 20 0)),
((10 10 0,2 20 10,0 20 0,10 10 0)),((11 11 10,2 20 10,10 10 0,11 11 10)),((12 28 10,11 29 10,11 11 10,12 28 10)),
((9.99999999999995 30 0,2 20 10,11 29 10,9.99999999999995 30 0)),((11 11 10,11 29 10,2 20 10,11 11 10)))Name
ST_3DDifference — Errechnet die Differenzmenge in 3D
Synopsis
geometry ST_3DDifference(geometry geom1, geometry geom2);
Beschreibung
Gibt jenen Teil von geom1 zurück, der nicht Teil von geom2 ist.
Verfügbarkeit: 2.2.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
Die 3D Bilder sind mit PostGIS ST_AsX3D erzeugt und das Rendern in HTML mit X3Dom HTML Javascript rendering library.
SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30) AS geom1,
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
50, 'quad_segs=1'),0,0,30) AS geom2;
Ursprüngliche 3D-Geometrien überlagert. geom2 ist jener Teil der nicht entfernt wird. |
SELECT ST_3DDifference(geom1,geom2)
FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30) AS geom1,
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;
 Was bleibt zurück nachdem geom2 entfernt wurde |
Name
ST_3DUnion — Führt eine Vereinigung/Union in 3D aus
Synopsis
geometry ST_3DUnion(geometry geom1, geometry geom2);
Beschreibung
Verfügbarkeit: 2.2.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
Die 3D Bilder sind mit PostGIS ST_AsX3D erzeugt und das Rendern in HTML mit X3Dom HTML Javascript rendering library.
SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30) AS geom1,
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
50, 'quad_segs=1'),0,0,30) AS geom2;
Überlagerung der ursprünglichen Geometrien in 3D. geom2 ist transparent dargestellt. |
SELECT ST_3DUnion(geom1,geom2)
FROM ( SELECT ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2'),0,0,30) AS geom1,
ST_Extrude(ST_Buffer(ST_GeomFromText('POINT(80 80)'),
50, 'quad_segs=1'),0,0,30) AS geom2 ) As t;
 Vereinigung von geom1 und geom2 |
Name
ST_3DArea — Berechnet die Fläche von 3D-Oberflächengeometrien. Gibt 0 für Solids zurück.
Synopsis
floatST_3DArea(geometry geom1);
Beschreibung
Verfügbarkeit: 2.1.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
Anmerkung: Standardmäßig ist ein aus WKT erzeugtes PolyhedralSurface eine Oberflächengeometrie und kein Solid. Es hat daher eine Flächenausdehnung. In ein Solid umgewandelt, keine Fläche.
SELECT ST_3DArea(geom) As cube_surface_area,
ST_3DArea(ST_MakeSolid(geom)) As solid_surface_area
FROM (SELECT 'POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'::geometry) As f(geom);
cube_surface_area | solid_surface_area
-------------------+--------------------
6 | 0 Name
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
Synopsis
geometry ST_Tesselate(geometry geom);
Beschreibung
Nimmt als Eingabe eine Fläche, wie ein Multi(Polygon) oder eine polyedrische Oberfläche, und gibt, mittels Mosaikierung in Dreiecke, eine TIN-Darstellung der Geometrie zurück.
Verfügbarkeit: 2.1.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiele
SELECT ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )');
 Ursprünglicher Würfel |
SELECT ST_Tesselate(ST_GeomFromText('POLYHEDRALSURFACE Z( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)), ((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)), ((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'));
ST_AsText Ausgabe: TIN Z (((0 0 0,0 0 1,0 1 1,0 0 0)),((0 1 0,0 0 0,0 1 1,0 1 0)),
((0 0 0,0 1 0,1 1 0,0 0 0)),
((1 0 0,0 0 0,1 1 0,1 0 0)),((0 0 1,1 0 0,1 0 1,0 0 1)),
((0 0 1,0 0 0,1 0 0,0 0 1)),
((1 1 0,1 1 1,1 0 1,1 1 0)),((1 0 0,1 1 0,1 0 1,1 0 0)),
((0 1 0,0 1 1,1 1 1,0 1 0)),((1 1 0,0 1 0,1 1 1,1 1 0)),
((0 1 1,1 0 1,1 1 1,0 1 1)),((0 1 1,0 0 1,1 0 1,0 1 1)))
 Mosaikierter Würfel mit eingefärbten Dreiecken |
SELECT 'POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, 10 190 ))'::geometry;
 Ursprüngliches Polygon |
SELECT
ST_Tesselate('POLYGON (( 10 190, 10 70, 80 70, 80 130, 50 160, 120 160, 120 190, 10 190 ))'::geometry);
ST_AsText Ausgabe TIN(((80 130,50 160,80 70,80 130)),((50 160,10 190,10 70,50 160)),
((80 70,50 160,10 70,80 70)),((120 160,120 190,50 160,120 160)),
((120 190,10 190,50 160,120 190)))
 Mosaikiertes Polygon |
Name
ST_Volume — Berechnet das Volumen eines 3D-Solids. Auf Oberflächengeometrien (auch auf geschlossene) angewandt wird 0 zurückgegeben.
Synopsis
float ST_Volume(geometry geom1);
Beschreibung
Verfügbarkeit: 2.2.0
This method needs SFCGAL backend.
This function supports 3d and will not drop the z-index.
This function supports Polyhedral surfaces.
This function supports Triangles and Triangulated Irregular Network Surfaces (TIN).
Beispiel
Wenn geschlossene Oberflächen über WKT erzeugt werden, so werden diese wie eine Flächen und nicht wie ein Solid behandelt. Um sie in ein Solid umzuwandeln, müssen Sie ST_MakeSolid verwenden. Flächeneometrien besitzen kein Volumen. Das folgende Beispiel demonstriert dies.
SELECT ST_Volume(geom) As cube_surface_vol,
ST_Volume(ST_MakeSolid(geom)) As solid_surface_vol
FROM (SELECT 'POLYHEDRALSURFACE( ((0 0 0, 0 0 1, 0 1 1, 0 1 0, 0 0 0)),
((0 0 0, 0 1 0, 1 1 0, 1 0 0, 0 0 0)),
((0 0 0, 1 0 0, 1 0 1, 0 0 1, 0 0 0)),
((1 1 0, 1 1 1, 1 0 1, 1 0 0, 1 1 0)),
((0 1 0, 0 1 1, 1 1 1, 1 1 0, 0 1 0)),
((0 0 1, 1 0 1, 1 1 1, 0 1 1, 0 0 1)) )'::geometry) As f(geom);
cube_surface_vol | solid_surface_vol
------------------+-------------------
0 | 1
Name
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.
Synopsis
geometryST_MakeSolid(geometry geom1);
- ST_Buffer — (T) Gibt eine Geometrie zurück, welche alle Punkte innerhalb einer gegebenen Entfernung von der Eingabegeometrie beinhaltet.
- ST_BuildArea — Erzeugt eine Flächengeometrie aus den einzelnen Linien einer gegebenen Geometrie
- ST_Centroid — Gibt eine Sammelgeometrie zurück, die beim Auftrennen einer Geometrie entsteht.
- ST_ClipByBox2D — Gibt jenen Teil der Geometrie zurück, der innerhalb eines Rechteckes liegt.
- ST_ConcaveHull — Die konkave Hülle einer Geometrie stellt eine möglicherweise konkave Geometrie dar, welche alle Geometrien der Menge einschließt. Sie können es sich wie in Folie einpacken vorstellen.
- ST_ConvexHull — Computes the convex hull of a geometry.
- ST_CurveToLine — Wandelt einen CIRCULARSTRING/CURVEPOLYGON in ein LINESTRING/POLYGON 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_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_GeneratePoints — Wandelt ein Polygon oder ein MultiPolygon in einen MultiPoint um, welcher aus wahllos angeordeten, innerhalb der ursprünglichen Flächen liegenden Punkten besteht.
- ST_GeometricMedian — Returns the geometric median of a MultiPoint.
- ST_Intersection — (T) Gibt eine Geometrie zurück, welche den gemeinsamen Anteil von geomA und geomB repräsentiert.
- ST_LineToCurve — Wandelt einen LINESTRING/POLYGON in einen CIRCULARSTRING, CURVEPOLYGON um
- ST_MakeValid — Versucht eine ungültige Geometrie, ohne den Verlust an Knoten zu bereinigen.
- ST_MemUnion — Das gleiche wie ST_Union, nur freundlicher zum Arbeitsspeicher (verwendet weniger Arbeitsspeicher und mehr Rechnerzeit).
- ST_MinimumBoundingCircle — Gibt das kleinstmögliche Kreispolygon zurück, welches eine Geometrie zur Gänze beinhaltet. Standardmäßig werden 48 Segmente pro Viertelkreiss verwendet.
- ST_MinimumBoundingRadius — Gibt den Mittelpunkt und den Radius des kleinstmöglichen Kreises zurück, der die gesamte Geometrie beinhaltet.
- ST_OrientedEnvelope — Gibt eine Sammelgeometrie zurück, die beim Auftrennen einer Geometrie entsteht.
- 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_Node — Knotenberechnung für eine Menge von Linienzügen.
- ST_OffsetCurve — Gibt eine Linie zurück, die um eine gegebenen Entfernung und Seite von der Eingabelinie versetzt ist. Nützlich zur Berechnung von Linien, die zu einer Mittellinie parallel verlaufen
- ST_PointOnSurface — Returns a
POINTguaranteed to lie on the surface. - ST_RemoveRepeatedPoints — Gibt eine Version der Eingabegeometrie zurück, wobei duplizierte Punkte entfernt werden.
- ST_SharedPaths — Gibt eine Sammelgeometrie zurück, welche die gemeinsamen Strecken der beiden eingegebenen LineStrings/MultiLinestrings enthält.
- ST_ShiftLongitude — Schaltet geometrische Koordinaten zwischen den Bereichen -180..180 und 0..360 um.
- ST_WrapX — Versammelt eine Geometrie um einen X-Wert
- ST_Simplify — Gibt eine vereinfachte Version der Ausgangsgeometrie zurück. Verwendet den Douglas-Peucker Algorithmus.
- ST_SimplifyPreserveTopology — Gibt eine vereinfachte Version der Ausgangsgeometrie zurück. Verwendet den Douglas-Peucker Algorithmus. Vermeidet es abgeleitete Geometrien zu erzeugen (insbesondere Polygone), die invalide sind.
- ST_SimplifyVW — Gibt eine vereinfachte Version der Ausgangsgeometrie zurück. Verwendet den Visvalingam-Whyatt Algorithmus.
- ST_ChaikinSmoothing — Gibt eine vereinfachte Version der Ausgangsgeometrie zurück. Verwendet den Visvalingam-Whyatt Algorithmus.
- ST_FilterByM — Filters vertex points based on their m-value
- ST_SetEffectiveArea — Setzt die Nutzfläche für jeden Knoten und speichert den Wert in der M-Ordinate. Eine vereinfachte Geometrie kann dann über einen Filter auf die M-Ordinate erzeugt werden.
- ST_Split — Gibt eine Sammelgeometrie zurück, die beim Auftrennen einer Geometrie entsteht.
- 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_Subdivide — Gibt eine Geometriemenge zurück, wobei keine Geometrie der Menge mehr als die festgelegte Anzahl an Knoten aufweist.
- ST_Union — Gibt eine Geometrie zurück, welche der mengentheoretischen Vereinigung der Geometrien entspricht.
- ST_UnaryUnion — Wie ST_Union, arbeitet aber auf der Ebene der Geometriebestandteile.
- ST_VoronoiLines — Gibt die Grenzen zwischen den Zellen des Voronoi Diagramms aus, das aus den Knoten der Geometrie konstruiert wurde.
- ST_VoronoiPolygons — Gibt die Zellen des Voronoi Diagramms zurück, die aus den Knoten der Geometrie erzeugt wurden.
Name
ST_Buffer — (T) Gibt eine Geometrie zurück, welche alle Punkte innerhalb einer gegebenen Entfernung von der Eingabegeometrie beinhaltet.
Synopsis
geometry ST_Buffer(geometry g1, float radius_of_buffer);
geometry ST_Buffer(geometry g1, float radius_of_buffer, integer num_seg_quarter_circle);
geometry ST_Buffer(geometry g1, float radius_of_buffer, text buffer_style_parameters);
geography ST_Buffer(geography g1, float radius_of_buffer_in_meters);
geography ST_Buffer(geography g1, float radius_of_buffer, integer num_seg_quarter_circle);
geography ST_Buffer(geography g1, float radius_of_buffer, text buffer_style_parameters);
Beschreibung
Gibt eine Geometrie/Geographie zurück, die alle Punkte repräsentiert, deren Entfernung von dieser Geometrie/Geographie kleiner oder gleich der gegebenen Entfernung ist.
Geometrie: Berechnungen werden im Koordinatenreferenzsystem der Geometrie durchgeführt. Mit 1.5 wurde die Unterstützung unterschiedlicher Abschlussstücke/end-cap und Gehrungen/mitre eingeführt, um die Gestalt zu kontrollieren.
| |
Negative Radien: Bei Polygonen kann ein negativer Radius vergewendet werden, wodurch das Polygon geschrumpft anstatt vergrößert wird. |
| |
Geographie: Beim geographischen Datentyp handelt es sich lediglich um einen schlanken Adapter, der um die geometrische Implementation herumgelegt wurde. Zuerst wird die passenste SRID für das Umgebungsrechteck des geographischen Objektes bestimmt (bevorzugt UTM, Lambert Azimuthal Equal Area (LAEA) Nord/Süd Pol, im schlimmsten Fall wird auf Mercator zurückgegriffen), dann im planaren Koordinatenreferenzsystem gepuffert und anschließend nach WGS84 Geographie zurück transformiert. |
| |
Beim geographischen Datentyp kann sich dies anders verhalten als erwartet, nämlich dann, wenn das Objekt entrsprechend groß ist und zwischen zwei UTM-Zonen fällt oder eine Datumsgrenze überschreitet. |
Enhanced: 2.5.0 - ST_Buffer geometry support was enhanced to allow for side buffering specification side=both|left|right.
Verfügbarkeit: 1.5 - ST_Buffer wurde um die Unterstützung von Abschlusstücken/endcaps und Join-Typen erweitert. Diese können zum Beispiel dazu verwendet werden, um Linienzüge von Straßen in Straßenpolygone mit flachen oder rechtwinkeligen Abschlüssen anstatt mit runden Enden umzuwandeln. Ein schlanker Adapter für den geographischen Datentyp wurde hinzugefügt. - benötigt GEOS >= 3.2 um diese erweiterte geometrische Funktionalität auszunutzen.
Der optionale dritte Parameter (zurzeit nur auf den geometrischen Datentyp anwendbar) ermöglicht es die Anzahl der Segmente zur Näherung eines Viertelkreises (Ganzzahl, standardmäßig 8) oder eine Liste von leerzeichengetrennten key=value Paaren (string case) festzulegen, um die Berechnungen wie folgt zu optimieren:
'quad_segs=#' : Anzahl der Segmente die verwendet werden um einen Viertelkreis anzunähern (standardmäßig 8).
'endcap=round|flat|square' : endcap style (standardmäßig "round", benötigt GEOS-3.2 oder höher für andere Werte). 'butt' kann auch als Synonym für 'flat' verwendet werden.
'join=round|mitre|bevel' : join style (defaults to "round"). 'miter' kann auch als Synonym für 'mitre' verwendet werden.
'mitre_limit=#.#' : Gehrungsobergrenze (beeinflusst nur Gehrungsverbindungen). 'miter_limit' kann auch als Synonym von 'mitre_limit' verwendet werden.
'side=both|left|right' : 'left' or 'right' performs a single-sided buffer on the geometry, with the buffered side relative to the direction of the line. This is only really relevant to LINESTRING geometry and does not affect POINT or POLYGON geometries. By default end caps are square.
Die Einheiten des Radius werden in den Einheiten des Koordinatenreferenzsystems gemessen.
Es können POINTS, MULTIPOINTS, LINESTRINGS, MULTILINESTRINGS, POLYGONS, MULTIPOLYGONS, und Sammelgeometrien/GeometryCollections eingegeben werden.
| |
Diese Funktion ignoriert die dritte Dimension (z) und gibt immer einen 2-D Buffer zurück, sogar dann wenn eine 3D-Geometrie überreicht wird. |
Wird vom GEOS Modul ausgeführt
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1. s2.1.1.3
This method implements the SQL/MM specification. SQL-MM 3: 5.1.17
| |
Fälschlicherweise wird diese Funktion oft zur Umkreissuche verwendet. Die Erzeugung eines Puffers zur Umkreissuche ist langsam und witzlos. Benutzen Sie bitte stattdessen ???. |
Beispiele
 quad_segs=8 (Standardwert)
SELECT ST_Buffer(
ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=8');
|  quad_segs=2 (lahme Ente)
SELECT ST_Buffer(
ST_GeomFromText('POINT(100 90)'),
50, 'quad_segs=2');
| |
 endcap=round join=round (Standardwert)
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'endcap=round join=round');
|  endcap=square
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'endcap=square join=round');
|  endcap=flat
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'endcap=flat join=round');
|
 join=bevel
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=bevel');
|  join=mitre mitre_limit=5.0 (default mitre limit)
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=mitre mitre_limit=5.0');
|  join=mitre mitre_limit=1
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=mitre mitre_limit=1.0');
|
 side=left
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=bevel');
|  side=right
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=bevel');
|  side=left join=mitre
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=bevel');
|
 right-hand-winding, polygon boundary side=left
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=bevel');
|  right-hand-winding, polygon boundary side=right
SELECT ST_Buffer(
ST_GeomFromText(
'LINESTRING(50 50,150 150,150 50)'
), 10, 'join=bevel');
|
-- Ein gepufferter Punkt nähert sich einem Kreis an (sh. Abbildung)
-- Ein gepufferter Punkt der die Annäherung mit 2 Punkten pro Viertelkreis erzwingt
-- ist ein Polygon mit 8 Seiten (sh. Abbildung)
SELECT ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50)) As promisingcircle_pcount,
ST_NPoints(ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50, 2)) As lamecircle_pcount;
promisingcircle_pcount | lamecircle_pcount
------------------------+-------------------
33 | 9
-- Ein leichterer aber lahmer Kreis mit 2 Punkten pro Viertelkreis ist ein Achteck
-- Unterhalb ein 100 Meter Achteck
-- Die Koordinaten sind in NAD 83 Länge/Breite und werden nach
-- Mass state plane Meter transformiert um Messungen in Meter zu bekommen
-- und anschließend gepuffert
SELECT ST_AsText(ST_Buffer(
ST_Transform(
ST_SetSRID(ST_MakePoint(-71.063526, 42.35785),4269), 26986)
,100,2)) As octagon;
----------------------
POLYGON((236057.59057465 900908.759918696,236028.301252769 900838.049240578,235
957.59057465 900808.759918696,235886.879896532 900838.049240578,235857.59057465
900908.759918696,235886.879896532 900979.470596815,235957.59057465 901008.759918
696,236028.301252769 900979.470596815,236057.59057465 900908.759918696))
Name
ST_BuildArea — Erzeugt eine Flächengeometrie aus den einzelnen Linien einer gegebenen Geometrie
Synopsis
geometry ST_BuildArea(geometry A);
Beschreibung
Erzeugt eine Flächengeometrie aus den einzelnen Linien einer gegebenen Geometrie. Der zurückgegebene Datentyp ist, abhängig von der Eingabe, ein Polygon oder ein MultiPolygon. Wenn das Eingabe-Liniennetz keine Polygone bildet, wird NULL zurückgegeben. Die Eingabe können LineStrings, MultiLinestrings, Polygons, MultiPolygons und GeometryCollections sein.
Diese Funktion nimmt an, dass alle inneren Geometrien Lücken/Inseln darstellen.
| |
Damit diese Funktion korrekt arbeitet, müssen die Knoten des eingegebenen Liniennetzes richtig angeordnet sein |
Verfügbarkeit: 1.5.0
Beispiele
 Erzeugt einen Donut
SELECT ST_BuildArea(ST_Collect(smallc,bigc))
FROM (SELECT
ST_Buffer(
ST_GeomFromText('POINT(100 90)'), 25) As smallc,
ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As bigc) As foo;
|
 Dies erzeugt eine auseinanderklaffende Lücke innerhalb des Kreises mit herausstehenden Zacken
SELECT ST_BuildArea(ST_Collect(line,circle))
FROM (SELECT
ST_Buffer(
ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190)),
5) As line,
ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;
--dies erzeugt dieselbe auseinanderklaffende Lücke
--allerdings aus Linienzügen anstelle von Polygonen
SELECT ST_BuildArea(
ST_Collect(ST_ExteriorRing(line),ST_ExteriorRing(circle))
)
FROM (SELECT ST_Buffer(
ST_MakeLine(ST_MakePoint(10, 10),ST_MakePoint(190, 190))
,5) As line,
ST_Buffer(ST_GeomFromText('POINT(100 90)'), 50) As circle) As foo;
|
Siehe auch
ST_Node, ST_MakePolygon, ???, ??? Adapter für diese Funktion mit der OGC-Standardschnittstelle
Name
ST_Centroid — Gibt eine Sammelgeometrie zurück, die beim Auftrennen einer Geometrie entsteht.
Synopsis
geometry ST_Intersection( geometry geomA , geometry geomB );
geography ST_Intersection( geography geogA , geography geogB );
Beschreibung
Computes the geometric center of a geometry, or equivalently, the center of mass of the geometry as a POINT. For [MULTI]POINTs, this is computed as the arithmetic mean of the input coordinates. For [MULTI]LINESTRINGs, this is computed as the weighted length of each line segment. For [MULTI]POLYGONs, "weight" is thought in terms of area. If an empty geometry is supplied, an empty GEOMETRYCOLLECTION is returned. If NULL is supplied, NULL is returned. If CIRCULARSTRING or COMPOUNDCURVE are supplied, they are converted to linestring wtih CurveToLine first, then same than for LINESTRING
New in 2.3.0 : support CIRCULARSTRING and COMPOUNDCURVE (using CurveToLine)
Verfügbarkeit: 1.5 die Unterstützung des geograpischen Datentyps wurde eingeführt
The centroid is equal to the centroid of the set of component Geometries of highest dimension (since the lower-dimension geometries contribute zero "weight" to the centroid).
This method implements the OpenGIS Simple Features
Implementation Specification for SQL 1.1.
This method implements the SQL/MM specification. SQL-MM 3: 7.1.7
Beispiele
In each of the following illustrations, the green dot represents the centroid of the source geometry.
 Centroid of a |  Centroid of a |
 Centroid of a |  Bitte nicht mit einer |
SELECT ST_AsText(ST_Centroid('MULTIPOINT ( -1 0, -1 2, -1 3, -1 4, -1 7, 0 1, 0 3, 1 1, 2 0, 6 0, 7 8, 9 8, 10 6 )'));
st_astext
------------------------------------------
POINT(2.30769230769231 3.30769230769231)
(1 row)
SELECT ST_AsText(ST_centroid(g))
FROM ST_GeomFromText('CIRCULARSTRING(0 2, -1 1,0 0, 0.5 0, 1 0, 2 1, 1 2, 0.5 2, 0 2)') AS g ;
------------------------------------------
POINT(0.5 1)
SELECT ST_AsText(ST_centroid(g))
FROM ST_GeomFromText('COMPOUNDCURVE(CIRCULARSTRING(0 2, -1 1,0 0),(0 0, 0.5 0, 1 0),CIRCULARSTRING( 1 0, 2 1, 1 2),(1 2, 0.5 2, 0 2))' ) AS g;
------------------------------------------
POINT(0.5 1)
Name
ST_ClipByBox2D — Gibt jenen Teil der Geometrie zurück, der innerhalb eines Rechteckes liegt.
Synopsis
geometry ST_ClipByBox2D(geometry geom, box2d box);
Beschreibung
Schneidet eine Geometrie mittels einer 2D-Box aus; eine schnelle aber möglicherweise unsaubere Methode. Es ist nicht garantiert, dass die Ausgabegeometrie valide ist (bei Polygonen kann es zu Selbstüberschneidungen kommen). Topologisch invalide Eingabegeometrien führen zu keiner Fehlermeldung.
Wird vom GEOS Modul ausgeführt
Verfügbarkeit: