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> )

TO_GEOGRAPHY( <binary_expression> )

TO_GEOGRAPHY( <variant_expression> )

Argumente

Varchar-Ausdruck

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-Ausdruck

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

Variant-Ausdruck

Das Argument muss ein OBJECT im GeoJSON-Format sein.

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.

Beispiele

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

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