https://github.com/gee-community/qgis-earthengine-plugin
Integrates Google Earth Engine and QGIS using Python API
https://github.com/gee-community/qgis-earthengine-plugin
Last synced: 7 months ago
JSON representation
Integrates Google Earth Engine and QGIS using Python API
- Host: GitHub
- URL: https://github.com/gee-community/qgis-earthengine-plugin
- Owner: gee-community
- License: mit
- Created: 2017-06-12T21:30:20.000Z (over 8 years ago)
- Default Branch: master
- Last Pushed: 2024-05-25T20:24:57.000Z (over 1 year ago)
- Last Synced: 2024-06-11T17:29:14.155Z (over 1 year ago)
- Language: Python
- Homepage: http://qgis-ee-plugin.appspot.com
- Size: 971 KB
- Stars: 435
- Watchers: 36
- Forks: 113
- Open Issues: 19
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
README
[](https://vshymanskyy.github.io/StandWithUkraine/)
# Google Earth Engine Plugin for QGIS
The **QGIS Earth Engine Plugin** integrates [Google Earth Engine](http://earthengine.google.com) with [QGIS](https://qgis.org/) using the [EE Python API](https://github.com/google/earthengine-api/tree/master/python).
📖 **[User Guide](https://gee-community.github.io/qgis-earthengine-plugin/)**
💬 **[Discussions & Support](https://github.com/gee-community/qgis-earthengine-plugin/discussions)**
🐞 **[Issue Tracker](https://github.com/gee-community/qgis-earthengine-plugin/issues)**
---
## 🚀 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](https://console.cloud.google.com/).
- 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](https://cloud.google.com/resource-manager/docs/creating-managing-projects).
### 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:
```python
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](https://developers.google.com/earth-engine/getstarted#adding-data-to-the-map).
---
## ❓ Troubleshooting
### Resetting Authentication
If you experience authentication issues:
- Run `earthengine authenticate` again.
- Delete the credentials file and restart QGIS:
- **Windows:** `C:\Users\\.config\earthengine\credentials`
- **Linux:** `/home//.config/earthengine/credentials`
- **MacOS:** `/Users//.config/earthengine/credentials`
More on authentication troubleshooting: [Earth Engine Guide](https://developers.google.com/earth-engine/guides/auth).
### 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](http://code.earthengine.google.com). |
| `SRE module mismatch` | Set `PYTHONPATH` to plugin extlibs (e.g. `export PYTHONPATH=~/Projects/qgis-earthengine-plugin/extlibs`) |
---
## 🤝 Contributing
We warmly welcome contributions! If you'd like to contribute:
1. Check out [CONTRIBUTING.md](CONTRIBUTING.md) for setup instructions.
2. Ensure your contribution relates to an existing [issue](https://github.com/gee-community/qgis-earthengine-plugin/issues) or discussion.
3. Open a pull request or issue before starting major changes.
For questions, contact the original author: [gennadiy.donchyts@gmail.com](mailto:gennadiy.donchyts@gmail.com).
For feature requests and updates, please check the [GitHub Issues](https://github.com/gee-community/qgis-earthengine-plugin/issues) and [Discussions](https://github.com/gee-community/qgis-earthengine-plugin/discussions).
Thank you for helping improve the QGIS Earth Engine Plugin!