ST_Hexagon
Prev | 8.3. Geometry Constructors | Next

## Name

ST_Hexagon — Returns a single hexagon, using the provided edge size and cell coordinate within the hexagon grid space.

## Synopsis

`geometry ST_Hexagon(`float8 size, integer cell_i, integer cell_j, geometry origin`)`;

## Description

Uses the same hexagon tiling concept as ST_HexagonGrid, but generates just one hexagon at the desired cell coordinate. Optionally, can adjust origin coordinate of the tiling, the default origin is at 0,0.

Hexagons are generated with no SRID set, so use ST_SetSRID to set the SRID to the one you expect.

Availability: 3.1.0

## Example: Creating a hexagon at the origin

    SELECT ST_AsText(ST_SetSRID(ST_Hexagon(1.0, 0, 0), 3857));

    POLYGON((-1 0,-0.5
             -0.866025403784439,0.5
             -0.866025403784439,1
             0,0.5
             0.866025403784439,-0.5
             0.866025403784439,-1 0))

## See Also

ST_TileEnvelope, ST_HexagonGrid, ST_Square

Prev | Up | Next
ST_HexagonGrid | Home | ST_SquareGrid