Announcement: All noncommercial projects registered to use Earth Engine before
April 15, 2025 must
verify noncommercial eligibility to maintain Earth Engine access.
ui.Map.DrawingTools.addLayer
Stay organized with collections
Save and categorize content based on your preferences.
Adds a given list of ee.Geometry objects to the drawing tools as a geometry layer.
Returns the new geometry layer.
| Usage | Returns | DrawingTools.addLayer(geometries, name, color, shown, locked) | ui.Map.GeometryLayer |
| Argument | Type | Details | this: ui.map.drawingtools | ui.Map.DrawingTools | The ui.Map.DrawingTools instance. |
geometries | List<Geometry> | The geometries with which to initialize the layer. |
name | String, optional | The name of the layer. |
color | String, optional | The CSS color of shapes in the layer, for instance
"white" or "#FFFFFF". |
shown | Boolean, optional | Whether to show the shapes in the layer. Defaults to true. |
locked | Boolean, optional | Whether to lock shape editing in the layer. Defaults to false. |
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 2025-07-08 UTC.
[null,null,["Last updated 2025-07-08 UTC."],[[["\u003cp\u003eThe \u003ccode\u003eDrawingTools.addLayer()\u003c/code\u003e function adds a list of Earth Engine Geometry objects to the drawing tools as a new layer.\u003c/p\u003e\n"],["\u003cp\u003eThe function allows customization of the layer's name, color, visibility, and editability.\u003c/p\u003e\n"],["\u003cp\u003eUsers receive the newly created \u003ccode\u003eui.Map.GeometryLayer\u003c/code\u003e object, enabling further interaction with it.\u003c/p\u003e\n"],["\u003cp\u003eBy default, the added layer is visible and unlocked for editing.\u003c/p\u003e\n"]]],["The `DrawingTools.addLayer` method adds a list of `ee.Geometry` objects to the drawing tools, creating a new geometry layer. It accepts a list of geometries, an optional layer name, an optional CSS color for the shapes, a boolean to control visibility (default true), and a boolean to lock shape editing (default false). It returns a `ui.Map.GeometryLayer` representing the newly created layer.\n"],null,["# ui.Map.DrawingTools.addLayer\n\n\u003cbr /\u003e\n\nAdds a given list of ee.Geometry objects to the drawing tools as a geometry layer.\n\n\u003cbr /\u003e\n\nReturns the new geometry layer.\n\n| Usage | Returns |\n|------------------------------------------------------------------------------------|----------------------|\n| DrawingTools.addLayer`(geometries, `*name* `, `*color* `, `*shown* `, `*locked*`)` | ui.Map.GeometryLayer |\n\n| Argument | Type | Details |\n|-----------------------------|---------------------|--------------------------------------------------------------------------|\n| this: `ui.map.drawingtools` | ui.Map.DrawingTools | The ui.Map.DrawingTools instance. |\n| `geometries` | List\\\u003cGeometry\\\u003e | The geometries with which to initialize the layer. |\n| `name` | String, optional | The name of the layer. |\n| `color` | String, optional | The CSS color of shapes in the layer, for instance \"white\" or \"#FFFFFF\". |\n| `shown` | Boolean, optional | Whether to show the shapes in the layer. Defaults to true. |\n| `locked` | Boolean, optional | Whether to lock shape editing in the layer. Defaults to false. |"]]