WeatherBug® API

 

Oauth Security:

Consumer Key:

  • An alphanumeric key issued after authorizing your API package.

Consumer Secret Key:

  • An alphanumeric key issued after authorizing your API package.

 

Call Format:  https://thepulseapi.earthnetworks.com/oauth20/token?grant_type=client_credentials&client_id=<Consumer Key>&client_secret=<Consumer Secret Key> 

 

Example:  https://thepulseapi.earthnetworks.com/oauth20/token?grant_type=client_credentials&client_id=KZ7mAIv49AbdoecEoMO1Dy23gf0rrDHp&client_secret=cFy71jSwicuZgfQp

 

Definition of API Terms

Access_token:

  • An alphanumeric license key issued by EarthNetworks.

CityType:

  • citytype="0" — city in the U.S.
  • citytype="1" — city outside of the U.S.

CityCode:

  • 5 digits designation for non-U.S. cities.

Latitude:

  • Location of a place north or south of the equator. Minimum value: -90. Maximum value: 90.

Longitude:

  • Location of a place east or west of the prime meridian. Minimum value -180. Maximum value: 180.

SearchString:

  • Parameter used to search for locations. Only U.S. zipcodes and citynames can be searched. SearchString is not case-sensitive and accepts blank spaces.

UnitType:

  • UnitType=<UnitType>0 — U.S. customary units (miles, °F, etc...) [default]
  • UnitType=<UnitType>1 — Metric system units (kms, °C, etc...).

OutputType:

  • OutputType=<OutputType>0 — Returns the RSS with the XML embedded inside it starting with "<aws:weather>" [default].
  • OutputType=<OutputType>1 — Returns pure xml beginning with "<aws:weather>".

ZipCode:

  • 5 digits designation for U.S. cities only.

 

I.  XML Reference

  1. Search Locations
  2. Search Stations
  3. Live Weather
  4. Forecast
  5. Alerts

A.  Search Locations

Description:  Returns the location based on the U.S. and international city name or U.S. Zip Code.

1.  By Zipcode:

Call Format: https://thepulseapi.earthnetworks.com/getLocationsXML.aspx?access_token=&SearchString=<zipcode>

Example: https://thepulseapi.earthnetworks.com/getLocationsXML.aspx?access_token=&SearchString=64732

Input Parameters:
  • Access_token (required)
  • SearchString (required)
Output:
  • An XML document containing locations which match the Zip Code.

<aws:weather>
<aws:api version="2.0"/>
<aws:locations>
<aws:location cityname="Chilhowee" statename="MO" countryname="USA" zipcode="64733" citycode="" citytype="0"/>
</aws:locations>
</aws:weather>

 

 

2.  By Location Names (soundex):

The soundex system allows searching for a city based on phonetics rather than spelling.

Call Format: https://thepulseapi.earthnetworks.com/getLocationsXML.aspx?access_token=&SearchString=<cityname>

Example: https://thepulseapi.earthnetworks.com/getLocationsXML.aspx?access_token=&SearchString=San Francisco

Input Parameters:
  • Access_token (required)
  • SearchString (required)
Output:
  • An XML document containing locations which may match the search string.

<aws:weather>
<aws:api version="2.0"/>
<aws:locations>
<aws:location cityname="San Francisco" statename="" countryname="Argentina" zipcode="" citycode="50273" citytype="1"/>
<aws:location cityname="San Francisco" statename="" countryname="El Salvador" zipcode="" citycode="75304" citytype="1"/>
<aws:location cityname="San Francisco" statename="" countryname="Philippines" zipcode="" citycode="78331" citytype="1"/>
<aws:location cityname="San Francisco" statename="" countryname="Philippines" zipcode="" citycode="72545" citytype="1"/>
<aws:location cityname="San Francisco" statename="" countryname="Philippines" zipcode="" citycode="72546" citytype="1"/>
<aws:location cityname="San Francisco" statename="" countryname="Philippines" zipcode="" citycode="72547" citytype="1"/>
<aws:location cityname="San Francisco" statename="CA" countryname="United States" zipcode="94101" citycode="" citytype="0"/>
<aws:location cityname="San Francisco de Dos Rios" statename="" countryname="Costa Rica" zipcode="" citycode="58067" citytype="1"/>
<aws:location cityname="San Francisco de Macoris" statename="" countryname="Dominican Republic" zipcode="" citycode="60148" citytype="1"/>
<aws:location cityname="San Francisco Del Rincon" statename="" countryname="Mexico" zipcode="" citycode="70351" citytype="1"/>
</aws:locations>
</aws:weather>

 

