This topic describes the ST_Subdivide function. This function divides the input geometry object into parts until the number of vertexes in each part is less than the value of the maxVertices parameter.
Syntax
setof geometry ST_Subdivide(geometry geom , integer maxVertices);Parameters
| Parameter | Description |
|---|---|
| geom | The geometry object that you want to specify. |
| maxVertices | The maximum number of vertexes. Default value: 256. Minimum value: 5. |
Description
After the division, operations of obtaining points within a polygon object and spatial
operations run fast for the indexed divided parts for the following reasons:
- In most cases, the bounding boxes of all parts are smaller than the box of the input geometry object, so missed points are obtained faster.
- The recheck operations are performed on fewer points, so hit points are obtained faster.
Examples
Execute the following statement to divide a circle object:
SELECT ST_Subdivide(st_buffer('POINT(0 0)'::geometry,1),6);