Export and cloud mask Google Earth Engine imagery with automated composite creation and filtering capabilities.
—
Initialize Google Earth Engine with high-volume endpoint and credential management, including support for service account authentication and environment variable configuration.
Initialize Earth Engine with optional configuration for endpoint URL and authentication parameters.
def Initialize(
opt_url: str = 'https://earthengine-highvolume.googleapis.com',
**kwargs
) -> None:
"""
Initialize Earth Engine.
Credentials will be read from the EE_SERVICE_ACC_PRIVATE_KEY environment
variable if it exists (useful for integrating with e.g. GitHub actions).
Parameters:
- opt_url (str): The Earth Engine endpoint to use. Defaults to the high
volume endpoint. See the Earth Engine docs for available endpoints.
- **kwargs: Additional keyword arguments passed to ee.Initialize()
Returns:
None
"""Usage Example:
import geedim
# Initialize with default high-volume endpoint
geedim.Initialize()
# Initialize with custom endpoint
geedim.Initialize(opt_url='https://earthengine.googleapis.com')
# Initialize with additional Earth Engine parameters
geedim.Initialize(project='my-project-id')Environment Variable Support:
The function automatically detects service account credentials from the EE_SERVICE_ACC_PRIVATE_KEY environment variable, making it ideal for CI/CD pipelines and server deployments.
import os
import geedim
# Set service account key via environment variable
os.environ['EE_SERVICE_ACC_PRIVATE_KEY'] = 'path/to/service-account.json'
geedim.Initialize()High-Volume Endpoint:
By default, geedim uses the high-volume Earth Engine endpoint (https://earthengine-highvolume.googleapis.com) which provides better performance for bulk operations and exports compared to the standard endpoint.
Install with Tessl CLI
npx tessl i tessl/pypi-geedim