AI-generated Key Takeaways
-
This function calculates and returns the area of a given geometry.
-
The area of points and line strings is always 0, while the area of multi-geometries is the sum of their component areas.
-
The returned area is in square meters by default, but can be calculated in the units of a specified projection using the
proj
parameter. -
Intersecting areas within multi-geometries are counted multiple times in the total area calculation.
Usage | Returns |
---|---|
MultiPoint.area(maxError, proj) | Float |
Argument | Type | Details |
---|---|---|
this: geometry | Geometry | The geometry input. |
maxError | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |
proj | Projection, default: null | If 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 MultiPoint object. var multiPoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]]); // Apply the area method to the MultiPoint object. var multiPointArea = multiPoint.area({'maxError': 1}); // Print the result to the console. print('multiPoint.area(...) =', multiPointArea); // Display relevant geometries on the map. Map.setCenter(-122.085, 37.422, 15); Map.addLayer(multiPoint, {'color': 'black'}, 'Geometry [black]: multiPoint');
import ee import geemap.core as geemap
Colab (Python)
# Define a MultiPoint object. multipoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]]) # Apply the area method to the MultiPoint object. multipoint_area = multipoint.area(maxError=1) # Print the result. display('multipoint.area(...) =', multipoint_area) # Display relevant geometries on the map. m = geemap.Map() m.set_center(-122.085, 37.422, 15) m.add_layer(multipoint, {'color': 'black'}, 'Geometry [black]: multipoint') m