Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ee.Geometry.BBox.closestPoints
Stay organized with collections
Save and categorize content based on your preferences.
Returns a dictionary containing up to two entries representing a point on each input geometry that is closest to the other input geometry. If either geometry is empty, an empty dictionary is returned. If both geometries are unbounded, the dictionary has an arbitrary point for both 'left' and 'right'. If one geometry is unbounded, the dictionary has an arbitrary point contained in the bounded geometry for both 'left' and 'right'.
| Usage | Returns | BBox.closestPoints(right, maxError, proj) | Object |
| 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. |
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2024-10-23 UTC.
[null,null,["Last updated 2024-10-23 UTC."],[[["\u003cp\u003eReturns a dictionary with points on each geometry closest to the other, useful for proximity analysis.\u003c/p\u003e\n"],["\u003cp\u003eHandles various geometry types, including empty and unbounded geometries, with specific behaviors for each.\u003c/p\u003e\n"],["\u003cp\u003eAllows customization of error tolerance (\u003ccode\u003emaxError\u003c/code\u003e) and projection (\u003ccode\u003eproj\u003c/code\u003e) for accurate results.\u003c/p\u003e\n"],["\u003cp\u003eAccessible via the \u003ccode\u003eclosestPoints\u003c/code\u003e method on a BBox (bounding box) object, taking the other geometry as input.\u003c/p\u003e\n"]]],["The function determines the closest points between two geometries (`left` and `right`). It returns a dictionary with up to two entries, representing a point from each geometry. Empty geometries result in an empty dictionary. Unbounded geometries lead to arbitrary points in the output. The operation can account for a maximum error (`maxError`) and be performed under a specific projection (`proj`). The function uses `BBox.closestPoints(right, maxError, proj)`.\n"],null,["# ee.Geometry.BBox.closestPoints\n\nReturns a dictionary containing up to two entries representing a point on each input geometry that is closest to the other input geometry. If either geometry is empty, an empty dictionary is returned. If both geometries are unbounded, the dictionary has an arbitrary point for both 'left' and 'right'. If one geometry is unbounded, the dictionary has an arbitrary point contained in the bounded geometry for both 'left' and 'right'.\n\n\u003cbr /\u003e\n\n| Usage | Returns |\n|------------------------------------------------------|---------|\n| BBox.closestPoints`(right, `*maxError* `, `*proj*`)` | Object |\n\n| Argument | Type | Details |\n|--------------|----------------------------|---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| this: `left` | Geometry | The geometry used as the left operand of the operation. |\n| `right` | Geometry | The geometry used as the right operand of the operation. |\n| `maxError` | ErrorMargin, default: null | The maximum amount of error tolerated when performing any necessary reprojection. |\n| `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. |"]]