B.  Search Stations

Description:  For a given zipcode, citycode or latitude/longitude this call returns the weather stations in the area.

1.  By ZipCode:

Call Format: https://thepulseapi.earthnetworks.com/getStationsXML.aspx?access_token=&zipCode=<zipcode>

Example: https://thepulseapi.earthnetworks.com/getStationsXML.aspx?access_token=&zipCode=20874

Input Paramters:
  • Access_token (required)
  • SearchString (required)
Output:
  • An XML document containing weather stations in the area in and around the Zip Code.

<aws:weather>
<aws:api version="2.0"/>
<aws:stations>
<aws:station id="GRMTN" name="Seneca Valley HS" city="Germantown" state="MD" country="USA" zipcode="20874" distance="0.60" Unit="Miles" latitude="39.1769444444444" longitude="-77.2636111111111"/>
<aws:station id="GRMKM" name="Kingsview MS" city="Germantown" state="MD" country="USA" zipcode="20874" distance="0.81" Unit="Miles" latitude="39.1672222222222" longitude="-77.2841666666667"/>
<aws:station id="P0007" name="Crawford Farms PWS" city="Germantown" state="MD" country="USA" zipcode="20874" distance="1.11" Unit="Miles" latitude="39.1716666666667" longitude="-77.2488888888889"/>
<aws:station id="GERMN" name="Dr. Martin Luther King, Jr. MS" city="Germantown" state="MD" country="USA" zipcode="20874" distance="1.16" Unit="Miles" latitude="39.1811111111111" longitude="-77.285"/>
<aws:station id="GRMNT" name="Matsunaga ES" city="Germantown" state="MD" country="USA" zipcode="20874" distance="1.26" Unit="Miles" latitude="39.1569444444444" longitude="-77.2863888888889"/>
<aws:station id="GRMNW" name="Northwest HS" city="Germantown" state="MD" country="USA" zipcode="20874" distance="1.46" Unit="Miles" latitude="39.1497222222222" longitude="-77.2788888888889"/>
<aws:station id="GRMTD" name="Montgomery College" city="Germantown" state="MD" country="USA" zipcode="20876" distance="2.02" Unit="Miles" latitude="39.1941666666667" longitude="-77.2491666666667"/>
<aws:station id="AWSHQ2" name="WeatherBug Headquarters 2" city="Germantown" state="MD" country="USA" zipcode="20876" distance="2.17" Unit="Miles" latitude="39.2005555555556" longitude="-77.2636111111111"/>
<aws:station id="AWSHQ" name="WeatherBug Headquarters" city="Germantown" state="MD" country="USA" zipcode="20876" distance="2.17" Unit="Miles" latitude="39.2005555555556" longitude="-77.2630555555556"/>
<aws:station id="GERTN" name="Neelsville MS" city="Germantown" state="MD" country="USA" zipcode="20876" distance="2.28" Unit="Miles" latitude="39.1941666666667" longitude="-77.2411111111111"/>
<aws:station id="GBUGD" name="Diamond ES" city="Gaithersburg" state="MD" country="USA" zipcode="20878" distance="2.91" Unit="Miles" latitude="39.1355555555556" longitude="-77.2372222222222"/>
<aws:station id="GRMNN" name="Sally Ride ES" city="Germantown" state="MD" country="USA" zipcode="20876" distance="2.99" Unit="Miles" latitude="39.2088888888889" longitude="-77.2463888888889"/>
<aws:station id="GNIST" name="NIST" city="Gaithersburg" state="MD" country="USA" zipcode="20899" distance="3.33" Unit="Miles" latitude="39.1447222222222" longitude="-77.2161111111111"/>
<aws:station id="MZTGM" name="Montgomery Village MS" city="Montgomery Village" state="MD" country="USA" zipcode="20886" distance="3.85" Unit="Miles" latitude="39.1758333333333" longitude="-77.1980555555556"/>
<aws:station id="CLRCH" name="Clarksburg Area HS" city="Clarksburg" state="MD" country="USA" zipcode="20871" distance="3.94" Unit="Miles" latitude="39.2263888888889" longitude="-77.2636111111111"/>
<aws:station id="GTHRR" name="Quince Orchard HS" city="Gaithersburg" state="MD" country="USA" zipcode="20878" distance="3.96" Unit="Miles" latitude="39.1136111111111" longitude="-77.2527777777778"/>
<aws:station id="GRLKL" name="Lakelands Park MS" city="Gaithersburg" state="MD" country="USA" zipcode="20878" distance="4.23" Unit="Miles" latitude="39.1155555555556" longitude="-77.2322222222222"/>
<aws:station id="GTHRS" name="Summit Hall ES" city="Gaithersburg" state="MD" country="USA" zipcode="20877" distance="4.37" Unit="Miles" latitude="39.1330555555556" longitude="-77.2027777777778"/>
<aws:station id="GAITH" name="Gaithersburg HS" city="Gaithersburg" state="MD" country="USA" zipcode="20877" distance="4.58" Unit="Miles" latitude="39.135" longitude="-77.1963888888889"/>
<aws:station id="GAIBG" name="Forest Oak MS" city="Gaithersburg" state="MD" country="USA" zipcode="20877" distance="4.65" Unit="Miles" latitude="39.1538888888889" longitude="-77.185"/>
<aws:station id="GBURG" name="Gaithersburg MS" city="Gaithersburg" state="MD" country="USA" zipcode="20877" distance="4.73" Unit="Miles" latitude="39.1438888888889" longitude="-77.1875"/>
<aws:station id="DTOWN" name="Darnestown ES" city="Darnestown" state="MD" country="USA" zipcode="20878" distance="4.79" Unit="Miles" latitude="39.1011111111111" longitude="-77.2844444444444"/>
<aws:station id="CLRBF" name="Little Bennett ES" city="Clarksburg" state="MD" country="USA" zipcode="20871" distance="5.07" Unit="Miles" latitude="39.2427777777778" longitude="-77.2736111111111"/>
<aws:station id="GBGWG" name="Washington Grove ES" city="Gaithersburg" state="MD" country="USA" zipcode="20877" distance="5.54" Unit="Miles" latitude="39.1319444444444" longitude="-77.1780555555556"/>
<aws:station id="GRMCG" name="Cedar Grove ES" city="Germantown" state="MD" country="USA" zipcode="20876" distance="6.03" Unit="Miles" latitude="39.2516666666667" longitude="-77.2316666666667"/>
</aws:stations>
</aws:weather>

