Earth Engine is introducing
noncommercial quota tiers to safeguard shared compute resources and ensure reliable performance for everyone. All noncommercial projects will need to select a quota tier by
April 27, 2026 or will use the Community Tier by default. Tier quotas will take effect for all projects (regardless of tier selection date) on
April 27, 2026.
Learn more.
ui.Map.DrawingTools.onLayerSelect
Stay organized with collections
Save and categorize content based on your preferences.
Registers a callback that's fired when a layer is selected.
Returns an ID which can be passed to unlisten() to unregister the callback.
| Usage | Returns | DrawingTools.onLayerSelect(callback) | String |
| Argument | Type | Details | this: ui.map.drawingtools | ui.Map.DrawingTools | The ui.Map.DrawingTools instance. |
callback | Function | The callback to fire when a shape is selected. The callback is passed two parameters: the selected GeometryLayer (or null for deselect) and the ui.Map.DrawingTools widget that the event listener is bound to. |
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 2023-10-06 UTC.
[null,null,["Last updated 2023-10-06 UTC."],[],["A callback function is registered to be executed upon layer selection. The `onLayerSelect` method takes a callback as an argument, which receives the selected `GeometryLayer` (or null if deselected) and the `ui.Map.DrawingTools` instance. This method returns a unique string ID, enabling the callback to be unregistered later via the `unlisten()` method. The method's `ui.Map.DrawingTools` instance is implicitly bound to this.\n"]]