Get Visible Image

Get visible image by ID

curl --request GET \
  --url https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}

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>"
}

GET

imagery

visible

{image_id}

Get visible image by ID

curl --request GET \
  --url https://avert-legacy.ldeo.columbia.edu/api/imagery/visible/r/{image_id}

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_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

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

Query Visible Imagery Overview

Getting Started

The Single-Board Computer

Node Software

The Data Server

API Reference v1

The AVERT Data Portal

Overview

Usage Examples

Get Image Metadata

Download Image File

Batch Download Example

Notes

Path Parameters

Query Parameters

Response

​Overview

​Usage Examples

​Get Image Metadata

​Download Image File

​Batch Download Example

​Notes

Path Parameters

Query Parameters

Response

Overview

Usage Examples

Get Image Metadata

Download Image File

Batch Download Example

Notes