AI-generated Key Takeaways
-
The
Geometry.distancemethod returns the minimum distance between two geometries as a Float. -
The method takes
right(the second geometry), optionalmaxError, optionalprojfor projection, and optionalsphericalparameters. -
The
maxErrorparameter specifies the maximum tolerated error during reprojection. -
The
projparameter specifies the projection to use; otherwise, it defaults to a spherical coordinate system. -
The
sphericalparameter determines whether calculations are done on a unit sphere or elliptically, and it is ignored ifprojis specified.
| Usage | Returns |
|---|---|
Geometry.
distance
(right, maxError
, proj
, spherical
)
|
Float |
| 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. |
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. |
spherical
|
Boolean, default: false | If true, the calculation will be done on the unit sphere. If false, the calculation will be elliptical, taking earth flattening into account. Ignored if proj is specified. Default is false. |
Examples
Code Editor (JavaScript)
// Define a Geometry object. var geometry = ee . Geometry ({ 'type' : 'Polygon' , 'coordinates' : [[[ - 122.081 , 37.417 ], [ - 122.086 , 37.421 ], [ - 122.084 , 37.418 ], [ - 122.089 , 37.416 ]]] }); // Define other inputs. var inputGeom = ee . Geometry . Point ( - 122.090 , 37.423 ); // Apply the distance method to the Geometry object. var geometryDistance = geometry . distance ({ 'right' : inputGeom , 'maxError' : 1 }); // Print the result to the console. print ( 'geometry.distance(...) =' , geometryDistance ); // Display relevant geometries on the map. Map . setCenter ( - 122.085 , 37.422 , 15 ); Map . addLayer ( geometry , { 'color' : 'black' }, 'Geometry [black]: geometry' ); Map . addLayer ( inputGeom , { 'color' : 'blue' }, 'Parameter [blue]: inputGeom' );
import ee import geemap.core as geemap
Colab (Python)
# Define a Geometry object. geometry = ee . Geometry ({ 'type' : 'Polygon' , 'coordinates' : [[ [ - 122.081 , 37.417 ], [ - 122.086 , 37.421 ], [ - 122.084 , 37.418 ], [ - 122.089 , 37.416 ], ]], }) # Define other inputs. input_geom = ee . Geometry . Point ( - 122.090 , 37.423 ) # Apply the distance method to the Geometry object. geometry_distance = geometry . distance ( right = input_geom , maxError = 1 ) # Print the result. display ( 'geometry.distance(...) =' , geometry_distance ) # Display relevant geometries on the map. m = geemap . Map () m . set_center ( - 122.085 , 37.422 , 15 ) m . add_layer ( geometry , { 'color' : 'black' }, 'Geometry [black]: geometry' ) m . add_layer ( input_geom , { 'color' : 'blue' }, 'Parameter [blue]: input_geom' ) m
