カテゴリ:: 地理空間関数、変換関数

ST_GEOGRAPHYFROMWKB¶

WKB （周知のバイナリ）または EWKB （周知の拡張バイナリ）入力を解析し、型 GEOGRAPHY の値を返します。

エイリアス:

ST_GEOGFROMWKB , ST_GEOGRAPHYFROMEWKB , ST_GEOGFROMEWKB

こちらもご参照ください。: TO_GEOGRAPHY

構文¶

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

引数¶

varchar_or_binary_expression

引数は、有効な地理空間オブジェクトを表す WKB または EWKB の文字列またはバイナリ式である必要があります。

文字列式は16進数形式である必要があります（先頭に 0x なし）。

オプション:

allow_invalid: TRUE の場合、入力形状が無効で修復できない場合でも、関数が GEOGRAPHY または GEOMETRY オブジェクトを返す必要があることを指定します。詳細については、 Specifying How Invalid Geospatial Shapes Are Handled をご参照ください。

戻り値¶

この関数は、 GEOGRAPHY 型の値を返します。

使用上の注意¶

入力が WKB または EWKB として解析できない場合は、エラーを発行します。
入力形式が EWKB で、 SRID が 4326 でない場合は、エラーを発行します。 EWKT および EWKB の取り扱いに関する注意をご参照ください。

例¶

次の例は、WKT 形式内で説明された地理空間オブジェクトに対して、GEOGRAPHY オブジェクトを返します。

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

次の例は、EWKT 形式内で説明された地理空間オブジェクトに対して、GEOGRAPHY オブジェクトを返します。

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