ST_PointOnSurface

定義

ST_PointOnSurface は、ST_Polygon または ST_MultiPolygon を入力として、サーフェス上にあることが保証される ST_Point を返します。

構文

sde.st_pointonsurface (pl1 sde.st_geometry)
sde.st_pointonsurface (mpl1 sde.st_geometry)

戻り値のタイプ

ST_Point

例

都市エンジニアは、各建物のラベル ポイントを作成したいと考えています。建物は、次の CREATE TABLE ステートメントで作成された buildingfootprints テーブルに格納されます。

CREATE TABLE buildings (building_id integer,
footprint sde.st_geometry);

INSERT INTO buildings (building_id, footprint) VALUES (
1,
sde.st_polygon ('polygon ((0 0, 0 10, 10 10, 10 0, 0 0))', 0)
);

INSERT INTO buildings (building_id, footprint) VALUES (
2,
sde.st_polygon ('polygon ((20 0, 20 10, 30 10, 30 0, 20 0))', 0)
);

ST_PointOnSurface 関数は、建物のサーフェス上にあることが保証されるポイントを生成します。ST_PointOnSurface 関数は、ST_AsText 関数がアプリケーションで使用できるテキストに変換するポイントを返します。

Oracle

SELECT sde.st_astext (sde.st_pointonsurface (footprint)) Surface_Points
FROM BUILDINGS;

SURFACE_POINTS

POINT  (5.00000000 5.00000000)
POINT  (25.00000000 5.00000000)

PostgreSQL

SELECT sde.st_astext (sde.st_pointonsurface (footprint)) 
AS Surface_Points
FROM buildings;

surface_points

POINT  (5 5)
POINT  (25 5)