geemap

library0.38.2pypypi✓ verified 85d ago

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).

gcp data web-framework

pip install geemap

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · GEEMAP

geemap

gcppythonv0.38.2

Install

25.7s avg

Import

12642ms

Disk

569MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v0.37.2 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 12.900s · 552.7MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 25.7s · import 12.384s · 560MB

569MB installed

● package 569MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Map

✓ from geemap import Map

✗ import geemap; m = geemap.Map()

Both work, but from import is preferred.

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

Debug

Known issues

gotchageemap 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.

affects: all

gotchaThe 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.

affects: >0.30

deprecatedSome 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.

affects: >0.35

breakingIn 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.

affects: >=0.37.0

Errors

Common errors & fixes

ee.ee_exception.EEException: Earth Engine authentication required.

You haven't authenticated or initialized Earth Engine.

fix

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

ModuleNotFoundError: No module named 'geemap'

geemap is not installed or the environment is not activated.

fix

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

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

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`.

Upgrade

Version history

0.38.2latest on PyPI · released Jun 18, 2026

Audit

Dependencies

google-api-python-clientrequiredRequired for Google Earth Engine authentication and API calls

earthengine-apirequiredPython client for Google Earth Engine

Agent activity

33 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/gee-community/geemap ↗

packagehttps://pypi.org/project/geemap/ ↗

homepagehttps://geemap.org ↗