Unified endpoint for querying infrared and visible volcano imagery
infrared - Thermal/infrared imagery (default)visible - Standard visible light imageryCLNE - Cleveland volcanoVPMI - Poás volcano311240 - Cleveland345040 - Poás383010 - Cumbre Vieja311290 - Okmokyyyymmddhhmmss20250321110000 = March 21, 2025 at 11:00:00 AM UTCyyyymmddhhmmssfreq=all with single site: Time portion ignored, dates interpreted as local datesfreq=daily: Time portion ignored, dates interpreted as local datesfreq=hourly/minutely: Time portion creates daily recurring UTC time windowfreq=all without site: Time portion used, dates interpreted as exact UTC rangetrue - Images with fogfalse - Clear images (no fog)true - Nighttime imagesfalse - Daytime imagestrue - Images with cloudsfalse - Clear images (no clouds)all - Return all captured images (default, ~1-2 min intervals)
minutely - Middle image from each minute within daily UTC time window (requires site)hourly - Middle image from each hour within daily UTC time window (requires site)daily - Image closest to 10:00 AM local time for each day (requires site)freq parameter groups images by time period and returns a representative image from each period.| freq value | Data Reduction | Timestamp Format | Requires Site? |
|---|---|---|---|
all (single site) | None (100% of images) | Local time (no Z) | No |
all (no site) | None | UTC (with Z) | No |
minutely | ~0-5% | UTC (with Z) | Yes |
hourly | ~98% (60x smaller) | UTC (with Z) | Yes |
daily | ~99.9% (1440x smaller) | UTC (with Z) | Yes |
freq=all with single site: Time portion ignored, returns full local daysfreq=daily: Time portion ignored, returns one image per local day at 10 AMfreq=hourly/minutely: Time portion creates daily recurring UTC time windowdesc - Newest images first (default)asc - Oldest images firstfreq=all with single site: Sorts by local site timefreq=hourly and freq=minutely, the same images are returned regardless of order - only the display order changes.estimate - Get download estimate (size, time, warnings) WITHOUT downloadingtrue - Download all matching images as ZIP fileselected - Download specific images by ID (requires image_ids)Get estimate
Show confirmation
Trigger download
download=selecteddownload=estimate:
download=true or download=selected, returns a ZIP file containing JPG images.
ZIP Structure:
Use estimates before downloading
download=estimate before triggering large downloads to inform users about size and time requirements.Use freq parameter for large datasets
freq=hourly or freq=daily to reduce dataset size while maintaining temporal coverage.Implement pagination for large result sets
Cache results when appropriate
Handle errors gracefully