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 isntall geopandas, xarray_leaflet, and leafmap.

    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.

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-07-29