Volcview API Documentation - LIGHTNING API

Only lightning near a volcano is included in this data. Lightning within 100 KM of an Alaskan volcano or within 10 KM of other volcanoes is available here.

GET METHODS

Select recent AVO lightning, last 30 days.

https://volcview.wr.usgs.gov/vv-api/lightningApi/avorecent

Select recent AVO lightning, user specified days back, 1 in this example, maximum 30.

https://volcview.wr.usgs.gov/vv-api/lightningApi/avorecent/1

Select recent worldwide lightning, last 30 days. NOTE: the server is having issues pulling back 30 days of data, so total rows is being limited to 10k.

https://volcview.wr.usgs.gov/vv-api/lightningApi/recent

Select recent worldwide lightning, user specified days back, 1 in this example, maximum 30.

https://volcview.wr.usgs.gov/vv-api/lightningApi/recent/1

Select lightning within a region and time window.

https://volcview.wr.usgs.gov/vv-api/lightningApi/region?minLat=12.7878&maxLat=14.7878&minLong=-90.0854&maxLong=-88.0854&unixTimestamp=1621042674&plusMinusMinutes=100

Parameters:

Select lightning for an observatory, all U.S. or worldwide and after a specific time.

The startTimestamp value is calculated and provided by you. If not included, will default to the last hour.
EXAMPLES:
US in the last hour because startTimestamp is empty: https://volcview.wr.usgs.gov/vv-api/lightningApi/obs?obsAbbr=US
WORLD in the last hour because obsAbbr and startTimestamp are empty: https://volcview.wr.usgs.gov/vv-api/lightningApi/obs
AVO in the last hour: https://volcview.wr.usgs.gov/vv-api/lightningApi/obs?obsAbbr=AVO&startTimestamp=1621039086
US in the last day: https://volcview.wr.usgs.gov/vv-api/lightningApi/obs?obsAbbr=US&startTimestamp=1620956286
US in the last week: https://volcview.wr.usgs.gov/vv-api/lightningApi/obs?obsAbbr=US&startTimestamp=1620437886

Parameters:

Select lightning near a point and within time window.

https://volcview.wr.usgs.gov/vv-api/lightningApi/nearPoint?lat=13.78780&long=-89.08540&radiusKm=30&unixTimestamp=1621042674&plusMinusMinutes=100

Parameters:

ADD LIGHTNING

Will insert new lightning record if latitude, longitude, timestamp and data source are unique.

curl -i --header "username:USERNAME" --header "password:PASSWORD" -X POST -d 'JSON-DATA' https://volcview.wr.usgs.gov/vv-api/lightningApi/vv-api/lightningApi/lightning
JSON Data Format: { "vnum":"253011","distanceKm":19.57,"lightningTimestamp":1583112396,"dataSource":"EN", "flashType":"IC","latitude":-8.82454,"longitude":148.38179, "peakCurrent":-9154.0,"icHeight":16790.0,"numSensors":16,"icMultiplicity":1,"cgMultiplicity":0 "kmlUrl":"http://wwlln.net/USGS/AVO/archive/...","residual":9.9 }


Unix time values are the number of seconds since Jan. 1st, 1970 UTC. The current unixtime is 1621042686. They are simple to use in different systems, which have functions to convert them to regular date objects.