Where can i find a small description of the response fields?

  • 22
  • Question
  • Updated 3 years ago
Where can i find a small description of the response fields? the abbreviations are not always clear to me. example from houly forecast: qpf,wx,uvi,mslp ... what are they?

I see that the list http://api.wunderground.com/weather/a... is not complete
Photo of Bram Desoete

Bram Desoete

  • 5 Posts
  • 0 Reply Likes

Posted 8 years ago

  • 22
Photo of juanbond


  • 20 Posts
  • 8 Reply Likes
Yes, this is really the main downside right now with the API...lack of proper docs. A field-by-field layout and technical description for each request type is badly needed. Most of the field names are descriptive enough, but some, like the ones you mentioned, require either a bit of weather terminology knowledge, guesswork, googling, or all of the above.
Photo of Myle


  • 5 Posts
  • 0 Reply Likes
I use chrome and went to tool java put a stop in then mouse over the variable then I could drill down and see the value
Photo of John Celenza

John Celenza

  • 40 Posts
  • 21 Reply Likes
We hear you concerning the lack of such documentation. I will try to move an upgrade to the documentation up our task list.

We are like most developers, we love to write code, and drag our feet on documentation! But, that's not a proper excuse.
Photo of NormVA


  • 1 Post
  • 0 Reply Likes
Remember this well from my engineering days.
Photo of klauskraemer


  • 3 Posts
  • 2 Reply Likes
As I'm currently a newbie to the API I'd really appreciate such a documentation.

And why shouldn't that documentation be something like a wiki? This way developers and user could be able to contribute to the documentation and the documentation would be realized much faster...
Photo of mEErEck


  • 2 Posts
  • 0 Reply Likes
After 4 months, no update so far.
Can anybody just describe those fields here?

Photo of VHAuto


  • 1 Post
  • 0 Reply Likes
I was just trying to figure out what qpf was when i stumbled upon this thread. After i didn't find the answer i googled "rain totals qpf"(thinking it had something to do with that) and it appears qpf stands for Quantitative Precipitation Forecasts. You can read about it anywhere on the net but here it is on Wikipedia.

it is basically how much rain is expected...

Photo of John Celenza

John Celenza

  • 40 Posts
  • 21 Reply Likes

Sorry for the long delay.
We just upgraded the documentation backend and have launched in incremental upgrade:

Now we need to work as a group at Wunderground and go through and document the fields (although with the documentation upgrade, this now is possible).

qpf - quantitative precipitation forecast. How much rain will fall in the 3 hour period
wx - the sensible weather field. This is a US forecast field from the National Weather Service, and is rather esoteric to decode
uvi - ultraviolet index (1-16, where 16 is extreme)
mslp - mean sea-level pressure, the barometric pressure reduced to sea-level.

I hope this helps, sorry again for the delay.

Photo of TNelsonEnigma


  • 3 Posts
  • 0 Reply Likes
John, if I use the hourly10day API then I get a response for each hour of the day. You stated that qpf the amount of rain in a three hour period. If I want to get the amount of rain expected within that hour do I need to divide the qpf by three or is it already in the "per hour" format in this API call? Thanks!
Photo of tstrassner


  • 2 Posts
  • 0 Reply Likes
please answer this. also is qpf rain or water? i.e. if it's snowing will qpf be zero or a measure of precipitation if the snow were water?
Photo of mEErEck


  • 2 Posts
  • 0 Reply Likes
Thanks John.
Photo of vancew


  • 9 Posts
  • 0 Reply Likes
Please upgrade the docs further. They are very lacking. An example, what does "magic" mean? Does precipitation include snowfall? or only rain?

Thanks for such a great resource, keep up the good work!
Photo of Paul G

Paul G

  • 3 Posts
  • 1 Reply Like

I'm new to the wunderground weather API and was just wondering....

Is there a list of all possible weather types somewhere in the docs??

Ex: Partly Cloudy, Cloudy, Light Rain, Clear, Shallow Fog, etc....

I would like my program to display data a little differently depending on the weather type.

Thanks in advance!
Photo of kennybobo


  • 1 Post
  • 0 Reply Likes
+1 here
Photo of smimic


  • 1 Post
  • 0 Reply Likes

The list is quite exhaustive. I suspect if you observe the responses for your local weather the list will be smaller.

