ee.Geometry.MultiLineString.edgesAreGeodesics

  • edgesAreGeodesics() is a method used to determine if the edges of a MultiLineString geometry are treated as geodesics (curved along the Earth's surface) or straight lines in the projection.

  • It returns true if the edges are geodesics and false if they are straight lines.

  • The method is applied to a MultiLineString geometry object and takes no arguments.

  • This function is useful for controlling how lines are displayed and analyzed in Earth Engine, especially when dealing with large distances or areas.

 Returns true if the geometry edges, if any, are geodesics along a spherical model of the earth; if false, any edges are straight lines in the projection.

UsageReturns
MultiLineString.edgesAreGeodesics()Boolean
ArgumentTypeDetails
this: geometryGeometry

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 edgesAreGeodesics method to the MultiLineString object.
var multiLineStringEdgesAreGeodesics = multiLineString.edgesAreGeodesics();

// Print the result to the console.
print('multiLineString.edgesAreGeodesics(...) =', multiLineStringEdgesAreGeodesics);

// 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 edgesAreGeodesics method to the MultiLineString object.
multilinestring_edges_are_geodesics = multilinestring.edgesAreGeodesics()

# Print the result.
display(
    'multilinestring.edgesAreGeodesics(...) =',
    multilinestring_edges_are_geodesics,
)

# 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