Die vorliegende Übersetzung wurde maschinell erstellt. Im Falle eines Konflikts oder eines Widerspruchs zwischen dieser übersetzten Fassung und der englischen Fassung (einschließlich infolge von Verzögerungen bei der Übersetzung) ist die englische Fassung maßgeblich.

Konstruktor-Funktionen

Mithilfe von Konstruktorfunktionen erhalten Sie binäre Werte der Geometriedatentypen point, line oder polygon. Sie können diese Funktionen auch verwenden, um Binärdaten in Text zu konvertieren und Binärwerte für Geometriedaten abzurufen, die als wohlbekannter Text () WKT ausgedrückt werden.

ST_AsBinary(geometry)

Gibt einen varbinary-Datentyp zurück, der die WKB Darstellung der angegebenen Geometrie enthält. Beispiel:

SELECT ST_AsBinary(ST_Point(-158.54, 61.56))

ST_AsText(geometry)

Konvertiert die einzelnen angegebenen Geometrie-Datentypen in Text. Gibt einen Wert in einem Varchar-Datentyp zurück, der eine WKT Darstellung des Geometriedatentyps ist. Beispiel:

SELECT ST_AsText(ST_Point(-158.54, 61.56))

ST_GeomAsLegacyBinary(geometry)

Gibt eine Legacy-Varbinary aus der angegebenen Geometrie zurück. Beispiel:

SELECT ST_GeomAsLegacyBinary(ST_Point(-158.54, 61.56)

ST_GeometryFromText(varchar)

Konvertiert WKT formatierten Text in einen Geometriedatentyp. Gibt einen Wert mit dem Geometrie-Datentyp zurück. Beispiel:

SELECT ST_GeometryFromText(ST_AsText(ST_Point(1, 2)))

ST_GeomFromBinary(varbinary)

Gibt ein Objekt vom Typ Geometrie aus einer WKB Darstellung zurück. Beispiel:

SELECT ST_GeomFromBinary(ST_AsBinary(ST_Point(-158.54, 61.56)))

ST_GeomFromLegacyBinary(varbinary)

Gibt ein Geometrietypobjekt aus einem Legacy-Varbinary-Typ zurück. Beispiel:

SELECT ST_GeomFromLegacyBinary(ST_GeomAsLegacyBinary(ST_Point(-158.54, 61.56)))

ST_LineFromText(varchar)

Gibt einen Wert im Geometriedatentyp line zurück. Beispiel:

SELECT ST_Line('linestring(1 1, 2 2, 3 3)')

ST_LineString(array(point))

Gibt einen LineString-Geometrietyp zurück, der aus einem Array von Punktgeometrietypen gebildet wird. Wenn das angegebene Array weniger als zwei nicht leere Punkte enthält, wird eine leere LineString zurückgegeben. Löst eine Ausnahme aus, wenn ein Element im Array null, leer oder dasselbe wie das vorherige ist. Die zurückgegebene Geometrie ist möglicherweise nicht einfach. Abhängig von der angegebenen Eingabe kann sich die zurückgegebene Geometrie selbst schneiden oder doppelte Scheitelpunkte enthalten. Beispiel:

SELECT ST_LineString(ARRAY[ST_Point(-158.54, 61.56), ST_Point(-158.55, 61.56)])

ST_MultiPoint(array(point))

Gibt ein MultiPoint-Geometrieobjekt zurück, das aus den angegebenen Punkten gebildet wird. Gibt null zurück, wenn das angegebene Array leer ist. Löst eine Ausnahme aus, wenn ein Element im Array null oder leer ist. Die zurückgegebene Geometrie ist möglicherweise nicht einfach und kann doppelte Punkte enthalten, wenn das angegebene Array Duplikate aufweist. Beispiel:

SELECT ST_MultiPoint(ARRAY[ST_Point(-158.54, 61.56), ST_Point(-158.55, 61.56)])

ST_Point(double, double)

Gibt ein Objekt vom Geometrietyp point zurück. Verwenden Sie für die Eingabedatenwerte für diese Funktion geometrische Werte, z. B. Werte im kartesischen Koordinatensystem Universal Transverse Mercator (UTM) oder geografische Karteneinheiten (Längen- und Breitengrad) in Dezimalgraden. Die Längen- und Breitengradwerte verwenden das World Geodetic System, auch bekannt als 1984, oder:4326. WGS EPSG WGS1984 ist das vom Global Positioning System () verwendete Koordinatensystem. GPS

In der folgenden Notation werden die Kartenkoordinaten beispielsweise in Längen- und Breitengraden angegeben. Der Wert .072284, bei dem es sich um die Pufferdistanz handelt, wird in Winkeleinheiten als Dezimalgrad angegeben:

SELECT ST_Buffer(ST_Point(-74.006801, 40.705220), .072284)

Syntax:

SELECT ST_Point(longitude, latitude) FROM earthquakes LIMIT 1

Im nächsten Beispiel werden bestimmte Längen- und Breitenkoordinaten verwendet:

SELECT ST_Point(-158.54, 61.56)
FROM earthquakes
LIMIT 1

Im nächsten Beispiel werden bestimmte Längen- und Breitenkoordinaten verwendet:

SELECT ST_Point(-74.006801, 40.705220)

Im folgenden Beispiel wird die ST_AsText Funktion verwendet, um die Geometrie von abzurufenWKT:

SELECT ST_AsText(ST_Point(-74.006801, 40.705220)) AS WKT

ST_Polygon(varchar)

Unter Verwendung der angegebenen Ordinatenreihenfolge im Uhrzeigersinn von links nach rechts wird ein Geometriedatentyp polygon zurückgegeben. Ab Athena-Engine-Version 2 werden nur Polygone als Eingaben akzeptiert. Beispiel:

SELECT ST_Polygon('polygon ((1 1, 1 4, 4 4, 4 1))') 

to_geometry(sphericalGeography)

Gibt ein Geometrieobjekt aus dem angegebenen sphärischen Geographieobjekt zurück. Beispiel:

SELECT to_geometry(to_spherical_geography(ST_Point(-158.54, 61.56)))

to_spherical_geography(geometry)

Gibt ein sphärisches Geographieobjekt aus der angegebenen Geometrie zurück. Verwenden Sie diese Funktion, um ein Geometrieobjekt in ein kugelförmiges Geographieobjekt auf der Kugel des Radius der Erde zu konvertieren. Diese Funktion kann nur für POINT-, MULTIPOINT-, LINESTRING-, MULTILINESTRING-, POLYGON- und MULTIPOLYGON- Geometrien verwendet werden, die im 2D-Raum oder einer GEOMETRYCOLLECTION solcher Geometrien definiert sind. Für jeden Punkt der angegebenen Geometrie überprüft die Funktion, ob point.x innerhalb von [-180.0, 180.0] und point.y innerhalb von [-90.0, 90.0] liegt. Die Funktion verwendet diese Punkte als Längen- und Breitengrad, um die Form des sphericalGeography-Ergebnisses zu konstruieren.

Beispiel:

SELECT to_spherical_geography(ST_Point(-158.54, 61.56))