Zone Forecast Response element

The Zone Forecast Response Element is returned for the following request type:

Table of Contents
Zone Forecast
Top
Element Cardinality Description
<zoneForecast> 0..1 Holder element for a zone forecast report
<header>GREATER PORTLAND METRO AREA-GREATER VANCOUVER AREA- INCLUDING THE CITIES OF...PORTLAND...FOREST GROVE...BEAVERTON... GRESHAM...OREGON CITY...LA CENTER...BATTLEGROUND...VANCOUVER...CAMAS 912 AM PDT TUE AUG 28 2012</header> 1..1 "Header" section of the original forecast, listing zone names, cities, time, and sometimes other information such as advisories.
<general>Expires:201208282245;;760339 FPUS56 KPQR 281612 ZFPPQR ZONE FORECASTS FOR NORTHWEST OREGON AND SOUTHWEST WASHINGTON NATIONAL WEATHER SERVICE PORTLAND OREGON 912 AM PDT TUE AUG 28 2012 SPOT TEMPERATURES ARE FOR TODAY...TONIGHT...WEDNESDAY...WEDNESDAY NIGHT...AND THURSDAY.</general> 1..1 "General" section of the original forecast, providing various kinds of top-level data.
<zones> 1..1 List of zones the forecast applies to.
<zone>ORZ006</zone> 1..n Timestamp of the observations the report is based on (UTC).
</zones>
<reportTime>2012-08-28T09:12:00.000-07:00</reportTime> 1..1 Timestamp for when the forecast was produced.
<cities> 1..1 List of cities within the zone.
<city>Portland</city> 1..n City name.
</cities>
<zoneNames> 1..1 List of zone names, for zones included in this report
<zoneName>Greater Portland Metro Area</zoneName> 1..n Zone name.
</zoneNames>
<dayForecasts> 1..1 List of day forecasts contained in the report.
<dayForecast> 0..n Entry for a day forecast.
<day>Today</day> 1..1 Day name for this forecast section. Can be a day of week name (e.g. "Monday" or "Monday night"), a day number (e.g. "Day three"), or one of several idiomatic expressions ("Today", "Tonight", "Rest of the afternoon", etc.)
<forecast>Partly sunny in the morning...then mostly sunny. Highs 70 to 75. West wind 5 to 10 mph.</forecast> 1..1 Weather forecast details.
<start>2012-08-28T09:12:00.000</start> 1..1 Start of the valid period for this forecast (local time).
<end>2012-08-28T18:00:00.000</end> 1..1 End of the valid period for this forecast (local time).
<tags> 1..1
<tag>...</tag> 0..n tag fields; currently the only tag is "Prevailing conditions."
</tags>
</dayForecast>
</dayForecasts>
</zoneForecast>
Tags
Top

Currently, there is only one kind of tagging applied to zone forecasts; this is the "Prevailing conditions" tag applied to each day forecast. This tag is not guaranteed to appear in all cases, but is usually present. The prevailing conditions will be one of the values listed below; the forecast is tagged with only the highest-priority condition.

Element Cardinality Description
<tag> 0..n Tag field
<key>Prevailing conditions</key> 1..1 Tag key; currently "Prevailing conditions" is the only possible key.
<value>Clear</value> 1..1 Tag value. Possible values by key:
Key Possible Values
Note: Numbers preceding values indicate priority, and are not part of the value.
Prevailing conditions
  1. Hurricane
  2. Tornado
  3. Volcanic Ash
  4. Ice
  5. Thunderstorms
  6. Snow
  7. Dust / Sand Storms
  8. Fog
  9. Smoke
  10. Patchy Fog
  11. Windy
  12. Breezy
  13. Rain
  14. High Chance of Rain
  15. Showers
  16. Low Chance of Showers
  17. Cloudy
  18. Partly Cloudy
  19. Smog
  20. Mostly Clear
  21. Clear
  22. Partly Sunny
  23. Sunny
