AI-generated Key Takeaways
-
The
convexHull()
method returns the smallest convex Geometry that contains all the points in the input geometry. -
It can be applied to any Geometry object, but is most commonly used with MultiPoint objects.
-
The result can be a Point, a LineString, or a Polygon depending on the input geometry.
-
Optional parameters
maxError
andproj
allow control over reprojection and the coordinate system used for calculations.
Usage | Returns |
---|---|
MultiPoint.convexHull(maxError, proj) | Geometry |
Argument | Type | Details |
---|---|---|
this: geometry | Geometry | Calculates the convex hull of this geometry. |
maxError | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |
proj | Projection, default: null | The projection in which to perform the operation. If not specified, the operation will be performed in a spherical coordinate system, and linear distances will be in meters on the sphere. |
Examples
Code Editor (JavaScript)
// Define a MultiPoint object. var multiPoint = ee.Geometry.MultiPoint([[-122.082, 37.420], [-122.081, 37.426]]); // Apply the convexHull method to the MultiPoint object. var multiPointConvexHull = multiPoint.convexHull({'maxError': 1}); // Print the result to the console. print('multiPoint.convexHull(...) =', multiPointConvexHull); // Display relevant geometries on the map. Map.setCenter(-122.085, 37.422, 15); Map.addLayer(multiPoint, {'color': 'black'}, 'Geometry [black]: multiPoint'); Map.addLayer(multiPointConvexHull, {'color': 'red'}, 'Result [red]: multiPoint.convexHull');
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 convexHull method to the MultiPoint object. multipoint_convex_hull = multipoint.convexHull(maxError=1) # Print the result. display('multipoint.convexHull(...) =', multipoint_convex_hull) # 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.add_layer( multipoint_convex_hull, {'color': 'red'}, 'Result [red]: multipoint.convexHull', ) m