Search, Composite, and Download 'Google Earth Engine' Imagery with the 'Python' Module 'geedim'
Overview
Search, composite, and download 'Google Earth Engine' imagery with 'reticulate' bindings for the 'Python' module 'geedim' by Dugal Harris. Read the 'geedim' documentation here: https://geedim.readthedocs.io/. Wrapper functions are provided to make it more convenient to use 'geedim' to download images larger than the 'Google Earth Engine' size limit https://developers.google.com/earth-engine/apidocs/ee-image-getdownloadurl. By default the "High Volume" API endpoint https://developers.google.com/earth-engine/cloud/highvolume is used to download data and this URL can be customized during initialization of the package.
- Support for geedim v2.0.0 and earthengine-api v1.7+
- Updated API calls to use
ee.Image.gdandee.ImageCollection.gdaccessors - Fixed
gd_collection_from_list()to correctly extract underlyingee.Imagefromgeedim2.0 accessor objects gd_initialize()now defaults tocredentials = NULL, using Application Default Credentials (ADC) by defaultgd_properties()now correctly returns the full image ID (including collection path) forgeedim2.0.0+, fixing an issue where only the asset name was returned.- Fix for
gd_export()whengeedim >= 2.0.0where passingoverwriteargument caused aTypeError. - Consistent use of
ee.Geometryforregionargument ingd_search(),gd_composite(), andgd_download()whengeedim >= 2.0.0. - Authentication and Headless Support
- Standardized on
GOOGLE_CLOUD_QUOTA_PROJECTenvironment variable for automatic project ID detection ingd_initialize() gd_initialize(private_key_file=...)parameter andEE_SERVICE_ACC_PRIVATE_KEYenvironment variable are deprecated in favor of standardGOOGLE_APPLICATION_CREDENTIALSgd_authenticate()andgd_initialize()now support authentication in headless environments (e.g. CI/CD, Workload Identity Federation)- Updated all vignettes and examples to use
gd_is_initialized()and environment variableR_RGEEDIM_RUN_EXAMPLESfor conditional evaluation
Show all changes in 0.4.0Hide the rest of the changes in 0.4.0
gd_region()andgd_region_to_vect()improvementsgd_region()now correctly handlesSpatVectorobjects withMultiPolygongeometries or holes by leveragingterra::writeVector(..., filetype="GeoJSON")- Using Python's native
jsonmodule (viareticulate) for dependency-light GeoJSON serialization and parsing gd_region_to_vect()now supports complex GeoJSON-like lists, includingGeometryCollection
From NEWS.md in the release
Install
Health
WARNINGS3 generic/method consistencyr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. See section ‘Generic functions and methods’ in the ‘Writing R Extensions’ manual.
WARNINGfor code/documentation mismatchesr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer.
WARNINGfor missing documentation entriesr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. All user-level objects in a package should have documentation entries. See chapter ‘Writing R documentation files’ in the ‘Writing R Extensions’ manual.
WARNINGreplacement functionsr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. The argument of a replacement function which corresponds to the right hand side must be named ‘value’.
NOTER code for possible problemsr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer.
NOTERd \usage sectionsr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. The \usage entries for S3 methods should use the \method markup and not their full name. See chapter ‘Writing R documentation files’ in the ‘Writing R Extensions’ manual.
NOTEdependencies in R coder-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer.
NOTEforeign function callsr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. See chapter ‘System and foreign language interfaces’ in the ‘Writing R Extensions’ manual.
NOTEwhether startup messages can be suppressedr-devel-linux-x86_64-fedora-clang, r-devel-linux-x86_64-fedora-gcc
warning: Failed to inspect Python interpreter from search path at `/usr/sbin/pypy` cause: Can't use Python at `/usr/sbin/pypy` cause: Python executable does not support `-I` flag. Please use Python 3.6 or newer. It looks like this package (or a package it requires) has a startup message which cannot be suppressed: see ?packageStartupMessage.
- WARNING11 OK, 2 WARNINGNow
- WARNING12 OK, 1 WARNING2026-09-10
- OK13 OK2026-08-05
- NOTE12 OK, 1 NOTE2026-08-01
- OK13 OK2026-06-09
- ERROR12 OK, 1 ERROR2026-06-08
Show 1 earlier changeHide 1 earlier change
- OK14 OK2026-03-10
Documentation
- Help pages
- 23 (1 internal)includes a package overview page
- Examples that run
- 11%2 run in a plain check · 11 only when donttest examples are enabled (R CMD check --as-cran) · 5 never run
- Exported functions with examples
- 86%
- Documented parameters
- 97%
- Return-value docs
- 100%
- Help pages citing references
- 0%
Downloads
Repository
- PRs merged (all time)
- 100%
- Median days to close, 50 most recently updated closed issues
- 14
- Median days to close, 50 most recently updated closed PRs
- 0
PRs over time
Commits over time
7 development-tooling and community-health practices detected across 4 families in the upstream repository
Checks run against github.com/brownag/rgeedim on 2026-10-21.
The R CMD check workflow runs on Linux, macOS and Windows, and on R-devel
GitHub Pages site last deployed 2026-07-23 · The repository has a site deploy workflow
Dependencies
Installing rgeedim adds 10 packages (7 with compiled code, 5.5 MB of source tarballs). Heaviest: Rcpp 1.8 MB, reticulate 1.6 MB, jsonlite 1.0 MB.
Code & Tests
People & History
Pick two releases to compare their code metrics.
- RR 4.6.0 released · 2026-04-24
- 0.4.0Latest
- RR 4.5.0 released · 2025-04-11
- RR 4.4.0 released · 2024-04-24
- 0.2.72024-01-18 · diff ↗
- 0.2.62023-12-19 · diff ↗
- 0.2.5
- 0.2.4
- RR 4.3.0 released · 2023-04-21
- 0.2.2
- 0.2.12023-02-14 · diff ↗
- 0.2.02022-12-22 · diff ↗ ·
added 5 exports
gd_asset_id, gd_delete_asset, gd_export, gd_export_types, gd_get_asset - 0.1.02022-11-02
- RR 4.2.0 released · 2022-04-22
Package metadata
- First published
- 2022-11-02
- Total releases
- 9 / 4 yrs
- License
- Apache License (>= 2)
- Minimum R
- ≥ 3.5
- Download size
- 270 KB
Cite
Cite this package
Run in R for the authors' preferred citation:
citation("rgeedim")This package has no citation file, so citation() returns this entry built from DESCRIPTION.
Cite the R Observatory
For a number measured here: a download total, a coverage figure, an archival date.
From data release v2026-10-25, which the citation names so these numbers can be found later. More on citing and the projects behind them.