Ashcam API Documentation - WEBCAM API

Get webcam images.

GET METHODS

Select Webcam.
https://volcview.wr.usgs.gov/ashcam-api/webcamApi/webcam/{WEBCAM_CODE}

Select all Webcams.
https://volcview.wr.usgs.gov/ashcam-api/webcamApi/webcams

Get webcams in GEO JSON Format Within Predefined Area
https://volcview.wr.usgs.gov/ashcam-api/webcamApi/geojson?lat1=60&lat2=70&long1=-150&long2=-160

CREATE OR UPDATE WEBCAM

Will create webcam if not found, else update. Because image paths use the webcamCode value, it cannot be changed (once created) when using the API. The webcamCode is used for the image path so avoid spaces and special characters, it must be unique. Webcam name is displayed within the webapp and used for sorting, it is required. Other values are optional, but latitude and longitude are needed to determine if the image is daytime or nighttime. The optional vnum, volcano_name values are the value assigned by the Smithsonian Institution for a volcano webcam views.

curl -i --header "username:USERNAME" --header "password:PASSWORD" -X POST -d '{ "webcamCode":"TEST","webcamName":"Test webcam label","latitude":"90.0", "longitude":"160.0","elevationM":"900","bearingDeg":"45","externalUrl":"", "vnum":"", "vName":"" }' https://volcview.wr.usgs.gov/ashcam-api/webcamApi/webcam

Refresh All Webcam image information.

Refreshes the hasImages and newestImage values for all webcams.

curl -i --header "username:USERNAME" --header "password:PASSWORD" -X POST https://volcview.wr.usgs.gov/ashcam-api/webcamApi/refreshAll

UPDATE CLEAR IMAGE INFORMATION

Copies webcam image from image directory to clear image directory. Enables clear image slider in webcam viewer. The imageIdentifier value can be either the imageID or the image md5 value.

curl -i --header "username:USERNAME" --header "password:PASSWORD" -X GET https://volcview.wr.usgs.gov/ashcam-api/webcamApi/assignClearImage/{webcamCode}/{imageIdentifier}

UPDATE WEBCAM Volcano Info

Sets the vnum and volcano name for selected webcam.

curl -i --header "username:USERNAME" --header "password:PASSWORD" -X POST -d '{ "webcamCode":"TEST","vnum":"", "vName":"" }' https://volcview.wr.usgs.gov/ashcam-api/webcamApi/assignVolcano