CustomWeather Documentation

CustomWeather API Guide

INTRODUCTION

The CustomWeather API is a consistent source of reliable weather forecasts and data for millions of locations worldwide, available in over 80 languages.

Key features include:

  • Ability to search by location name, latitude/longitude coordinate, postal codes and ID.
  • Locations are geocoded with latitude, longitude, time zone, state, province, and country information.
  • Ability to refine forecasts down to 100 meter resolution worldwide.
  • Ability to request data in multiple languages.
  • Ability to request data via HTTPS for secure data encryption.
  • Products can be combined into one request to economize the number of requests.

Access to the CustomWeather API requires a username and password. If you would like to request access, click here.  CustomWeather offers competitive, flexible pricing plans. For more information, contact us.

1. Search

The search product returns a list of the requested location.

1.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=search&version=2.0

1.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather. IP address authentication also available without a password.
product yes The weather product name.
search yes The name of the requested location. Requesting only the location name will return the location with the largest population. The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
language Optional The name of the language in which to return results. The default language is English. A list of languages can be made available upon request.

1.3 Response Object

Field Description
size The number of locations available.
search_type Not used.
id The location's ID code.
name The location name.
state The state code of the reporting station.
state_name The state name of the reporting station.
country The country code of the reporting station.
country_name The country name of the reporting station.
lat Latitude Coordinates in Decimal Degrees
long Longitude Coordinates in Decimal Degrees
population The population of the location.
timezone Time zone offset from UTC of the location.
timezone_code The time zone abbreviation.
timezone_id IANA (Internet Assigned Numbers Authority) time zone database identifier.
timezone_offset Time zone offset from UTC of the location in seconds.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
region The region name (defunct).
iso_cc The ISO country code.

1.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=search&search=London&version=2.0

1.5 Example Response(XML)

<cw_citylist size="36" search_type="city"><city id="gn2643741" name="City of London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51279" long="-0.09184" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/><city id="gn2643743" name="London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.50853" long="-0.12574" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="W03770" iso_cc="GB"/><city id="gn6058560" name="London" state="ON" state_name="null" country="CA" country_name="Canada" lat="42.98339" long="-81.23304" population="346765" timezone="-5" timezone_code="EDT" timezone_id="America/Toronto" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="" weather_id="54211" iso_cc="CA"/><city id="gn4517009" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="39.88645" long="-83.44825" population="9904" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26250" iso_cc="US"/><city id="gn2643744" name="The City" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51334" long="-0.08901" population="8000" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/><city id="gn4298960" name="London" state="KY" state_name="Kentucky" country="US" country_name="United States" lat="37.12898" long="-84.08326" population="7993" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="18256" iso_cc="US"/><city id="gn5367815" name="London" state="CA" state_name="California" country="US" country_name="United States" lat="36.47606" long="-119.44318" population="1869" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="southwest" weather_id="11913" iso_cc="US"/><city id="gn4030939" name="London Village" state="L" state_name="Line Islands" country="KR" country_name="Kiribati" lat="1.98487" long="-157.47502" population="1829" timezone="14" timezone_code="LINT" timezone_id="Pacific/Kiritimati" timezone_offset="50400" localtime="Fri, 06 Oct 2017 09:21:21 LINT" region="SouthPacific" weather_id="PLCH" iso_cc="KI"/><city id="gn4119617" name="London" state="AR" state_name="Arkansas" country="US" country_name="United States" lat="35.32897" long="-93.25296" population="1039" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="11244" iso_cc="US"/><city id="gn3581797" name="London" state="OW" state_name="Orange Walk" country="BH" country_name="Belize" lat="17.98333" long="-88.43333" population="0" timezone="-6" timezone_code="CST" timezone_id="America/Belize" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 13:21:21 CST" region="CentralAmerica" weather_id="51239" iso_cc="BZ"/><city id="gn1705729" name="London" state="BUK" state_name="Soccsksargen" country="RP" country_name="Philippines" lat="6.00972" long="125.12944" population="0" timezone="8" timezone_code="PHT" timezone_id="Asia/Manila" timezone_offset="28800" localtime="Fri, 06 Oct 2017 03:21:21 PHT" region="Indonesia" weather_id="RPWB" iso_cc="PH"/><city id="gn4812926" name="London" state="WV" state_name="West Virginia" country="US" country_name="United States" lat="38.19455" long="-81.36872" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="32636" iso_cc="US"/><city id="gn4637795" name="London" state="TN" state_name="Tennessee" country="US" country_name="United States" lat="35.86982" long="-83.00209" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="southeast" weather_id="29954" iso_cc="US"/><city id="gn4707415" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="32.23099" long="-94.94438" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="30862" iso_cc="US"/><city id="gn5260737" name="London" state="WI" state_name="Wisconsin" country="US" country_name="United States" lat="43.04778" long="-89.01289" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="32848" iso_cc="US"/><city id="gn5035441" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="47.2027" long="-91.56962" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="KBFW" iso_cc="US"/><city id="gn4707414" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="30.67685" long="-99.57645" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="KJCT" iso_cc="US"/><city id="gn2406961" name="London" state="E" state_name="Eastern Province" country="SL" country_name="Sierra Leone" lat="8.31068" long="-10.78731" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75289" iso_cc="SL"/><city id="gn982299" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.76667" long="30.86667" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77048" iso_cc="ZA"/><city id="gn982298" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.81927" long="31.04765" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77064" iso_cc="ZA"/><city id="gn5035439" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="43.52607" long="-93.0627" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="20708" iso_cc="US"/><city id="gn4999913" name="London" state="MI" state_name="Michigan" country="US" country_name="United States" lat="42.02004" long="-83.61327" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Detroit" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northcentral" weather_id="19913" iso_cc="US"/><city id="gn982300" name="London" state="LP" state_name="Limpopo" country="SF" country_name="South Africa" lat="-24.30262" long="30.5725" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="FAHS" iso_cc="ZA"/><city id="gn5056033" name="London" state="MO" state_name="Missouri" country="US" country_name="United States" lat="40.445" long="-95.23498" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="22276" iso_cc="US"/><city id="gn3803838" name="London" state="M" state_name="Miranda" country="VE" country_name="Venezuela" lat="10.36093" long="-66.73159" population="0" timezone="-4" timezone_code="VET" timezone_id="America/Caracas" timezone_offset="-16200" localtime="Thu, 05 Oct 2017 14:51:21 VET" region="SouthAmerica" weather_id="800433" iso_cc="VE"/><city id="gn2308696" name="London" state="00" state_name="" country="EK" country_name="Equatorial Guinea" lat="2.26815" long="9.78934" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Malabo" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="FGBT" iso_cc="GQ"/><city id="gn9876172" name="London" state="S" state_name="Southern Province" country="SL" country_name="Sierra Leone" lat="7.65137" long="-12.00293" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75284" iso_cc="SL"/><city id="gn1313003" name="Lonton" state="11" state_name="Kachin" country="BM" country_name="Myanmar [Burma]" lat="25.09229" long="96.28854" population="0" timezone="6" timezone_code="MMT" timezone_id="Asia/Rangoon" timezone_offset="23400" localtime="Fri, 06 Oct 2017 01:51:21 MMT" region="CentralAsia" weather_id="XZKT" iso_cc="MM"/><city id="gn5737562" name="London" state="OR" state_name="Oregon" country="US" country_name="United States" lat="43.63457" long="-123.09285" population="0" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="northwest" weather_id="27686" iso_cc="US"/><city id="gn5198788" name="London" state="PA" state_name="Pennsylvania" country="US" country_name="United States" lat="41.14367" long="-80.14867" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="28141" iso_cc="US"/><city id="gn4073570" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="31.29767" long="-87.08775" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10069" iso_cc="US"/><city id="gn4073571" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="32.2732" long="-86.05024" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10392" iso_cc="US"/><city id="gn4260673" name="London" state="IN" state_name="Indiana" country="US" country_name="United States" lat="39.6256" long="-85.92026" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Indiana/Indianapolis" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="15993" iso_cc="US"/><city id="gn1489797" name="Tel’manskiy" state="ALT" state_name="Altayskiy" country="RS" country_name="Russia" lat="52.8" long="79.55" population="0" timezone="6" timezone_code="OMST" timezone_id="Asia/Omsk" timezone_offset="21600" localtime="Fri, 06 Oct 2017 01:21:21 OMST" region="Russia" weather_id="73947" iso_cc="RU"/><city id="gn2331921" name="London" state="DE" state_name="Delta State" country="NI" country_name="Nigeria" lat="5.72257" long="5.78787" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Lagos" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="70936" iso_cc="NG"/><city id="gn5161176" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="40.91033" long="-82.62934" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26605" iso_cc="US"/></cw_citylist><cw_citylist size="36" search_type="city"^
<city id="gn2643741" name="City of London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51279" long="-0.09184" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/^
<city id="gn2643743" name="London" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.50853" long="-0.12574" population="7556900" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="W03770" iso_cc="GB"/^
<city id="gn6058560" name="London" state="ON" state_name="null" country="CA" country_name="Canada" lat="42.98339" long="-81.23304" population="346765" timezone="-5" timezone_code="EDT" timezone_id="America/Toronto" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="" weather_id="54211" iso_cc="CA"/^
<city id="gn4517009" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="39.88645" long="-83.44825" population="9904" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26250" iso_cc="US"/^
<city id="gn2643744" name="The City" state="ENG" state_name="England" country="EL" country_name="United Kingdom" lat="51.51334" long="-0.08901" population="8000" timezone="0" timezone_code="BST" timezone_id="Europe/London" timezone_offset="0" localtime="Thu, 05 Oct 2017 20:21:21 BST" region="BritishIsles" weather_id="EGRB" iso_cc="GB"/^
<city id="gn4298960" name="London" state="KY" state_name="Kentucky" country="US" country_name="United States" lat="37.12898" long="-84.08326" population="7993" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="18256" iso_cc="US"/^
<city id="gn5367815" name="London" state="CA" state_name="California" country="US" country_name="United States" lat="36.47606" long="-119.44318" population="1869" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="southwest" weather_id="11913" iso_cc="US"/^
<city id="gn4030939" name="London Village" state="L" state_name="Line Islands" country="KR" country_name="Kiribati" lat="1.98487" long="-157.47502" population="1829" timezone="14" timezone_code="LINT" timezone_id="Pacific/Kiritimati" timezone_offset="50400" localtime="Fri, 06 Oct 2017 09:21:21 LINT" region="SouthPacific" weather_id="PLCH" iso_cc="KI"/^
<city id="gn4119617" name="London" state="AR" state_name="Arkansas" country="US" country_name="United States" lat="35.32897" long="-93.25296" population="1039" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="11244" iso_cc="US"/^
<city id="gn3581797" name="London" state="OW" state_name="Orange Walk" country="BH" country_name="Belize" lat="17.98333" long="-88.43333" population="0" timezone="-6" timezone_code="CST" timezone_id="America/Belize" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 13:21:21 CST" region="CentralAmerica" weather_id="51239" iso_cc="BZ"/^
<city id="gn1705729" name="London" state="BUK" state_name="Soccsksargen" country="RP" country_name="Philippines" lat="6.00972" long="125.12944" population="0" timezone="8" timezone_code="PHT" timezone_id="Asia/Manila" timezone_offset="28800" localtime="Fri, 06 Oct 2017 03:21:21 PHT" region="Indonesia" weather_id="RPWB" iso_cc="PH"/^
<city id="gn4812926" name="London" state="WV" state_name="West Virginia" country="US" country_name="United States" lat="38.19455" long="-81.36872" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="32636" iso_cc="US"/^
<city id="gn4637795" name="London" state="TN" state_name="Tennessee" country="US" country_name="United States" lat="35.86982" long="-83.00209" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="southeast" weather_id="29954" iso_cc="US"/^
<city id="gn4707415" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="32.23099" long="-94.94438" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="30862" iso_cc="US"/^
<city id="gn5260737" name="London" state="WI" state_name="Wisconsin" country="US" country_name="United States" lat="43.04778" long="-89.01289" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="32848" iso_cc="US"/^
<city id="gn5035441" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="47.2027" long="-91.56962" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="KBFW" iso_cc="US"/^
<city id="gn4707414" name="London" state="TX" state_name="Texas" country="US" country_name="United States" lat="30.67685" long="-99.57645" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="KJCT" iso_cc="US"/^
<city id="gn2406961" name="London" state="E" state_name="Eastern Province" country="SL" country_name="Sierra Leone" lat="8.31068" long="-10.78731" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75289" iso_cc="SL"/^
<city id="gn982299" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.76667" long="30.86667" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77048" iso_cc="ZA"/^
<city id="gn982298" name="London" state="MP" state_name="Mpumalanga" country="SF" country_name="South Africa" lat="-24.81927" long="31.04765" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="77064" iso_cc="ZA"/^
<city id="gn5035439" name="London" state="MN" state_name="Minnesota" country="US" country_name="United States" lat="43.52607" long="-93.0627" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="northcentral" weather_id="20708" iso_cc="US"/^
<city id="gn4999913" name="London" state="MI" state_name="Michigan" country="US" country_name="United States" lat="42.02004" long="-83.61327" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Detroit" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northcentral" weather_id="19913" iso_cc="US"/^
<city id="gn982300" name="London" state="LP" state_name="Limpopo" country="SF" country_name="South Africa" lat="-24.30262" long="30.5725" population="0" timezone="2" timezone_code="SAST" timezone_id="Africa/Johannesburg" timezone_offset="7200" localtime="Thu, 05 Oct 2017 21:21:21 SAST" region="Africa" weather_id="FAHS" iso_cc="ZA"/^
<city id="gn5056033" name="London" state="MO" state_name="Missouri" country="US" country_name="United States" lat="40.445" long="-95.23498" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southcentral" weather_id="22276" iso_cc="US"/^
<city id="gn3803838" name="London" state="M" state_name="Miranda" country="VE" country_name="Venezuela" lat="10.36093" long="-66.73159" population="0" timezone="-4" timezone_code="VET" timezone_id="America/Caracas" timezone_offset="-16200" localtime="Thu, 05 Oct 2017 14:51:21 VET" region="SouthAmerica" weather_id="800433" iso_cc="VE"/^
<city id="gn2308696" name="London" state="00" state_name="" country="EK" country_name="Equatorial Guinea" lat="2.26815" long="9.78934" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Malabo" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="FGBT" iso_cc="GQ"/^
<city id="gn9876172" name="London" state="S" state_name="Southern Province" country="SL" country_name="Sierra Leone" lat="7.65137" long="-12.00293" population="0" timezone="0" timezone_code="GMT" timezone_id="Africa/Freetown" timezone_offset="0" localtime="Thu, 05 Oct 2017 19:21:21 GMT" region="Africa" weather_id="75284" iso_cc="SL"/^
<city id="gn1313003" name="Lonton" state="11" state_name="Kachin" country="BM" country_name="Myanmar [Burma]" lat="25.09229" long="96.28854" population="0" timezone="6" timezone_code="MMT" timezone_id="Asia/Rangoon" timezone_offset="23400" localtime="Fri, 06 Oct 2017 01:51:21 MMT" region="CentralAsia" weather_id="XZKT" iso_cc="MM"/^
<city id="gn5737562" name="London" state="OR" state_name="Oregon" country="US" country_name="United States" lat="43.63457" long="-123.09285" population="0" timezone="-8" timezone_code="PDT" timezone_id="America/Los_Angeles" timezone_offset="-28800" localtime="Thu, 05 Oct 2017 12:21:21 PDT" region="northwest" weather_id="27686" iso_cc="US"/^
<city id="gn5198788" name="London" state="PA" state_name="Pennsylvania" country="US" country_name="United States" lat="41.14367" long="-80.14867" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="28141" iso_cc="US"/^
<city id="gn4073570" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="31.29767" long="-87.08775" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10069" iso_cc="US"/^
<city id="gn4073571" name="London" state="AL" state_name="Alabama" country="US" country_name="United States" lat="32.2732" long="-86.05024" population="0" timezone="-6" timezone_code="CDT" timezone_id="America/Chicago" timezone_offset="-21600" localtime="Thu, 05 Oct 2017 14:21:21 CDT" region="southeast" weather_id="10392" iso_cc="US"/^
<city id="gn4260673" name="London" state="IN" state_name="Indiana" country="US" country_name="United States" lat="39.6256" long="-85.92026" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/Indiana/Indianapolis" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="15993" iso_cc="US"/^
<city id="gn1489797" name="Tel’manskiy" state="ALT" state_name="Altayskiy" country="RS" country_name="Russia" lat="52.8" long="79.55" population="0" timezone="6" timezone_code="OMST" timezone_id="Asia/Omsk" timezone_offset="21600" localtime="Fri, 06 Oct 2017 01:21:21 OMST" region="Russia" weather_id="73947" iso_cc="RU"/^
<city id="gn2331921" name="London" state="DE" state_name="Delta State" country="NI" country_name="Nigeria" lat="5.72257" long="5.78787" population="0" timezone="1" timezone_code="WAT" timezone_id="Africa/Lagos" timezone_offset="3600" localtime="Thu, 05 Oct 2017 20:21:21 WAT" region="Africa" weather_id="70936" iso_cc="NG"/^
<city id="gn5161176" name="London" state="OH" state_name="Ohio" country="US" country_name="United States" lat="40.91033" long="-82.62934" population="0" timezone="-5" timezone_code="EDT" timezone_id="America/New_York" timezone_offset="-18000" localtime="Thu, 05 Oct 2017 15:21:21 EDT" region="northeast" weather_id="26605" iso_cc="US"/^
</cw_citylist^