</tag>
Example XML Output
Top
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
<zoneForecast> <header> GREATER PORTLAND METRO AREA-GREATER VANCOUVER AREA- INCLUDING THE CITIES OF...PORTLAND...FOREST GROVE...BEAVERTON... GRESHAM...OREGON CITY...LA CENTER...BATTLEGROUND...VANCOUVER...CAMAS 253 PM PDT WED SEP 5 2012 </header> <general> Expires:201209060600;;103888 FPUS56 KPQR 052153 ZFPPQR ZONE FORECASTS FOR NORTHWEST OREGON AND SOUTHWEST WASHINGTON NATIONAL WEATHER SERVICE PORTLAND OREGON 253 PM PDT WED SEP 5 2012 SPOT TEMPERATURES ARE FOR TONIGHT...THURSDAY...THURSDAY NIGHT... FRIDAY...FRIDAY NIGHT...AND SATURDAY. </general> <zones> <zone>ORZ006</zone> <zone>WAZ039</zone> </zones> <reportTime>2012-09-05T14:53:00.000-07:00</reportTime> <cities> <city>Portland</city> <city>Forest Grove</city> <city>Beaverton</city> <city>Gresham</city> <city>Oregon City</city> <city>La Center</city> <city>Battleground</city> <city>Vancouver</city> <city>Camas</city> </cities> <zoneNames> <zoneName>Greater Portland Metro Area</zoneName> <zoneName>Greater Vancouver Area</zoneName> </zoneNames> <dayForecasts> <dayForecast> <day>Tonight</day> <forecast> Clear. Lows 55 to 60....but 50 to 55 in outlying areas. Evening northwest wind 10 mph...then light wind. </forecast> <start>2012-09-05T18:00:00.000</start> <end>2012-09-06T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Clear</value> </tag> </tags> </dayForecast> <dayForecast> <day>Thursday</day> <forecast> Sunny. Highs around 85. Light wind...becoming northeast 5 to 10 mph. </forecast> <start>2012-09-06T06:00:00.000</start> <end>2012-09-06T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Sunny</value> </tag> </tags> </dayForecast> <dayForecast> <day>Thursday Night</day> <forecast> Clear. Lows around 60...except 50 to 55 in outlying areas. Northeast wind 5 to 10 mph. </forecast> <start>2012-09-06T18:00:00.000</start> <end>2012-09-07T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Clear</value> </tag> </tags> </dayForecast> <dayForecast> <day>Friday</day> <forecast>Sunny. Highs around 90. East wind 5 to 15 mph.</forecast> <start>2012-09-07T06:00:00.000</start> <end>2012-09-07T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Sunny</value> </tag> </tags> </dayForecast> <dayForecast> <day>Friday Night</day> <forecast> Clear. Lows around 60...except 50 to 55 in outlying areas. Northeast wind 10 to 15 mph in evening...then light wind. </forecast> <start>2012-09-07T18:00:00.000</start> <end>2012-09-08T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Clear</value> </tag> </tags> </dayForecast> <dayForecast> <day>Saturday</day> <forecast>Mostly sunny. Highs 80 to 85.</forecast> <start>2012-09-08T06:00:00.000</start> <end>2012-09-08T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Sunny</value> </tag> </tags> </dayForecast> <dayForecast> <day>Saturday Night</day> <forecast> Clear in the evening...then increasing clouds. Lows 50 to 55. </forecast> <start>2012-09-08T18:00:00.000</start> <end>2012-09-09T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Cloudy</value> </tag> </tags> </dayForecast> <dayForecast> <day>Sunday</day> <forecast>Mostly cloudy. Highs around 75.</forecast> <start>2012-09-09T06:00:00.000</start> <end>2012-09-09T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Cloudy</value> </tag> </tags> </dayForecast> <dayForecast> <day>Sunday Night</day> <forecast>Cloudy. 20 percent chance of rain. Lows 50 to 55.</forecast> <start>2012-09-09T18:00:00.000</start> <end>2012-09-10T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Rain</value> </tag> </tags> </dayForecast> <dayForecast> <day>Monday</day> <forecast> Mostly cloudy. 20 percent chance of rain. Highs near 70. </forecast> <start>2012-09-10T06:00:00.000</start> <end>2012-09-10T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Rain</value> </tag> </tags> </dayForecast> <dayForecast> <day>Monday Night</day> <forecast>Mostly cloudy. Lows 50 to 55.</forecast> <start>2012-09-10T18:00:00.000</start> <end>2012-09-11T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Cloudy</value> </tag> </tags> </dayForecast> <dayForecast> <day>Tuesday</day> <forecast> Morning clouds...then partly sunny. Highs 70 to 75. </forecast> <start>2012-09-11T06:00:00.000</start> <end>2012-09-11T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Cloudy</value> </tag> </tags> </dayForecast> <dayForecast> <day>Tuesday Night</day> <forecast>Mostly clear. Lows 50 to 55.</forecast> <start>2012-09-11T18:00:00.000</start> <end>2012-09-12T06:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Mostly Clear</value> </tag> </tags> </dayForecast> <dayForecast> <day>Wednesday</day> <forecast>Partly cloudy. Highs 70 to 75.</forecast> <start>2012-09-05T14:53:00.000</start> <end>2012-09-05T18:00:00.000</end> <tags> <tag> <key>Prevailing Conditions</key> <value>Partly Cloudy</value> </tag> </tags> </dayForecast> </dayForecasts> </zoneForecast>
Example JSON Output (whitespace added for clarity)
Top
The following example is a partial response and uses inline references for simplicity.
See Full Sample Responses for a complete response.
{ "zoneForecast": { "header": "GREATER PORTLAND METRO AREA-GREATER VANCOUVER AREA-\nINCLUDING THE CITIES OF...PORTLAND...FOREST GROVE...BEAVERTON...\nGRESHAM...OREGON CITY...LA CENTER...BATTLEGROUND...VANCOUVER...CAMAS\n253 PM PDT WED SEP 5 2012", "general": "Expires:201209060600;;103888\nFPUS56 KPQR 052153\nZFPPQR\nZONE FORECASTS FOR NORTHWEST OREGON AND SOUTHWEST WASHINGTON\nNATIONAL WEATHER SERVICE PORTLAND OREGON\n253 PM PDT WED SEP 5 2012\nSPOT TEMPERATURES ARE FOR TONIGHT...THURSDAY...THURSDAY NIGHT...\nFRIDAY...FRIDAY NIGHT...AND SATURDAY.", "zones": [ "ORZ006", "WAZ039" ], "reportTime": "2012-09-05T14:53:00.000-07:00", "cities": [ "Portland", "Forest Grove", "Beaverton", "Gresham", "Oregon City", "La Center", "Battleground", "Vancouver", "Camas" ], "zoneNames": [ "Greater Portland Metro Area", "Greater Vancouver Area" ], "dayForecasts": [ { "day": "Tonight", "forecast": "Clear. Lows 55 to 60....but 50 to 55 in outlying areas. Evening northwest wind 10 mph...then light wind.", "start": "2012-09-05T18:00:00.000", "end": "2012-09-06T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Clear" } ] }, { "day": "Thursday", "forecast": "Sunny. Highs around 85. Light wind...becoming northeast 5 to 10 mph.", "start": "2012-09-06T06:00:00.000", "end": "2012-09-06T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Sunny" } ] }, { "day": "Thursday Night", "forecast": "Clear. Lows around 60...except 50 to 55 in outlying areas. Northeast wind 5 to 10 mph.", "start": "2012-09-06T18:00:00.000", "end": "2012-09-07T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Clear" } ] }, { "day": "Friday", "forecast": "Sunny. Highs around 90. East wind 5 to 15 mph. ", "start": "2012-09-07T06:00:00.000", "end": "2012-09-07T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Sunny" } ] }, { "day": "Friday Night", "forecast": "Clear. Lows around 60...except 50 to 55 in outlying areas. Northeast wind 10 to 15 mph in evening...then light wind.", "start": "2012-09-07T18:00:00.000", "end": "2012-09-08T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Clear" } ] }, { "day": "Saturday", "forecast": "Mostly sunny. Highs 80 to 85. ", "start": "2012-09-08T06:00:00.000", "end": "2012-09-08T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Sunny" } ] }, { "day": "Saturday Night", "forecast": "Clear in the evening...then increasing clouds. Lows 50 to 55.", "start": "2012-09-08T18:00:00.000", "end": "2012-09-09T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Cloudy" } ] }, { "day": "Sunday", "forecast": "Mostly cloudy. Highs around 75. ", "start": "2012-09-09T06:00:00.000", "end": "2012-09-09T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Cloudy" } ] }, { "day": "Sunday Night", "forecast": "Cloudy. 20 percent chance of rain. Lows 50 to 55.", "start": "2012-09-09T18:00:00.000", "end": "2012-09-10T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Rain" } ] }, { "day": "Monday", "forecast": "Mostly cloudy. 20 percent chance of rain. Highs near 70.", "start": "2012-09-10T06:00:00.000", "end": "2012-09-10T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Rain" } ] }, { "day": "Monday Night", "forecast": "Mostly cloudy. Lows 50 to 55. ", "start": "2012-09-10T18:00:00.000", "end": "2012-09-11T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Cloudy" } ] }, { "day": "Tuesday", "forecast": "Morning clouds...then partly sunny. Highs 70 to 75. ", "start": "2012-09-11T06:00:00.000", "end": "2012-09-11T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Cloudy" } ] }, { "day": "Tuesday Night", "forecast": "Mostly clear. Lows 50 to 55. ", "start": "2012-09-11T18:00:00.000", "end": "2012-09-12T06:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Mostly Clear" } ] }, { "day": "Wednesday", "forecast": "Partly cloudy. Highs 70 to 75. ", "start": "2012-09-05T14:53:00.000", "end": "2012-09-05T18:00:00.000", "tags": [ { "key": "Prevailing Conditions", "value": "Partly Cloudy" } ] } ] } }
Full Sample Responses
Top