What I did was have a case where an unrecognized response in the "weather":"xxxx" (where xxxx is {Cloudy, Clear, ...}) displayed a special character -- when I noticed the special character, I checked the downloaded file manually and included the new icon.

I suppose you could write a code to collect all the responses too.
Photo of DomenicF


  • 1 Post
  • 0 Reply Likes
Is this the list that Wunderground definitely goes off of? Because other API's (well, I only know of the World Weather Online one (https://www.worldweatheronline.com/fe...)) go off a separate list, as you can see.
Photo of lporiginalg


  • 2 Posts
  • 0 Reply Likes
I'm also looking for this list, thanks.
Photo of torben


  • 1 Post
  • 0 Reply Likes
I'm looking for a list of the translated strings - to determine the maximum needed space on the frontend (over all supported languages and conditions).

And it seems some strings still lack translation so an overview would be useful there as well.
Photo of VMakwana


  • 1 Post
  • 0 Reply Likes
After the doc upgrade, I still could not find documented response fields for History feature. However, many of the fields are self-descriptive, except, m and i suffixes.
Can any one tell me what m and i suffix means?
Thank you.
Photo of John Bowen

John Bowen

  • 1 Post
  • 0 Reply Likes
Metric and Imperial?
Photo of Brendan Hayes

Brendan Hayes, Official Rep

  • 962 Posts
  • 124 Reply Likes
which fields in particular? I can answer some here
Photo of emptythetill


  • 1 Post
  • 0 Reply Likes
I'm looking for the complete list of 'Partly Cloudy', 'Chance of Rain', 'Chance of Snow' responses. I need to get the full list so I can create icons for each one. Any ideas where I can get this? Thanks.
Photo of afelicioni


  • 227 Posts
  • 43 Reply Likes
Available strings lists are published under phrase glossary api resource at http://www.wunderground.com/weather/a...
Photo of lporiginalg


  • 2 Posts
  • 0 Reply Likes
Ah perfect, thanks!
Photo of cmilono


  • 5 Posts
  • 0 Reply Likes
I need to do something with XML, so I built an XSD for PWS "conditions" - I posted it to "ideas", but it looks like the forum gobbled angle brackets and everything with it.

Where can I post my XSD?

I made everything a String, since the types weren't known, though I am guessing at least a few are integers and some are decimal, and other number things.
Photo of cmilono


  • 5 Posts
  • 0 Reply Likes

<?xml version="1.0" encoding="UTF-8"?>