1.6 Notes

The "id" parameter is not required to request the data.

2. Current Conditions

The current_conditons product returns available weather data from nearby weather stations. The estimated_conditions returns estimated conditions based on nearby reporting stations and model data.

2.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=current_conditions

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=estimated_conditions

2.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 
filter_no_sky_cond Optional Filters out any reporting station that is not reporgting a sky condition (filter_no_sky_cond=true).
cc.icon_now Optional Checks the current daylight status of the request at the time of the request is made and will toggle the sky condition icon between night and day if necessary (cc.icon_now=true).
version Optional Returns only one report (version=exact). Can only be used with the estimated_conditions product.

2.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the reporting station.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the reporting station in meters or feet.
state The state code of the reporting station.
state_name The state name of the reporting station.
country The country code of the reporting station.
iso_cc The ISO country code of the reporting station.
country_name The country name of the reporting station.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc The sky descriptor integer.
sky The sky descriptor text.
precip_desc The precipitation descriptor integer.
precip The precipitation descriptor text.
temp_desc The temperature descriptor integer.
temp The temperature descriptor text.
air_desc The air descriptor integer.
air The air descriptor text.
description The text summary of all the descriptors.
temperature The temperature in Celsius or Fahrenheit.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The humidity in percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
baro_pressure The barometric pressure in millibars or inches of Mercury.
baro_tendency The barometric pressure tendency initials.
barometer The barometric pressure tendency text.
visibility The visibility in kilometers or miles.
icon The weather icon integer.
icon_name The weather icon name.
iso8601 The date and time of the report in ISO 8601 format.

2.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=current_conditions&id=12156

2.5 Example Response(XML)

<report gmt_date="0711232016" unix_date="1479884664.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Tue, 22 Nov 2016 23:13:54 PST" localupdatetime="Tue, 22 Nov 2016 23:04:24 PST" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="current_conditions">
<observation city="KSFO" city_name="San Francisco" location="San Francisco International Airport" latitude="37.6188" longitude="-122.3754" elevation="5.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="18" sky="Overcast" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Overcast. Cool." temperature="14.39" wind_speed="16.68" wind_dir="150" wind_short="SE" wind_long="Southeast" humidity="72" dew_point="9.39" comfort="13.18" baro_pressure="1019.60" baro_tendency="*" barometer="" visibility="16.09" icon="17" icon_name="cloudy" iso8601="2016-11-22T22:56:00.00-08:00"/>
<observation city="KOAK" city_name="Oakland" location="Metro Oakland International Airport" latitude="37.7213" longitude="-122.2207" elevation="6.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="16" sky="Mostly cloudy" precip_desc="7" precip="Light rain" temp_desc="6" temp="Cool" air_desc="*" air="" description="Light rain. Mostly cloudy. Cool." temperature="12.78" wind_speed="22.24" wind_dir="130" wind_short="SE" wind_long="Southeast" humidity="83" dew_point="10.00" comfort="10.71" baro_pressure="1019.70" baro_tendency="*" barometer="" visibility="16.09" icon="34" icon_name="night_sprinkles" iso8601="2016-11-22T22:53:00.00-08:00"/>
</report> 

2.6 Notes

The products will return conditions for up to ten nearby locations.

3. Expanded Forecast

The expanded forecast products return daily forecast data for 7 days, 15 days or just for the current day. The times returned are the location's time zone.

3.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=expanded_forecast

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=15day_expanded_forecast

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=day1_forecast

3.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

3.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
day_sequence The day sequence in location node (1 through 7).
day_of_week The day of the week integer (1 = Sunday).
weekday The day of the week name.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
date The date of the forecast day in MMDDYY format.
iso8601 The date and time of the forecast day in ISO 8601 format.
high_temp The forecasted high temperature in Celsius or Fahrenheit.
low_temp The forecasted low temperature in Celsius or Fahrenheit.
sky_desc The sky descriptor integer.
sky The sky descriptor text.
precip_desc The precipitation descriptor integer.
precip The precipitation descriptor text.
temp_desc The temperature descriptor integer.
temp The temperature descriptor text.
air_desc The air descriptor integer.
air The air descriptor text.
description The text summary of all the descriptors.
uv_index The UV index integer.
uv The UV index text.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The relative humidity percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
rainfall The forecasted rainfall amount in centimeters or inches.
snowfall The forecasted snowfall amount in centimeters or inches.
precip_prob The propability of precipitation percentage.
icon The weather icon integer.
icon_name The weather icon name.
beaufort The beaufort scale integer.
beaufort_desc The beaufort scale text descriptor.
baro_pressure The barometric pressure in millibars or inches of Mercury.
iso8601 The date and time of the report in ISO 8601 format.

3.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=expanded_forecast&id=22256&metric=false

3.5 Example Response(XML)

<report gmt_date="0011242016" unix_date="1479948644.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 20:23:15 PST" localupdatetime="Wed, 23 Nov 2016 16:50:44 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="expanded_forecast">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast day_sequence="1" day_of_week="5" weekday="Thursday" daylight="D" date="112416" iso8601="2016-11-24T00:00:00.00-08:00" high_temp="57.92" low_temp="46.22" sky_desc="3" sky="Mostly sunny" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly sunny. Cool." uv_index="0" uv="Minimal" wind_speed="4.91" wind_dir="256" wind_short="W" wind_long="West" humidity="60" dew_point="42.39" comfort="55.63" rainfall="*" snowfall="*" precip_prob="5" icon="2" icon_name="mostly_sunny" beaufort="2" beaufort_desc="Light breeze" baro_pressure="30.37"/>
<forecast day_sequence="2" day_of_week="6" weekday="Friday" daylight="D" date="112516" iso8601="2016-11-25T00:00:00.00-08:00" high_temp="60.08" low_temp="50.18" sky_desc="17" sky="Cloudy" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Cloudy. Cool." uv_index="0" uv="Minimal" wind_speed="12.37" wind_dir="161" wind_short="S" wind_long="South" humidity="67" dew_point="48.27" comfort="57.18" rainfall="*" snowfall="*" precip_prob="19" icon="7" icon_name="cloudy" beaufort="4" beaufort_desc="Moderate breeze" baro_pressure="30.21"/>
<forecast day_sequence="3" day_of_week="7" weekday="Saturday" daylight="D" date="112616" iso8601="2016-11-26T00:00:00.00-08:00" high_temp="58.28" low_temp="53.96" sky_desc="18" sky="Overcast" precip_desc="9" precip="Rain" temp_desc="6" temp="Cool" air_desc="*" air="" description="Rain. Overcast. Cool." uv_index="0" uv="Minimal" wind_speed="14.48" wind_dir="227" wind_short="SW" wind_long="Southwest" humidity="68" dew_point="46.92" comfort="54.37" rainfall="0.50" snowfall="*" precip_prob="98" icon="19" icon_name="rain" beaufort="4" beaufort_desc="Moderate breeze" baro_pressure="29.99"/>

</location>
</report>

4. Conditions & Expanded Forecast

The Conditions and Expanded Forecast product returns a combination of the current_conditions and expanded_forecast product.

4.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=current_one

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=current_extended

4.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

4.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the reporting station.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the reporting station in meters or feet.
state The state code of the reporting station.
state_name The state name of the reporting station.
country The country code of the reporting station.
iso_cc The ISO country code of the reporting station.
country_name The country name of the reporting station.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc The sky descriptor integer.
sky The sky descriptor text.
precip_desc The precipitation descriptor integer.
precip The precipitation descriptor text.
temp_desc The temperature descriptor integer.
temp The temperature descriptor text.
air_desc The air descriptor integer.
air The air descriptor text.
description The text summary of all the descriptors.
temperature The temperature in Celsius or Fahrenheit.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The humidity in percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
baro_pressure The barometric pressure in millibars or inches of Mercury.
baro_tendency The barometric pressure tendency initials.
barometer The barometric pressure tendency text.
visibility The visibility in kilometers or miles.
icon The weather icon integer.
icon_name The weather icon name.
iso8691 The date and time of the report in ISO 8601 format.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
day_sequence The day sequence in location node (1 through 7).
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
date The date of the forecast day in MMDDYY format.
iso8601 The date and time of the forecast day in ISO 8601 format.
high_temp The forecasted high temperature in Celsius and Fahrenheit.
low_temp The forecasted low temperature in Celsius and Fahrenheit.
sky_desc The sky descriptor integer.
sky The sky descriptor text.
precip_desc The precipitation descriptor integer.
precip The precipitation descriptor text.
temp_desc The temperature descriptor integer.
temp The temperature descriptor text.
air_desc The air descriptor integer.
air The air descriptor text.
description The text summary of all the descriptors.
uv_index The UV index integer.
uv The UV index text.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The relative humidity percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
rainfall The forecasted rainfall amount in centimeters or inches.
snowfall The forecasted snowfall amount in centimeters or inches.
precip_prob The propability of precipitation percentage.
icon The weather icon integer.
icon_name The weather icon name.
beaufort The beaufort scale integer.
beaufort_desc The beaufort scale text descriptor.
baro_pressure The barometric pressure in millibars or inches of Mercury.
iso8601 The date and time of the report in ISO 8601 format.

4.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=current_one&id=22257&metric=false

4.5 Example Response(XML)

<report gmt_date="0711242017" unix_date="1479971070.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2017 23:13:43 PST" localupdatetime="Wed, 23 Nov 2017 23:04:20 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="current_conditions">
<observation city="KOAK" city_name="Oakland" location="Metro Oakland International Airport" latitude="37.7213" longitude="-122.2207" elevation="7.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="47.90" wind_speed="4.59" wind_dir="90" wind_short="E" wind_long="East" humidity="87" dew_point="43.00" comfort="44.82" baro_pressure="30.37" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:53:00.00-08:00"/>
<observation city="KSFO" city_name="San Francisco" location="San Francisco International Airport" latitude="37.7188" longitude="-122.3754" elevation="5.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="51.10" wind_speed="5.75" wind_dir="270" wind_short="W" wind_long="West" humidity="74" dew_point="43.00" comfort="49.08" baro_pressure="30.37" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:57:00.00-08:00"/>
<observation city="KHWD" city_name="Hayward" location="Hayward Air Terminal" latitude="37.7592" longitude="-122.1218" elevation="14.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="47.90" wind_speed="7.89" wind_dir="70" wind_short="NE" wind_long="Northeast" humidity="74" dew_point="39.00" comfort="43.47" baro_pressure="30.40" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:54:00.00-08:00"/>
<observation city="KSQL" city_name="San Carlos Airport" location="San Carlos Airport" latitude="37.5100" longitude="-122.2500" elevation="2.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="7" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="50.00" wind_speed="0.00" wind_dir="0" wind_short="N" wind_long="North" humidity="82" dew_point="44.70" comfort="50.00" baro_pressure="30.39" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:50:00.00-08:00"/>
<observation city="KCCR" city_name="Concord" location="Buchanan Field" latitude="37.9897" longitude="-122.0579" elevation="7.00" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="5" temp="Quite cool" air_desc="*" air="" description="Clear. Quite cool." temperature="44.10" wind_speed="0.00" wind_dir="0" wind_short="N" wind_long="North" humidity="82" dew_point="39.00" comfort="44.10" baro_pressure="30.34" baro_tendency="*" barometer="" visibility="10.00" icon="13" icon_name="night_clear" iso8701="2017-11-23T22:53:00.00-08:00"/>
</report>

4.6 Notes

The current_one product will return just the day one of the 7-day forecast.

5. Detailed Forecast

The detailed forecast product returns a rolling forecast broken down into four segments per day (Morning, Afternoon, Evening, Overnight) for the next 48 hours or 5 days.

5.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_forecast

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_forecast_5day

5.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

5.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
segment The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment The time segment of the day text.
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
date The date of the forecast day in MMDDYY format.
iso8601 The date and time of the forecast day in ISO 8601 format.
high_temp The forecasted high temperature in Celsius and Fahrenheit.
low_temp The forecasted low temperature in Celsius and Fahrenheit.
sky_desc The sky descriptor integer.
sky The sky descriptor text.
precip_desc The precipitation descriptor integer.
precip The precipitation descriptor text.
temp_desc The temperature descriptor integer.
temp The temperature descriptor text.
air_desc The air descriptor integer.
air The air descriptor text.
description The text summary of all the descriptors.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The relative humidity percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
rainfall The forecasted rainfall amount in centimeters or inches.
snowfall The forecasted snowfall amount in centimeters or inches.
precip_prob The propability of precipitation percentage.
icon The weather icon integer.
icon_name The weather icon name.
beaufort The beaufort scale integer.
beaufort_desc The beaufort scale text descriptor.
iso8601 The date and time of the report in ISO 8601 format.