2.  By CityCode:

Call Format: https://thepulseapi.earthnetworks.com/getStationsXML.aspx?access_token=&cityCode=<citycode>

Example: https://thepulseapi.earthnetworks.com/getStationsXML.aspx?access_token=cityCode=50526

Input Paramters:
  • Access_token (required)
  • SearchString (required)
Output:

An XML document containing weather stations in the area in and around the Zip Code.

  • <aws:weather>
    <aws:api version="2.0"/>
    <aws:stations>
    <aws:station id="YSSY" name="Sydney International Airport" city="Sydney" country="Australia" citycode="50507" latitude="-33.95000000000" longitude="151.183333333"/>
    <aws:station id="YSRI" name="Richmond (Air Force Base)" city="Richmond" country="Australia" citycode="W95753" latitude="-33.60000000000" longitude="150.783333333"/>
    <aws:station id="YSCB" name="Canberra Airport" city="Canberra" country="Australia" citycode="50396" latitude="-35.30000000000" longitude="149.183333333"/>
    <aws:station id="YSDU" name="Dubbo" city="Dubbo" country="Australia" citycode="50413" latitude="-32.20000000000" longitude="148.566666666"/>
    <aws:station id="YSTW" name="Tamworth Airport" city="Tamworth" country="Australia" citycode="50527" latitude="-31.08333333300" longitude="150.833333333"/>
    <aws:station id="YSWG" name="Wagga Wagga Airport" city="Wagga Wagga" country="Australia" citycode="50535" latitude="-35.15000000000" longitude="147.45"/>
    <aws:station id="YMAY" name="Albury Airport" city="Albury" country="Australia" citycode="50366" latitude="-36.06666666600" longitude="146.95"/>
    </aws:stations>
    </aws:weather>

