Kategorien:

Geodatenfunktionen, Konvertierungsfunktionen

TO_GEOGRAPHY

Analysiert eine Eingabe und gibt einen Wert vom Typ GEOGRAPHY zurück.

Siehe auch:

TRY_TO_GEOGRAPHY, ST_GEOGRAPHYFROMWKB, ST_GEOGRAPHYFROMWKT

Syntax

Verwenden Sie eine der folgenden Optionen:

TO_GEOGRAPHY( <varchar_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <binary_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <variant_expression> [ , <allow_invalid> ] )

TO_GEOGRAPHY( <geometry_expression> [ , <allow_invalid> ] )
Copy

Argumente

Benötigt:

varchar_expression

Das Argument muss ein Zeichenfolgenausdruck sein, der ein gültiges geometrisches Objekt in einem der folgenden Formate repräsentiert:

  • WKT (Well-Known Text)

  • WKB (Well-Known Binary) im Hexadezimalformat (ohne führendes 0x)

  • EWKT (Extended Well-Known Text)

  • EWKB (Extended Well-Known Binary) im Hexadezimalformat (ohne führendes 0x)

  • GeoJSON.

binary_expression

Das Argument muss ein Binärausdruck im WKB- oder EWKB-Format sein.

variant_expression

Das Argument muss ein OBJECT im GeoJSON-Format sein.

geometry_expression

Das Argument muss ein Ausdruck vom Typ GEOMETRY mit der SRID 4326 sein.

Optional:

allow_invalid

TRUE gibt an, dass die Funktion ein GEOGRAPHY- oder GEOMETRY-Objekt zurückgeben soll, selbst wenn die Form des Eingabeobjekts ungültig ist und nicht repariert werden kann. Weitere Informationen dazu finden Sie unter Festlegen der Verarbeitung von ungültigen Geodaten.

Rückgabewerte

Gibt einen Wert vom Typ GEOGRAPHY zurück.

Nutzungshinweise

  • Gibt eine Fehlermeldung aus, wenn die Eingabe nicht als eines der unterstützten Formate (WKT, WKB, EWKT, EWKB, GeoJSON) analysiert werden kann.

  • Gibt einen Fehler aus, wenn das Eingabeformat EWKT oder EWKB ist und die SRID nicht „4326“ ist. Siehe den Hinweis zur Verwendung von EWKT und EWKB.

  • Um ein GEOGRAPHY-Objekt aus der WKT- oder EWKT-Eingabe zu erstellen, können Sie auch ST_GEOGRAPHYFROMWKT verwenden.

  • Um ein GEOGRAPHY-Objekt aus der WKB- oder EWKB-Eingabe zu erstellen, können Sie auch ST_GEOGRAPHYFROMWKB verwenden.

  • Bei Koordinaten in WKT, EWKT und GeoJSON wird erst die Länge, dann die Breite angezeigt (z. B. POINT(lon lat)).

Beispiele

Das folgende Beispiel zeigt eine einfache Verwendung der Funktion TO_GEOGRAPHY mit VARCHAR-Daten:

select TO_GEOGRAPHY('POINT(-122.35 37.55)');
Copy
+--------------------------------------+
| TO_GEOGRAPHY('POINT(-122.35 37.55)') |
|--------------------------------------|
| POINT(-122.35 37.55)                 |
+--------------------------------------+

Das folgende Beispiel gibt das GEOGRAPHY-Objekt eines Geodatenobjekts mit einer Z-Koordinate im WKT-Format zurück:

select TO_GEOGRAPHY('POINTZ(-122.35 37.55 30)');
Copy
+------------------------------------------+
| TO_GEOGRAPHY('POINTZ(-122.35 37.55 30)') |
|------------------------------------------|
| POINTZ(-122.35 37.55 30)                 |
+------------------------------------------+
Sprache: Deutsch