ST_Geometry タイプの ST_SnapToGrid(DOUBLE) メソッド

指定したグリッドにすべてのポイントがスナップされたジオメトリのコピーを返します。

構文

geometry-expression.ST_SnapToGrid(cell-size)

パラメーター

名前	型	説明
cell-size	DOUBLE	グリッドのセルサイズ。

戻り値

ST_Geometry グリッドにすべてのポイントがスナップされたジオメトリを返します。
結果の空間参照系識別子は、geometry-expression の空間参照系と同じです。

備考

ST_SnapToGrid メソッドを使用して、原点とセルサイズで定義したグリッドにジオメトリ内のすべてのポイントをスナップすることによって、データの精度を下げることができます。

X 座標と Y 座標がグリッドにスナップされます。Z 値と M 値は変更されません。

注意

精度を下げると、結果のジオメトリに別のプロパティが含まれる可能性があります。たとえば、単純な線ストリングがそれ自体と交差したり、無効なジオメトリが生成されたりする可能性があります。

注意

各空間参照系で、すべてのジオメトリが自動的にスナップされるグリッドが定義されます。この事前に定義されたグリッドよりも高い精度を格納することはできません。

注意

ST_SnapToGrid では、デフォルトで、使用可能な場合はジオメトリの元のフォーマットが使用されます。それ以外の場合は、内部フォーマットが使用されます。内部フォーマットと元のフォーマットの詳細については、STORAGE FORMAT 句、CREATE SPATIAL REFERENCE SYSTEM 文を参照してください。

参照

標準と互換性

例

次の例では、結果として LineString (1.536133 6.439453, 2.173828 6.100586) を返します。

SELECT NEW ST_LineString( 'LineString( 1.5358 6.4391, 2.17401 6.10018 )' )
              .ST_SnapToGrid( 0.001 )

それぞれの X 座標と Y 座標は、約 0.001 のグリッドサイズを使用して、最も近いグリッドポイントに移動されます。実際に使用されるグリッドサイズは、指定したグリッドサイズとは完全には一致しません。

DocCommentXchange で意見交換できます