<xs:schema xmlns:xs="http://www.w3.org/2001/XMLSchema"
<xs:element name="response">
<xs:element ref="version" minOccurs="0"/>
<xs:element ref="termsofService" minOccurs="0"/>
<xs:element ref="features" minOccurs="0"/>
<xs:element ref="current_observation" minOccurs="0"/>
<xs:element name="current_observation">
<xs:element ref="image" minOccurs="0"/>
<xs:element ref="display_location" minOccurs="0"/>
<xs:element ref="observation_location" minOccurs="0"/>
<xs:element ref="estimated" minOccurs="0"/>
<xs:element ref="station_id" minOccurs="0"/>
<xs:element ref="observation_time" minOccurs="0"/>
<xs:element ref="observation_time_rfc822"/>
<xs:element ref="observation_epoch" minOccurs="0"/>
<xs:element ref="local_time_rfc822" minOccurs="0"/>
<xs:element ref="local_epoch" minOccurs="0"/>
<xs:element ref="local_tz_short" minOccurs="0"/>
<xs:element ref="local_tz_long" minOccurs="0"/>
<xs:element ref="local_tz_offset" minOccurs="0"/>
<xs:element ref="weather" minOccurs="0"/>
<xs:element ref="temperature_string" minOccurs="0"/>
<xs:element ref="temp_f" minOccurs="0"/>
<xs:element ref="temp_c" minOccurs="0"/>
<xs:element ref="relative_humidity" minOccurs="0"/>
<xs:element ref="wind_string" minOccurs="0"/>
<xs:element ref="wind_dir" minOccurs="0"/>
<xs:element ref="wind_degrees" minOccurs="0"/>
<xs:element ref="wind_mph" minOccurs="0"/>
<xs:element ref="wind_gust_mph" minOccurs="0"/>
<xs:element ref="wind_kph" minOccurs="0"/>
<xs:element ref="wind_gust_kph" minOccurs="0"/>
<xs:element ref="pressure_mb" minOccurs="0"/>
<xs:element ref="pressure_in" minOccurs="0"/>
<xs:element ref="pressure_trend" minOccurs="0"/>
<xs:element ref="dewpoint_string" minOccurs="0"/>
<xs:element ref="dewpoint_f" minOccurs="0"/>
<xs:element ref="dewpoint_c" minOccurs="0"/>
<xs:element ref="heat_index_string" minOccurs="0"/>
<xs:element ref="heat_index_f" minOccurs="0"/>
<xs:element ref="heat_index_c" minOccurs="0"/>
<xs:element ref="windchill_string" minOccurs="0"/>
<xs:element ref="windchill_f" minOccurs="0"/>
<xs:element ref="windchill_c" minOccurs="0"/>
<xs:element ref="feelslike_string" minOccurs="0"/>
<xs:element ref="feelslike_f" minOccurs="0"/>
<xs:element ref="feelslike_c" minOccurs="0"/>
<xs:element ref="visibility_mi" minOccurs="0"/>
<xs:element ref="visibility_km" minOccurs="0"/>
<xs:element ref="solarradiation" minOccurs="0"/>
<xs:element ref="UV" minOccurs="0"/>
<xs:element ref="precip_1hr_string" minOccurs="0"/>
<xs:element ref="precip_1hr_in" minOccurs="0"/>
<xs:element ref="precip_1hr_metric" minOccurs="0"/>
<xs:element ref="precip_today_string" minOccurs="0"/>
<xs:element ref="precip_today_in" minOccurs="0"/>
<xs:element ref="precip_today_metric" minOccurs="0"/>
<xs:element ref="icon" minOccurs="0"/>
<xs:element ref="icon_url" minOccurs="0"/>
<xs:element ref="forecast_url" minOccurs="0"/>
<xs:element ref="history_url" minOccurs="0"/>
<xs:element ref="ob_url" minOccurs="0"/>
<xs:element name="observation_location">
<xs:element ref="full" minOccurs="0"/>
<xs:element ref="city" minOccurs="0"/>
<xs:element ref="state" minOccurs="0"/>
<xs:element ref="country" minOccurs="0"/>
<xs:element ref="country_iso3166" minOccurs="0"/>
<xs:element ref="latitude" minOccurs="0"/>
<xs:element ref="longitude" minOccurs="0"/>
<xs:element ref="elevation" minOccurs="0"/>
<xs:element name="full" type="xs:string"/>
<xs:element name="feelslike_string" type="xs:string"/>
<xs:element name="wind_string" type="xs:string"/>
<xs:element name="termsofService" type="xs:string"/>
<xs:element name="features">
<xs:element ref="feature" minOccurs="0"/>
<xs:element name="feature" type="xs:string"/>
<xs:element name="version" type="xs:string"/>
<xs:element name="image">
<xs:element ref="url" minOccurs="0"/>
<xs:element ref="title" minOccurs="0"/>
<xs:element ref="link" minOccurs="0"/>
<xs:element name="display_location">
<xs:element ref="full" minOccurs="0"/>
<xs:element ref="city" minOccurs="0"/>
<xs:element ref="state" minOccurs="0"/>
<xs:element ref="state_name" minOccurs="0"/>
<xs:element ref="country" minOccurs="0"/>
<xs:element ref="country_iso3166" minOccurs="0"/>
<xs:element ref="zip" minOccurs="0"/>
<xs:element ref="latitude" minOccurs="0"/>
<xs:element ref="longitude" minOccurs="0"/>
<xs:element ref="elevation"/>
<xs:element name="forecast" type="xs:string' />
<xs:element name="history_url" type="xs:string"/>
<xs:element name="ob_url" type="xs:string"/>
<xs:element name="url" type="xs:string"/>
<xs:element name="title" type="xs:string"/>
<xs:element name="link" type="xs:string"/>
<xs:element name="estimated" type="xs:string"/>
<xs:element name="station_id" type="xs:string"/>
<xs:element name="observation_time" type="xs:string"/>
<xs:element name="observation_time_rfc822" type="xs:string"/>
<xs:element name="observation_epoch" type="xs:string"/>
<xs:element name="local_tz_short" type="xs:string"/>
<xs:element name="local_tz_long" type="xs:string"/>
<xs:element name="local_tz_offset" type="xs:string"/>
<xs:element name="weather" type="xs:string"/>
<xs:element name="temperature_string" type="xs:string"/>
<xs:element name="temp_f" type="xs:string"/>
<xs:element name="temp_c" type="xs:string"/>
<xs:element name="relative_humidity" type="xs:string"/>
<xs:element name="wind_dir" type="xs:string"/>
<xs:element name="wind_degrees" type="xs:string"/>
<xs:element name="wind_mph" type="xs:string"/>
<xs:element name="wind_gust_mph" type="xs:string"/>
<xs:element name="wind_kph" type="xs:string"/>
<xs:element name="wind_gust_kph" type="xs:string"/>
<xs:element name="pressure_mb" type="xs:string"/>
<xs:element name="pressure_in" type="xs:string"/>
<xs:element name="pressure_trend" type="xs:string"/>
<xs:element name="dewpoint_string" type="xs:string"/>
<xs:element name="dewpoint_f" type="xs:string"/>
<xs:element name="dewpoint_c" type="xs:string"/>
<xs:element name="heat_index_string" type="xs:string"/>
<xs:element name="heat_index_f" type="xs:string"/>
<xs:element name="heat_index_c" type="xs:string"/>
<xs:element name="windchill_string" type="xs:string"/>
<xs:element name="windchill_f" type="xs:string"/>
<xs:element name="windchill_c" type="xs:string"/>
<xs:element name="feelslike_f" type="xs:string"/>
<xs:element name="feelslike_c" type="xs:string"/>
<xs:element name="visibility_mi" type="xs:string"/>
<xs:element name="visibility_km" type="xs:string"/>
<xs:element name="solarradiation" type="xs:string"/>
<xs:element name="UV" type="xs:string"/>
<xs:element name="precip_1hr_string" type="xs:string"/>
<xs:element name="precip_1hr_in" type="xs:string"/>
<xs:element name="precip_1hr_metric" type="xs:string"/>
<xs:element name="precip_today_string" type="xs:string"/>
<xs:element name="precip_today_in" type="xs:string"/>
<xs:element name="precip_today_metric" type="xs:string"/>
<xs:element name="icon" type="xs:string"/>
<xs:element name="icon_url" type="xs:string"/>
<xs:element name="city" type="xs:string"/>
<xs:element name="state" type="xs:string"/>
<xs:element name="state_name" type="xs:string"/>
<xs:element name="country" type="xs:string"/>
<xs:element name="country_iso3166" type="xs:string"/>
<xs:element name="zip" type="xs:string"/>
<xs:element name="latitude" type="xs:string"/>
<xs:element name="longitude" type="xs:string"/>
<xs:element name="elevation" type="xs:string"/>
<xs:element name="local_time_rfc822" type="xs:string"/>
<xs:element name="local_epoch" type="xs:string"/>
<xs:element name="forecast_url" type="xs:string"/>

