ST_Dimension

Returns the dimension of the geometry or geography.

Usage

integer ST_Dimension(geom: geometry)
integer ST_Dimension(geog: geography)

Arguments

• geog (geography): Input geography
• geom (geometry): Input geometry

Description

Returns the inherent dimension of the geometry:

• 0 for points or multipoints
• 1 for linestring or multilinestrings
• 2 for polygons or multipolygons

For geometry collections, returns the largest dimension among the components.

Examples

SELECT ST_Dimension(ST_GeomFromWKT('POLYGON ((0 0, 1 0, 0 1, 0 0))'));

┌──────────────────────────────────────────────────────────────────────┐
│ st_dimension(st_geomfromwkt(Utf8("POLYGON ((0 0, 1 0, 0 1, 0 0))"))) │
│                                 int8                                 │
╞══════════════════════════════════════════════════════════════════════╡
│                                                                    2 │
└──────────────────────────────────────────────────────────────────────┘

SELECT ST_Dimension(ST_GeogFromWKT('POLYGON ((0 0, 1 0, 0 1, 0 0))'));

┌──────────────────────────────────────────────────────────────────────┐
│ st_dimension(st_geogfromwkt(Utf8("POLYGON ((0 0, 1 0, 0 1, 0 0))"))) │
│                                 int8                                 │
╞══════════════════════════════════════════════════════════════════════╡
│                                                                    2 │
└──────────────────────────────────────────────────────────────────────┘