ST_GEOGRAPHYFROMWKB¶
WKB (周知のバイナリ) または EWKB (周知の拡張バイナリ) 入力を解析し、型 GEOGRAPHY の値を返します。
- エイリアス:
ST_GEOGFROMWKB , ST_GEOGRAPHYFROMEWKB , ST_GEOGFROMEWKB
- こちらもご参照ください。
構文¶
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> ] )
引数¶
必須:
varchar_or_binary_expression
引数は、有効な地理空間オブジェクトを表す WKB または EWKB の文字列またはバイナリ式である必要があります。
文字列式は16進数形式である必要があります(先頭に
0x
なし)。
オプション:
allow_invalid
TRUE の場合、入力形状が無効で修復できない場合でも、関数が GEOGRAPHY または GEOMETRY オブジェクトを返す必要があることを指定します。詳細については、 無効な地理空間形状の処理方法の指定 をご参照ください。
戻り値¶
この関数は、 GEOGRAPHY 型の値を返します。
使用上の注意¶
入力が WKB または EWKB として解析できない場合は、エラーを発行します。
入力形式が EWKB で、 SRID が 4326 でない 場合は、エラーを発行します。 EWKT および EWKB の取り扱いに関する注意 をご参照ください。
例¶
次の例は、WKT 形式内で説明された地理空間オブジェクトに対して、GEOGRAPHY オブジェクトを返します。
-- Set the output format to WKT alter session set GEOGRAPHY_OUTPUT_FORMAT='WKT';select ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240'); +-------------------------------------------------------------------+ | ST_GEOGRAPHYFROMWKB('01010000006666666666965EC06666666666C64240') | |-------------------------------------------------------------------| | POINT(-122.35 37.55) | +-------------------------------------------------------------------+
次の例は、EWKT 形式内で説明された地理空間オブジェクトに対して、GEOGRAPHY オブジェクトを返します。
-- Set the output format to EWKT alter session set GEOGRAPHY_OUTPUT_FORMAT='EWKT';select ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240'); +----------------------------------------------------------------------------+ | ST_GEOGRAPHYFROMEWKB('0101000020E61000006666666666965EC06666666666C64240') | |----------------------------------------------------------------------------| | SRID=4326;POINT(-122.35 37.55) | +----------------------------------------------------------------------------+