Page Summary
-
The
lengthmethod returns the length of the linear parts of a geometry, ignoring polygonal parts. -
For multi geometries, the length is the sum of the lengths of their components.
-
The method takes optional
maxErrorandprojarguments to control reprojection error and the output units. -
The result is returned as a Float representing the length.
| Usage | Returns |
|---|---|
LineString.
length
( maxError
, proj
)
|
Float |
| Argument | Type | Details |
|---|---|---|
|
this:
geometry
|
Geometry | The input 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 the units of the coordinate system of this projection. Otherwise it will be in meters. |
Examples
Code Editor (JavaScript)
// Define a LineString object. var lineString = ee . Geometry . LineString ([[ - 122.09 , 37.42 ], [ - 122.08 , 37.43 ]]); // Apply the length method to the LineString object. var lineStringLength = lineString . length (); // Print the result to the console. print ( 'lineString.length(...) =' , lineStringLength ); // Display relevant geometries on the map. Map . setCenter ( - 122.085 , 37.422 , 15 ); Map . addLayer ( lineString , { 'color' : 'black' }, 'Geometry [black]: lineString' );
import ee import geemap.core as geemap
Colab (Python)
# Define a LineString object. linestring = ee . Geometry . LineString ([[ - 122.09 , 37.42 ], [ - 122.08 , 37.43 ]]) # Apply the length method to the LineString object. linestring_length = linestring . length () # Print the result. display ( 'linestring.length(...) =' , linestring_length ) # Display relevant geometries on the map. m = geemap . Map () m . set_center ( - 122.085 , 37.422 , 15 ) m . add_layer ( linestring , { 'color' : 'black' }, 'Geometry [black]: linestring' ) m
