Announcement : All noncommercial projects registered to use Earth Engine before April 15, 2025 must verify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

ee.Geometry.convexHull

AI-generated Key Takeaways

The convex hull of a geometry is returned by the convexHull method.
The result is a Geometry object, which can be a point, line, or polygon depending on the input.
Optional maxError and proj arguments can be used to control the calculation.
Examples are provided for both JavaScript and Python.

Returns the convex hull of the given geometry. The convex hull of a single point is the point itself, the convex hull of collinear points is a line, and the convex hull of everything else is a polygon. Note that a degenerate polygon with all vertices on the same line will result in a line segment.

Usage	Returns
`Geometry. 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 Geometry object. 
 var 
  
 geometry 
  
 = 
  
 ee 
 . 
 Geometry 
 ({ 
  
 'type' 
 : 
  
 'Polygon' 
 , 
  
 'coordinates' 
 : 
  
 [[[ 
 - 
 122.081 
 , 
  
 37.417 
 ], 
  
 [ 
 - 
 122.086 
 , 
  
 37.421 
 ], 
  
 [ 
 - 
 122.084 
 , 
  
 37.418 
 ], 
  
 [ 
 - 
 122.089 
 , 
  
 37.416 
 ]]] 
 }); 
 // Apply the convexHull method to the Geometry object. 
 var 
  
 geometryConvexHull 
  
 = 
  
 geometry 
 . 
 convexHull 
 ({ 
 'maxError' 
 : 
  
 1 
 }); 
 // Print the result to the console. 
 print 
 ( 
 'geometry.convexHull(...) =' 
 , 
  
 geometryConvexHull 
 ); 
 // Display relevant geometries on the map. 
 Map 
 . 
 setCenter 
 ( 
 - 
 122.085 
 , 
  
 37.422 
 , 
  
 15 
 ); 
 Map 
 . 
 addLayer 
 ( 
 geometry 
 , 
  
 { 
 'color' 
 : 
  
 'black' 
 }, 
  
 'Geometry [black]: geometry' 
 ); 
 Map 
 . 
 addLayer 
 ( 
 geometryConvexHull 
 , 
  
 { 
 'color' 
 : 
  
 'red' 
 }, 
  
 'Result [red]: geometry.convexHull' 
 );

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 Geometry object. 
 geometry 
 = 
 ee 
 . 
 Geometry 
 ({ 
 'type' 
 : 
 'Polygon' 
 , 
 'coordinates' 
 : 
 [[ 
 [ 
 - 
 122.081 
 , 
 37.417 
 ], 
 [ 
 - 
 122.086 
 , 
 37.421 
 ], 
 [ 
 - 
 122.084 
 , 
 37.418 
 ], 
 [ 
 - 
 122.089 
 , 
 37.416 
 ], 
 ]], 
 }) 
 # Apply the convexHull method to the Geometry object. 
 geometry_convex_hull 
 = 
 geometry 
 . 
 convexHull 
 ( 
 maxError 
 = 
 1 
 ) 
 # Print the result. 
 display 
 ( 
 'geometry.convexHull(...) =' 
 , 
 geometry_convex_hull 
 ) 
 # Display relevant geometries on the map. 
 m 
 = 
 geemap 
 . 
 Map 
 () 
 m 
 . 
 set_center 
 ( 
 - 
 122.085 
 , 
 37.422 
 , 
 15 
 ) 
 m 
 . 
 add_layer 
 ( 
 geometry 
 , 
 { 
 'color' 
 : 
 'black' 
 }, 
 'Geometry [black]: geometry' 
 ) 
 m 
 . 
 add_layer 
 ( 
 geometry_convex_hull 
 , 
 { 
 'color' 
 : 
 'red' 
 }, 
 'Result [red]: geometry.convexHull' 
 ) 
 m

ee.Geometry.convexHull Stay organized with collections Save and categorize content based on your preferences.

AI-generated Key Takeaways

Examples

Code Editor (JavaScript)

Colab (Python)

ee.Geometry.convexHull