5.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_forecast&id=22256&metric=false

5.5 Example Response(XML)

<report gmt_date="0011242016" unix_date="1479948644.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 21:04:26 PST" localupdatetime="Wed, 23 Nov 2016 16:50:44 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_forecast">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="E" day_segment="Evening" day_of_week="4" weekday="Wednesday" iso8601="2016-11-23T18:00:00.00-08:00" daylight="N" sky_desc="4" sky="Mostly clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly clear. Cool." temperature="52.52" wind_speed="8.70" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="333" wind_short="NW" wind_long="Northwest" dew_point="43.88" humidity="73" comfort="49.55" visibility="7.56" rainfall="*" snowfall="*" precip_prob="1" icon="14" icon_name="night_mostly_clear"/>
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" iso8601="2016-11-24T00:00:00.00-08:00" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="47.30" wind_speed="5.80" beaufort="2" beaufort_desc="Light breeze" wind_dir="349" wind_short="N" wind_long="North" dew_point="42.80" humidity="84" comfort="44.53" visibility="7.01" rainfall="*" snowfall="*" precip_prob="1" icon="13" icon_name="night_clear"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" iso8601="2016-11-24T06:00:00.00-08:00" daylight="D" sky_desc="3" sky="Mostly sunny" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly sunny. Cool." temperature="46.22" wind_speed="5.36" beaufort="2" beaufort_desc="Light breeze" wind_dir="71" wind_short="E" wind_long="East" dew_point="42.98" humidity="89" comfort="43.52" visibility="7.42" rainfall="*" snowfall="*" precip_prob="0" icon="2" icon_name="mostly_sunny"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" iso8601="2016-11-24T12:00:00.00-08:00" daylight="D" sky_desc="3" sky="Mostly sunny" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly sunny. Cool." temperature="57.92" wind_speed="5.13" beaufort="2" beaufort_desc="Light breeze" wind_dir="322" wind_short="NW" wind_long="Northwest" dew_point="42.26" humidity="56" comfort="57.43" visibility="8.47" rainfall="*" snowfall="*" precip_prob="0" icon="2" icon_name="mostly_sunny"/>
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" iso8601="2016-11-24T18:00:00.00-08:00" daylight="N" sky_desc="4" sky="Mostly clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Mostly clear. Cool." temperature="48.56" wind_speed="3.57" beaufort="1" beaufort_desc="Light air" wind_dir="236" wind_short="SW" wind_long="Southwest" dew_point="42.80" humidity="81" comfort="47.52" visibility="7.06" rainfall="*" snowfall="*" precip_prob="2" icon="14" icon_name="night_mostly_clear"/>
</location>
</report>

6. Astronomy Data

The astronomy data product returns the moonrise/moonset and sunrise/sunset times for the current day or the next 5 days.

6.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=astronomy_forecast

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=astronomy_forecast_ext

6.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

6.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
sunrise The location's time of sunrise in h:mm%z format.
sunset The location's time of sunset in h:mm%z format.
moonrise The location's time of moonrise in h:mm%z format.
moonset The location's time of moonset in h:mm%z format.
moon_phase The moon phase expressed as floating point number between -1 and 1.
moon_phase_desc The moon phase text.
icon_name The weather icon name.
iso8601 The date and time of the forecast day in ISO 8601 format.

6.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=astronomy_forecast&id=22256&metric=false

6.5 Example Response(XML)

<report gmt_date="0811232016" unix_date="1479888302.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 21:19:28 PST" localupdatetime="Wed, 23 Nov 2016 00:05:02 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="astronomy_forecast">
<forecast city="12156" city_name="San Francisco" location="San Francisco" latitude="37.77" longitude="-122.42" sunrise="6:59AM" sunset="4:53PM" moonrise="1:33AM" moonset="2:07PM" moon_phase="-0.338" moon_phase_desc="Waning crescent" icon_name="cw_waning_crescent" iso8601="2016-11-23T00:00:00.00-08:00"/>
</report>

7. Detailed Marine

The detailed marine products returns a rolling forecast broken down into four segments per day (Morning, Afternoon, Evening, Overnight) for the next 48 hours or 7 days for the open ocean and 5 days for the Mediterranean daily.

7.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=one_detailed_marine

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_marine_7day

7.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

7.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
segment The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment The time segment of the day text.
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
wind_desc The wind descriptor integer.
wind The wind descriptor text.
sea_state_desc The sea state integer.
sea_state The sea state text.
wave_desc The wave descriptor integer.
wave The wave descriptor text.
surf_desc The surf descriptor integer.
surf The surf descriptor text.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_gusts The wind gusts in kilometers per mile or miles per hour.
wind_direction The wind direction in compass degrees.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
wave_height The wave height in meters or feet.
mean_wave_direction The mean wave direction in compass degrees.
mean_wave_direction_short The cardinal and intercardinal mean wave direction initials.
mean_wave_direction_long The cardinal and intercardinal mean wave direction.
mean_wave_period The mean wave period is in seconds.
wind_wave_direction The wind wave direction in compass degrees.
wind_wave_direction_short The cardinal and intercardinal wind wave direction initials.
wind_wave_direction_long The cardinal and intercardinal wind wave direction.
wind_wave_period The wind wave period is in seconds.
peak_wave_direction The peak wave direction in compass degrees.
peak_wave_direction_short The cardinal and intercardinal peak wave direction initials.
peak_wave_direction_long The cardinal and intercardinal peak wave direction.
peak_wave_period The peak wave period is in seconds.
sea_surface_temp The sea surface temperature in Celsius or Fahrenheit.
iso8601 The date and time of the forecast day in ISO 8601 format.

7.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=one_detailed_marine&id=12156&metric=false

7.5 Example Response(XML)

<report gmt_date="0211242016" unix_date="1479954274.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 23 Nov 2016 21:31:55 PST" localupdatetime="Wed, 23 Nov 2016 18:24:34 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_marine">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="E" day_segment="Evening" day_of_week="4" weekday="Wednesday" wind_desc="2" wind="Light winds" sea_state_desc="6" sea_state="Rough" wave_desc="5" wave="Big waves" surf_desc="8" surf="Double-overhead waves" wind_speed="8.70" wind_gusts="13.80" wind_direction="356.23" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="356.23" wind_short="N" wind_long="North" wave_height="12.70" mean_wave_direction="296.29" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.84" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="297.29" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="14.93" sea_surface_temp="58.32" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_calm" baro_pressure="30.09" iso8601="2016-11-23T18:00:00.00-08:00"/>
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" wind_desc="2" wind="Light winds" sea_state_desc="6" sea_state="Rough" wave_desc="5" wave="Big waves" surf_desc="8" surf="Double-overhead waves" wind_speed="8.12" wind_gusts="12.88" wind_direction="356.20" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="356.20" wind_short="N" wind_long="North" wave_height="12.21" mean_wave_direction="296.87" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.87" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="297.59" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="14.83" sea_surface_temp="58.32" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_calm" baro_pressure="30.10" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" wind_desc="2" wind="Light winds" sea_state_desc="6" sea_state="Rough" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="7.14" wind_gusts="11.33" wind_direction="16.28" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="16.28" wind_short="N" wind_long="North" wave_height="10.89" mean_wave_direction="297.68" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.56" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="298.62" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="14.43" sea_surface_temp="58.32" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_calm" baro_pressure="30.11" iso8601="2016-11-24T06:00:00.00-08:00"/>
</location>
</report>

8. Extended Marine

The extended marine product returns open ocean 7-day and Mediterranean Sea 5-day daily marine forecast data.

8.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=one_extended_marine

8.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

8.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
day_sequence The day sequence in location node (1 through 7).
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
wind_desc The wind descriptor integer.
wind The wind descriptor text.
sea_state_desc The sea state integer.
sea_state The sea state text.
wave_desc The wave descriptor integer.
wave The wave descriptor text.
surf_desc The surf descriptor integer.
surf The surf descriptor text.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_gusts The wind gusts in kilometers per mile or miles per hour.
wind_direction The wind direction in compass degrees.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
wave_height The wave height in meters or feet.
mean_wave_direction The mean wave direction in compass degrees.
mean_wave_direction_short The cardinal and intercardinal mean wave direction initials.
mean_wave_direction_long The cardinal and intercardinal mean wave direction.
mean_wave_period The mean wave period is in seconds.
wind_wave_direction The wind wave direction in compass degrees.
wind_wave_direction_short The cardinal and intercardinal wind wave direction initials.
wind_wave_direction_long The cardinal and intercardinal wind wave direction.
wind_wave_period The wind wave period is in seconds.
peak_wave_direction The peak wave direction in compass degrees.
peak_wave_direction_short The cardinal and intercardinal peak wave direction initials.
peak_wave_direction_long The cardinal and intercardinal peak wave direction.
peak_wave_period The peak wave period is in seconds.
sea_surface_temp The sea surface temperature in Celsius or Fahrenheit.
baro_pressure The barometric pressure in millibars or inches of Mercury.
iso8601 The date and time of the forecast day in ISO 8601 format.

8.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=one_extended_marine&id=22256&metric=false

8.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1410202017" unix_date="1508509529.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Fri, 20 Oct 2017 10:30:26 PDT" localupdatetime="Fri, 20 Oct 2017 07:25:29 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="extended_marine" >
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast day_sequence="1" day_of_week="6" weekday="Friday" wind_desc="3" wind="Breezy conditions" sea_state_desc="6" sea_state="Rough" wave_desc="5" wave="Big waves" surf_desc="8" surf="Double-overhead waves" wind_speed="19.40" wind_gusts="30.79" wind_direction="307.75" beaufort="4" beaufort_desc="Moderate breeze" wind_dir="307.75" wind_short="NW" wind_long="Northwest" wave_height="4.59" mean_wave_direction="299.88" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="13.58" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="300.9" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="15.91" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1017.96" iso8601="2017-10-20T00:00:00.00-07:00" />
<forecast day_sequence="2" day_of_week="7" weekday="Saturday" wind_desc="3" wind="Breezy conditions" sea_state_desc="6" sea_state="Rough" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="18.26" wind_gusts="28.98" wind_direction="324.45" beaufort="4" beaufort_desc="Moderate breeze" wind_dir="324.45" wind_short="NW" wind_long="Northwest" wave_height="3.03" mean_wave_direction="300.92" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="11.77" wind_wave_direction="340.63" wind_wave_direction_short="N" wind_wave_direction_long="North" wind_wave_period="4.01" peak_wave_direction="301.68" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="13.52" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1018.29" iso8601="2017-10-21T00:00:00.00-07:00" />
<forecast day_sequence="3" day_of_week="1" weekday="Sunday" wind_desc="4" wind="Windy conditions" sea_state_desc="4" sea_state="Moderate Chop" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="29.27" wind_gusts="46.45" wind_direction="334.43" beaufort="5" beaufort_desc="Fresh breeze" wind_dir="334.43" wind_short="NW" wind_long="Northwest" wave_height="2.92" mean_wave_direction="302.03" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="10.72" wind_wave_direction="318.26" wind_wave_direction_short="NW" wind_wave_direction_long="Northwest" wind_wave_period="7.0" peak_wave_direction="301.3" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="12.36" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1018.62" iso8601="2017-10-22T00:00:00.00-07:00" />
<forecast day_sequence="4" day_of_week="2" weekday="Monday" wind_desc="3" wind="Breezy conditions" sea_state_desc="6" sea_state="Rough" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="18.57" wind_gusts="29.47" wind_direction="339.65" beaufort="4" beaufort_desc="Moderate breeze" wind_dir="339.65" wind_short="N" wind_long="North" wave_height="3.00" mean_wave_direction="296.86" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="12.18" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="293.31" peak_wave_direction_short="NW" peak_wave_direction_long="Northwest" peak_wave_period="15.39" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1018.96" iso8601="2017-10-23T00:00:00.00-07:00" />
<forecast day_sequence="5" day_of_week="3" weekday="Tuesday" wind_desc="3" wind="Breezy conditions" sea_state_desc="3" sea_state="Light Chop" wave_desc="4" wave="Large waves" surf_desc="7" surf="Overhead waves" wind_speed="17.93" wind_gusts="28.45" wind_direction="334.91" beaufort="3" beaufort_desc="Gentle breeze" wind_dir="334.91" wind_short="NW" wind_long="Northwest" wave_height="2.42" mean_wave_direction="296.02" mean_wave_direction_short="NW" mean_wave_direction_long="Northwest" mean_wave_period="11.64" wind_wave_direction="*" wind_wave_direction_short="" wind_wave_direction_long="" wind_wave_period="*" peak_wave_direction="286.47" peak_wave_direction_short="W" peak_wave_direction_long="West" peak_wave_period="14.71" sea_surface_temp="14.57" wave_icon_name="cw_marine_large" wind_icon_name="cw_wind_light" baro_pressure="1019.29" iso8601="2017-10-24T00:00:00.00-07:00" />
</location>
</report>

9. Hourly Forecast

The hourly forecast product returns hourly forecasts for 12 hours, 48 hours or 7 days.

9.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hourly_forecast

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hourly_forecast_12hr

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hourly_forecast_48hr

9.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

9.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
id The location's ID code.
utc_time The GMT time and date of the forecast hour in HHMMDDYYYY format.
local_time The local time and date of the forecast hour in HHMMDDYYYY format.
date_format Format of utc_time and local_time.
day_of_week_utc The GMT day of the week integer (1 = Sunday).
day_of_week_local The local day of the week integer (1 = Sunday).
weekday_utc The GMT day of the week name.
weekday_local The local day of the week name.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc The sky descriptor integer.
sky The sky descriptor text.
precip_desc The precipitation descriptor integer.
precip The precipitation descriptor text.
temp_desc The temperature descriptor integer.
temp The temperature descriptor text.
air_desc The air descriptor integer.
air The air descriptor text.
description The text summary of all the descriptors.
temperature The temperature in Celsius or Fahrenheit.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The humidity in percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
visibility The visibility in kilometers or miles.
precip_prob The propability of precipitation percentage.
icon The weather icon integer.
icon_name The weather icon name.
iso8691 The date and time of the forecast in ISO 8601 format.

9.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hourly_forecast&id=12156&metric=false

9.5 Example Response(XML)

