geemap

0.37.2 verified Fri May 01 auth: no python

A Python package for interactive mapping with Google Earth Engine (GEE) and ipyleaflet. It provides a high-level API for creating interactive maps, analyzing geospatial data, and building GIS applications. Current version: 0.37.2, released frequently (monthly or weekly).

pip install geemap

Common errors

error ee.ee_exception.EEException: Earth Engine authentication required. ↓

cause You haven't authenticated or initialized Earth Engine.

fix

Run ee.Authenticate() then ee.Initialize() or use the command line: earthengine authenticate.

error ModuleNotFoundError: No module named 'geemap' ↓

cause geemap is not installed or the environment is not activated.

fix

Install with pip install geemap or conda install -c conda-forge geemap.

error ImportError: cannot import name 'Map' from 'geemap' ↓

cause Possibly an outdated version of geemap where Map was in a submodule or imported differently.

fix

Ensure geemap is updated to the latest version: pip install --upgrade geemap. Then use from geemap import Map.

Warnings

gotcha geemap requires the Earth Engine Python API (earthengine-api) and authentication. First run `earthengine authenticate` or `ee.Authenticate()` and `ee.Initialize()`. ↓

fix Run `earthengine authenticate` in the terminal or use `ee.Authenticate()` in the notebook.

gotcha The default backend is ipyleaflet. For faster performance, you can switch to the folium or mapboxgl backend via `geemap.set_projection()` or environment variables. ↓

fix Use `geemap.set_backend('folium')` before creating a Map.

deprecated Some old API functions like `geemap.legend()` have been deprecated in favor of `Map.add_legend()`. ↓

fix Use `m.add_legend()` on a Map instance instead.

breaking In version 0.37.0, the minimum Python version was raised to 3.10. Older Python versions are no longer supported. ↓

fix Upgrade Python to 3.10 or later.

Install

conda install -c conda-forge geemap

Imports

Map

wrong

import geemap; m = geemap.Map()

correct

from geemap import Map

Both work, but from import is preferred.

Quickstart

Creates an interactive map and adds a Landsat 8 image layer from Earth Engine.

import ee
import geemap

# If not already authenticated, use ee.Authenticate()
# ee.Initialize()

# Create a map
m = geemap.Map()

# Add a sample dataset (e.g., Landsat composite)
image = ee.Image('LANDSAT/LC08/C01/T1_TOA/LC08_044034_20140318')
vis_params = {'bands': ['B4', 'B3', 'B2'], 'max': 0.3}
m.addLayer(image, vis_params, 'Landsat 8')

# Display the map
m