ST_DIMENSION

Introduced or updated: v1.2.442

Return the dimension for a geometry object. The dimension of a GEOMETRY object is:

Geospatial Object Type	Dimension
Point / MultiPoint	0
LineString / MultiLineString	1
Polygon / MultiPolygon	2

Syntax

ST_DIMENSION(<geometry>)

Arguments

Arguments	Description
<geometry>	The argument must be an expression of type GEOMETRY.

Return Type

UInt8.

Examples

SELECT
  ST_DIMENSION(
    ST_GEOMETRYFROMWKT(
      'POINT(-122.306100 37.554162)'
    )
  ) AS pipeline_dimension;

┌────────────────────┐
│ pipeline_dimension │
├────────────────────┤
│                  0 │
└────────────────────┘

SELECT
  ST_DIMENSION(
    ST_GEOMETRYFROMWKT(
      'LINESTRING(-124.20 42.00, -120.01 41.99)'
    )
  ) AS pipeline_dimension;

┌────────────────────┐
│ pipeline_dimension │
├────────────────────┤
│                  1 │
└────────────────────┘

SELECT
  ST_DIMENSION(
    ST_GEOMETRYFROMWKT(
      'POLYGON((-124.20 42.00, -120.01 41.99, -121.1 42.01, -124.20 42.00))'
    )
  ) AS pipeline_dimension;

┌────────────────────┐
│ pipeline_dimension │
├────────────────────┤
│                  2 │
└────────────────────┘