Kategorien:

Geodatenfunktionen, Konvertierungsfunktionen

ST_GEOGRAPHYFROMWKB

Analysiert eine Eingabe im WKB (Well-Known Binary)- oder EWKB (Extended Well-Known Binary)-Format und gibt einen Wert vom Typ GEOGRAPHY zurück.

Aliasse:

ST_GEOGFROMWKB , ST_GEOGRAPHYFROMEWKB , ST_GEOGFROMEWKB

Siehe auch:

TO_GEOGRAPHY

Syntax

ST_GEOGRAPHYFROMWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGFROMWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGRAPHYFROMEWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )

ST_GEOGFROMEWKB( <varchar_or_binary_expression> [ , <allow_invalid> ] )
Copy

Argumente

Benötigt:

varchar_or_binary_expression

Das Argument muss eine Zeichenfolge oder ein binärer Ausdruck in WKB oder EWKB sein, der ein gültiges Geodatenobjekt darstellt.

Ein Zeichenfolgenausdruck muss im Hexadezimalformat vorliegen (ohne ein führendes 0x).

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 WKB oder EWKB analysiert werden kann.

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

Beispiele

Das folgende Beispiel gibt das Objekt GEOGRAPHY für einen Geodatenobjekt im WKT-Format zurück:

-- Set the output format to WKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';
Copy
select ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240');
+-------------------------------------------------------------------+
| ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240') |
|-------------------------------------------------------------------|
| POINT(-122.35 37.55)                                              |
+-------------------------------------------------------------------+
Copy

Das folgende Beispiel gibt das Objekt GEOGRAPHY für einen Geodatenobjekt im EWKT-Format zurück:

-- Set the output format to EWKT
alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';
Copy
select ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240');
+----------------------------------------------------------------------------+
| ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240') |
|----------------------------------------------------------------------------|
| SRID=4326;POINT(-122.35 37.55)                                             |
+----------------------------------------------------------------------------+
Copy