すべてのプロダクト
Search
ドキュメントセンター

ApsaraDB RDS:ST_PixelAsPoint

最終更新日:Mar 29, 2026

指定されたラスタのピクセルに対応するポイントジオメトリを返します。ref_point パラメーターを使用して、返されるポイントがピクセルの左上角に配置されるか、またはピクセルのセンターに配置されるかをコントロールします。

構文

geometry ST_PixelAsPoint(raster raster_obj,
    integer row default 0,
    integer column default 0,
    integer pyramid default 0,
    cstring ref_point default 'UPPERLEFT');

パラメーター

パラメーター説明
raster_objクエリ対象のラスタです。
rowピクセルの行インデックスで、左上角から 0 が始まります。
columnピクセルの列インデックスで、左上角から 0 が始まります。
pyramidピクセルのピラミッドレベルです。
ref_point返されるポイントのピクセル内における基準位置です。有効な値は以下のとおりです:UPPERLEFT(デフォルト) — ピクセルの左上角;CENTER — ピクセルのセンター。

次の例では、行インデックス 10、列インデックス 10、ピラミッドレベル 0 のピクセルの左上角のポイントを返します。

SELECT ST_AsText(ST_PixelAsPoint(rast, 10, 10))
FROM rast_table
WHERE id = 10;

------------------
POINT(-178.2 88.2)