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

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

If TRUE, specifies that the function should return a GEOGRAPHY or GEOMETRY object, even when the input shape is invalid and cannot be repaired. For details, refer to Specifying How Invalid Geospatial Shapes Are Handled.

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