ui.Map.add
Adds an item to the map. Can also be used to add widgets like ui.Label as well as some non-widget objects like ui.Map.Layer.
Returns the map.
Usage | Returns |
---|
Map.add(item) | ui.Map |
Argument | Type | Details |
---|
this: ui.map | ui.Map | The ui.Map instance. |
item | Object | The item to add. |
Examples
// The default map in the Code Editor is a built-in ui.Map object called "Map".
// Let's refer to it as "defaultMap" for clarity.
var defaultMap = Map;
// ui.Map objects can be constructed. Here, a new map is declared.
var newMap = ui.Map({
center: {lat: 0, lon: 0, zoom: 1},
style: {position: 'bottom-right', width: '400px'}
});
// Add the newMap to the defaultMap;
defaultMap.add(newMap);
// Other UI widgets can be added to ui.Map objects, for example labels:
defaultMap.add(ui.Label('Default Map', {position: 'bottom-left'}));
newMap.add(ui.Label('New Map', {position: 'bottom-left'}));
// ...selectors:
defaultMap.add(ui.Select(['This', 'That', 'Other']));
// ...or buttons:
defaultMap.add(ui.Button('Click me'));
// You can also add ui.Map.Layer objects. Here, an ee.Geometry object
// is converted to a map layer and added to the default map.
var geom = ee.Geometry.Point(-122.0841, 37.4223);
var geomLayer = ui.Map.Layer(geom, {color: 'orange'}, 'Googleplex');
defaultMap.add(geomLayer);
defaultMap.centerObject(geom, 18);
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."],[[["`ui.Map.add()` inserts items like UI widgets (labels, buttons, selectors) and map layers onto a map."],["This method accepts the map and the item to be added as arguments, and subsequently returns the map itself."],["Developers can utilize this function to enhance map visualization by incorporating interactive elements and data layers directly within their maps."],["The provided examples illustrate adding a new map, labels, selectors, buttons, and geometry-based layers to the default or a newly created map."]]],["The `Map.add(item)` function adds an object to a `ui.Map` instance, returning the modified map. The `item` can be a `ui.Map` itself, UI widgets like `ui.Label`, `ui.Select`, or `ui.Button`, or objects like `ui.Map.Layer`. Examples demonstrate adding a new map, labels, selectors, buttons, and a geometry layer to an existing map. These are done using default and newly created maps. The new elements are added to the map using `defaultMap.add()`.\n"]]