TRY_TO_GEOMETRY¶
入力を解析し、 GEOMETRY 型の値を返します。
この関数は基本的に TO_GEOMETRY と同じですが、 TO_GEOMETRY がエラーを発行したときに NULL を返す点が異なります。
- こちらもご参照ください。
構文¶
次のいずれかを使用します。
TRY_TO_GEOMETRY( <varchar_expression> )
TRY_TO_GEOMETRY( <binary_expression> )
TRY_TO_GEOMETRY( <variant_expression> )
引数¶
varchar_expression
引数は、次のいずれかの形式で有効なジオメトリオブジェクトを表す文字列式である必要があります。
WKT (よく知られているテキスト)。
WKB (周知のバイナリ)16進数形式(先頭に
0x
なし)。EWKT (周知のテキスト)。
EWKB (周知のバイナリ)16進数形式(先頭に
0x
なし)。GeoJSON
binary_expression
引数は WKB または EWKB 形式のバイナリ式である必要があります。
variant_expression
引数は、 GeoJSON 形式の OBJECT である必要があります。
戻り値¶
この関数は、 GEOMETRY 型の値を返します。
使用上の注意¶
入力が、サポートされている適切な形式(WKT、 WKB、 EWKT、 EWKB、 GeoJSON)として解析できない場合は、 NULL を返します。
GeoJSON、WKT、および WKB 入力の場合、結果の GEOMETRY オブジェクトでは SRID が0に設定されます。SRID を変更するには、 GEOMETRY オブジェクトを ST_SETSRID に渡し、設定する SRID を指定します。ST_SETSRID は、その SRID が設定された GEOMETRY オブジェクトを返します。
例¶
これは、 TRY_TO_GEOMETRY 関数と VARCHAR データの簡単な使用法を示しています。
select try_to_geometry('INVALID INPUT');+--------------------------------------+ | try_to_geometry('INVALID INPUT') | |--------------------------------------| | NULL | +--------------------------------------+