AI-generated Key Takeaways
-
The centroid method returns a point at the center of the highest-dimension components of a geometry, ignoring lower-dimensional components.
-
This method can be applied to a MultiLineString geometry to find its centroid.
-
The centroid method takes optional
maxErrorandprojarguments to specify the maximum tolerated error during reprojection and the desired output projection, respectively. -
The default output projection for the centroid is EPSG:4326.
-
The result of the centroid method is a Geometry object.
| Usage | Returns |
|---|---|
MultiLineString.
centroid
( maxError
, proj
)
|
Geometry |
| Argument | Type | Details |
|---|---|---|
|
this:
geometry
|
Geometry | Calculates the centroid of this geometry. |
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 this projection. Otherwise it will be in EPSG:4326. |
Examples
Code Editor (JavaScript)
// Define a MultiLineString object. var multiLineString = ee . Geometry . MultiLineString ( [[[ - 122.088 , 37.418 ], [ - 122.086 , 37.422 ], [ - 122.082 , 37.418 ]], [[ - 122.087 , 37.416 ], [ - 122.083 , 37.416 ], [ - 122.082 , 37.419 ]]]); // Apply the centroid method to the MultiLineString object. var multiLineStringCentroid = multiLineString . centroid ({ 'maxError' : 1 }); // Print the result to the console. print ( 'multiLineString.centroid(...) =' , multiLineStringCentroid ); // Display relevant geometries on the map. Map . setCenter ( - 122.085 , 37.422 , 15 ); Map . addLayer ( multiLineString , { 'color' : 'black' }, 'Geometry [black]: multiLineString' ); Map . addLayer ( multiLineStringCentroid , { 'color' : 'red' }, 'Result [red]: multiLineString.centroid' );
import ee import geemap.core as geemap
Colab (Python)
# Define a MultiLineString object. multilinestring = ee . Geometry . MultiLineString ([ [[ - 122.088 , 37.418 ], [ - 122.086 , 37.422 ], [ - 122.082 , 37.418 ]], [[ - 122.087 , 37.416 ], [ - 122.083 , 37.416 ], [ - 122.082 , 37.419 ]], ]) # Apply the centroid method to the MultiLineString object. multilinestring_centroid = multilinestring . centroid ( maxError = 1 ) # Print the result. display ( 'multilinestring.centroid(...) =' , multilinestring_centroid ) # Display relevant geometries on the map. m = geemap . Map () m . set_center ( - 122.085 , 37.422 , 15 ) m . add_layer ( multilinestring , { 'color' : 'black' }, 'Geometry [black]: multilinestring' ) m . add_layer ( multilinestring_centroid , { 'color' : 'red' }, 'Result [red]: multilinestring.centroid' , ) m