Complete List of City Codes

 

3.  By Latitude and Longitude:

Call Format: https://thepulseapi.earthnetworks.com/getStationsXML.aspx?access_token=&lat=<latitude>&long=<longitude>

Example: https://thepulseapi.earthnetworks.com/getStationsXML.aspx?access_token=&lat=55.73&long=-14.36

Input Paramters:

Access_token (required)

  • Lat (required) [min:-90 max:90] (with 2 digits right to the decimal point)
  • Long (required) [min:-180 max:180] (with 2 digits right to the decimal point)
Output:
  • An XML document containing weather stations in the area in around the latitude and longitude.

<aws:weather>
<aws:api version="2.0"/>
<aws:stations>
<aws:station id="EIKN" name="Connaught" city="Connaught" country="Ireland" citycode="800972" latitude="53.91027777777" longitude="-8.81805555488"/>
<aws:station id="ENNSK" name="Enniskillen" city="Enniskillen" country="Ireland" citycode="" latitude="54.34416666633" longitude="-7.645833333"/>
<aws:station id="EINN" name="Shannon Airport" city="Shannon" country="Ireland" citycode="140800" latitude="52.70000000000" longitude="-8.916666666"/>
<aws:station id="LNDND" name="Londonderry" city="Londonderry" country="Ireland" citycode="" latitude="54.98333333300" longitude="-7.316666666"/>
<aws:station id="EGAE" name="Eglinton (Londonderry)" city="Eglinton" country="United Kingdom" citycode="70995" latitude="55.05000000000" longitude="-7.15"/>
<aws:station id="PRTDW" name="Portadown" city="Portadown" country="Ireland" citycode="" latitude="54.41666666600" longitude="-6.45"/>
<aws:station id="EGAA" name="Belfast (Aldergrove)" city="Belfast" country="United Kingdom" citycode="70978" latitude="54.65000000000" longitude="-6.216666666"/>
<aws:station id="DNMRR" name="Dunmurry  South" city="Dunmurry" country="Ireland" citycode="" latitude="54.54499999966" longitude="-6.02138888822"/>
<aws:station id="EIDW" name="Dublin Airport" city="Dublin" country="Ireland" citycode="66200" latitude="53.43333333300" longitude="-6.25"/>
<aws:station id="MLLSK" name="Roughfort Central" city="Mallusk" country="Ireland" citycode="" latitude="54.68722222188" longitude="-6.02027777711"/>
<aws:station id="BLLYC" name="Ballycastle" city="Ballycastle Co Antrim" country="Ireland" citycode="" latitude="55.20361111111" longitude="-6.24277777744"/>
<aws:station id="BELST" name="Windsor Business Park" city="Belfast" country="Ireland" citycode="" latitude="54.58083333266" longitude="-5.95"/>
<aws:station id="BLFST" name="BT Group" city="Belfast" country="United Kingdom" citycode="70983" latitude="54.59638888855" longitude="-5.91888888822"/>
<aws:station id="EGAC" name="Belfast Harbour" city="Belfast Harbour" country="United Kingdom" citycode="70983" latitude="54.60000000000" longitude="-5.883333333"/>
<aws:station id="CRRCK" name="Carrickfergus West" city="Carrickfergus" country="Ireland" citycode="" latitude="54.71277777777" longitude="-5.84527777744"/>
<aws:station id="CCMBR" name="Comber Central" city="Comber" country="Ireland" citycode="" latitude="54.54833333300" longitude="-5.75027777777"/>
<aws:station id="LRNCN" name="Larne" city="Larne Co Antrim" country="Ireland" citycode="" latitude="54.85361111111" longitude="-5.82194444377"/>
<aws:station id="CNTYD" name="Newtonwards" city="County Down" country="Ireland" citycode="" latitude="54.59194444411" longitude="-5.69777777744"/>
</aws:stations>
</aws:weather>

 

C.  Live Weather

