ee.Geometry.MultiLineString.length

  • The length method calculates the length of the linear parts of a geometry, ignoring polygonal parts.

  • The length of multi geometries is the sum of the lengths of their component linear parts.

  • The method takes optional maxError and proj arguments to control the accuracy of reprojection and the units of the result.

  • The method returns a float representing the calculated length.

Returns the length of the linear parts of the geometry. Polygonal parts are ignored. The length of multi geometries is the sum of the lengths of their components.
Usage Returns
MultiLineString. 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 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 length method to the MultiLineString object. 
 var 
  
 multiLineStringLength 
  
 = 
  
 multiLineString 
 . 
 length 
 (); 
 // Print the result to the console. 
 print 
 ( 
 'multiLineString.length(...) =' 
 , 
  
 multiLineStringLength 
 ); 
 // Display relevant geometries on the map. 
 Map 
 . 
 setCenter 
 ( 
 - 
 122.085 
 , 
  
 37.422 
 , 
  
 15 
 ); 
 Map 
 . 
 addLayer 
 ( 
 multiLineString 
 , 
  
 { 
 'color' 
 : 
  
 'black' 
 }, 
  
 'Geometry [black]: multiLineString' 
 ); 

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 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 length method to the MultiLineString object. 
 multilinestring_length 
 = 
 multilinestring 
 . 
 length 
 () 
 # Print the result. 
 display 
 ( 
 'multilinestring.length(...) =' 
 , 
 multilinestring_length 
 ) 
 # 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 
Create a Mobile Website
View Site in Mobile | Classic
Share by: