Skip to main content
GET
/
imagery
/
visible
/
r
/
{image_id}
Get visible image by ID
curl --request GET \
  --url https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}
{
  "id": 269011,
  "image_id": "311240.CLNE.2024.152_000001-0000",
  "site": "CLNE",
  "vnum": 311240,
  "timestamp": "2024-05-31T00:00:01",
  "file_format": "jpg",
  "url": "/data/vulcand/archive/imagery/visible/311240/2024/CLNE/still/152/311240.CLNE.2024.152_000001-0000.jpg",
  "frame": 0,
  "quality": 0
}

​
Overview

This endpoint allows you to retrieve a specific visible image using its unique identifier. You can either get the image metadata or download the actual image file.

​
Usage Examples

​
Get Image Metadata

Retrieve metadata for a specific visible image: 
import requests

response = requests.get(
    f"https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}"
)
image_info = response.json()

​
Download Image File

Download the actual visible image file: 
import requests

response = requests.get(
    f"https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}",
    params={"download": True}
)

# Save the image file
with open(f"visible_image_{image_id}.jpg", "wb") as f:
    f.write(response.content)

​
Batch Download Example

Download multiple visible images from a query result: 
import requests

# First, get the list of images
query_response = requests.get(
    "https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/query",
    params={
        "site": "CLNE",
        "vnum": 311240,
        "search_from": "2022-10-01T00:00",
        "search_to": "2022-10-02T00:00"
    }
)

# Then download each image individually
for image in query_response.json():
    print(f"Downloading image: {image['image_id']}")
    image_response = requests.get(
        f"https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image['image_id']}",
        params={"download": True}
    )

    with open(f"visible_{image['image_id']}.jpg", "wb") as f:
        f.write(image_response.content)

​
Notes

  • Image IDs are obtained from the query endpoint response
  • When download=false (default), you get JSON metadata about the image
  • When download=true, you get the binary image file
  • Image file formats vary (JPEG, PNG, etc.) - check the file_format field in metadata

Path Parameters

​
image_id
string
required

Unique identifier for the image

Query Parameters

​
download
boolean
default:false

Download the image file

Response

Image file or metadata

​
id
integer
required

Database ID of the image record

Example:

269011

​
image_id
string
required

Unique identifier for the image file

Example:

"311240.CLNE.2024.152_000001-0000"

​
site
string
required

Site identifier

Example:

"CLNE"

​
vnum
integer
required

Volcano number identifier

Example:

311240

​
timestamp
string<date-time>
required

When the image was captured

Example:

"2024-05-31T00:00:01"

​
file_format
string
required

Image file format

Example:

"jpg"

​
url
string
required

Relative path to the image file

Example:

"/data/vulcand/archive/imagery/visible/311240/2024/CLNE/still/152/311240.CLNE.2024.152_000001-0000.jpg"

​
frame
integer

Frame number for video sequences

Example:

0

​
quality
integer

Image quality indicator

Example:

0