Description:  Returns detailed live weather conditions for the chosen location.

1.  By StationId:

The StationId Call Format allows searching weather conditions for multiple stations (up to 5). Separate the station ids with a comma; no blank space.

Call Format:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&stationid=<stationid>&UnitType=<UnitType>&OutputType=<OutputType>

 

Single Station Example:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&stationid=awshq

 

Multiple Stations Example: https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&stationid=awshq,vomm,germn&UnitType=1&OutputType=1

Input Paramters:
  • Access_token (required)
  • Stationid (required)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing weather conditions for the station or stations.
  • An XML document containing weather conditions for the station or stations.

Complete List of Short Predictions | Complete List of Icon Descriptions

2.  By Zip Code:

Call Format:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&zipCode=<zipcode>&UnitType=<UnitType>&OutputType=<OutputType>

Example:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&zipCode=20874

Input Parameters:
  • Access_token (required)
  • ZipCode (required)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing weather conditions for the Zip Code.
  • An XML document containing weather conditions for the Zip Code.

Complete List of Short Predictions | Complete List of Icon Descriptions

 

3.  By City Code:

Call Format:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&cityCode=<citycode>&UnitType=<UnitType>&OutputType=<OutputType>

Example: https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&cityCode=60888

Input Parameters:
  • Access_token (required)
  • CityCode (required)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing weather conditions for the City Code.
  • An XML document containing weather conditions for the City Code.

Complete List of City Codes | Complete List of Short Predictions | Complete List of Icon Descriptions

 

4.  By Latitude and Longitude:

Call Format:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&lat=<latitude>&long=<longitude>&UnitType=<UnitType>&OutputType=<OutputType>

Example:
https://thepulseapi.earthnetworks.com/getLiveWeatherRSS.aspx?access_token=&lat=28.73&long=77.46&UnitType=1

Input Parameters:
  • Access_token (required)
  • Lat (required) [min:-90 max:90] (with 2 digits right to the decimal point)
  • Long (required) [min:-180 max:180] (with 2 digits right to the decimal point)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing weather conditions for the City Code.
  • An XML document containing weather conditions for the City Code.

Complete List of Short Predictions | Complete List of Icon Descriptions

 

D.  Forecast

Description:  Returns the 7-day forecast for a zipcode, citycode or latitude/longitude.

1.  By ZipCode:

Call Format: https://thepulseapi.earthnetworks.com/getForecastRSS.aspx?access_token=&zipCode=<zipcode>&UnitType=<UnitType>&OutputType=<OutputType>

Example:
https://thepulseapi.earthnetworks.com/getForecastRSS.aspx?access_token=&zipCode=56395

Input Parameters:
  • Access_token (required)
  • ZipCode (required)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing the forecast for the Zip Code.
  • An XML document containing the forecast for the Zip Code.

Complete List of Short Predictions | Complete List of Icon Descriptions

 

2.  By CityCode:

Call Format:
https://thepulseapi.earthnetworks.com/getForecastRSS.aspx?access_token=&cityCode=<citycode>&UnitType=<UnitType>&OutputType=<OutputType>

Example:
https://thepulseapi.earthnetworks.com/getForecastRSS.aspx?access_token=&cityCode=54493&UnitType=1

Input Parameters:
  • Access_token (required)
  • CityCode (required)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing the forecast for the City Code.
  • An XML document containing the forecast for the City Code.

Complete List of City Codes | Complete List of Short Predictions | Complete List of Icon Descriptions

 

3.  By Latitude and Longitude:

Call Format:
https://thepulseapi.earthnetworks.com/getForecastRSS.aspx?access_token=&lat=<latitude>&long=<longitude>&UnitType=<UnitType>&OutputType=<OutputType>

Example: 
https://thepulseapi.earthnetworks.com/getForecastRSS.aspx?access_token=&lat=37.01&long=4.55&UnitType=1

Input Parameters:
  • Access_token (required)
  • Lat (required) [min:-90 max:90] (with 2 digits right to the decimal point)
  • Long (required) [min:-180 max:180] (with 2 digits right to the decimal point)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing the forecast for the latitude and longitude.
  • An XML document containing the forecast for the latitude and longitude.

