ee.Geometry.Rectangle.geodesic

  • The geodesic() method, when applied to a Rectangle geometry, determines whether the edges of the rectangle are rendered as straight lines or curved lines following the Earth's curvature.

  • If geodesic() returns false, the rectangle edges appear straight on the map projection, while a true value results in curved edges that represent the shortest path on the Earth's surface.

  • This method is accessible for Rectangle geometries in Earth Engine and can be used in both JavaScript and Python environments.

  • Examples demonstrate how to utilize the geodesic() method and visualize the results on a map using the Earth Engine API.

 If false, edges are straight in the projection. If true, edges are curved to follow the shortest path on the surface of the Earth.

UsageReturns
Rectangle.geodesic()Boolean
ArgumentTypeDetails
this: geometryGeometry

Examples

Code Editor (JavaScript)

// Define a Rectangle object.
var rectangle = ee.Geometry.Rectangle(-122.09, 37.42, -122.08, 37.43);

// Apply the geodesic method to the Rectangle object.
var rectangleGeodesic = rectangle.geodesic();

// Print the result to the console.
print('rectangle.geodesic(...) =', rectangleGeodesic);

// Display relevant geometries on the map.
Map.setCenter(-122.085, 37.422, 15);
Map.addLayer(rectangle,
             {'color': 'black'},
             'Geometry [black]: rectangle');

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 Rectangle object.
rectangle = ee.Geometry.Rectangle(-122.09, 37.42, -122.08, 37.43)

# Apply the geodesic method to the Rectangle object.
rectangle_geodesic = rectangle.geodesic()

# Print the result.
display('rectangle.geodesic(...) =', rectangle_geodesic)

# Display relevant geometries on the map.
m = geemap.Map()
m.set_center(-122.085, 37.422, 15)
m.add_layer(rectangle, {'color': 'black'}, 'Geometry [black]: rectangle')
m