AI-generated Key Takeaways
-
The
withinDistancemethod returns true if two geometries are within a specified distance of each other. -
This method can be applied to a MultiLineString geometry.
-
The method requires a right geometry, a distance threshold, and optionally accepts a maximum error and projection.
-
The distance is measured in the units of the projected coordinate system if specified, otherwise in meters on the sphere.
| Usage | Returns |
|---|---|
MultiLineString.
withinDistance
(right, distance, maxError
, proj
)
|
Boolean |
| Argument | Type | Details |
|---|---|---|
|
this:
left
|
Geometry | The geometry used as the left operand of the operation. |
right
|
Geometry | The geometry used as the right operand of the operation. |
distance
|
Float | The distance threshold. If a projection is specified, the distance is in units of that projected coordinate system, otherwise it is in meters. |
maxError
|
ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |
proj
|
Projection, default: null | The projection in which to perform the operation. If not specified, the operation will be performed in a spherical coordinate system, and linear distances will be in meters on the sphere. |
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 ]]]); // Define other inputs. var inputGeom = ee . Geometry . Point ( - 122.090 , 37.423 ); // Apply the withinDistance method to the MultiLineString object. var multiLineStringWithinDistance = multiLineString . withinDistance ({ 'right' : inputGeom , 'distance' : 500 , 'maxError' : 1 }); // Print the result to the console. print ( 'multiLineString.withinDistance(...) =' , multiLineStringWithinDistance ); // Display relevant geometries on the map. Map . setCenter ( - 122.085 , 37.422 , 15 ); Map . addLayer ( multiLineString , { 'color' : 'black' }, 'Geometry [black]: multiLineString' ); Map . addLayer ( inputGeom , { 'color' : 'blue' }, 'Parameter [blue]: inputGeom' );
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 ]], ]) # Define other inputs. input_geom = ee . Geometry . Point ( - 122.090 , 37.423 ) # Apply the withinDistance method to the MultiLineString object. multilinestring_within_distance = multilinestring . withinDistance ( right = input_geom , distance = 500 , maxError = 1 ) # Print the result. display ( 'multilinestring.withinDistance(...) =' , multilinestring_within_distance ) # 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 . add_layer ( input_geom , { 'color' : 'blue' }, 'Parameter [blue]: input_geom' ) m