Complete List of Short Predictions | Complete List of Icon Descriptions

 

E.  Alerts

Description:  Returns weather alert information for a given Zip Code or latitude/longitude (U.S. Only).

1.  By ZipCode:

Call Format:
https://thepulseapi.earthnetworks.com/getAlertsRSS.aspx?access_token=&zipCode=<zipcode>&UnitType=<UnitType>&OutputType=<OutputType>

Example:
https://thepulseapi.earthnetworks.com/getAlertsRSS.aspx?access_token=&zipCode=87101

Input Parameters:
  • Access_token (required)
  • ZipCode (required)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing a list of any applicable alerts for the Zip Code.

<rss version="2.0">
 <channel>
 
    <title>Alerts for Bernalillo County, NM - USA </title>
 
    <link>http://weather.weatherbug.com/NM/Albuquerque-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0</link>
    <description>Weatherbug, the owner of the world's largest weather network is now providing an API to it's weather data in the form of RSS. This will enable it's enthusiastic users to build their own applications.</description>
    <language>en-us</language>

    <lastBuildDate>Mon, 02 Jun 2008 20:40:00 GMT</lastBuildDate>
    <ttl>60</ttl>
    <aws:weather xmlns:aws="
http://www.aws.com/aws"><aws:api version="2.0" /><aws:WebURL>http://weather.weatherbug.com/NM/Albuquerque-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0</aws:WebURL><aws:alerts count="1"><aws:alert><aws:id>2562057</aws:id><aws:type>Red Flag Warning</aws:type><aws:title>FIRE WEATHER WATCH REMAINS IN EFFECT FROM WEDNESDAY MORNING THROUGH WEDNESDAY EVENING</aws:title><aws:posted-date><aws:year number="2008" /><aws:month number="6" text="June" abbrv="Jun" /><aws:day number="2" text="Monday" abbrv="Mon" /><aws:hour number="2" hour-24="14" /><aws:minute number="40" /><aws:second number="00" /><aws:am-pm abbrv="PM" /><aws:time-zone offset="-6" text="Mountain Daylight Time" abbrv="MDT" /></aws:posted-date><aws:expires-date><aws:year number="2008" /><aws:month number="6" text="June" abbrv="Jun" /><aws:day number="2" text="Monday" abbrv="Mon" /><aws:hour number="8" hour-24="20" /><aws:minute number="00" /><aws:second number="00" /><aws:am-pm abbrv="PM" /><aws:time-zone offset="-6" text="Mountain Daylight Time" abbrv="MDT" /></aws:expires-date><aws:msg-summary>FIRE WEATHER WATCH REMAINS IN EFFECT FROM WEDNESDAY MORNING THROUGH WEDNESDAY EVENING FOR  NM: Sandoval,San Juan,McKinley,Rio Arriba,Santa Fe,Taos,San Miguel,Los Alamos,Cibola,Valencia,Bernalillo,Socorro,Catron -  A FIRE WEATHER WATCH REMAINS IN EFFECT FROM WEDNESDAY MORNING THROUGH WEDNESDAY EVENING.   RELATIVE HUMIDITY OF 15 PERCENT OR LOWER WITH SUSTAINED 20 FOOT WINDS OF 20 MPH OR HIGHER-AND HIGH FIRE DANGER ARE VERY POSSIBLE  ON WEDNESDAY.  PLEASE ADVISE THE APPROPRIATE OFFICIALS OR FIRE CREWS IN THE FIELD OF THIS FIRE WEATHER WATCH.</aws:msg-summary></aws:alert></aws:alerts></aws:weather>
   
   
            <item>
                <title>FIRE WEATHER WATCH REMAINS IN EFFECT FROM WEDNESDAY MORNING THROUGH WEDNESDAY EVENING</title>

                <description>
                    <![CDATA[
                        <b>FIRE WEATHER WATCH REMAINS IN EFFECT FROM WEDNESDAY MORNING THROUGH WEDNESDAY EVENING FOR  NM: Sandoval,San Juan,McKinley,Rio Arriba,Santa Fe,Taos,San Miguel,Los Alamos,Cibola,Valencia,Bernalillo,Socorro,Catron -  A FIRE WEATHER WATCH REMAINS IN EFFECT FROM WEDNESDAY MORNING THROUGH WEDNESDAY EVENING.   RELATIVE HUMIDITY OF 15 PERCENT OR LOWER WITH SUSTAINED 20 FOOT WINDS OF 20 MPH OR HIGHER-AND HIGH FIRE DANGER ARE VERY POSSIBLE  ON WEDNESDAY.  PLEASE ADVISE THE APPROPRIATE OFFICIALS OR FIRE CREWS IN THE FIELD OF THIS FIRE WEATHER WATCH.</b>
                    ]]>
                    
                </description>
                <pubdate>Mon, 02 Jun 2008 14:40:00 MDT</pubdate>
                <guid isPermaLink="false">Alert-Mon, 02 Jun 2008 20:40:00 GMT-1</guid>
                <link>http://weather.weatherbug.com/NM/Albuquerque-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0&rnd=1</link>

            </item>
   
 </channel>