<report gmt_date="0811242016" unix_date="1489985836.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 00:54:35 PST" localupdatetime="Thu, 24 Nov 2016 00:22:16 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="38.88" tzinfo="America/Los_Angeles" elevation="10.00" name="hourly_forecast">
<location city="12156" city_name="San Francisco" latitude="38.88" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast id="12156" utc_time="0811242016" local_time="2311232016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="4" weekday_utc="Thursday" weekday_local="Wednesday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="51.08" wind_speed="9.82" wind_dir="354" wind_short="N" wind_long="North" dew_point="41.90" humidity="81" comfort="48.41" visibility="8.48" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-23T23:00:00.00-08:00"/>
<forecast id="12156" utc_time="0811242016" local_time="0011242016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="5" weekday_utc="Thursday" weekday_local="Thursday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="50.36" wind_speed="10.04" wind_dir="6" wind_short="N" wind_long="North" dew_point="41.54" humidity="82" comfort="46.44" visibility="8.98" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast id="12156" utc_time="0911242016" local_time="0111242016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="5" weekday_utc="Thursday" weekday_local="Thursday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="49.28" wind_speed="8.80" wind_dir="28" wind_short="NE" wind_long="Northeast" dew_point="41.54" humidity="85" comfort="45.58" visibility="8.53" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-24T01:00:00.00-08:00"/>
<forecast id="12156" utc_time="1011242016" local_time="0211242016" date_format="HHMMddyyyy" day_of_week_utc="5" day_of_week_local="5" weekday_utc="Thursday" weekday_local="Thursday" daylight="N" sky_desc="2" sky="Clear" precip_desc="*" precip="" temp_desc="6" temp="Cool" air_desc="*" air="" description="Clear. Cool." temperature="48.02" wind_speed="8.48" wind_dir="35" wind_short="NE" wind_long="Northeast" dew_point="41.36" humidity="88" comfort="44.11" visibility="8.03" rainfall="*" snowfall="*" precip_prob="0" icon="13" icon_name="night_clear" iso8601="2016-11-24T02:00:00.00-08:00"/>
</location>
</report>

10. Buoy Data

The buoy data product returns buoy data from available worldwide stations.

10.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=buoy_report

10.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

10.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
buoy_id The buoy's ID code.
buoy_name The buoy name.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
date The date and time of the data in MMDDHH format.
air_temperature The air temperature in Celsius or Fahrenheit.
dew_point The dew point temperature in Celsius or Fahrenheit.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_gusts The wind gusts in kilometers per mile or miles per hour.
wind_direction The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
wind_long The cardinal and intercardinal wind direction.
humidity The humidity in percentage.
beaufort_desc The beaufort scale text descriptor.
baro_pressure The barometric pressure in millibars or inches of Mercury.
baro_pressure The barometric pressure in millibars or inches of Mercury.
baro_tendency The barometric pressure tendency initials.
barometer The barometric pressure tendency text.
visibility The visibility in kilometers or miles.
water_temperature The water temperature in Celsius or Fahrenheit.
wave_height The wave height in meters or feet.
wave_period The wave period in seconds.
iso8601 The date and time of the report in ISO 8601 format.

10.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=buoy_report&id=12156&metric=false

10.5 Example Response(XML)

<report gmt_date="0911242016" unix_date="1479977703.000000" timezone="-9" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 01:26:14 PST" localupdatetime="Thu, 24 Nov 2016 00:55:03 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="buoy_report">
<observation buoy_id="bRTYC1" buoy_name="Redwood City" latitude="37.51" longitude="-122.21" date="112409" air_temperature="47.70" dew_point="*" wind_speed="2.30" wind_gusts="*" wind_direction="190" beaufort="1" beaufort_desc="Light air" wind_short="S" wind_long="South" baro_pressure="30.36" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="59.29" wave_height="*" wave_period="*"/>
<observation buoy_id="b46026" buoy_name="San Francisco" latitude="37.76" longitude="-122.93" date="112409" air_temperature="54.50" dew_point="*" wind_speed="9.04" wind_gusts="*" wind_direction="340" beaufort="3" beaufort_desc="Gentle breeze" wind_short="N" wind_long="North" baro_pressure="30.36" baro_tendency="0.0" barometer="Steady" visibility="*" water_temperature="56.66" wave_height="10.17" wave_period="4.0"/>
<observation buoy_id="bPCOC1" buoy_name="Port Chicago" latitude="39.06" longitude="-122.04" date="112409" air_temperature="46.90" dew_point="*" wind_speed="9.19" wind_gusts="*" wind_direction="190" beaufort="3" beaufort_desc="Gentle breeze" wind_short="S" wind_long="South" baro_pressure="30.35" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="59.46" wave_height="*" wave_period="*"/>
<observation buoy_id="b46012" buoy_name="Half Moon Bay" latitude="37.39" longitude="-122.72" date="112409" air_temperature="55.90" dew_point="*" wind_speed="9.04" wind_gusts="*" wind_direction="350" beaufort="3" beaufort_desc="Gentle breeze" wind_short="N" wind_long="North" baro_pressure="30.34" baro_tendency="0.0" barometer="Steady" visibility="*" water_temperature="59.10" wave_height="14.76" wave_period="4.0"/>
<observation buoy_id="b46013" buoy_name="Bodega" latitude="39.22" longitude="-123.33" date="112409" air_temperature="54.70" dew_point="45.10" wind_speed="9.04" wind_gusts="*" wind_direction="350" beaufort="3" beaufort_desc="Gentle breeze" wind_short="N" wind_long="North" baro_pressure="30.39" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="57.56" wave_height="*" wave_period="*"/>
<observation buoy_id="b46042" buoy_name="Monterey" latitude="36.75" longitude="-122.42" date="112409" air_temperature="55.90" dew_point="*" wind_speed="*" wind_gusts="*" wind_direction="*" beaufort="0" beaufort_desc="Calm" wind_short="" wind_long="" baro_pressure="30.35" baro_tendency="0.3" barometer="Rising" visibility="*" water_temperature="57.20" wave_height="15.09" wave_period="6.0"/>
<observation buoy_id="b46114" buoy_name="West Monterey Bay" latitude="36.71" longitude="-122.342" date="112409" air_temperature="*" dew_point="*" wind_speed="*" wind_gusts="*" wind_direction="*" beaufort="0" beaufort_desc="Calm" wind_short="" wind_long="" baro_pressure="*" baro_tendency="*" barometer="Rising" visibility="*" water_temperature="57.02" wave_height="14.76" wave_period="11.3"/>
</report>

11. Detailed Fire Danger

The fire danger product returns the probability of fire danger for specific areas based on soil moisture and weather conditions broken down into four segments per day (Morning, Afternoon, Evening, Overnight) for the next 48 hours. Indicates the reason for probability, for example, high winds.

11.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_fire_danger

11.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

11.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
segment The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment The time segment of the day text.
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
danger_level The fire danger level integer (0-4).
level The fire danger text.
danger_reason The fire danger reason integer (0-8).
reason The fire danger reason text.
upper_soil_moisture The upper soil moisture in mm or inches.
lower_soil_moisture The lower soil moisture in mm or inches.
icon_name The weather icon name.
iso8691 The date and time of the forecast in ISO 8601 format.

11.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_fire_danger&id=12156&metric=false

11.5 Example Response(XML)

<report gmt_date="0611242016" unix_date="147101067511.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 01:310:16 PST" localupdatetime="Wed, 23 Nov 2016 22:05:11 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_fire_danger">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T18:00:00.00-08:00"/>
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T18:00:00.00-08:00"/>
</location>
</report>

12. Extended Fire Danger

The fire danger product returns the probability of fire danger for specific areas based on soil moisture and weather conditions for the next 5 days. Indicates the reason for probability, for example, high winds.

12.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=extended_fire_danger

12.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

12.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
segment The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment The time segment of the day text.
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
danger_level The fire danger level integer (0-4).
level The fire danger text.
danger_reason The fire danger reason integer (0-8).
reason The fire danger reason text.
upper_soil_moisture The upper soil moisture in mm or inches.
lower_soil_moisture The lower soil moisture in mm or inches.
icon_name The weather icon name.
iso8691 The date and time of the forecast in ISO 8601 format.

12.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_fire_danger&id=12156&metric=false

12.5 Example Response(XML)

<report gmt_date="0611242016" unix_date="147101067511.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 24 Nov 2016 01:310:16 PST" localupdatetime="Wed, 23 Nov 2016 22:05:11 PST" metric="false" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="detailed_fire_danger">
<location city="12156" city_name="San Francisco" latitude="37.77" longitude="-122.42" location="San Francisco" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="0.00">
<forecast segment="N" day_segment="Night" day_of_week="4" weekday="Wednesday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-24T18:00:00.00-08:00"/>
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Thursday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T00:00:00.00-08:00"/>
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T06:00:00.00-08:00"/>
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T12:00:00.00-08:00"/>
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" danger_level="0" level="Fire danger very low" danger_reason="*" reason="" upper_soil_moisture="0.26" lower_soil_moisture="0.23" icon_name="cw_fire_vlow" iso8601="2016-11-25T18:00:00.00-08:00"/>
</location>
</report>

13. Hurricane

The hurricane products returns all the active tropical storms.

13.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hurricane

13.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 
hurricane.code Optional The name of the storm from previous years. The format is YYYY_stormname, e.g. 2015_Dolores.

13.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
code The CustomWeather storm code (YYYY_stormname)
name Full name of the tropical system
current_pressue The tropical system's current pressure
current_movement_deg The tropical system's current movement in degrees
current_movement_kmh The tropical system's current speed in kilometers per hour (if metric units are requested)
current_movement_mph The tropical system's current speed in miles per hour (if Imperial units are requested)
iso_date The date and time of the update in ISO 8601 format.
utc_time The date and time of the update in %m/%d/%Y %H:%M format in UTC time.
locale_time Same as utc_time
latitude The latitude coordinates in decimal degrees of the tropical system's current position.
longitude The longitude coordinates in decimal degrees of the tropical system's current position.
wind_speed The tropical system's current wind speed.
wind_gusts The tropical system's current wind gusts.
category The category strength of the tropical system.
storm_name The tropical system's name.
local_storm_name The tropical system's local name.
type Observation or forecast.
comments Comment from the National Hurricane Center.
NE_12ft_radii 12 foot sea radii in NE quadrant in feet or meters.
SE_12ft_radii 12 foot sea radii in SE quadrant in feet or meters.
SW_12ft_radii 12 foot sea radii in SW quadrant in feet or meters.
NW_12ft_radii 12 foot sea radii in NW quadrant in feet or meters.
minimum_wind_speed The minimum wind speed radii in knots. The subsequent quadrant attributes return the distance of the radii.
northeast The distance in miles or kilometers of the wind radii in the northeast quadrant.
southeast The distance in miles or kilometers of the wind radii in the southeast quadrant.
southwest The distance in miles or kilometers of the wind radii in the southwest quadrant.
northwest The distance in miles or kilometers of the wind radii in the northwest quadrant.
iso8601 The date and time of the report in ISO 8601 format.

13.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=hurricane

