Get visible image by ID
curl --request GET \
--url https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}import requests
url = "https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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
}{
"error": 123,
"message": "<string>"
}Visible Imagery
Get Visible Image
Retrieve a specific visible image by its ID
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}import requests
url = "https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}"
response = requests.get(url)
print(response.text)const options = {method: 'GET'};
fetch('https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));{
"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
}{
"error": 123,
"message": "<string>"
}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_formatfield in metadata
Path Parameters
Unique identifier for the image
Query Parameters
Download the image file
Response
Image file or metadata
Database ID of the image record
Example:
269011
Unique identifier for the image file
Example:
"311240.CLNE.2024.152_000001-0000"
Site identifier
Example:
"CLNE"
Volcano number identifier
Example:
311240
When the image was captured
Example:
"2024-05-31T00:00:01"
Image file format
Example:
"jpg"
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 number for video sequences
Example:
0
Image quality indicator
Example:
0