</rss>

  • An XML document containing a list of any applicable alerts for the Zip Code.

<aws:weather>
 <aws:api version="2.0"/>
 <aws:WebURL>
  
http://weather.weatherbug.com/WI/Milwaukee-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0
 </aws:WebURL>
 <aws:alerts count="1">
  <aws:alert>
   <aws:id>82243003</aws:id>
   <aws:type>Non Precipitation Advisory</aws:type>
   <aws:title>
    FROST ADVISORY IN EFFECT FROM MIDNIGHT TONIGHT TO 7 AM CDT SATURDAY
   </aws:title>
   <aws:posted-date>
    <aws:year number="2008"/>
    <aws:month number="10" text="October" abbrv="Oct"/>
    <aws:day number="3" text="Friday" abbrv="Fri"/>
    <aws:hour number="12" hour-24="12"/>
    <aws:minute number="12"/>
    <aws:second number="00"/>
    <aws:am-pm abbrv="PM"/>
    <aws:time-zone offset="-5" text="Central Daylight Time" abbrv="CDT"/>
   </aws:posted-date>
   <aws:expires-date>
    <aws:year number="2008"/>
    <aws:month number="10" text="October" abbrv="Oct"/>
    <aws:day number="3" text="Friday" abbrv="Fri"/>
    <aws:hour number="8" hour-24="20"/>
    <aws:minute number="15"/>
    <aws:second number="00"/>
    <aws:am-pm abbrv="PM"/>
    <aws:time-zone offset="-5" text="Central Daylight Time" abbrv="CDT"/>
   </aws:expires-date>
   <aws:msg-summary>
    FROST ADVISORY IN EFFECT FROM MIDNIGHT TONIGHT TO 7 AM CDT SATURDAY UNTIL 8:15PM CDT FOR  WI: Ozaukee,Milwaukee,Racine,Kenosha,Walworth -  THE NATIONAL WEATHER SERVICE IN MILWAUKEE/SULLIVAN HAS ISSUED A FROST ADVISORY-WHICH IS IN EFFECT FROM MIDNIGHT TONIGHT TO 7 AM CDT SATURDAY.   FROST WILL DEVELOP AWAY FROM LAKE MICHIGAN AFTER MIDNIGHT TONIGHT AS TEMPERATURES FALL INTO THE LOWER TO MIDDLE 30S.  A FROST ADVISORY IS ISSUED WHEN FROST IS EXPECTED TO DEVELOP DURING THE GROWING SEASON. THOSE WITH AGRICULTURAL INTERESTS ARE URGED TO PROTECT OR HARVEST TENDER VEGETATION.
   </aws:msg-summary>
  </aws:alert>
 </aws:alerts>
</aws:weather>

 

2.  By Latitude and Longitude:

Call Format:
https://thepulseapi.earthnetworks.com/getAlertsRSS.aspx?access_token=&lat=<latitude>&long=<longitude>&UnitType=<UnitType>&OutputType=<OutputType>

Example:
https://thepulseapi.earthnetworks.com/getAlertsRSS.aspx?access_token=&lat=26&long=-80&UnitType=1

Input Parameters:
  • Access_token (required)
  • Lat (required) [U.S. Only] (with 2 digits right to the decimal point)
  • Long (required) [U.S. Only] (with 2 digits right to the decimal point)
  • UnitType (optional)
  • OutputType (optional)
