ST_PointOnSurface

Définition

ST_PointOnSurface prend un ST_Polygon ou un ST_MultiPolygon et renvoie un ST_Point qui doit nécessairement résider sur sa surface.

Syntaxe

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

Type de retour

ST_Point

Exemple

L'ingénieur municipal souhaite créer un point label pour l'emprise de chaque bâtiment. Les emprises des bâtiments sont stockées dans la table buildingfootprints qui a été créée avec l'instruction CREATE TABLE suivante :

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)
);

La fonction ST_PointOnSurface génère un point qui doit nécessairement résider sur la surface des emprises de bâtiments. La fonction ST_PointOnSurface renvoie un point que la fonction ST_AsText convertit en texte pour être utilisé par l'application.

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)