Google Earth Engine Plugin for QGIS

The QGIS Earth Engine Plugin integrates Google Earth Engine with QGIS using the EE Python API.

📖 User Guide 💬 Discussions & Support 🐞 Issue Tracker

---

🚀 Quickstart Guide

1️⃣ Install the Plugin

• Open QGIS Plugin Manager (Plugins > Manage and Install Plugins).
• Search for "Google Earth Engine" and install it.

2️⃣ Find Your Google Cloud Project ID

Google Earth Engine requires a Google Cloud Project. To find your Project ID:

• Go to the Google Cloud Console.
• Your Project ID is visible in the URL or can be selected from the resource list.
• For more details, refer to the official Google Cloud Project Management Guide.

3️⃣ Authenticate with your project ID

• Select the sign-in under Plugins > Google Earth Engine > Sign-In.
• Follow prompts to enter your project ID.

4️⃣ Use Earth Engine Directly in QGIS 🎉

Once the plugin is set up, you can start using Earth Engine within QGIS! Try adding a dataset:

import ee
from ee_plugin import Map

# Load an elevation dataset
image = ee.Image('USGS/SRTMGL1_003')

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

# Add the image layer to QGIS
Map.addLayer(image, vis_params, 'Digital Elevation Model')
Map.setCenter(-121.753, 46.855, 9)

---

🗺️ Map Functions

The plugin supports several Map API functions similar to the Earth Engine Code Editor:

Function	Description
Map.addLayer(eeObject, visParams, name, shown, opacity)	Adds a dataset to QGIS.
Map.centerObject(object, zoom)	Centers the map on an object.
Map.getBounds(asGeoJSON)	Returns map bounds.
Map.getCenter()	Gets the current center of the map.
Map.setCenter(lon, lat, zoom)	Moves the center of the map.
Map.getScale()	Returns the current map scale.
Map.getZoom()	Returns the current zoom level.
Map.setZoom(zoom)	Sets a new zoom level.

For more details, check the EE API Documentation.

---

❓ Troubleshooting

Resetting Authentication

If you experience authentication issues:

• Run earthengine authenticate again.
• Delete the credentials file and restart QGIS:
  • Windows: C:\Users\<USER>\.config\earthengine\credentials
  • Linux: /home/<USER>/.config/earthengine/credentials
  • MacOS: /Users/<USER>/.config/earthengine/credentials

More on authentication troubleshooting: Earth Engine Guide.

Common Errors

Error	Solution
ModuleNotFoundError: No module named 'ee_plugin'	Ensure the plugin is installed via QGIS Plugin Manager.
earthengine authenticate fails	Run earthengine authenticate --quiet and restart QGIS.
ssl.SSLError: [SSL: CERTIFICATE_VERIFY_FAILED]	On MacOS, run /Applications/Python 3.x/Install Certificates.command.
Plugin crashes after authentication	Ensure your IP is not blocked by a firewall. Check code.earthengine.google.com.

---

🤝 Contributing

We warmly welcome contributions! If you'd like to contribute:

1. Check out CONTRIBUTING.md for setup instructions.
2. Ensure your contribution relates to an existing issue or discussion.
3. Open a pull request or issue before starting major changes.

For questions, contact the original author: gennadiy.donchyts@gmail.com.

For feature requests and updates, please check the GitHub Issues and Discussions.

Thank you for helping improve the QGIS Earth Engine Plugin!