ST_PointOnSurface

Definition

ST_PointOnSurface akzeptiert ein ST_Polygon- oder ST_MultiPolygon-Objekt und gibt ein ST_Point-Objekt zurück, das sicher auf der Oberfläche der angegebenen Geometrie liegt.

Syntax

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

Rückgabetyp

ST_Point

Beispiel

Ein Ingenieur des Bauamts möchte einen Label-Punkt für jeden Gebäudegrundriss erstellen. Die Gebäudegrundrisse werden in der Tabelle "buildingfootprints" gespeichert, die mit der folgenden CREATE TABLE-Anweisung erstellt wurde:

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

Die Funktion ST_PointOnSurface generiert einen Punkt, der sicher auf der Fläche des angegebenen Gebäudegrundrisses liegt. Die Funktion ST_PointOnSurface gibt einen Punkt zurück, der von der Funktion ST_AsText in Text konvertiert wird, der von der Anwendung verwendet wird.

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)