13.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1710202017" unix_date="1508521492.000000">
<hurricane code="2017_25W" name="Tropical Depression TWENTYFIVE" current_pressure="1012.312" current_movement_deg="300" current_movement_kmh="11.11">
    <period iso_date="2017-10-15T12:00:00Z" utc_time="10/15/2017 12:00 UTC" locale_time="10/15/2017 12:00 UTC" latitude="9.3" longitude="136.8" wind_speed="46.3" wind_gusts="64.82" category="Tropical Depression" storm_name="TWENTYFIVE" local_storm_name="Tropical Depression TWENTYFIVE" type="observation" comments="151500Z POSITION NEAR 9.5N 136.5E. TROPICAL DEPRESSION 25W (TWENTYFIVE), LOCATED APPROXIMATELY 78 NM WEST OF YAP, CNMI, HAS TRACKED WEST-NORTHWESTWARD AT 06 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 151200Z IS 8 FEET. NEXT WARNINGS AT 152100Z, 160300Z, 160900Z AND 161500Z. REFER TO TYPHOON 24W (KHANUN) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES. THIS CANCELS AND SUPERSEDES REF A (WTPN21 PGTW 150230)." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1012">
        <wind_radii minimum_wind_speed="34.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-16T06:00:00Z" utc_time="10/16/2017 06:00 UTC" locale_time="10/16/2017 06:00 UTC" latitude="11.0" longitude="134.7" wind_speed="64.82" wind_gusts="83.34" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Depression LAN" type="observation" comments="160900Z POSITION NEAR 11.1N 134.4E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 220 NM WEST-NORTHWEST OF YAP, FSM, HAS TRACKED WEST-NORTHWESTWARD AT 11 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 160600Z IS 12 FEET. NEXT WARNINGS AT 161500Z, 162100Z, 170300Z AND 170900Z. REFER TO TROPICAL DEPRESSION 24W (KHANUN) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1007">
        <wind_radii minimum_wind_speed="34.0" northeast="101.85" southeast="194.45" southwest="74.08" northwest="92.6"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-16T12:00:00Z" utc_time="10/16/2017 12:00 UTC" locale_time="10/16/2017 12:00 UTC" latitude="10.7" longitude="133.3" wind_speed="64.82" wind_gusts="83.34" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Depression LAN" type="observation" comments="161500Z POSITION NEAR 10.8N 133.1E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 214 NM NORTH- NORTHWEST OF KOROR, PALAU, HAS TRACKED WESTWARD AT 12 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 161200Z IS 12 FEET. NEXT WARNINGS AT 162100Z, 170300Z, 170900Z AND 171500Z. REFER TO TROPICAL CYCLONE 24W (KHANUN) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1007">
        <wind_radii minimum_wind_speed="34.0" northeast="101.85" southeast="194.45" southwest="74.08" northwest="92.6"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-16T18:00:00Z" utc_time="10/16/2017 18:00 UTC" locale_time="10/16/2017 18:00 UTC" latitude="10.7" longitude="132.3" wind_speed="74.08" wind_gusts="92.6" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Storm LAN" type="observation" comments="162100Z POSITION NEAR 10.7N 132.1E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 239 NM NORTH- NORTHWEST OF KOROR, HAS TRACKED WESTWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 161800Z IS 15 FEET. NEXT WARNINGS AT 170300Z, 170900Z, 171500Z AND 172100Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="1003">
        <wind_radii minimum_wind_speed="34.0" northeast="259.27" southeast="138.89" southwest="138.89" northwest="259.27"/>
        <wind_radii minimum_wind_speed="50.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-17T06:00:00Z" utc_time="10/17/2017 06:00 UTC" locale_time="10/17/2017 06:00 UTC" latitude="10.0" longitude="132.2" wind_speed="92.6" wind_gusts="120.37" category="Tropical Storm" storm_name="LAN" local_storm_name="Tropical Storm LAN" type="observation" comments="170900Z POSITION NEAR 10.2N 132.2E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 187 NM NORTHWEST OF KAYANGEL, HAS TRACKED SOUTH-SOUTHEASTWARD AT 03 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 170600Z IS 18 FEET. NEXT WARNINGS AT 171500Z, 172100Z, 180300Z AND 180900Z. " NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="994">
        <wind_radii minimum_wind_speed="34.0" northeast="148.15" southeast="120.37" southwest="120.37" northwest="166.67"/>
        <wind_radii minimum_wind_speed="50.0" northeast="64.82" southeast="46.3" southwest="46.3" northwest="74.08"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-17T12:00:00Z" utc_time="10/17/2017 12:00 UTC" locale_time="10/17/2017 12:00 UTC" latitude="10.2" longitude="132.4" wind_speed="101.85" wind_gusts="129.63" category="Tropical Storm" storm_name="LAN" local_storm_name="Severe Tropical Storm LAN" type="observation" comments="171500Z POSITION NEAR 10.6N 132.4E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 186 NM NORTHWEST OF KAYANGEL, HAS TRACKED NORTHEASTWARD AT 03 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 171200Z IS 18 FEET. NEXT WARNINGS AT 172100Z, 180300Z, 180900Z AND 181500Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="148.15" southeast="175.93" southwest="194.45" northwest="185.19"/>
        <wind_radii minimum_wind_speed="50.0" northeast="64.82" southeast="83.34" southwest="92.6" northwest="92.6"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-17T18:00:00Z" utc_time="10/17/2017 18:00 UTC" locale_time="10/17/2017 18:00 UTC" latitude="10.8" longitude="132.4" wind_speed="111.11" wind_gusts="138.89" category="Tropical Storm" storm_name="LAN" local_storm_name="Severe Tropical Storm LAN" type="observation" comments="172100Z POSITION NEAR 11.2N 132.4E. TROPICAL STORM 25W (LAN), LOCATED APPROXIMATELY 212 NM NORTHWEST OF KAYANGEL, HAS TRACKED NORTH-NORTHEASTWARD AT 04 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 171800Z IS 21 FEET. NEXT WARNINGS AT 180300Z, 180900Z, 181500Z AND 182100Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="240.75" southeast="370.38" southwest="370.38" northwest="240.75"/>
        <wind_radii minimum_wind_speed="50.0" northeast="111.11" southeast="138.89" southwest="138.89" northwest="111.11"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T00:00:00Z" utc_time="10/18/2017 00:00 UTC" locale_time="10/18/2017 00:00 UTC" latitude="12.1" longitude="132.3" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="180300Z POSITION NEAR 12.5N 132.2E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 314 NM NORTH-NORTHWEST OF KOROR, HAS TRACKED NORTHWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 180000Z IS 25 FEET. NEXT WARNINGS AT 180900Z, 181500Z, 182100Z AND 190300Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="305.56" southeast="351.86" southwest="379.64" northwest="231.49"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="194.45" southwest="212.97" northwest="120.37"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T06:00:00Z" utc_time="10/18/2017 06:00 UTC" locale_time="10/18/2017 06:00 UTC" latitude="12.9" longitude="132.3" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="180900Z POSITION NEAR 13.4N 132.1E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 321 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTHWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 180600Z IS 25 FEET. NEXT WARNINGS AT 181500Z, 182100Z, 190300Z AND 190900Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="981">
        <wind_radii minimum_wind_speed="34.0" northeast="333.34" southeast="398.16" southwest="379.64" northwest="250.01"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="194.45" southwest="212.97" northwest="120.37"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T12:00:00Z" utc_time="10/18/2017 12:00 UTC" locale_time="10/18/2017 12:00 UTC" latitude="14.2" longitude="131.8" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="181500Z POSITION NEAR 14.5N 131.6E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 404 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTH-NORTHWESTWARD AT 14 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 181200Z IS 25 FEET. NEXT WARNINGS AT 182100Z, 190300Z, 190900Z AND 191500Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="977">
        <wind_radii minimum_wind_speed="34.0" northeast="314.82" southeast="592.61" southwest="500.01" northwest="370.38"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="259.27" southwest="231.49" northwest="148.15"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-18T18:00:00Z" utc_time="10/18/2017 18:00 UTC" locale_time="10/18/2017 18:00 UTC" latitude="14.7" longitude="131.4" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="182100Z POSITION NEAR 15.1N 131.2E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 441 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTH-NORTHWESTWARD AT 08 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 181800Z IS 27 FEET. NEXT WARNINGS AT 190300Z, 190900Z, 191500Z AND 192100Z. REFER TO TROPICAL CYCLONE 26W (TWENTYSIX) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="977">
        <wind_radii minimum_wind_speed="34.0" northeast="305.56" southeast="305.56" southwest="175.93" northwest="296.3"/>
        <wind_radii minimum_wind_speed="50.0" northeast="166.67" southeast="166.67" southwest="83.34" northwest="157.41"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T00:00:00Z" utc_time="10/19/2017 00:00 UTC" locale_time="10/19/2017 00:00 UTC" latitude="15.4" longitude="130.6" wind_speed="120.37" wind_gusts="148.15" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="190300Z POSITION NEAR 15.8N 130.4E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 500 NM NORTH-NORTHWEST OF KAYANGEL, HAS TRACKED NORTHWESTWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 190000Z IS 28 FEET. NEXT WARNINGS AT 190900Z, 191500Z, 192100Z AND 200300Z. REFER TO TROPICAL DEPRESSION 26W (TWENTYSIX) WARNINGS (WTPN31 PGTW) FOR SIX- HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="977">
        <wind_radii minimum_wind_speed="34.0" northeast="259.27" southeast="259.27" southwest="222.23" northwest="185.19"/>
        <wind_radii minimum_wind_speed="50.0" northeast="138.89" southeast="138.89" southwest="111.11" northwest="92.6"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T06:00:00Z" utc_time="10/19/2017 06:00 UTC" locale_time="10/19/2017 06:00 UTC" latitude="16.3" longitude="130.1" wind_speed="138.89" wind_gusts="166.67" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="190900Z POSITION NEAR 16.7N 130.0E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 625 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED NORTH-NORTHWESTWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 190600Z IS 30 FEET. NEXT WARNINGS AT 191500Z, 192100Z, 200300Z AND 200900Z. REFER TO TROPICAL DEPRESSION 26W (TWENTYSIX) WARNINGS (WTPN31 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="968">
        <wind_radii minimum_wind_speed="34.0" northeast="407.42" southeast="425.94" southwest="324.08" northwest="305.56"/>
        <wind_radii minimum_wind_speed="50.0" northeast="212.97" southeast="240.75" southwest="175.93" northwest="166.67"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T12:00:00Z" utc_time="10/19/2017 12:00 UTC" locale_time="10/19/2017 12:00 UTC" latitude="16.9" longitude="130.0" wind_speed="138.89" wind_gusts="166.67" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="191500Z POSITION NEAR 17.2N 130.0E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 589 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED NORTHWARD AT 06 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 191200Z IS 30 FEET. NEXT WARNINGS AT 192100Z, 200300Z, 200900Z AND 201500Z." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="968">
        <wind_radii minimum_wind_speed="34.0" northeast="601.87" southeast="675.94" southwest="620.39" northwest="388.9"/>
        <wind_radii minimum_wind_speed="50.0" northeast="351.86" southeast="398.16" southwest="370.38" northwest="222.23"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-19T18:00:00Z" utc_time="10/19/2017 18:00 UTC" locale_time="10/19/2017 18:00 UTC" latitude="18.0" longitude="129.9" wind_speed="138.89" wind_gusts="166.67" category="Category 1 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="192100Z POSITION NEAR 18.4N 129.9E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 523 NM SOUTH-SOUTHEAST OF KADENA AB, HAS TRACKED NORTHWARD AT 10 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 191800Z IS 32 FEET. NEXT WARNINGS AT 200300Z, 200900Z, 201500Z AND 202100Z. REFER TO TROPICAL DEPRESSION 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="972">
        <wind_radii minimum_wind_speed="34.0" northeast="601.87" southeast="629.65" southwest="592.61" northwest="398.16"/>
        <wind_radii minimum_wind_speed="50.0" northeast="351.86" southeast="398.16" southwest="370.38" northwest="222.23"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-20T00:00:00Z" utc_time="10/20/2017 00:00 UTC" locale_time="10/20/2017 00:00 UTC" latitude="18.8" longitude="130.0" wind_speed="157.41" wind_gusts="194.45" category="Category 2 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="200300Z POSITION NEAR 19.2N 130.0E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 478 NM SOUTH-SOUTHEAST OF KADENA AB, HAS TRACKED NORTHWARD AT 08 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 200000Z IS 36 FEET. NEXT WARNINGS AT 200900Z, 201500Z, 202100Z AND 210300Z. REFER TO TROPICAL STORM 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX- HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="963">
        <wind_radii minimum_wind_speed="34.0" northeast="601.87" southeast="648.17" southwest="601.87" northwest="425.94"/>
        <wind_radii minimum_wind_speed="50.0" northeast="351.86" southeast="398.16" southwest="370.38" northwest="222.23"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-20T06:00:00Z" utc_time="10/20/2017 06:00 UTC" locale_time="10/20/2017 06:00 UTC" latitude="19.7" longitude="130.1" wind_speed="166.67" wind_gusts="203.71" category="Category 2 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="200900Z POSITION NEAR 20.1N 130.2E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 427 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED NORTHWARD AT 09 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 200600Z IS 36 FEET. NEXT WARNINGS AT 201500Z, 202100Z, 210300Z AND 210900Z. REFER TO TROPICAL STORM 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="959">
        <wind_radii minimum_wind_speed="34.0" northeast="351.86" southeast="351.86" southwest="296.3" northwest="277.78"/>
        <wind_radii minimum_wind_speed="50.0" northeast="194.45" southeast="194.45" southwest="166.67" northwest="148.15"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-20T12:00:00Z" utc_time="10/20/2017 12:00 UTC" locale_time="10/20/2017 12:00 UTC" latitude="20.4" longitude="130.2" wind_speed="185.19" wind_gusts="231.49" category="Category 3 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="observation" comments="201500Z POSITION NEAR 20.9N 130.3E. TYPHOON 25W (LAN), LOCATED APPROXIMATELY 389 NM SOUTH-SOUTHEAST OF KADENA AB, OKINAWA, JAPAN, HAS TRACKED  AT 07 KNOTS OVER THE PAST SIX HOURS. MAXIMUM SIGNIFICANT WAVE HEIGHT AT 201200Z IS 36 FEET. NEXT WARNINGS AT 202100Z, 210300Z, 210900Z AND 211500Z. REFER TO TROPICAL DEPRESSION 27W (TWENTYSEVEN) WARNINGS (WTPN33 PGTW) FOR SIX-HOURLY UPDATES." NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="950">
        <wind_radii minimum_wind_speed="34.0" northeast="481.49" southeast="527.79" southwest="444.46" northwest="416.68"/>
        <wind_radii minimum_wind_speed="50.0" northeast="277.78" southeast="305.56" southwest="259.27" northwest="240.75"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-21T00:00:00Z" utc_time="10/21/2017 00:00 UTC" locale_time="10/21/2017 00:00 UTC" latitude="22.2" longitude="130.7" wind_speed="203.71" wind_gusts="250.01" category="Category 3 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="950">
        <wind_radii minimum_wind_speed="34.0" northeast="546.31" southeast="583.35" southwest="564.83" northwest="638.91"/>
        <wind_radii minimum_wind_speed="50.0" northeast="296.3" southeast="314.82" southwest="259.27" northwest="268.53"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-21T12:00:00Z" utc_time="10/21/2017 12:00 UTC" locale_time="10/21/2017 12:00 UTC" latitude="24.7" longitude="131.6" wind_speed="222.23" wind_gusts="268.53" category="Category 4 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="941">
        <wind_radii minimum_wind_speed="34.0" northeast="638.91" southeast="546.31" southwest="620.39" northwest="712.98"/>
        <wind_radii minimum_wind_speed="50.0" northeast="305.56" southeast="305.56" southwest="268.53" northwest="314.82"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-22T00:00:00Z" utc_time="10/22/2017 00:00 UTC" locale_time="10/22/2017 00:00 UTC" latitude="27.6" longitude="132.8" wind_speed="203.71" wind_gusts="250.01" category="Category 3 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="950">
        <wind_radii minimum_wind_speed="34.0" northeast="657.42" southeast="564.83" southwest="638.91" northwest="777.8"/>
        <wind_radii minimum_wind_speed="50.0" northeast="333.34" southeast="314.82" southwest="277.78" northwest="361.12"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-22T12:00:00Z" utc_time="10/22/2017 12:00 UTC" locale_time="10/22/2017 12:00 UTC" latitude="31.8" longitude="135.4" wind_speed="166.67" wind_gusts="203.71" category="Category 2 Hurricane" storm_name="LAN" local_storm_name="Typhoon LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="968">
        <wind_radii minimum_wind_speed="34.0" northeast="685.2" southeast="611.13" southwest="694.46" northwest="777.8"/>
        <wind_radii minimum_wind_speed="50.0" northeast="342.6" southeast="314.82" southwest="277.78" northwest="351.86"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
    <period iso_date="2017-10-23T12:00:00Z" utc_time="10/23/2017 12:00 UTC" locale_time="10/23/2017 12:00 UTC" latitude="41.2" longitude="147.3" wind_speed="101.85" wind_gusts="129.63" category="Tropical Storm" storm_name="LAN" local_storm_name="Severe Tropical Storm LAN" type="forecast" comments="*" NE_12ft_sea_radii="0.0" SE_12ft_sea_radii="0.0" SW_12ft_sea_radii="0.0" NW_12ft_sea_radii="0.0" central_pressure="999">
        <wind_radii minimum_wind_speed="34.0" northeast="694.46" southeast="888.91" southwest="666.68" northwest="500.01"/>
        <wind_radii minimum_wind_speed="50.0" northeast="287.04" southeast="277.78" southwest="324.08" northwest="231.49"/>
        <wind_radii minimum_wind_speed="64.0" northeast="0.0" southeast="0.0" southwest="0.0" northwest="0.0"/>
    </period>
</hurricane></report>

13.6 Notes

Location parameters are not needed to request the data.

14. Air Quality Observations

14.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=air_quality_obs

14.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

14.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
station_id The air quality station ID.
forecast_id The nearest CustomWeather location ID.
air_station_name The air quality station name.
state_code The US state code.
concentration The ozone level integer (see range below).
category The air quality category character (see full description below).
iso8601 The date and time of the report in ISO 8601 format.

14.4 Example Request

xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=air_quality_obs&id=KCGX

14.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="2309282017" unix_date="1506641402.000000" timezone="-6" state="IL" state_name="Illinois" country="US" iso_cc="US" country_name="United States" localtime="Fri, 29 Sep 2017 10:06:30 CDT" localupdatetime="Thu, 28 Sep 2017 18:30:02 CDT" metric="false" city_name="Chicago / Meigs" longitude="-87.59" latitude="41.86" tzinfo="America/Chicago" elevation="175.00" name="air_quality_obs" >
<observation station_id="170314002" forecast_id="14751" air_station_name="CIRERO" state_code="IL" concentration="41" category="G" />
<observation station_id="170310032" forecast_id="K63G" air_station_name="CHI-SWFP" state_code="IL" concentration="41" category="G" />
<observation station_id="170317002" forecast_id="K62G" air_station_name="EVANSTON" state_code="IL" concentration="45" category="G" />
<observation station_id="180892008" forecast_id="16050" air_station_name="HAMMOND" state_code="IN" concentration="41" category="G" />
</report>

14.6 Notes

G == Good M == Moderate S == Unhealthy for Sensitive Groups U == Unhealthy V == Very Unhealthy H == Hazardous 0-50 == Good 51-100 == Moderate 101-150 == Unhealthy for Sensitive Groups 151-200 == Unhealthy 201-300 == Very Unhealthy >300 == Hazardous

15. Air Quality Forecasts

15.1 URL Description

http://xml.customweather.com/xml?client=client=sampleuser&client_password=samplepassword&product=air_quality_for

15.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

15.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
station_id The air quality station ID.
forecast_id The nearest CustomWeather location ID.
air_station_name The air quality station name.
state_code The US state code.
concentration The ozone level integer (see range below).
category The air quality category character (see full description below).
iso8601 The date and time of the report in ISO 8601 format.

15.4 Example Request

xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=air_quality_for&id=KCGX

15.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="2309282017" unix_date="1506641402.000000" timezone="-6" state="IL" state_name="Illinois" country="US" iso_cc="US" country_name="United States" localtime="Fri, 29 Sep 2017 10:06:30 CDT" localupdatetime="Thu, 28 Sep 2017 18:30:02 CDT" metric="false" city_name="Chicago / Meigs" longitude="-87.59" latitude="41.86" tzinfo="America/Chicago" elevation="175.00" name="air_quality_obs" >
<observation station_id="170314002" forecast_id="14751" air_station_name="CIRERO" state_code="IL" concentration="41" category="G" />
<observation station_id="170310032" forecast_id="K63G" air_station_name="CHI-SWFP" state_code="IL" concentration="41" category="G" />
<observation station_id="170317002" forecast_id="K62G" air_station_name="EVANSTON" state_code="IL" concentration="45" category="G" />
<observation station_id="180892008" forecast_id="16050" air_station_name="HAMMOND" state_code="IN" concentration="41" category="G" />
</report>

15.6 Notes

G == Good M == Moderate S == Unhealthy for Sensitive Groups U == Unhealthy V == Very Unhealthy H == Hazardous 0-50 == Good 51-100 == Moderate 101-150 == Unhealthy for Sensitive Groups 151-200 == Unhealthy 201-300 == Very Unhealthy >300 == Hazardous

16. Airport Delay Forecasts

The airport delay forecasts returns the data for the nearest airports or just the nearest airport (one_airport_delay).

16.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=airport_delay

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=one_airport_delay

16.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

16.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
station_id The air quality station ID.
forecast_id The nearest CustomWeather location ID.
air_station_name The air quality station name.
state_code The US state code.
date_format The format of the forecast date.
date The forecast date.
pollutant The primary air pollutant listed as "O" for Ozone or "P" for particulates smaller than 2.5 microns.
concentration The ozone level integer (see range below).
category The air quality category character (see full description below).
city The location's ID code.
city_name The location name.
location The name of the forecast location.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the forecast location in meters or feet.
state The state code of the forecast location.
state_name The state name of the forecast location.
country The country code of the forecast location.
iso_cc The ISO country code of the forecast location.
country_name The country name of the forecast location.
distance The distance to the forecast location in kilometers or miles.
segment The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_segment The time segment of the day text.
day_of_week The day of the week integer 1 = Sunday).
weekday The day of the week name.
delay_time The delay time integer. Descriptor can be found in the delays attribute.
delay The delay time descriptor.
primary_delay_reason The primary reason integer.
primary_reason The primary reason descriptor.
secondary_delay_reason The secondary reason integer.
secondary_reason The secondary reason descriptor.
icon_name The weather icon name.
iso8601 The date and time of the forecast day in ISO 8601 format.

