AI-generated Key Takeaways
-
The
cutLinesmethod converts LineString, MultiLineString, and LinearRing geometries into a MultiLineString by cutting them into parts no longer than a specified distance. -
Other geometry types are converted to an empty MultiLineString.
-
The method takes a list of distances along each LineString to determine where to cut.
-
Optional arguments include
maxErrorfor reprojection tolerance andprojfor the output projection and distance units.
| Usage | Returns |
|---|---|
LinearRing.
cutLines
(distances, maxError
, proj
)
|
Geometry |
| Argument | Type | Details |
|---|---|---|
|
this:
geometry
|
Geometry | Cuts the lines of this geometry. |
distances
|
List | Distances along each LineString to cut the line into separate pieces, measured in units of the given proj, or meters if proj is unspecified. |
maxError
|
ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |
proj
|
Projection, default: null | Projection of the result and distance measurements, or EPSG:4326 if unspecified. |
Examples
Code Editor (JavaScript)
// Define a LinearRing object. var linearRing = ee . Geometry . LinearRing ( [[ - 122.091 , 37.420 ], [ - 122.085 , 37.422 ], [ - 122.080 , 37.430 ]]); // Apply the cutLines method to the LinearRing object. var linearRingCutLines = linearRing . cutLines ({ 'distances' : [ 10 , 100 ], 'maxError' : 1 }); // Print the result to the console. print ( 'linearRing.cutLines(...) =' , linearRingCutLines ); // Display relevant geometries on the map. Map . setCenter ( - 122.085 , 37.422 , 15 ); Map . addLayer ( linearRing , { 'color' : 'black' }, 'Geometry [black]: linearRing' ); Map . addLayer ( linearRingCutLines , { 'color' : 'red' }, 'Result [red]: linearRing.cutLines' );
import ee import geemap.core as geemap
Colab (Python)
# Define a LinearRing object. linearring = ee . Geometry . LinearRing ( [[ - 122.091 , 37.420 ], [ - 122.085 , 37.422 ], [ - 122.080 , 37.430 ]] ) # Apply the cutLines method to the LinearRing object. linearring_cut_lines = linearring . cutLines ( distances = [ 10 , 100 ], maxError = 1 ) # Print the result. display ( 'linearring.cutLines(...) =' , linearring_cut_lines ) # Display relevant geometries on the map. m = geemap . Map () m . set_center ( - 122.085 , 37.422 , 15 ) m . add_layer ( linearring , { 'color' : 'black' }, 'Geometry [black]: linearring' ) m . add_layer ( linearring_cut_lines , { 'color' : 'red' }, 'Result [red]: linearring.cutLines' ) m
