127 create legend

Uncomment the following line to install geemap if needed.

In [ ]:

# !pip install -U geemap

# !pip install -U geemap

In [ ]:

import geemap

import geemap

Create a built-in draggable legend. Specify the output parameter to save the legend as an HTML file.

In [ ]:

geemap.create_legend(
    title="NLCD Land Cover Type",
    builtin_legend="NLCD",
    draggable=True,
    output="NLCD_legend.html",
)

geemap.create_legend( title="NLCD Land Cover Type", builtin_legend="NLCD", draggable=True, output="NLCD_legend.html", )

Create a built-in non-draggable legend. If the output parameter is not specified, the legend will be returned as an HTML string.

In [ ]:

html = geemap.create_legend(
    title="NLCD Land Cover Type",
    builtin_legend="NLCD",
    draggable=False,
    position="bottomright",
)

html = geemap.create_legend( title="NLCD Land Cover Type", builtin_legend="NLCD", draggable=False, position="bottomright", )

In [ ]:

widget = geemap.show_html(html)
widget

widget = geemap.show_html(html) widget

In [ ]:

widget.close()

widget.close()

Create a custom legend.

In [ ]:

legend_dict = {
    "10 Trees": "006400",
    "20 Shrubland": "ffbb22",
    "30 Grassland": "ffff4c",
    "40 Cropland": "f096ff",
    "50 Built-up": "fa0000",
    "60 Barren / sparse vegetation": "b4b4b4",
    "70 Snow and ice": "f0f0f0",
    "80 Open water": "0064c8",
    "90 Herbaceous wetland": "0096a0",
    "95 Mangroves": "00cf75",
    "100 Moss and lichen": "fae6a0",
}

legend_dict = { "10 Trees": "006400", "20 Shrubland": "ffbb22", "30 Grassland": "ffff4c", "40 Cropland": "f096ff", "50 Built-up": "fa0000", "60 Barren / sparse vegetation": "b4b4b4", "70 Snow and ice": "f0f0f0", "80 Open water": "0064c8", "90 Herbaceous wetland": "0096a0", "95 Mangroves": "00cf75", "100 Moss and lichen": "fae6a0", }

In [ ]:

geemap.create_legend(
    title="ESA Land Cover Type",
    legend_dict=legend_dict,
    draggable=False,
    output="ESA_legend.html",
)

geemap.create_legend( title="ESA Land Cover Type", legend_dict=legend_dict, draggable=False, output="ESA_legend.html", )

Customize the legend by specifying the style parameter.

In [ ]:

m = geemap.Map()
m.add_basemap("ESA WorldCover 2021")

style = {
    "position": "fixed",
    "z-index": "9999",
    "border": "2px solid grey",
    "background-color": "rgba(255, 255, 255, 0.8)",
    "border-radius": "10px",
    "padding": "5px",
    "font-size": "14px",
    "bottom": "20px",
    "right": "5px",
}

m.add_legend(
    title="ESA Land Cover Type", legend_dict=legend_dict, draggable=False, style=style
)
m

m = geemap.Map() m.add_basemap("ESA WorldCover 2021") style = { "position": "fixed", "z-index": "9999", "border": "2px solid grey", "background-color": "rgba(255, 255, 255, 0.8)", "border-radius": "10px", "padding": "5px", "font-size": "14px", "bottom": "20px", "right": "5px", } m.add_legend( title="ESA Land Cover Type", legend_dict=legend_dict, draggable=False, style=style ) m

Add a legend to the map.

In [ ]:

m = geemap.Map()
m.add_basemap("ESA WorldCover 2021")
m.add_legend(title="ESA Land Cover Type", builtin_legend="ESA_WorldCover")
m

m = geemap.Map() m.add_basemap("ESA WorldCover 2021") m.add_legend(title="ESA Land Cover Type", builtin_legend="ESA_WorldCover") m

Add legends to a split-view map. Make sure the draggable parameter is set to False.

In [ ]:

m = geemap.Map(
    center=[40, -100],
    zoom=4,
    draw_control=False,
    measure_control=False,
    scale_control=False,
)
m.split_map(left_layer="ESA WorldCover 2021", right_layer="NLCD 2019 CONUS Land Cover")
m.add_legend(
    title="ESA Land Cover Type",
    builtin_legend="ESA_WorldCover",
    draggable=False,
    position="bottomleft",
    style={"bottom": "5px"},
)
m.add_legend(
    title="NLCD Land Cover Type",
    builtin_legend="NLCD",
    draggable=False,
    position="bottomright",
)
m

m = geemap.Map( center=[40, -100], zoom=4, draw_control=False, measure_control=False, scale_control=False, ) m.split_map(left_layer="ESA WorldCover 2021", right_layer="NLCD 2019 CONUS Land Cover") m.add_legend( title="ESA Land Cover Type", builtin_legend="ESA_WorldCover", draggable=False, position="bottomleft", style={"bottom": "5px"}, ) m.add_legend( title="NLCD Land Cover Type", builtin_legend="NLCD", draggable=False, position="bottomright", ) m