ST_Split

ST_Split
Précédent	7.13. Fonctions de superposition	Suivant

Nom

ST_Split — Renvoie une collection de géométries créées en divisant une géométrie par une autre géométrie.

Synopsis

geometry ST_Split(geometry input, geometry blade);

Description

Cette fonction permet de diviser une ligne par un (Multi)Point, une (Multi)Ligne ou un (Multi)Polygone, ou un (Multi)Polygone par une ligne. Lorsqu'un (Multi)Polygone est utilisé, ses composantes linéaires (la frontière) sont utilisées pour diviser l'entrée. La géométrie résultante est toujours une collection.

Cette fonction est en quelque sorte l'inverse de ST_Union. L'application de ST_Union à la collection retournée devrait théoriquement donner la géométrie originale (bien qu'en raison de l'arrondi numérique, cela puisse ne pas être exactement le cas).


	Si l'entrée et la "lame" ne se croisent pas en raison de problèmes de précision numérique, l'entrée peut ne pas être divisée comme prévu. Pour éviter cette situation, il peut être nécessaire d'accrocher d'abord l'entrée à la "lame", en utilisant ST_Snap avec une petite tolérance.

Disponibilité : 2.0.0 nécessite GEOS

Amélioration : la version 2.2.0 prend en charge la division d'une ligne par une limite multiligne, multipoint ou (multi)polygone.

Amélioration : la prise en charge de la division d'un polygone par une ligne multiple a été introduite dans la version 2.5.0.

Exemples

Split a circular polygon by a diagonal line.

Code

SELECT
         ST_Split(
           ST_Buffer('POINT(100 90)'::geometry, 50),
           'LINESTRING(10 10,190 190)'::geometry
         );

Export de raster

GEOMETRYCOLLECTION(POLYGON((150 90,149 80.2,146.2 70.9,141.6 62.2,135.4 54.6,127.8 48.4,119.1 43.8,109.8 41,100 40,90.2 41,80.9 43.8,72.2 48.4,64.6 54.6,60.1 60.1,129.9 129.9,135.4 125.4,141.6 117.8,146.2 109.1,149 99.8,150 90)), POLYGON((60.1 60.1,58.4 62.2,53.8 70.9,51 80.2,50 90,51 99.8,53.8 109.1,58.4 117.8,64.6 125.4,72.2 131.6,80.9 136.2,90.2 139,100 140,109.8 139,119.1 136.2,127.8 131.6,129.9 129.9,60.1 60.1)))

010700000002000000010300000001000000140000000000000000C0624000000000008056401A509EA641A16240C9AE1902B60F544098DF770E35466240EBE271BB69B7514092DB04F459B2614024BEEFBA591C4F40AED904F05EEB60404999EC3F84524B40EE208822D3F15F40B991EC2F98364840161D8E4496C85D40A18120C62BE745403751E6FD49705B4096BF8665F97A444000000000000059400000000000004440C9AE1902B68F564096BF8665F97A4440EBE271BB69375440A18120C62BE7454013DF77DD2C0E5240B791EC2F98364840A44CF61F422950404899EC3F84524B403A7DCB148D114E403A7DCB148D114E40B120CDBA9C3B6040B120CDBA9C3B6040AED904F05EEB60405CB309E0BD565F4092DB04F459B26140EE208822D3715D4097DF770E35466240181D8E4496485B401A509EA641A162403951E6FD49F058400000000000C062400000000000805640010300000001000000120000003A7DCB148D114E403A7DCB148D114E40B891EC2F98364D4024BEEFBA591C4F40A18120C62BE74A40EAE271BB69B7514096BF8665F97A4940C8AE1902B60F54400000000000004940000000000080564096BF8665F97A49403751E6FD49F05840A18120C62BE74A40151D8E4496485B40B791EC2F98364D40ED208822D3715D40A44CF61F422950405CB309E0BD565F4012DF77DD2C0E524092DB04F459726040E9E271BB6937544097DF770E35066140C8AE1902B68F56401A509EA641616140000000000000594000000000008061403751E6FD49705B401A509EA641616140161D8E4496C85D4098DF770E35066140ED208822D3F15F4092DB04F459726040B120CDBA9C3B6040B120CDBA9C3B60403A7DCB148D114E403A7DCB148D114E40

Figure

Divise une MultiLineString par un point, où le point se trouve exactement sur les deux éléments de la LineString.

Code

SELECT ST_Split('MULTILINESTRING((10 10,190 190),(15 15,30 30,100 90))',
    ST_Point(30, 30));

Export de raster

GEOMETRYCOLLECTION(
    LINESTRING(10 10,30 30),
    LINESTRING(30 30,190 190),
    LINESTRING(15 15,30 30),
    LINESTRING(30 30,100 90)
)

010700000004000000010200000002000000000000000000244000000000000024400000000000003E400000000000003E400102000000020000000000000000003E400000000000003E400000000000C067400000000000C067400102000000020000000000000000002E400000000000002E400000000000003E400000000000003E400102000000020000000000000000003E400000000000003E4000000000000059400000000000805640

Figure

Diviser une ligne par un point, lorsque le point ne se trouve pas exactement sur la ligne. Montre l'utilisation de ST_Snap pour accrocher la ligne au point afin de permettre son découpage.

Code

WITH data AS (SELECT
  'LINESTRING(0 0,100 100)'::geometry AS line,
  'POINT(51 50)':: geometry AS point
)
SELECT ST_Split(ST_Snap(line, point, 1), point) AS snapped_split,
       ST_Split(line, point) AS not_snapped_not_split
       FROM data;

Export de raster

-[ RECORD 1 ]---------
snapped_split         | GEOMETRYCOLLECTION(LINESTRING(0 0,51 50), LINESTRING(51 50,100 100))
not_snapped_not_split | GEOMETRYCOLLECTION(LINESTRING(0 0,100 100))

01070000000200000001020000000200000000000000000000000000000000000000000000000080494000000000000049400102000000020000000000000000804940000000000000494000000000000059400000000000005940 | 0107000000010000000102000000020000000000000000000000000000000000000000000000000059400000000000005940

Figure

Voir aussi

ST_Snap, ST_Union