@turf/area

What is @turf/area?

@turf/area is a module from the Turf.js library that allows you to calculate the area of GeoJSON polygons. It is useful for geospatial analysis and can handle complex polygons, including those with holes.

What are @turf/area's main functionalities?

Calculate area of a simple polygon

This feature allows you to calculate the area of a simple polygon. The code sample demonstrates how to create a polygon and calculate its area using the @turf/area module.

const turf = require('@turf/turf');
const polygon = turf.polygon([[
  [-74.0059413, 40.7127837],
  [-73.935242, 40.730610],
  [-73.944158, 40.678178],
  [-74.0059413, 40.7127837]
]]);
const area = turf.area(polygon);
console.log(area);

Calculate area of a polygon with holes

This feature allows you to calculate the area of a polygon that contains holes. The code sample demonstrates how to create such a polygon and calculate its area using the @turf/area module.

const turf = require('@turf/turf');
const polygonWithHole = turf.polygon([[
  [-74.0059413, 40.7127837],
  [-73.935242, 40.730610],
  [-73.944158, 40.678178],
  [-74.0059413, 40.7127837]
], [
  [-73.965242, 40.7127837],
  [-73.955242, 40.7227837],
  [-73.945242, 40.7127837],
  [-73.965242, 40.7127837]
]]);
const area = turf.area(polygonWithHole);
console.log(area);

Other packages similar to @turf/area

geolib

Geolib is a library for geospatial calculations, including distance and area calculations. It is more general-purpose compared to @turf/area, which is specifically focused on area calculations for GeoJSON polygons.

geojson-area

Geojson-area is a lightweight library specifically designed to calculate the area of GeoJSON polygons. It is similar to @turf/area but is more focused and has fewer dependencies.

README

@turf/area

area

Takes one or more features and returns their area in square meters.

Parameters

• geojson (FeatureCollection | Feature<any>) input GeoJSON feature(s)

Examples

var polygon = {
  "type": "Feature",
  "properties": {},
  "geometry": {
    "type": "Polygon",
    "coordinates": [
      [
        [125, -15],
        [113, -22],
        [117, -37],
        [130, -33],
        [148, -39],
        [154, -27],
        [144, -15],
        [125, -15]
      ]
    ]
  }
}
var area = turf.area(polygon);
//=area => square meters
//=polygon

Returns number area in square meters

---

This module is part of the Turfjs project, an open source module collection dedicated to geographic algorithms. It is maintained in the Turfjs/turf repository, where you can create PRs and issues.

Installation

Install this module individually:

$ npm install @turf/area

Or install the Turf module that includes it as a function:

$ npm install @turf/turf