Aus Well-Known Text- und Well-Known Binary-Daten generierte ST_Geometry
Konvertieren von Geometrie in den Typ "ST_Geometry" in Oracle
Nachfolgend finden Sie eine Beschreibung räumlicher Datenformate und der Konvertierung zwischen ihnen und dem räumlichen Datentyp für Oracle.
OGC Well-Known Text-Format
Das Well-Known Text (WKT)-Format ist eine formatierte ASCII-Textzeichenfolge, die ermöglicht, dass Geometrie in ASCII-Textform ausgetauscht wird. Sie können diese Funktionen in einem Sprachprogramm der dritten oder vierten Generation (3GL oder 4GL) verwenden, da sie keine Definition besonderer Programmstrukturen benötigen.
Der räumliche Datentyp verfügt über mehrere Funktionen, die Geometrien aus Textbeschreibungen generieren. Dazu gehören folgende Funktionen:
- ST_GeomFromText – Erstellt eine ST_Geometry aus einem WKT-Format eines beliebigen Geometrietyps
- ST_PointFromText – Erstellt einen ST_Point aus einem Punkt-WKT-Format
- ST_LineFromText – Erstellt einen ST_LineString aus einem Linestring-WKT-Format
- ST_PolyFromText – Erstellt ein ST_Polygon aus einem Polygon-WKT-Format
- ST_MPointFromText – Erstellt einen ST_MultiPoint aus einem Multipoint-WKT-Format
- ST_MLineFromText – Erstellt einen ST_MultiLineString aus einem Multilinestring-WKT-Format
- ST_MPolyFromText – Erstellt ein ST_MultiPolygon aus einem Multipolygon-WKT-Format
Die Funktion "ST_AsText" konvertiert eine vorhandene Geometrie in ein WKT-Format.
Verwenden des Well-Known Text-Formats in einem C-Programm
Das WKT-Format der Geometrie kann in C-Programme integriert werden. Die Struktur solch einer Implementierung ist unten definiert. Die Notation {}* gibt 0 (null) oder mehr Wiederholungen der Token innerhalb der geschweiften Klammern an. Die geschweiften Klammern werden nicht in der Ausgabe-Token-Liste angezeigt.
<Geometry Tagged Text> :=
| <Point Tagged Text>
| <LineString Tagged Text>
| <Polygon Tagged Text>
| <MultiPoint Tagged Text>
| <MultiLineString Tagged Text>
| <MultiPolygon Tagged Text>
<Point Tagged Text> :=
POINT <Point Text>
<LineString Tagged Text> :=
LINESTRING <LineString Text>
<Polygon Tagged Text> :=
POLYGON <Polygon Text>
<MultiPoint Tagged Text> :=
MULTIPOINT <Multipoint Text>
<MultiLineString Tagged Text> :=
MULTILINESTRING <MultiLineString Text>
<MultiPolygon Tagged Text> :=
MULTIPOLYGON <MultiPolygon Text>
<Point Text> := EMPTY
| <Point>
| Z <PointZ>
| M <PointM>
| ZM <PointZM>
<Point> := <x> <y>
<x> := double precision literal
<y> := double precision literal
<PointZ> := <x> <y> <z>
<x> := double precision literal
<y> := double precision literal
<z> := double precision literal
<PointM> := <x> <y> <m>
<x> := double precision literal
<y> := double precision literal
<m> := double precision literal
<PointZM> := <x> <y> <z> <m>
<x> := double precision literal
<y> := double precision literal
<z> := double precision literal
<m> := double precision literal
<LineString Text> := EMPTY
| ( <Point Text > {, <Point Text> }* )
| Z ( <PointZ Text > {, <PointZ Text> }* )
| M ( <PointM Text > {, <PointM Text> }* )
| ZM ( <PointZM Text > {, <PointZM Text> }* )
<Polygon Text> := EMPTY
| ( <LineString Text > {,< LineString Text > }*)
<Multipoint Text> := EMPTY
| ( <Point Text > {, <Point Text > }* )
<MultiLineString Text> := EMPTY
| ( <LineString Text > {,< LineString Text>}* )
<MultiPolygon Text> := EMPTY
| ( < Polygon Text > {, < Polygon Text > }* )
Verwenden des Well-Known Text-Formats in einem SQL-Editor
Da das Well-Known Text-Format Text ist, kann es bequem in ein SQL-Skript oder direkt in einen SQL-Editor eingegeben werden. Der Text wird von einer Funktion in und aus einer Geometrie konvertiert. Funktionen, die Text in Geometrie konvertieren, verfügen über die folgende Syntax:
function ('<text description>',<SRID>)
Beispiele:
ST_PointFromText('point zm(10.01 20.04 3.2 9.5)', 1)
Die Raumbezugskennung (SRID) – der Primärschlüssel zur Tabelle ST_SPATIAL_REFERENCES – identifiziert die möglichen Raumbezugssysteme innerhalb einer Oracle-Instanz. Einer räumlichen Spalte wird beim Erstellen eine SRID zugewiesen. Bevor eine Geometrie in eine räumliche Spalte eingefügt werden kann, muss ihre SRID mit der SRID der räumlichen Spalte übereinstimmen.
Die Textbeschreibung besteht aus drei grundlegenden, in einfache Anführungszeichen eingeschlossenen Komponenten:
'<geometry type> [coordinate type] [coordinate list]'
Der Geometrietyp wird als einer der Folgenden definiert: Point, Linestring, Polygon, Multipoint, Multilinestring oder Multipolygon.
Der Koordinatentyp gibt an, ob die Geometrie Z-Koordinaten und/oder Messwerte hat. Lassen Sie dieses Argument leer, wenn die Geometrie keines von beiden hat; setzen Sie den Koordinatentyp andernfalls auf Z für Geometrien, die Z-Koordinaten enthalten, M für Geometrien mit Messwerten und ZM für Geometrien, die beides haben.
Die Koordinatenliste definiert die Stützpunkte der Geometrie mit doppelter Genauigkeit. Koordinatenlisten sind durch Kommas getrennt und in Klammern eingeschlossen. Geometrien mit mehreren Komponenten erfordern Klammerpaare, die jede Komponente einschließen. Wenn die Geometrie leer ist, ersetzt das Schlüsselwort EMPTY die Koordinaten.
In den folgenden Beispielen wird eine vollständige Liste aller möglichen Kombinationen des Textbeschreibungsteils des Textformats bereitgestellt:
|
Geometrietyp |
Textbeschreibung |
Anmerkung |
|---|---|---|
|
ST_Point |
'point empty' |
Leerer Punkt |
|
ST_Point |
'point z empty' |
Leerer Punkt mit Z-Koordinate |
|
ST_Point |
'point m empty' |
Leerer Punkt mit Messwert |
|
ST_Point |
'point zm empty' |
Leerer Punkt mit Z-Koordinate und Messwert |
|
ST_Point |
'point ( 10.05 10.28 )' |
Punkt |
|
ST_Point |
'point z( 10.05 10.28 2.51 )' |
Punkt mit Z-Koordinate |
|
ST_Point |
'point m( 10.05 10.28 4.72 )' |
Punkt mit Messwert |
|
ST_Point |
'point zm(10.05 10.28 2.51 4.72 )' |
Punkt mit Z-Koordinate und Messwert |
|
ST_LineString |
'linestring empty' |
Leerer Linestring |
|
ST_LineString |
'linestring z empty' |
Leerer Linestring mit Z-Koordinaten |
|
ST_LineString |
'linestring m empty' |
Leerer Linestring mit Messwerten |
|
ST_LineString |
'linestring zm empty' |
Leerer Linestring mit Z-Koordinaten und Messwerten |
|
ST_LineString |
'linestring (10.05 10.28 , 20.95 20.89 )' |
Linestring |
|
ST_LineString |
'linestring z(10.05 10.28 3.09, 20.95 31.98 4.72, 21.98 29.80 3.51 )' |
Linestring mit Z-Koordinaten |
|
ST_LineString |
'linestring m(10.05 10.28 5.84, 20.95 31.98 9.01, 21.98 29.80 12.84 )' |
Linestring mit Messwerten |
|
ST_LineString |
'linestring zm(10.05 10.28 3.09 5.84, 20.95 31.98 4.72 9.01, 21.98 29.80 3.51 12.84)' |
Linestring mit Z-Koordinaten und Messwerten |
|
ST_Polygon |
'polygon empty' |
Leeres Polygon |
|
ST_Polygon |
'polygon z empty' |
Leeres Polygon mit Z-Koordinaten |
|
ST_Polygon |
'polygon m empty' |
Leeres Polygon mit Messwerten |
|
ST_Polygon |
'polygon zm empty' |
Leeres Polygon mit Z-Koordinaten und Messwerten |
|
ST_Polygon |
'polygon ((10 10, 10 20, 20 20, 20 15, 10 10))' |
Polygon |
|
ST_Polygon |
'polygon z((10 10 3, 10 20 3, 20 20 3, 20 15 4, 10 10 3))' |
Polygon mit Z-Koordinaten |
|
ST_Polygon |
'polygon m((10 10 8, 10 20 9, 20 20 9, 20 15 9, 10 10 8 ))' |
Polygon mit Messwerten |
|
ST_Polygon |
'polygon zm((10 10 3 8, 10 20 3 9, 20 20 3 9, 20 15 4 9, 10 10 3 8 ))' |
Polygon mit Z-Koordinaten und Messwerten |
|
ST_MultiPoint |
'multipoint empty' |
Leerer Multipoint |
|
ST_MultiPoint |
'multipoint z empty' |
Leerer Multipoint mit Z-Koordinaten |
|
ST_MultiPoint |
'multipoint m empty' |
Leerer Multipoint mit Messwerten |
|
ST_MultiPoint |
'multipoint zm empty' |
Leerer Multipoint mit Z-Koordinaten und Messwerten |
|
ST_MultiPoint |
'multipoint (10 10, 20 20)' |
Multipoint mit zwei Punkten |
|
ST_MultiPoint |
'multipoint z(10 10 2, 20 20 3)' |
Multipoint mit Z-Koordinaten |
|
ST_MultiPoint |
'multipoint m(10 10 4, 20 20 5)' |
Multipoint mit Messwerten |
|
ST_MultiPoint |
'multipoint zm(10 10 2 4, 20 20 3 5)' |
Multipoint mit Z-Koordinaten und Messwerten |
|
ST_MultiLineString |
'multilinestring empty' |
Leerer Multilinestring |
|
ST_MultiLineString |
'multilinestring z empty' |
Leerer Multilinestring mit Z-Koordinaten |
|
ST_MultiLineString |
'multilinestring m empty' |
Leerer Multilinestring mit Messwerten |
|
ST_MultiLineString |
'multilinestring zm empty' |
Leerer Multilinestring mit Z-Koordinaten und Messwerten |
|
ST_MultiLineString |
'multilinestring ((10.05 10.28 , 20.95 20.89 ),( 20.95 20.89, 31.92 21.45))' |
Multilinestring |
|
ST_MultiLineString |
'multilinestring z((10.05 10.28 3.4, 20.95 20.89 4.5),( 20.95 20.89 4.5, 31.92 21.45 3.6))' |
Multilinestring mit Z-Koordinaten |
|
ST_MultiLineString |
'multilinestring m((10.05 10.28 8.4, 20.95 20.89 9.5), (20.95 20.89 9.5, 31.92 21.45 8.6))' |
Multilinestring mit Messwerten |
|
ST_MultiLineString |
'multilinestring zm((10.05 10.28 3.4 8.4, 20.95 20.89 4.5 9.5), (20.95 20.89 4.5 9.5, 31.92 21.45 3.6 8.6))' |
Multilinestring mit Z-Koordinaten und Messwerten |
|
ST_MultiPolygon |
'multipolygon empty' |
Leeres Multipolygon |
|
ST_MultiPolygon |
'multipolygon z empty' |
Leeres Multipolygon mit Z-Koordinaten |
|
ST_MultiPolygon |
'multipolygon m empty' |
Leeres Multipolygon mit Messwerten |
|
ST_MultiPolygon |
'multipolygon zm empty' |
Leer |
|
ST_MultiPolygon |
'multipolygon (((10 10, 10 20, 20 20, 20 15 , 10 10), (50 40, 50 50, 60 50, 60 40, 50 40)))' |
Multipolygon |
|
ST_MultiPolygon |
'multipolygon z(((10 10 7, 10 20 8, 20 20 7, 20 15 5, 10 10 7), (50 40 6, 50 50 6, 60 50 5, 60 40 6, 50 40 6)))' |
Multipolygon mit Z-Koordinaten |
|
ST_MultiPolygon |
'multipolygon m(((10 10 2, 10 20 3, 20 20 4, 20 15 5, 10 10 2), (50 40 7, 50 50 3, 60 50 4, 60 40 5, 50 40 7)))' |
Multipolygon mit Messwerten |
|
ST_MultiPolygon |
'multipolygon zm(((10 10 7 2, 10 20 8 3, 20 20 7 4, 20 15 5 5, 10 10 7 2), (50 40 6 7, 50 50 6 3, 60 50 5 4, 60 40 6 5, 50 40 6 7)))' |
Multipolygon mit Z-Koordinaten und Messwerten |
OGC Well-Known Binary-Format
Das Well-known Binary-Format für Geometrie ist Teil der Simple Features-Spezifikation des Open Geospatial Consortium (OGC). Diese implementiert ein einfaches Speichermodell für Punkt-, Linien- und Polygon-Features mit X/Y-Koordinaten. Es bietet eine übertragbare Darstellung eines Geometriewerts in Form eines zusammenhängenden Datenstroms. Auf diese Weise können Geometriewerte zwischen einem ODBC-Client und einer Datenbank im Binärformat ausgetauscht werden. Sie werden dabei nicht komprimiert.
Der Typ "ST_Geometry" für Oracle verfügt über mehrere Funktionen, die Geometrien aus Well-Known Binary-Formaten (WKB) generieren. Dazu gehören folgende Funktionen:
- ST_GeomFromWKB – Erstellt eine ST_Geometry aus einem WKB-Format eines beliebigen Geometrietyps
- ST_PointFromWKB – Erstellt einen ST_Point aus einem Punkt-WKB-Format
- ST_LineFromWKB – Erstellt einen ST_LineString aus einem Linestring-WKB-Format
- ST_PolyFromWKB – Erstellt ein ST_Polygon aus einem Polygon-WKB-Format
- ST_MPointFromWKB – Erstellt einen ST_MultiPoint aus einem Multipoint-WKB-Format
- ST_MLineFromWKB – Erstellt einen ST_MultiLineString aus einem Multilinestring-WKB-Format
- ST_MPolyFromWKB – Erstellt ein ST_MultiPolygon aus einem Multipolygon-WKB-Format
Hinweis:Diese Geometriefunktionen erfordern die Definition von C-Strukturen, um das binäre Format zuzuordnen. Sie sind für die Verwendung in einem 3GL-Programm vorgesehen und werden nicht an eine 4GL-Umgebung gepasst.
Die Funktion ST_AsBinary konvertiert einen vorhandenen Geometriewert in ein Well-Known Binary-Format.
Weitere Informationen zum Well-Known Binary-Format finden Sie unter Das OGC-Well-Known Binary-Format für Geometrie.