Page Summary
-
The
convexHullmethod returns the convex hull of a given geometry. -
The resulting geometry type depends on the input: a point for a single point, a line for collinear points, and a polygon for other cases.
-
The method can take optional
maxErrorandprojarguments for controlling reprojection tolerance and the coordinate system.
| Usage | Returns |
|---|---|
Point.
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 Point object. var point = ee . Geometry . Point ( - 122.082 , 37.42 ); // Apply the convexHull method to the Point object. var pointConvexHull = point . convexHull ({ 'maxError' : 1 }); // Print the result to the console. print ( 'point.convexHull(...) =' , pointConvexHull ); // Display relevant geometries on the map. Map . setCenter ( - 122.085 , 37.422 , 15 ); Map . addLayer ( point , { 'color' : 'black' }, 'Geometry [black]: point' ); Map . addLayer ( pointConvexHull , { 'color' : 'red' }, 'Result [red]: point.convexHull' );
import ee import geemap.core as geemap
Colab (Python)
# Define a Point object. point = ee . Geometry . Point ( - 122.082 , 37.42 ) # Apply the convexHull method to the Point object. point_convex_hull = point . convexHull ( maxError = 1 ) # Print the result. display ( 'point.convexHull(...) =' , point_convex_hull ) # Display relevant geometries on the map. m = geemap . Map () m . set_center ( - 122.085 , 37.422 , 15 ) m . add_layer ( point , { 'color' : 'black' }, 'Geometry [black]: point' ) m . add_layer ( point_convex_hull , { 'color' : 'red' }, 'Result [red]: point.convexHull' ) m