16.4 Example Request

xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=airport_delay&id=12156

16.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1610192017" unix_date="1508431203.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Thu, 19 Oct 2017 14:47:20 PDT" localupdatetime="Thu, 19 Oct 2017 09:40:03 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="airport_delay" >
<location city="KSFO" city_name="San Francisco" latitude="37.618805" longitude="-122.37542" location="San Francisco International Airport" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="17.28">
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T06:00:00.00-07:00" />
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="6" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="7" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T06:00:00.00-07:00" />
</location>
<location city="KOAK" city_name="Oakland" latitude="37.7213" longitude="-122.2207" location="Metro Oakland International Airport" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="18.36">
<forecast segment="A" day_segment="Afternoon" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="5" weekday="Thursday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-19T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="5" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T06:00:00.00-07:00" />
<forecast segment="A" day_segment="Afternoon" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T12:00:00.00-07:00" />
<forecast segment="E" day_segment="Evening" day_of_week="6" weekday="Friday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-20T18:00:00.00-07:00" />
<forecast segment="N" day_segment="Night" day_of_week="6" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T00:00:00.00-07:00" />
<forecast segment="M" day_segment="Morning" day_of_week="7" weekday="Saturday" delay_time="0" delay="No delays" primary_delay_reason="*" primary_reason="" secondary_delay_reason="*" secondary_reason="" icon_name="cw_airport_0" iso8601="2017-10-21T06:00:00.00-07:00" />
</location>

17. Detailed Forecast Advisories

The product returns advisories based on the forecast for the next six or 24 hours or five days broken down into segments of the day (Morning, Afternoon, Evening, Overnight).

17.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories_6hr

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories_ext

17.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 
xml.return_all_records Optional Returns all available advisories when true (xml.return_all_records=true).

17.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
location The name of the reporting station.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the reporting station in meters or feet.
distance The distance to the forecast location in kilometers or miles.
type The alert type integer.
description The alert description.
segment The time segment of the day (Character - M=Morning, A=Afternoon, E=Evening, N=Overnight)
day_of_week The day of the week integer 1 = Sunday).
applicable_from Date and time of the start of the advisory in ISO 8601 format.
applicable_to Date and time of the end of the advisory in ISO 8601 format.
occurrence Likelyhood of advisory occurring (Low, Medium, High).
impact Impact of the advisory (Low, Medium, High).
iso8601 The date and time of the report in ISO 8601 format.

17.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=detailed_cw_advisories&id=12156

17.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<cw_multi_report>
<report gmt_date="1810202017" unix_date="1508523610.000000" timezone="-6" state="AR" state_name="Arkansas" country="US" iso_cc="US" country_name="United States" localtime="Fri, 20 Oct 2017 13:54:11 CDT" localupdatetime="Fri, 20 Oct 2017 13:20:10 CDT" metric="true" city_name="Bearden" longitude="-92.61" latitude="33.72" tzinfo="America/Chicago" elevation="70.00" name="detailed_cw_advisories" >
<location city="10997" city_name="Bearden" latitude="33.72" longitude="-92.61" location="Bearden" state="AR" state_name="Arkansas" country="US" iso_cc="US" country_name="United States" distance="0.00">
<cw_advisory type="1" description="Strong thunderstorms anticipated" >
<time_segment segment="N" day_of_week="7"  />
<time_segment segment="M" day_of_week="1"  />
</cw_advisory>

</location>
</report>

17.6 Notes

The product will only return data if an advisory is available for the location when requesting by id or coordinates.

18. Extended Forecast Advisories

The product returns advisories based on the forecast for the next six or 24 hours or 5 days.

18.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=cw_advisories_6hr

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=cw_advisories

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=cw_advisories_ext

18.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 
xml.return_all_records Optional Returns all available advisories when true (xml.return_all_records=true).

18.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city The location's ID code.
location The name of the reporting station.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
elevation The elevation of the reporting station in meters or feet.
distance The distance to the forecast location in kilometers or miles.
type The alert type integer.
description The alert description.
category The alert category
applicable_from Date and time of the start of the advisory in ISO 8601 format.
applicable_to Date and time of the end of the advisory in ISO 8601 format.
occurrence Likelyhood of advisory occurring (Low, Medium, High).
impact Impact of the advisory (Low, Medium, High).
iso8601 The date and time of the report in ISO 8601 format.

18.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=cw_advisories&id=12156

18.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1812102018" unix_date="1544466013.000000" timezone="1" state="23" state_name="Västerbotten" country="SW" iso_cc="SE" country_name="Sweden" localtime="Mon, 10 Dec 2018 21:36:13 CET" localupdatetime="Mon, 10 Dec 2018 19:20:13 CET" metric="true" city_name="Skelleftea" longitude="20.95" latitude="64.75" tzinfo="Europe/Stockholm" elevation="5.00" name="cw_advisories" >
<location city="75562" city_name="Skelleftea" latitude="64.75" longitude="20.95" location="Skelleftea" state="23" state_name="Västerbotten" country="SW" iso_cc="SE" country_name="Sweden" distance="0.00">
<cw_advisory type="13" description="Snow advisory" category="Snow and Ice" applicable_from="2018-12-10T19:00:00.00+01:00" applicable_to="2018-12-11T19:00:00.00+01:00" occurrence="Likely" impact="Medium" />

</location>
</report>

18.6 Notes

The product will only return data if an advisory is available for the location when requesting by id or coordinates.

19. US and Canadian Weather Alerts

The product returns National Weather Service and Canadian Weather Service weather alerts (nws_alerts will only return NWS alerts).

19.1 URL Description

http://xml.customweather.com/xml?client=client=sampleuser&client_password=samplepassword&product=intl_alerts

http://xml.customweather.com/xml?client=client=sampleuser&client_password=samplepassword&product=nws_alerts

19.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 
narrow Optional Returns a list of alerts for the exact location requested (narrow=true).
distance Optional The distance in kilometers will return all active county and zone alerts with a centroid within the distance threshold. Since centroids are used, distance values less than 30 kilometers are not recommended.

19.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
metric Metric units indicator (true or false).
name The name of the weather product being requested.
message_id The unique reference id as an alphanumeric string.
description The text description of the alert.
type The alert type integer.
nws_office Issuing NWS office.
source Source of alert.
severity Severity of alerts (0-100 where 0 is the most severe).
issue_time_local The issue date and time of the alert in %m/%d/%Y %H:%M format in local time.
issue_time_utc Theissue date and time of the alert in %m/%d/%Y %H:%M format in UTC time.
broadcast_time_local The broadcast date and time of the alert in %m/%d/%Y %H:%M format in local time.
broadcast_time_utc The broadcast date and time of the alert in %m/%d/%Y %H:%M format in UTC time.
valid_until_time_local The valid until date and time of the alert in %m/%d/%Y %H:%M format in local time.
valid_until_time_utc The valid until date and time of the alert in %m/%d/%Y %H:%M format in UTC time.
parent_id The parent reference id as an alphanumeric string.
name The name of the weather product being requested.
state_name The state name of the requested location.
country_name The country name.
latitude Latitude Coordinates in Decimal Degrees
longitude Longitude Coordinates in Decimal Degrees
message The alert text.
latitude (county_id, zone_id or location_id attribute) Central latitude coordinates in decimal degrees of the county.
longitude (county_id, zone_id or location_id attribute) Central longitude coordinates in decimal degrees of the county.
name (county_id, zone_id or location_id attribute) The county name.
country (county_id, zone_id or location_id attribute) The country code.
country_name (county_id, zone_id or location_id attribute) The country name.
state (county_id, zone_id or location_id attribute) The state or province code.
state_name (county_id, zone_id or location_id attribute) The state or province name.
county_id The NWS county ID.
zone_id The NWS zone ID.
location_id The Canadian Weather office province ID.
smpp_message Not in use (defunct).
polygon The coordinates of the polygon of the warned area.

19.4 Example Request

http://xml.customweather.com/xml?client=client=sampleuser&client_password=samplepassword&product=intl_alerts

19.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1610232017" unix_date="1508774919.000000" metric="true" name="nws_alert" >


<watch message_id="190742PMZ1531000" description="Small Craft Advisory" type="1000" nws_office="NWS Field Office" source="9" severity="70" issue_time_local="10/19/2017 17:42 ChST" issue_time_utc="10/19/2017 07:42 UTC" broadcast_time_local="10/19/2017 17:42 ChST" broadcast_time_utc="10/19/2017 07:42 UTC" valid_until_time_local="10/24/2017 18:00 ChST" valid_until_time_utc="10/24/2017 08:00 UTC" parent_id="181902PMZ1531000" name="Rota Island  N. Mariana Is  Rota International Airport" state_name="Guam" country_name="United States" latitude="14.43" longitude="145.44" >
<message>This alert has expired</message>
<zone_id latitude="14.86054" longitude="145.59991" name="Tinian Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ153</zone_id>
<zone_id latitude="15.32804" longitude="145.78462" name="Saipan Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ154</zone_id>
<zone_id latitude="13.37584" longitude="144.77906" name="Guam Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ151</zone_id>
<zone_id latitude="14.14431" longitude="145.59041" name="Rota Coastal Waters" country="US" country_name="United States" state="*" state_name="*">PMZ152</zone_id>
<smpp_message>Small Craft Advisory;till:10/24 18:00 ChST; This alert has expired</smpp_message></watch>

19.6 Notes

Using a location parameter will return alerts for the location only if it's available.

20. Daily Historical Climate

The product returns daily historical climate for any one year range based on availability. Access is available via Paid Subscription only. For more information please contact sales@customeather.com.

20.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=

20.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
start_time yes The start date of the first day of data in ISO 8601 format.
end_time yes The end date of the last day of data in ISO 8601 format.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

20.3 Response Object

Field Description
gmt_date The update time of the product in UTC time in HHMMDDYYYY format.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
icao The ICAO ID of the nearest reporting station.
date The date of the data in YYYY-MM-DD format.
tmax The maximum temperature in Celsius or Fahrenheit.
tmin The minumum temperature in Celsius or Fahrenheit.
tmean The average temperature in Celsius or Fahrenheit.
hdd The heating degree days in Celsius or Fahrenheit.
cdd The cooling degree days in Celsius or Fahrenheit.
precip The precipitation in millimeters or inches
rh The relative humidity as a percentage.
windspd The windspeed in kilometer per hour or miles per hour.
visibility The visibility in kilometers or miles.
slp The sea level pressure in millibars or inches of mercury.
iso8601 The date and time of the report in ISO 8601 format.

20.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=&id=12156&start_time=2016-05-22T00:00:00&end_time=2016-05-26T00:00:00

20.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1710232017" unix_date="1508779722.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Mon, 23 Oct 2017 10:28:42 PDT" localupdatetime="Mon, 23 Oct 2017 10:28:42 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="" >
<location city="KSFO" city_name="San Francisco" latitude="37.618805" longitude="-122.37542" location="San Francisco International Airport" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" distance="17.28">
<observation icao="KSFO" date="2016-05-22" tmax="18.33" tmin="12.78" tmean="15.56" hdd="2.78" cdd="0.00" precip="0.00" rh="64.73" windspd="18.83" dewpoint="8.89" visibility="16.09" slp="1018.66" />

<observation icao="KSFO" date="2016-05-23" tmax="18.89" tmin="12.22" tmean="15.56" hdd="2.78" cdd="0.00" precip="0.00" rh="64.73" windspd="22.69" dewpoint="8.89" visibility="16.09" slp="1014.26" />

<observation icao="KSFO" date="2016-05-24" tmax="18.33" tmin="13.33" tmean="15.83" hdd="2.50" cdd="0.00" precip="0.00" rh="67.29" windspd="23.98" dewpoint="10.00" visibility="16.09" slp="1015.61" />

