geemap 0.1.7

A Python package for interactive mapping using Google Earth Engine and ipyleaflet

geemap

Authors: Dr. Qiusheng Wu (https://wetlands.io)

A Python package for interactive mapping using Google Earth Engine, ipyleaflet, and ipywidgets

• GitHub repo: https://github.com/giswqs/geemap

• Documentation: https://geemap.readthedocs.io

• PyPI: https://pypi.org/project/geemap/

• Free software: MIT license

Contents

• Features

• Installation

• Examples

• Dependencies

• Reporting Bugs

• Credits

Features

• Automatically convert Earth Engine JavaScripts to Python scripts and Jupyter Notebooks.

• Add Earth Engine tile layers to ipyleaflet map for interactive mapping.

• Capture user inputs and query Earth Engine objects.

• Plot charts bases on Earth Engine data

Installation

To install geemap , run this command in your terminal:

pip install geemap

If you have Anaconda or Miniconda installed on your computer, you can use create conda Python environment to install geemap:

conda create -n gee python
conda activate gee
pip install geemap

If you have installed geemap before and want to upgrade to the latest version, you can use the following command:

pip install geemap -U

Examples

Open a Jupyter notebook and paste the follow code to a notebook cell. Alternatively, you can run the code interactively with mybinder.org or binder.pangeo.io now:

import ee
import geemap

try:
        ee.Initialize()
except Exception as e:
        ee.Authenticate()
        ee.Initialize()

# Create an interactive map
Map = geemap.Map(center=(40, -100), zoom=4)
Map

# Add Earth Engine dataset
image = ee.Image('USGS/SRTMGL1_003')

# Set visualization parameters.
vis_params = {
        'min': 0,
        'max': 4000,
        'palette': ['006633', 'E5FFCC', '662A00', 'D8D8D8', 'F5F5F5']
}

# Print the elevation of Mount Everest.
xy = ee.Geometry.Point([86.9250, 27.9881])
elev = image.sample(xy, 30).first().get('elevation').getInfo()
print('Mount Everest elevation (m):', elev)

# Add Earth Engine layers to Map
Map.addLayer(image, vis_params, 'STRM DEM', True, 0.5)
Map.addLayer(xy, {'color': 'red'}, 'Mount Everest')

# Set center of the map
Map.centerObject(ee_object=xy, zoom=13)
Map.setCenter(lon=-100, lat=40, zoom=4)

Dependencies

• earthengine-api

• ipyleaflet

• ipywidgets

• folium

• bqplot

• ipynb-py-convert

Reporting Bugs

Report bugs at https://github.com/giswqs/geemap/issues.

If you are reporting a bug, please include:

• Your operating system name and version.

• Any details about your local setup that might be helpful in troubleshooting.

• Detailed steps to reproduce the bug.

Credits

This package was created with Cookiecutter and the audreyr/cookiecutter-pypackage project template.

History

0.1.0 (2020-03-08)

• First release on PyPI.