ラスターのバウンディングボックスを、((maxX,maxY),(minX,minY)) フォーマットの PostgreSQL の BOX 値として返します。
構文
BOX ST_Extent(raster raster_obj, CoorSpatialOption csOption = 'WorldFirst')
BOX ST_Extent(raster raster_obj, integer pyramid, CoorSpatialOption csOption = 'WorldFirst')パラメーター
| パラメーター | 説明 |
|---|---|
raster_obj | クエリ対象のラスターオブジェクトです。 |
pyramid | クエリ対象のピラミッドレベルです。有効な値は 0 から始まります。 |
csOption | 使用する座標空間です。デフォルト： WorldFirst。 |
説明
ST_Extent は、ラスターのバウンディングボックスを表す BOX 値を返します。フォーマットは ((maxX,maxY),(minX,minY)) で、右上隅が先に、左下隅がその後に続きます。
csOption パラメーターは、使用する座標空間をコントロールします：
| 値 | 動作 |
|---|---|
Raster | ピクセル座標を返します。 |
World | ワールド (地理) 座標を返します。 |
WorldFirst | ラスターがジオリファレンス済みの場合、ワールド座標を返します。それ以外の場合は、ピクセル座標を返します。 |
説明
WorldFirst がデフォルトです。ラスターがジオリファレンス済みでなく、csOption を指定せずに ST_Extent を呼び出した場合、結果はピクセル座標になります。常にワールド座標を取得するには、'World'::CoorSpatialOption を明示的に渡してください。
例
ピクセル座標を返す：
SELECT ST_Extent(raster_obj, 'Raster'::CoorSpatialOption) FROM raster_table;結果：
((255,255),(0,0))ワールド座標を返す：
SELECT ST_Extent(raster_obj, 'World'::CoorSpatialOption) FROM raster_table;特定のピラミッドレベルでワールド座標を返す：
SELECT ST_Extent(raster_obj, 2, 'World'::CoorSpatialOption) FROM raster_table;