Skip to content

Installation

Earth Engine Account

To use geemap, you must first sign up for a Google Earth Engine account. You cannot use Google Earth Engine unless your application has been approved. Once you receive the application approval email, you can log in to the Earth Engine Code Editor to get familiar with the JavaScript API.

signup

Install from PyPI

geemap is available on PyPI. To install geemap, run this command in your terminal:

1
    pip install geemap

Install from conda-forge

geemap is also available on conda-forge. If you have Anaconda or Miniconda installed on your computer, you can install leafmap using the following command:

1
    conda install geemap -c conda-forge

The geemap package has an optional dependency - geopandas, which can be challenging to install on some computers, especially Windows. It is highly recommended that you create a fresh conda environment to install geopandas and geemap. Follow the commands below to set up a conda env and install geopandas, xarray_leaflet, and leafmap.

1
2
3
4
5
    conda create -n gee python=3.8
    conda activate gee
    conda install geopandas
    conda install mamba -c conda-forge
    mamba install geemap xarray_leaflet -c conda-forge

Optionally, you can install some Jupyter notebook extensions, which can improve your productivity in the notebook environment. Some useful extensions include Table of Contents, Gist-it, Autopep8, Variable Inspector, etc. See this post for more information.

1
    conda install jupyter_contrib_nbextensions -c conda-forge

Check the YouTube video below on how to install geemap using conda.

geemap

Install from GitHub

To install the development version from GitHub using Git, run the following command in your terminal:

1
    pip install git+https://github.com/giswqs/geemap

Upgrade geemap

If you have installed geemap before and want to upgrade to the latest version, you can run the following command in your terminal:

1
    pip install -U geemap

If you use conda, you can update geemap to the latest version by running the following command in your terminal:

1
    mamba update -c conda-forge geemap

To install the development version from GitHub directly within Jupyter notebook without using Git, run the following code:

1
2
    import geemap
    geemap.update_package()

Use Docker

To use geemap in a Docker container, check out the following docker containers with geemap installed.


Last update: 2021-10-26