Photo of Peter


  • 1 Post
  • 0 Reply Likes
The official Phrase Glossary is still missing several fields, including qpf, wx, and mslp. They've been documented above... any chance those definitions could get copied to the official docs, so they're easier to find?

Aside: cmilono, your XML question doesn't really belong here, could you move your messages? You can use pastebin.com for posting code snippets, BTW.
Photo of tkr1


  • 5 Posts
  • 0 Reply Likes
I have to admit Your system is great but suffers from lack of documentation.
A short description of the fields would be great.
Photo of ivens


  • 1 Post
  • 0 Reply Likes
Great system. Potentially worse documentation ever for a paid service.
Photo of cdavis3806


  • 2 Posts
  • 0 Reply Likes
Horrible documentation. For planner data over say a 7 day window, what is precip min / max / avg of ? which metric provides the amount of precip for the 7 days ?
Photo of up


  • 1 Post
  • 0 Reply Likes
This thread is 2 years old and still there is no proper documentation!!!! Don't you guys know that if we cannot understand the Response there is no point in requesting for it? Please provide a brief description for 'the Response Fields'. Its very frustrating.
Photo of WunderWilliam


  • 267 Posts
  • 18 Reply Likes
This page should cover the majority of the response phrases:

Photo of mike mike

mike mike

  • 1 Post
  • 0 Reply Likes

It would be nice to understand the responses rather than making educated guesses or assumptions about the meanings of the less than obvious ones (e.g., magic). Most keys are obvious but some are not.   I've wasted an hour searching for the missing 'short list of fields' asked for by so many instead of being creative.  I now have to know what 'magic' is or I may never sleep again.   You guys at WU need to document better and show off the nuances of you excellent work.