Description

Renvoie un POINT qui est garanti de se trouver à l'intérieur d'une surface (POLYGON, MULTIPOLYGON, et CURVEPOLYGON). Dans PostGIS, cette fonction fonctionne également pour les géométries de lignes et de points.

Cette méthode implémente la spécification OGC Simple Features Implementation Specification for SQL 1.1. s3.2.14.2 // s3.2.18.2

Cette méthode implémente la spécification SQL/MM. SQL-MM 3: 8.1.5, 9.5.6. Les spécifications définissent ST_PointOnSurface pour les géométries de surface uniquement. PostGIS étend la fonction pour prendre en charge tous les types de géométrie courants. D'autres bases de données (Oracle, DB2, ArcSDE) semblent ne prendre en charge cette fonction que pour les surfaces. SQL Server 2008 prend en charge tous les types de géométrie courants.

Cette fonction prend en charge la 3D et ne supprime pas l'indice z.

Exemples

Point on surface of a MultiPoint.

SELECT ST_PointOnSurface(
  'MULTIPOINT (8 24,10 92,12 154,17 68,28 10,29 52,29 84,55 50,56 24,131 14,160 180,189 180)');

POINT(55 50)

01010000000000000000804B400000000000004940

Figure

Point on surface of a LineString.

SELECT ST_PointOnSurface(
  'LINESTRING (190 160,10 190,40 90,20 70,10 10,30 40,30 10,110 40,70 10,110 10,140 40,140 10,160 30,180 10)');

POINT(40 90)

010100000000000000000044400000000000805640

Figure

Point on surface of a Polygon.

SELECT ST_PointOnSurface(
  'POLYGON ((190 190,10 190,10 10,190 10,190 20,160 30,60 30,60 130,190 140,190 190))');

POINT(35 80)

010100000000000000008041400000000000005440

Figure

Point on surface of the highest-dimension components of a GeometryCollection.

SELECT ST_PointOnSurface(
  'GEOMETRYCOLLECTION (POLYGON ((190 170,180 100,80 140,80 160,130 160,110 180,110 190,180 180,190 170)),
    LINESTRING (80 120,120 20,140 70,150 30,180 50,190 10),
    MULTIPOINT (19 150,22 49,30 13,32 101,45 35,67 88,75 16))');

POINT(133.571 150)

01010000002449922449B260400000000000C06240

Figure

SELECT ST_PointOnSurface('LINESTRING(0 5 1,0 0 1,0 10 2)');

st_asewkt
--------------
 POINT(0 0 1)
(1 row)

010100008000000000000000000000000000000000000000000000F03F

Figure

Exemple: Le résultat de ST_PointOnSurface est garanti à l'intérieur des polygones, alors que le point calculé par ST_Centroid peut se trouver à l'extérieur.

SELECT ST_PointOnSurface(geom) AS pt_on_surf, ST_Centroid(geom) AS centroid
    FROM (SELECT 'POLYGON ((130 120,120 190,30 140,50 20,190 20,
                      170 100,90 60,90 130,130 120))'::geometry AS geom) AS t;

pt_on_surf    |                  centroid
-----------------+---------------------------------------------
 POINT(62.5 110) | POINT(100.18264840182648 85.11415525114155)

01010000000000000000404F400000000000805B40 | 0101000000BB20EC82B00B59407594D3514E475540

Figure

Voir aussi

ST_Centroid, ST_MaximumInscribedCircle