<observation icao="KSFO" date="2016-05-25" tmax="18.33" tmin="13.33" tmean="15.83" hdd="2.50" cdd="0.00" precip="0.00" rh="64.85" windspd="21.72" dewpoint="9.44" visibility="16.09" slp="1019.68" />

<observation icao="KSFO" date="2016-05-26" tmax="21.11" tmin="12.78" tmean="16.94" hdd="1.39" cdd="0.00" precip="0.00" rh="65.07" windspd="13.20" dewpoint="10.56" visibility="16.09" slp="1017.98" />

</location>
</report>

20.6 Notes

Most historical daily data is available back to 1970.

21. Hourly Historical Climate

The product returns hourly historical climate for up to one year from the current date based on availability. Access is available via Paid Subscription only. For more information please contact sales@customeather.com.

21.1 URL Description

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=

21.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather.  IP address authentication also available without a password.
product yes The weather product name.
start_time yes The start date of the first day of data in ISO 8601 format.
end_time yes The end date of the last day of data in ISO 8601 format.
id Required but can only be used one at a time. The CustomWeather city ID.  A city list will be sent if needed and after a contract has been signed.  Sample IDs may be available upon request.  More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates.  Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates.  Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location.  Requesting only the location name will return the location with the largest population.  The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired.  “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.).  The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results.  The default language is English.  A list of languages can be made available upon request. 

21.3 Response Object

Field Description
gid The database field.
utc_time The UTC time of the location in %a, %d %b %Y %I:%M:%S %Z format.
local_time The local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
city The location's ID code.
city_name The location name.
location The name of the reporting station.
state The state code of the requested location.
state_name The state name of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
longitude The longitude coordinates in decimal degrees of the requested location.
daylight Icon daylight status (Character - 'D' for daytime icons, 'N' for nighttime icons).
sky_desc The sky descriptor integer.
precip_desc The precipitation descriptor integer.
temp_desc The temperature descriptor integer.
air_desc The air descriptor integer.
temperature The temperature in Celsius or Fahrenheit.
wind_speed The wind speed in kilometers per mile or miles per hour.
wind_dir The wind direction in compass degrees.
wind_short The cardinal and intercardinal wind direction initials.
humidity The humidity in percentage.
dew_point The dew point temperature in Celsius or Fahrenheit.
comfort The comfort temperature in Celsius or Fahrenheit. The comfort temperature is the heat index when the temperature is above 70 degree and wind chile when it's below 60 degrees.
baro_pressure The barometric pressure in millibars or inches of Mercury.
baro_tendency The barometric pressure tendency initials.
barometer The barometric pressure tendency text.
visibility The visibility in kilometers or miles.
sky_conditions The sky conditions for the hour (C-lear,F-ew,S-cattered,B-roken,O-vercast, X-obscured).
min_cloud_base The minimum cloud base in meters or feet.
max_cloud_base The maximum cloud base in meters or feet.
weather_type The weather type for the hour (+FC = tornado/waterspout, FC = funnel cloud, TS = thunderstorm, GR = hail, RA = rain, DZ = drizzle, SN = snow, SG = snow grains, GS = small hail &/or snow pellets, PE = ice pellets, IC = crystals, FG+ = heavy fog less than 0.25 miles vis, FG = fog, BR = mist, UP = unknown precip., HZ = haze, FU = smoke, VA = volcanic ash, DU = widespread dust, DS = duststorm, PO = sand/dust whirls, SA = sand, SS = sandstorm, PY = spray, SQ = squall) (DR - low drifting, SH - shower, FZ - freezing, MI - shallow, PR - partial, BC - patches, BL - blowing, VC - vicinity, - LIGHT, + HEAVY, 'NO SIGN' - moderate)| (24) hourly precip. [optional] (Floating Point - inches)|
hourly_precip_1hr The hourly precipitation in millimeters or inches.
hourly_precip_3hr The 3-hour precipitation in millimeters or inches.
hourly_precip_6hr The 6-hour precipitation in millimeters or inches.
hourly_precip_12hr The 12-hour precipitation in millimeters or inches.
hourly_precip_24hr The 24-hour precipitation in millimeters or inches.
max_temp_24hr The 24-hr maximum temperature in Celsius or Fahrenheit.
max_temp_6hr The 6-hr maximum temperature in Celsius or Fahrenheit.
min_temp_24hr The 24-hr minimum temperature in Celsius or Fahrenheit.
min_temp_6hr The 6-hr minimum temperature in Celsius or Fahrenheit.
snow_cover The snow cover in centimeters or inches.
solar_radiation The solar radiation in minutes.
iso8601 The date and time of the report in ISO 8601 format.

21.4 Example Request

http://xml.customweather.com/xml?client=sampleuser&client_password=samplepassword&product=&id=KSFO&start_time=2016-12-27T07:00:00.00&end_time=2016-12-28T08:00:00.00

21.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="2110232017" unix_date="1508793569.000000"><observation gid="9946897931" utc_time="2016-12-27T07:56:00.00+00:00" local_time="2016-12-26T23:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="5.61" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="68" dewpoint="*" comfort="5.61" baro_pressure="1028.20" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="11.72" max_temp_6hr="*" min_temp_24hr="5.00" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9946947632" utc_time="2016-12-27T08:56:00.00+00:00" local_time="2016-12-27T00:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="6.11" wind_speed="11.12" wind_direction="150" wind_gusts="*" humidity="62" dewpoint="-0.61" comfort="3.76" baro_pressure="1027.40" baro_tendency="F" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9946997977" utc_time="2016-12-27T09:56:00.00+00:00" local_time="2016-12-27T01:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="6.72" wind_speed="9.27" wind_direction="10" wind_gusts="*" humidity="51" dewpoint="-2.78" comfort="4.87" baro_pressure="1027.70" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947048543" utc_time="2016-12-27T10:56:00.00+00:00" local_time="2016-12-27T02:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="8.28" wind_speed="9.27" wind_direction="30" wind_gusts="*" humidity="54" dewpoint="-0.61" comfort="6.72" baro_pressure="1028.10" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947098670" utc_time="2016-12-27T11:56:00.00+00:00" local_time="2016-12-27T03:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="5.00" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="60" dewpoint="-2.22" comfort="5.00" baro_pressure="1027.70" baro_tendency="R" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="8.28" min_temp_24hr="*" min_temp_6hr="4.39" snow_cover="*" solar_radiation="*" />
<observation gid="9947150630" utc_time="2016-12-27T12:56:00.00+00:00" local_time="2016-12-27T04:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="4" air_desc="*" temperature="4.39" wind_speed="7.41" wind_direction="160" wind_gusts="*" humidity="70" dewpoint="-0.61" comfort="2.58" baro_pressure="1027.20" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947203191" utc_time="2016-12-27T13:56:00.00+00:00" local_time="2016-12-27T05:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="5.00" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="65" dewpoint="-1.11" comfort="5.00" baro_pressure="1027.00" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947255335" utc_time="2016-12-27T14:56:00.00+00:00" local_time="2016-12-27T06:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="4" air_desc="*" temperature="3.89" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="76" dewpoint="*" comfort="3.89" baro_pressure="1027.80" baro_tendency="S" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947307928" utc_time="2016-12-27T15:56:00.00+00:00" local_time="2016-12-27T07:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="7.22" wind_speed="11.12" wind_direction="330" wind_gusts="*" humidity="74" dewpoint="2.78" comfort="5.10" baro_pressure="1028.20" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947360798" utc_time="2016-12-27T16:56:00.00+00:00" local_time="2016-12-27T08:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="7.22" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="71" dewpoint="2.22" comfort="7.22" baro_pressure="1028.10" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947413281" utc_time="2016-12-27T17:56:00.00+00:00" local_time="2016-12-27T09:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="9.39" wind_speed="5.56" wind_direction="80" wind_gusts="*" humidity="59" dewpoint="1.72" comfort="8.89" baro_pressure="1028.40" baro_tendency="R" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="9.39" min_temp_24hr="*" min_temp_6hr="3.89" snow_cover="*" solar_radiation="*" />
<observation gid="9947465938" utc_time="2016-12-27T18:56:00.00+00:00" local_time="2016-12-27T10:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.00" wind_speed="5.56" wind_direction="60" wind_gusts="*" humidity="52" dewpoint="0.61" comfort="9.59" baro_pressure="1028.30" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947518249" utc_time="2016-12-27T19:56:00.00+00:00" local_time="2016-12-27T11:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.00" wind_speed="12.97" wind_direction="0" wind_gusts="*" humidity="57" dewpoint="1.72" comfort="8.18" baro_pressure="1028.20" baro_tendency="*" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947568707" utc_time="2016-12-27T20:56:00.00+00:00" local_time="2016-12-27T12:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.61" wind_speed="11.12" wind_direction="140" wind_gusts="*" humidity="48" dewpoint="*" comfort="9.18" baro_pressure="1026.40" baro_tendency="F" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947619290" utc_time="2016-12-27T21:56:00.00+00:00" local_time="2016-12-27T13:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.11" wind_speed="7.41" wind_direction="0" wind_gusts="*" humidity="49" dewpoint="0.61" comfort="10.43" baro_pressure="1026.30" baro_tendency="*" visibility="16.09" sky_conditions="B" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947669969" utc_time="2016-12-27T22:56:00.00+00:00" local_time="2016-12-27T14:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.11" wind_speed="5.56" wind_direction="10" wind_gusts="*" humidity="61" dewpoint="3.89" comfort="10.86" baro_pressure="1026.20" baro_tendency="*" visibility="16.09" sky_conditions="B" min_cloud_base="5486.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947719828" utc_time="2016-12-27T23:56:00.00+00:00" local_time="2016-12-27T15:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.72" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="59" dewpoint="3.89" comfort="11.72" baro_pressure="1026.00" baro_tendency="F" visibility="16.09" sky_conditions="B" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="11.72" min_temp_24hr="*" min_temp_6hr="8.89" snow_cover="*" solar_radiation="*" />
<observation gid="9947770166" utc_time="2016-12-28T00:56:00.00+00:00" local_time="2016-12-27T16:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="14" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.72" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="48" dewpoint="1.11" comfort="11.72" baro_pressure="1026.00" baro_tendency="*" visibility="16.09" sky_conditions="B" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947820373" utc_time="2016-12-28T01:56:00.00+00:00" local_time="2016-12-27T17:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="11.11" wind_speed="5.56" wind_direction="200" wind_gusts="*" humidity="47" dewpoint="*" comfort="10.86" baro_pressure="1025.90" baro_tendency="*" visibility="16.09" sky_conditions="S" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947869175" utc_time="2016-12-28T02:56:00.00+00:00" local_time="2016-12-27T18:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="7" precip_desc="*" temp_desc="6" air_desc="*" temperature="9.39" wind_speed="5.56" wind_direction="160" wind_gusts="*" humidity="57" dewpoint="1.11" comfort="8.89" baro_pressure="1026.00" baro_tendency="S" visibility="16.09" sky_conditions="F" min_cloud_base="6096.00" max_cloud_base="6096.00" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947918960" utc_time="2016-12-28T03:56:00.00+00:00" local_time="2016-12-27T19:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.61" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="42" dewpoint="-1.72" comfort="10.61" baro_pressure="1026.00" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9947969038" utc_time="2016-12-28T04:56:00.00+00:00" local_time="2016-12-27T20:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="10.00" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="50" dewpoint="*" comfort="10.00" baro_pressure="1026.50" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9948018699" utc_time="2016-12-28T05:56:00.00+00:00" local_time="2016-12-27T21:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="8.28" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="59" dewpoint="0.61" comfort="8.28" baro_pressure="1026.70" baro_tendency="R" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="11.72" min_temp_24hr="*" min_temp_6hr="7.22" snow_cover="*" solar_radiation="*" />
<observation gid="9948069593" utc_time="2016-12-28T06:56:00.00+00:00" local_time="2016-12-27T22:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="6" air_desc="*" temperature="7.78" wind_speed="5.56" wind_direction="180" wind_gusts="*" humidity="61" dewpoint="0.61" comfort="7.05" baro_pressure="1027.10" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="*" max_temp_6hr="*" min_temp_24hr="*" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
<observation gid="9948120854" utc_time="2016-12-28T07:56:00.00+00:00" local_time="2016-12-27T23:56:00.00-08:00" city="KSFO" city_name="San Francisco" location="San Francisco International Airport" state="CA" state_name="California" latitude="37.618805" longitude="-122.37542" daylight="*" sky_desc="2" precip_desc="*" temp_desc="5" air_desc="*" temperature="6.11" wind_speed="0.00" wind_direction="0" wind_gusts="*" humidity="71" dewpoint="1.11" comfort="6.11" baro_pressure="1026.90" baro_tendency="*" visibility="16.09" sky_conditions="C" min_cloud_base="*" max_cloud_base="*" weather_type="*" hourly_precip_1hr="*" hourly_precip_3hr="*" hourly_precip_6hr="*" hourly_precip_12hr="*" hourly_precip_24hr="*" max_temp_24hr="11.72" max_temp_6hr="*" min_temp_24hr="3.89" min_temp_6hr="*" snow_cover="*" solar_radiation="*" />
</report>

21.6 Notes

Many variables such as the 3-hour precipation and solar radiation are optional. Most historical houlry data is available back to 1970.

22. Ski Reports

The product returns ski report data for all the resorts in the location's US state or country for resorts outside of the US. The ski_search product will return the data only for the specified resort. More information is provided in the Notes seciton.

22.1 URL Description

http://xml.customweather.com/xml?client=client=sampleuser&client_password=ski_reports

http://xml.customweather.com/xml?client=client=sampleuser&client_password=ski_search

22.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather. IP address authentication also available without a password.
product yes The weather product name.
start_time yes The start date of the first day of data in ISO 8601 format.
end_time yes The end date of the last day of data in ISO 8601 format.
id Required but can only be used one at a time. The CustomWeather city ID. A city list will be sent if needed and after a contract has been signed. Sample IDs may be available upon request. More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates. Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates. Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location. Requesting only the location name will return the location with the largest population. The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired. “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.). The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results. The default language is English. A list of languages can be made available upon request.

