Announcement: All noncommercial projects registered to use Earth Engine beforeApril 15, 2025 mustverify noncommercial eligibility to maintain access. If you have not verified by September 26, 2025, your access may be on hold.

Map.add

  • TheMap.add(item) method adds an item, which can be a widget likeui.Label or a non-widget object likeui.Map.Layer, to the map.

  • This method is used to add various UI elements such as labels, selectors, buttons, and map layers to aui.Map object.

  • TheMap.add() method returns the updatedui.Map object itself.

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.

UsageReturns
Map.add(item)ui.Map
ArgumentTypeDetails
itemObjectThe item to add.

Examples

Code Editor (JavaScript)

// 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.vardefaultMap=Map;// ui.Map objects can be constructed. Here, a new map is declared.varnewMap=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.vargeom=ee.Geometry.Point(-122.0841,37.4223);vargeomLayer=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 theCreative Commons Attribution 4.0 License, and code samples are licensed under theApache 2.0 License. For details, see theGoogle Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.

Last updated 2023-10-06 UTC.