Node-spc-storm-reports NPM

node-spc-storm-reports

This is a library that parses and returns NWS Storm Prediction Center storm reports.

Install

$ npm install node-spc-storm-reports

Usage

var nodeStormReports = require('node-spc-storm-reports');

// Only request tornado reports
nodeStormReports('2016-01-01', { hail: false, windDamage: false }).then(function spcResponse(data) {
	console.log(data);
}).catch(function errorHandler(err) {
	console.log(err);
});

API

nodeStormReports(date, options)

date

Type: string
String in date format YYYY-MM-DD, e.g. 2016-01-30

options (optional)

Type: object
Defines which weather products should be returned. NOTE: If no data is available for a given product, the returned value will be an empty array.
Properties: - tornado Type: boolean Default: true Defines whether tornado reports should be returned - hail Type: boolean Default: true Defines whether hail reports should be returned - windDamage Type: boolean Default: true Defines whether wind damage reports should be returned - gust Type: boolean Default: false Defines whether wind gust reports should be returned - blizzard Type: boolean Default: false Defines whether blizzard reports should be returned - freezingRain Type: boolean Default: false Defines whether freezing rain reports should be returned - heavySnow Type: boolean Default: false Defines whether heavy snow reports should be returned - iceStorm Type: boolean Default: false Defines whether ice storm reports should be returned - sleet Type: boolean Default: false Defines whether sleet reports should be returned - snow Type: boolean Default: false Defines whether snow reports should be returned - wildfire Type: boolean Default: false * Defines whether wildfire reports should be returned

##Returned Data Structure Sample

{
  tornado: [
    {
      id: 1,
      time: '18:30',
      type: 'T',
      distance: 3,
      direction: 'NW',
      city: 'REPUBLIC',
      county: 'MARQUETTE',
      source: 'NWS STORM SURVEY',
      remark: 'PRELIMINARY NWS STORM SURVEY CONFIRMS TREE DAMAGE ASSOCIATED WITH A TORNADO ALONG RIVER ROAD NORTHWEST OF REPUBLIC...INCLUDING SNAPPED WHITE PINES LARGER THAN 12 INCHES IN DIAMETER. TIME ESTIMATED FROM RADAR.',
      office: 'MQT',
      issuance: 1464132240,
      fatalities: 0,
      injuries: 0,
      magnitudeDesignator: null,
      magnitude: null,
      state: 'MI',
      latitude: 46.43,
      longitude: -88.03
    }
  ],
  hail: [
    {
      id: 33,
      time: '19:54',
      type: 'A',
      distance: 3,
      direction: 'W',
      city: 'ARVADA',
      county: 'JEFFERSON',
      source: 'TRAINED SPOTTER',
      remark: null,
      office: 'BOU',
      issuance: 1464139140,
      fatalities: 0,
      injuries: 0,
      magnitudeDesignator: 'M',
      magnitude: 100,
      state: 'CO',
      latitude: 39.82,
      longitude: -105.16
    }
  ],
  windDamage: [
    {
      id: 104,
      time: '19:00',
      type: 'W',
      distance: 3,
      direction: 'WNW',
      city: 'PEEL',
      county: 'MARION',
      source: 'EMERGENCY MNGR',
      remark: 'TREES AND POWERLINES DOWN IN THE AREA.',
      office: 'LZK',
      issuance: 1464118500,
      fatalities: 0,
      injuries: 0,
      magnitudeDesignator: null,
      magnitude: null,
      state: 'AR',
      latitude: 36.45,
      longitude: -92.82
    }
  ]
}