ee.Geometry.LineString.area

  • The area() method returns the area of a geometry, with points and line strings having an area of 0.

  • For multi-geometries, the area is the sum of their component areas, including intersecting areas.

  • The area() method takes optional arguments maxError for reprojection tolerance and proj to specify the output coordinate system units.

 Returns the area of the geometry. Area of points and line strings is 0 and the area of multi geometries is the sum of the areas of their components (intersecting areas are counted multiple times).

UsageReturns
LineString.area(maxError, proj)Float
ArgumentTypeDetails
this: geometryGeometryThe geometry input.
maxErrorErrorMargin, default: nullThe maximum amount of error tolerated when performing any necessary reprojection.
projProjection, default: nullIf specified, the result will be in the units of the coordinate system of this projection. Otherwise it will be in square meters.

Examples

Code Editor (JavaScript)

// Define a LineString object.
var lineString = ee.Geometry.LineString([[-122.09, 37.42], [-122.08, 37.43]]);

// Apply the area method to the LineString object.
var lineStringArea = lineString.area({'maxError': 1});

// Print the result to the console.
print('lineString.area(...) =', lineStringArea);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(lineString,
             {'color': 'black'},
             'Geometry [black]: lineString');

Python setup

See the Python Environment page for information on the Python API and using geemap for interactive development.

import ee
import geemap.core as geemap

Colab (Python)

# Define a LineString object.
linestring = ee.Geometry.LineString([[-122.09, 37.42], [-122.08, 37.43]])

# Apply the area method to the LineString object.
linestring_area = linestring.area(maxError=1)

# Print the result.
display('linestring.area(...) =', linestring_area)

# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(linestring, {'color': 'black'}, 'Geometry [black]: linestring')
m