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

Пример

Городской инженер хочет создать точку метки для каждого контура здания. Контуры зданий хранятся в таблице buildingfootprints, созданной следующей инструкцией CREATE TABLE:

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)