ST_GeomFromWKB

ST_GeomFromWKB は、入力ジオメトリの 16 進数の WKB (Well-Known Binary) 表現からジオメトリオブジェクトを作成します。

ST_GeomFromWKB は、WKB の 16 進形式で記述された 3DZ、3DM、および 4D ジオメトリを受け入れます。

構文

ST_GeomFromWKB(wkb_string)

ST_GeomFromWKB(wkb_string, srid)

引数

wkb_string

ジオメトリの 16 進数の WKB 表現であるデータ型 VARCHAR の値。

srid

空間リファレンス識別子 (SRID) であるデータ型 INTEGER の値。SRID 値が指定されている場合、返されたジオメトリはこの SRID 値を持ちます。そうでない場合は、返されたジオメトリの SRID 値は 0 に設定されます。

戻り型

GEOMETRY

wkb_string または srid が null の場合、null が返されます。

srid が負数の場合、null が返されます。

wkb_string が有効でない場合、エラーが返されます。

srid が有効でない場合、エラーが返されます。

例

次の SQL は、WKB 値からポリゴンを作成し、ポリゴンの WKT 表現を返します。

SELECT ST_AsText(ST_GeomFromWKB('01030000000100000005000000000000000000000000000000000000000000000000000000000000000000F03F000000000000F03F000000000000F03F000000000000F03F000000000000000000000000000000000000000000000000'));            

 st_astext
--------------------------------
 POLYGON((0 0,0 1,1 1,1 0,0 0))