adding weather vocabulary
authordanbri <danbri@google.com>
Sun, 12 May 2013 01:12:24 +0100
changeset 81 c3ef6885a81c
parent 76 d48d6bd6ef1e
child 82 05cdb47c9ceb
adding weather vocabulary
schema.org/ext/weatherforecast.html
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/schema.org/ext/weatherforecast.html	Sun May 12 01:12:24 2013 +0100
@@ -0,0 +1,280 @@
+<!DOCTYPE html>
+<html>
+  <head>
+    <title>RDFa Lite vocabulary description</title>
+    <style type="text/css">
+      span.h {
+        padding-left: 0px;
+        font-weight: bold;
+      }
+      span {
+        display: block;
+        padding-left: 10px;
+      }
+    </style>
+  </head>
+  <body>
+
+   <h1>Weather Forecast Vocabulary</h1>
+
+  <p>This is a specification for schema.org vocabulary that describes weather forecasts and associated information. The primary types are: WeatherForecast, WeatherCondition, QuantitativeWeatherCondition, WeatherAlertType</p>
+
+
+ <!-- types -->
+
+    <div typeof="rdfs:Class" resource="http://schema.org/WeatherForecast">
+      <span class="h" property="rdfs:label">WeatherForecast</span>
+      <span property="rdfs:comment">A forecast of weather conditions, for some particular place and time.</span>
+      <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/CreativeWork">CreativeWork</a></span>
+    </div>
+
+    <div typeof="rdfs:Class" resource="http://schema.org/WeatherCondition">
+      <span class="h" property="rdfs:label">WeatherCondition</span>
+      <span property="rdfs:comment">A particular weather condition, described textually. Properties correspond to broad categories of weather condition, and their textual values capture a corresponding natural language description.</span>
+      <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></span>
+      <!-- notes: for discussion - original text is couched in terms of people talking, and filed this directly under Thing. -->
+      <!-- this property pattern is unusual for schema.org; we tend to handle such enumerations via types --> 
+    </div>
+
+    <div typeof="rdfs:Class" resource="http://schema.org/QuantitativeWeatherCondition">
+      <span class="h" property="rdfs:label">QuantitativeWeatherCondition</span>
+      <span property="rdfs:comment">A quantitatively described weather condition.</span>
+      <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></span>
+    </div>
+
+    <div typeof="rdfs:Class" resource="http://schema.org/WeatherAlertType">
+      <span class="h" property="rdfs:label">WeatherAlertType</span>
+      <span property="rdfs:comment">A type of weather alert, e.g. a tornado warning or heat advisory.</span>
+      <span>Subclass of: <a property="rdfs:subClassOf" href="http://schema.org/Intangible">Intangible</a></span>
+      <!-- notes: as with weather condition, the property-based enumeration is unusual. Are textual values important here? -->
+    </div>
+
+
+
+ <!-- properties -->
+
+    <div typeof="rdf:Property" resource="http://schema.org/forecastDate">
+      <span class="h" property="rdfs:label">forecastDate</span>
+      <span property="rdfs:comment">Date of a forecast, e.g. tomorrow's weather forecast.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Date">Date</a></span>
+      <!-- notes: writing forecastDate rather than plain 'date', as property space is flat so we try to be fairly specific. -->
+      <!-- ... we could add other kinds of forecast later, and broaden the domain. -->
+    </div>
+
+
+
+    <div typeof="rdf:Property" resource="http://schema.org/forecastPlace">
+      <span class="h" property="rdfs:label">forecastPlace</span>
+      <span property="rdfs:comment">Place associated with a WeatherForecast, e.g. friday's weather forecast for Boston.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Place">Place</a></span>
+      <!-- notes: as above, forecastPlace rather than just place, so the work the property is doing is clearer from its name -->
+    </div>
+
+
+
+    <div typeof="rdf:Property" resource="http://schema.org/forecastTime">
+      <span class="h" property="rdfs:label">forecastTime</span>
+      <span property="rdfs:comment">Time associated with a place, e.g. friday's weather forecast for Boston.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Time">Time</a></span>
+      <!-- notes: as above, forecastTime rather than just time, so the work the property is doing is clearer from its name -->
+       <!-- do we have a way to record when the forecast was made/published? Use CreativeWork properties? -->
+    </div>
+
+
+    <div typeof="rdf:Property" resource="http://schema.org/daysAhead">
+      <span class="h" property="rdfs:label">daysAhead</span>
+      <span property="rdfs:comment">The number of days ahead to forecast, e.g. 5 day, 10 day forecast.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Number">Number</a></span>
+      <!-- perhaps http://schema.org/Integer rather than Number, or is 2.5 sometimes useful? -->
+    </div>
+
+    <div typeof="rdf:Property" resource="http://schema.org/fromWhen">
+      <span class="h" property="rdfs:label">fromWhen</span>
+      <span property="rdfs:comment">The start of datetime range for forecast, e.g. some particular Monday</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a></span>
+    </div>
+
+    <div typeof="rdf:Property" resource="http://schema.org/toWhen">
+      <span class="h" property="rdfs:label">toWhen</span>
+      <span property="rdfs:comment">The end of datetime range for forecast, e.g. some particular Thursday</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/DateTime">DateTime</a></span>
+    </div>
+
+
+    <div typeof="rdf:Property" resource="http://schema.org/forecastCondition">
+      <span class="h" property="rdfs:label">forecastCondition</span>
+      <span property="rdfs:comment">The weather condition forecasted.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/WeatherCondition">WeatherCondition</a></span>
+      <!-- note: changed this so that we don't have a type and property differing only in case, see mail thread w/ Steve a few weeks back -->
+    </div>
+
+
+    <div typeof="rdf:Property" resource="http://schema.org/forecastConditionAlert">
+      <span class="h" property="rdfs:label">forecastConditionAlert</span>
+      <span property="rdfs:comment">The weather condition alert forecasted.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherForecast">WeatherForecast</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/WeatherCondition">WeatherConditionAlert</a></span>
+      <!-- note: changed this so that we don't have a type and property differing only in case, see mail thread w/ Steve a few weeks back -->
+    </div>
+
+
+
+    <div typeof="rdf:Property" resource="http://schema.org/sunnyWeather">
+      <span class="h" property="rdfs:label">sunnyWeather</span>
+      <span property="rdfs:comment">Description of sunny weather.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherCondition">WeatherCondition</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Text">Text</a></span>
+      <!-- note: adapted property names to be more rdfa/microdata-ish, esp. no whitespace and appended *Weather -->
+    </div>
+
+    <div typeof="rdf:Property" resource="http://schema.org/mostlySunnyWeather">
+      <span class="h" property="rdfs:label">mostlySunnyWeather</span>
+      <span property="rdfs:comment">Description of mostly sunny weather.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherCondition">WeatherCondition</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Text">Text</a></span>
+      <!-- note: adapted property names to be more rdfa/microdata-ish, esp. no whitespace and appended *Weather -->
+    </div>
+
+    <div typeof="rdf:Property" resource="http://schema.org/cloudyWeather">
+      <span class="h" property="rdfs:label">cloudyWeather</span>
+      <span property="rdfs:comment">Description of cloudy weather.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherCondition">WeatherCondition</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Text">Text</a></span>
+      <!-- note: adapted property names to be more rdfa/microdata-ish, esp. no whitespace and appended *Weather -->
+    </div>
+
+   <div typeof="rdf:Property" resource="http://schema.org/mostlyCloudyWeather">
+      <span class="h" property="rdfs:label">mostlyCloudyWeather</span>
+      <span property="rdfs:comment">Description of mostly cloudy weather.</span>
+      <span>Domain: <a property="http://schema.org/domain" href="http://schema.org/WeatherCondition">WeatherCondition</a></span>
+      <span>Range: <a property="http://schema.org/range" href="http://schema.org/Text">Text</a></span>
+      <!-- note: adapted property names to be more rdfa/microdata-ish, esp. no whitespace and appended *Weather -->
+    </div>
+
+<!-- more properties to be added, following this pattern. -->
+
+<!-- todo: add quantitative properties, see below.  Also alert types. Check we don't want an enum first. -->
+
+
+
+<!--
+
+copied from pdf
+
+
+http://schema.org/WeatherForecast
+
+“what’s the weather like“ "5 
+day forecast for Seattle, WA"
+date http://schema.org/Date specific date for 
+forecast
+weather for Tuesday, next 
+week, tomorrowplace http://schema.org/Place place, location for 
+weather
+weather in San Jose
+time http://schema.org/Time specific time of 
+weather answer
+weather at 8PM
+url URL forecast result 
+URL
+daysAhead Number number of days to 
+forecast
+5 day , 10 day forecast
+fromWhen DateTime start of datetime 
+range for forecast
+weather from Monday 
+toWhen DateTime end of datetime 
+range for forecast
+to Thursday
+weatherCondition http://schema.org/WeatherCo
+ndition
+end of datetime 
+range for forecast
+sunny
+weatherConditionAlert http://schema.org/Weather
+ConditionAlert
+
+
+
+
+
+
+
+
+Parent Object
+http://schema.org/Thing 
+URI http://schema.org/WeatherCondition
+property name property type Description Example
+sunny Text The value of what 
+the person said to 
+mean sunny.
+mostly sunny Text
+cloudy Text
+partly cloudy Text
+rain Text
+light showers Text
+heavy showers Text
+showers Text
+hail Text
+sleet Text
+snow Text
+foggy Text
+clear Text
+overcast Text
+humid Text
+
+
+
+
+
+
+
+Parent Object
+http://schema.org/Thi
+ng 
+URI http://schema.org/WeatherAlertType
+property name property type Description Example
+Tornado Warning Text
+Tornado Watch Text
+Severe Thunderstorm 
+Warning
+Text
+Severe Thunderstorm 
+Watch
+Text
+Winter Weather 
+Statement
+Text
+High Wind Advisory Text
+Flood Warning Text
+Flood Watch / Flood 
+Statement
+Text
+Hurricane Local 
+Statement
+Text
+Heat Advisory TextDense Fog Advisory Text
+Fire Weather Advisory Text
+Special Weather 
+Statement
+Text
+Record Set Text
+Public Reports Text
+Public Statement Text
+Tornado Warning Text
+High Wind Advisory Text
+Flood Warning Text
+Flood Watch / Flood 
+Statement
+Text
+-->
+
+  </body>
+</html>