Area

geometric-functions area

syntax

  • area(polygon_data_item, valuesunit)

definition

area(polygon_data_item, valuesunit) calculates the surface of the polygon_data_item argument, in the image the green hedged area.

The resulting values-unit is configured as second argument.

description

The resulting area values need to be positive, if the values are negative it means the order of points in the polygon geometry is not according to the following rules:

The order of points in a sequence needs to be clockwise for exterior bounds and counter clockwise for holes in polygons (right-hand-rule)

applies to

conditions

The metric of the values-unit argument must match with the square of the metric of the coordinates in the coordinate system.

example

attribute<m2> surface (district) := area(district/geometry, m2);
district/geometry surface
{21 {403025, 113810}{4 1003100
{17 {400990, 113269}{4 474460
{19 {401238, 115099}{4} 1246460

domain district, nr of rows = 3