22.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
sno_country_id The ski resort ID.
ski_area_name The ski resort name.
state The state name of the resort.
new_snow_min24 The minimum new snow in the last 24 hours in centimeters or inches.
new_snow_max24 The maximum new snow in the last 24 hours in centimeters or inches.
primary_surface The primary surface conditions. CORN CORN SNOW FRGR FROZEN GRANULAR HP HARD PACKED ICY ICY LSGR LOOSE GRANULAR MGS MACHINE GROOMED SNOW PDR POWDER PP PACKED POWDER SC SPRING CONDITIONS (after Mar 1) VC VARIABLE CONDITIONS WBLN WIND BLOWN WETGR WET GRANULAR WETPS WET PACKED SNOW WETSN WET SNOW
base_depth_min The minimum base depth in centimeters or inches.
base_depth_max The maximum base depth in centimeters or inches.
base_min The minimum base depth in centimeters or inches.
base_max The maximum base depth in centimeters or inches.
num_lifts_open The number of open lifts.
num_trails_open The number of open trails.
snow_making Snow making. Y or N.
night_skiing Night skiing. Y or N.
grooming Grooming. Y or N.
num_miles_open The number of open skiiable miles.
num_acres_open The number of open skiable acres.
percent_runs_open The percent of open runs.
cross_country Cross country. Y or N.
snow_boarding Snowboarding. Y or N.
operation_hours The hours of operation.
operation_status The operation status.
projected_operations The projected operation status.
snow_comments24 The comments on the snowfall.
general_comments The general comments from the ski resort.
state_code The state code of the resort
country_code The country code of the resort.
iso8601 The date and time of the report in ISO 8601 format.
resort_status Status of the ski resort (open, closed, etc.).
total_lifts The total number of lifts at the resort.
total_trails The total number of trails at the resort.
seasonal_snowfall The total natural snowfall season total in centimeters or inches.
last_snowfall_date Date of last snowfall.
last_snowfall_amount Amount of last snowfall in centimeters or inches.
previous_snowfall_date Date of previous snowfall.
previous_snowfall_amount Amount of previous snowfall in centimeters or inches.

22.4 Example Request

http://xml.customweather.com/xml?client=client=sampleuser&client_password=ski_reports&id=12156

http://xml.customweather.com/xml?client=client=sampleuser&client_password=ski_search&id=909002

22.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="1510242017" unix_date="1508858409.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Tue, 24 Oct 2017 10:49:37 PDT" localupdatetime="Tue, 24 Oct 2017 08:20:09 PDT" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="ski_report" >

<observation sno_country_id="303001" ski_area_name="Arapahoe Basin" state="CO" new_snow_min24="*" new_snow_max24="*" primary_surface="PP" base_depth_min="46 cm" base_depth_max="46 cm" base_min="46" base_max="46" num_lifts_open="1" num_trails_open="2" snow_making="*" night_skiing="*" grooming="*" num_miles_open="*" num_acres_open="46.0" percent_runs_open="2.0" cross_country="*" snow_boarding="*" operation_hours="Mon-Fri: 9am-4pm; Sat/Sun: 8:30am-4pm" operation_status="*" projected_operations="*" snow_comments24="2&quot;  past 72 hours" general_comments="*" state_code="CO" country_code="US" />
</report>

22.6 Notes

The ski_search product requires the ID of the resort, and a list of the IDs can be provided.

23. Earthquakes

The earthquakes product returns a summary of all of the earthquakes from around the world for up to the past 7 days.

23.1 URL Description

http://xml.customweather.com/xml?client=client=sampleuser&client_password=earthquake

23.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather. IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID. A city list will be sent if needed and after a contract has been signed. Sample IDs may be available upon request. More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates. Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates. Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location. Requesting only the location name will return the location with the largest population. The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired. “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.). The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results. The default language is English. A list of languages can be made available upon request.
earthquake.magnitude Optional Returns events with the minimum specified magnitude (default is 4.0).
earthquake.sort_by_magnitude Optional Sorts the events by magnitude in descending order.
earthquake.age Optional Returns events within the specified number of days, 1-7 (default is 7).

23.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
name The name of the weather product being requested.
city Location of the event.
occurrence Date and time of the the event in %a %b %d %H:%M:%S %Z %Y format in UTC time.
latitude The latitude coordinates of the event.
longitude The longitude coordinates of the event.
magnitude The magnitude of the event.
depth The depth of the event in kilometers.
comments The comments from the USGS.
iso8601 The date and time of the report in ISO 8601 format.

23.4 Example Request

http://xml.customweather.com/xml?client=client=sampleuser&client_password=earthquake

http://xml.customweather.com/xml?client=client=sampleuser&client_password=earthquake&earthquake.magnitude=5.0&earthquake.age=3

23.5 Example Response(XML)

<?xml version="1.0" encoding="UTF-8"?>
 <report gmt_date="2210242017" unix_date="1508885102.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Tue, 24 Oct 2017 15:55:01 PDT" localupdatetime="Tue, 24 Oct 2017 15:45:02 PDT" metric="true" total_results="201" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="earthquake" >
 
 <observation city="18Km N Of Pahala, Hawaii" occurrence="Tue Oct 24 22:23:30 UTC 2017" latitude="19.37" longitude="-155.50" magnitude="2.5" depth="6.9" comments="18Km N Of Pahala, Hawaii" />
 
 <observation city="27Km Wnw Of Amatignak Island, Alaska" occurrence="Tue Oct 24 20:49:18 UTC 2017" latitude="51.36" longitude="-179.48" magnitude="3.6" depth="40.6" comments="27Km Wnw Of Amatignak Island, Alaska" />
 
 <observation city="59Km E Of Amatignak Island, Alaska" occurrence="Tue Oct 24 20:44:56 UTC 2017" latitude="51.23" longitude="-178.25" magnitude="3.7" depth="32.4" comments="59Km E Of Amatignak Island, Alaska" />
 
 <observation city="26Km E Of Honaunau-Napoopoo, Hawaii" occurrence="Tue Oct 24 18:54:15 UTC 2017" latitude="19.41" longitude="-155.62" magnitude="2.6" depth="2.5" comments="26Km E Of Honaunau-Napoopoo, Hawaii" />
 
 <observation city="66Km W Of Larsen Bay, Alaska" occurrence="Tue Oct 24 18:17:54 UTC 2017" latitude="57.64" longitude="-155.07" magnitude="2.5" depth="80.0" comments="66Km W Of Larsen Bay, Alaska" />
 
 <observation city="124Km Sse Of Akutan, Alaska" occurrence="Tue Oct 24 17:44:35 UTC 2017" latitude="53.07" longitude="-165.18" magnitude="3.0" depth="28.4" comments="124Km Sse Of Akutan, Alaska" />
 </report>

23.6 Notes

Location parameters are not needed to request the data.

24. Tide Data

The tide data product returns tide data for the next 3 days or 30 days.

24.1 URL Description

http://xml.customweather.com/xml?client=client=sampleuser&client_password=tide_forecast

http://xml.customweather.com/xml?client=client=sampleuser&client_password=tide_forecast_30day

24.2 Request Parameters

Parameter Required Description
client yes Username provided by CustomWeather.
client_password yes Password provided by CustomWeather. IP address authentication also available without a password.
product yes The weather product name.
id Required but can only be used one at a time. The CustomWeather city ID. A city list will be sent if needed and after a contract has been signed. Sample IDs may be available upon request. More than one ID can be requested by separating the IDs by a comma.
zip_code Required but can only be used one at a time. The US zip code.
latitude Required but can only be used one at a time. The latitude decimal coordinates. Must be used concomitantly with the longitude parameter.
longitude Required but can only be used one at a time. The longitude decimal coordinates. Must be used concomitantly with the latitude parameter.
name Required but can only be used one at a time. The name of the requested location. Requesting only the location name will return the location with the largest population. The name of the state, province, etc, and/or country is required to receive the exact location you are looking for.
metric Optional Toggle switch for the unit system desired. “metric=false” will return the data in Imperial units (Fahrenheit, mph, inches, etc.). The default units is Metric (Celsius, km/h, centimeters, etc.)
language Optional The name of the language in which to return results. The default language is English. A list of languages can be made available upon request.

24.3 Response Object

Field Description
gmt_date The GMT time and date of the current conditions in HHMMDDYYYY.
unix_date The number of seconds elapsed since 1971-01-01 00:00 UTC of the update time of the actual data.
timezone Time zone offset from UTC of the location.
state The state code of the requested location.
state_name The state name of the requested location.
country The country code.
iso_cc The ISO country code.
country_name The country name.
local_time The real-time local time of the location in %a, %d %b %Y %I:%M:%S %Z format.
localupdatetime The time of the last update in %a, %d %b %Y %I:%M:%S %Z format.
metric Metric units indicator (true or false).
city_name The location name.
longitude The longitude coordinates in decimal degrees of the requested location.
latitude The latitude coordinates in decimal degrees of the requested location.
tzinfo IANA (Internet Assigned Numbers Authority) time zone database identifier.
elevation The elevation of the location in meters or feet.
city Location of the event.
tide_id The ID of the tide location.
tide_name The name of the tide location.
latitude The latitude coordinates in decimal degrees of the tide location.
longitude The longitude coordinates in decimal degrees of the tide location.
date The date of the tides in MM/DD/YY (timezone) format.
sunrise The tide location's time of sunrise in h:mm%z format.
sunset The tide location's time of sunset in h:mm%z format.
timezone The timezone abbreviation.
iso8601 The date and time of the forecast day in ISO 8601 format.
time The time of the tide in h:mm%z format.
type The type of tide (HIGH or LOW).
height The the height of the tide in feet or meters.

24.4 Example Request

http://xml.customweather.com/xml?client=client=sampleuser&client_password=tide_forecast&id=12156

http://xml.customweather.com/xml?client=client=sampleuser&client_password=tide_forecast_30day&id=12156

24.5 Example Response(XML)

"<?xml version="1.0" encoding="UTF-8"?>
<report gmt_date="0803062019" unix_date="1551860927.000000" timezone="-8" state="CA" state_name="California" country="US" iso_cc="US" country_name="United States" localtime="Wed, 06 Mar 2019 14:27:17 PST" localupdatetime="Wed, 06 Mar 2019 00:28:47 PST" metric="true" city_name="San Francisco" longitude="-122.42" latitude="37.77" tzinfo="America/Los_Angeles" elevation="10.00" name="tide_forecast" >
<location tide_id="T10129" tide_name="Potrero Point, San Francisco Bay">
<forecast tide_id="T10129" tide_name="Potrero Point, San Francisco Bay" latitude="37.7667" longitude="-122.3833" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:27 AM" type="HIGH" height="1.7" />
<tide time="11:47 AM" type="HIGH" height="1.9" />
<tide time="05:58 AM" type="LOW" height="0.6" />
<tide time="06:17 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10129" tide_name="Potrero Point, San Francisco Bay" latitude="37.7667" longitude="-122.3833" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:50 AM" type="HIGH" height="1.7" />
<tide time="12:25 PM" type="HIGH" height="1.8" />
<tide time="06:30 AM" type="LOW" height="0.5" />
<tide time="06:46 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10129" tide_name="Potrero Point, San Francisco Bay" latitude="37.7667" longitude="-122.3833" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="01:14 AM" type="HIGH" height="1.7" />
<tide time="01:03 PM" type="HIGH" height="1.7" />
<tide time="07:04 AM" type="LOW" height="0.5" />
<tide time="07:15 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T10128" tide_name="Potrero Point">
<forecast tide_id="T10128" tide_name="Potrero Point" latitude="37.7667" longitude="-122.3833" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:27 AM" type="HIGH" height="1.7" />
<tide time="11:47 AM" type="HIGH" height="1.9" />
<tide time="05:58 AM" type="LOW" height="0.6" />
<tide time="06:17 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10128" tide_name="Potrero Point" latitude="37.7667" longitude="-122.3833" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:51 AM" type="HIGH" height="1.7" />
<tide time="12:24 PM" type="HIGH" height="1.8" />
<tide time="06:30 AM" type="LOW" height="0.5" />
<tide time="06:46 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10128" tide_name="Potrero Point" latitude="37.7667" longitude="-122.3833" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="01:14 AM" type="HIGH" height="1.7" />
<tide time="01:03 PM" type="HIGH" height="1.7" />
<tide time="07:04 AM" type="LOW" height="0.5" />
<tide time="07:15 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco">
<forecast tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco" latitude="37.7833" longitude="-122.3833" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:17 AM" type="HIGH" height="1.7" />
<tide time="11:37 AM" type="HIGH" height="1.8" />
<tide time="05:37 AM" type="LOW" height="0.6" />
<tide time="05:56 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco" latitude="37.7833" longitude="-122.3833" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:41 AM" type="HIGH" height="1.7" />
<tide time="12:14 PM" type="HIGH" height="1.8" />
<tide time="06:09 AM" type="LOW" height="0.5" />
<tide time="06:25 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T10319" tide_name="Rincon Point, Pier 22 1/2, San Francisco" latitude="37.7833" longitude="-122.3833" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="01:04 AM" type="HIGH" height="1.7" />
<tide time="12:53 PM" type="HIGH" height="1.7" />
<tide time="06:43 AM" type="LOW" height="0.5" />
<tide time="06:54 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T2062" tide_name="San Francisco, Pier 22 1/2">
<forecast tide_id="T2062" tide_name="San Francisco, Pier 22 1/2" latitude="37.79" longitude="-122.3867" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:07 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:09 AM" type="HIGH" height="1.7" />
<tide time="11:30 AM" type="HIGH" height="1.8" />
<tide time="05:33 AM" type="LOW" height="0.6" />
<tide time="05:49 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T2062" tide_name="San Francisco, Pier 22 1/2" latitude="37.79" longitude="-122.3867" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:33 AM" type="HIGH" height="1.7" />
<tide time="12:09 PM" type="HIGH" height="1.8" />
<tide time="06:05 AM" type="LOW" height="0.5" />
<tide time="06:17 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T2062" tide_name="San Francisco, Pier 22 1/2" latitude="37.79" longitude="-122.3867" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="12:56 AM" type="HIGH" height="1.7" />
<tide time="12:48 PM" type="HIGH" height="1.7" />
<tide time="06:37 AM" type="LOW" height="0.5" />
<tide time="06:46 PM" type="LOW" height="0.2" />
</forecast>

</location>
<location tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay">
<forecast tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay" latitude="37.81" longitude="-122.4133" date="03/06/19 (PST)" sunrise="06:34 AM" sunset="06:08 PM" time_zone="PST" iso8601="2019-03-06T08:00:00.00+00:00" >
<tide time="12:00 AM" type="HIGH" height="1.6" />
<tide time="11:21 AM" type="HIGH" height="1.8" />
<tide time="05:17 AM" type="LOW" height="0.6" />
<tide time="05:33 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay" latitude="37.81" longitude="-122.4133" date="03/07/19 (PST)" sunrise="06:32 AM" sunset="06:09 PM" time_zone="PST" iso8601="2019-03-07T08:00:00.00+00:00" >
<tide time="12:22 AM" type="HIGH" height="1.6" />
<tide time="11:58 AM" type="HIGH" height="1.7" />
<tide time="05:48 AM" type="LOW" height="0.5" />
<tide time="06:02 PM" type="LOW" height="0.1" />
</forecast>

<forecast tide_id="T1565" tide_name="North Point, Pier 41, San Francisco Bay" latitude="37.81" longitude="-122.4133" date="03/08/19 (PST)" sunrise="06:31 AM" sunset="06:10 PM" time_zone="PST" iso8601="2019-03-08T08:00:00.00+00:00" >
<tide time="12:46 AM" type="HIGH" height="1.6" />
<tide time="12:37 PM" type="HIGH" height="1.6" />
<tide time="06:21 AM" type="LOW" height="0.5" />
<tide time="06:32 PM" type="LOW" height="0.2" />
</forecast>

</location>
</report>"

24.6 Notes

The product will return up to the 8 nearest tide locations.