Output:
  • An RSS document containing a list of any applicable alerts for the latitude and longitude.

<rss version="2.0">
 <channel>
 
    <title>Alerts for Broward County, FL - USA </title>
 
    <link>http://weather.weatherbug.com/FL/Hollywood-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0</link>
    <description>Weatherbug, the owner of the world's largest weather network is now providing an API to it's weather data in the form of RSS. This will enable it's enthusiastic users to build their own applications.</description>
    <language>en-us</language>

    <lastBuildDate>Mon, 02 Jun 2008 20:45:29 GMT</lastBuildDate>
    <ttl>60</ttl>
    <aws:weather xmlns:aws="http://www.aws.com/aws"><aws:api version="2.0" /><aws:WebURL>http://weather.weatherbug.com/FL/Hollywood-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0</aws:WebURL></aws:weather>
   
   
        <item>
           
            <title>No alerts issued for Broward County, FL - USA </title>
            <description>

                No severe alerts issued.
            </description>
            <pubdate>Mon, 02 Jun 2008 20:45:29 GMT</pubdate>
            <guid isPermaLink="false">Alert-Mon, 02 Jun 2008 20:45:29 GMT</guid>
            <link>http://weather.weatherbug.com/FL/Hollywood-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0</link>
         
           
        </item>
   
 </channel>

</rss>

  • An XML document containing a list of any applicable alerts for the latitude and longitude.

<aws:weather>
 <aws:api version="2.0"/>
 <aws:WebURL>
  
http://weather.weatherbug.com/WI/Milwaukee-weather/severe-weather/local-alerts.html?ZCode=Z5546&Units=0
 </aws:WebURL>
 <aws:alerts count="1">
  <aws:alert>
   <aws:id>82243003</aws:id>
   <aws:type>Non Precipitation Advisory</aws:type>
   <aws:title>
    FROST ADVISORY IN EFFECT FROM MIDNIGHT TONIGHT TO 7 AM CDT SATURDAY
   </aws:title>
   <aws:posted-date>
    <aws:year number="2008"/>
    <aws:month number="10" text="October" abbrv="Oct"/>
    <aws:day number="3" text="Friday" abbrv="Fri"/>
    <aws:hour number="12" hour-24="12"/>
    <aws:minute number="12"/>
    <aws:second number="00"/>
    <aws:am-pm abbrv="PM"/>
    <aws:time-zone offset="-5" text="Central Daylight Time" abbrv="CDT"/>
   </aws:posted-date>
   <aws:expires-date>
    <aws:year number="2008"/>
    <aws:month number="10" text="October" abbrv="Oct"/>
    <aws:day number="3" text="Friday" abbrv="Fri"/>
    <aws:hour number="8" hour-24="20"/>
    <aws:minute number="15"/>
    <aws:second number="00"/>
    <aws:am-pm abbrv="PM"/>
    <aws:time-zone offset="-5" text="Central Daylight Time" abbrv="CDT"/>
   </aws:expires-date>
   <aws:msg-summary>
    FROST ADVISORY IN EFFECT FROM MIDNIGHT TONIGHT TO 7 AM CDT SATURDAY UNTIL 8:15PM CDT FOR  WI: Ozaukee,Milwaukee,Racine,Kenosha,Walworth -  THE NATIONAL WEATHER SERVICE IN MILWAUKEE/SULLIVAN HAS ISSUED A FROST ADVISORY-WHICH IS IN EFFECT FROM MIDNIGHT TONIGHT TO 7 AM CDT SATURDAY.   FROST WILL DEVELOP AWAY FROM LAKE MICHIGAN AFTER MIDNIGHT TONIGHT AS TEMPERATURES FALL INTO THE LOWER TO MIDDLE 30S.  A FROST ADVISORY IS ISSUED WHEN FROST IS EXPECTED TO DEVELOP DURING THE GROWING SEASON. THOSE WITH AGRICULTURAL INTERESTS ARE URGED TO PROTECT OR HARVEST TENDER VEGETATION.
   </aws:msg-summary>
  </aws:alert>
 </aws:alerts>
</aws:weather>