Version: | 0.5 |
---|---|
Creator: | IPTC |
PublicId: | -//IPTC//SportsML DTD 0.5//EN |
SportsML aims to be a global XML standard for the interchange of sports data. Designed to be as easy to understand and implement as possible, SportsML allows for the exchange of sports scores, schedules, standings, and statistics for a wide variety of competitions. Its extensibility allows for the easy accommodation of many sports from around the globe. It cooperates with current IPTC standards NewsML and NITF to enable publishers to package sports statistics alongside edited coverage of sports.
ContentItem | A placeholder container. |
advisory | A short textual message to editors receiving the document. |
article | Holds either an article or a reference to an article. |
associate | Manager or coach or jockey, etc. |
associate-metadata | Metadata that describes an associate |
associate-metadata-for-specific-sport | Not an actual SportsML element. |
associate-stats | Statistics that capture values about the participation of an associate during one or more sports-events. |
associate-stats-for-specific-sport | Not an actual SportsML element. |
award | TBD. |
career-phase | A description of where a player is playing, or has previously played. |
event-actions | event-actions. |
event-actions-for-specific-sport | Not an actual SportsML element. |
event-metadata | TBD. |
event-metadata-for-specific-sport | Not an actual SportsML element. |
event-record | A world, national, state, or school record. |
event-sponsor | A sponsor for an event. |
highlight | A textual highlight. |
home-location | A location. |
name | Name of a player, official, associate, team, etc. |
official | Also referred to as umpire or referre. |
official-metadata | Metadata about the official. |
official-metadata-for-specific-sport | Not an actual SportsML element. |
official-stats | Statistics about the official. |
official-stats-for-specific-sport | Not an actual SportsML element. |
officials | A set of officials. |
outcome-totals | A report on the number of wins, losses, etc., the team or player had during a particular time period. |
penalty-stats | Statistics that detail the number of each type of penalty. |
player | A competitor. |
player-metadata | Metadata that describes a player. |
player-metadata-for-specific-sport | Not an actual SportsML element. |
player-stats | Statistics that capture how a player has performed. |
player-stats-for-specific-sport | Not an actual SportsML element. |
prize | TBD. |
rank | How a team is doing in comparison to other teams or players. |
schedule | A series of games. |
schedule-metadata | TBD. |
sports-content | Metadata and coverage of sporting news. |
sports-content-code | An individual code that describes an entity one may want to filter for. |
sports-content-codes | A container for content-codes. |
sports-content-qualifier | Further refinement/elaboration of a sports-content-code. |
sports-event | A sporting competition. |
sports-metadata | Metadata for the document being published. |
sports-title | A short textual description of the document. |
standing | A series of team or individual records. |
standing-metadata | A series of team or individual records. |
statistic | TBD. |
statistic-metadata | A series of team or individual records. |
sub-score | Statistics that detail the score for a particular period or inning. |
sub-score-attempts | Statistics that detail the scoring attempts for a particular period or inning. |
team | A team participating in a sporting event. |
team-metadata | Info about the team. Properties of a team that are not based on their competitive performance. |
team-metadata-for-specific-sport | Not an actual SportsML element. |
team-stats | Statistics that apply to the team as a whole. |
team-stats-for-specific-sport | Not an actual SportsML element. |
tournament | A structured series of competitions within one sport. |
tournament-division | A tournament subcategory, often with its own trophy and prize. |
tournament-division-for-specific-sport | Not an actual SportsML element. |
tournament-division-metadata | TBD. |
tournament-metadata | TBD. |
tournament-metadata-for-specific-sport | Not an actual SportsML element. |
tournament-round | Sub-component of tournament-division. |
A placeholder container. Can be used to group examples. Also can show how sports-content fits within NewsML.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | TBD. | |
ID (#IMPLIED ) |
Must appear as the root element.
A short textual message to editors receiving the document. Not generally published through to end-users.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Holds either an article or a reference to an article. Recommended format is NITF.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
article-ref | URL or system identifier (or IDREF?) to an externally-located news article. | |
CDATA (#IMPLIED ) | ||
class | An open placeholder for categorization. | |
CDATA (#IMPLIED ) | ||
format | Format for the included content. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
style | An open placeholder for reference by an external stylesheet. | |
CDATA (#IMPLIED ) |
Manager or coach or jockey, etc. An individual or a group that assists a team or player, and functions in a supporting capacity.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Metadata that describes an associate Generally does not change over the course of a sports-events.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
associate-key | The symbol for the associate. | |
CDATA (#IMPLIED ) | ||
associate-source | The maintainer of the controlled vocabulary for the key. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
position | A displayable name for the key. | |
CDATA (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as associate-metadata-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
Statistics that capture values about the participation of an associate during one or more sports-events. Generally does change over the course of a sports-event.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as associate-stats-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
TBD. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
award-name | Displayable name. For NHL Hockey, could be first-star, second-star, etc. | |
CDATA (#IMPLIED ) | ||
award-type | Type of award. Controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
class | An open placeholder for categorization. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
player-or-team-idref | Reference to the player or team that received the award. | |
IDREF (#IMPLIED ) | ||
style | An open placeholder for reference by an external stylesheet. | |
CDATA (#IMPLIED ) |
player-stats sports-event team-stats
A description of where a player is playing, or has previously played. Can be used to state where the player went to college. Can also list previous teams of the player.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
duration | In lieu of a start-date and end-date. Generally in years. Could hold the number of years that a player was a pro. | |
CDATA (#IMPLIED ) | ||
end-date | When the player started this phase in the career. Could hold a year of graduation. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
name | Name of the team or college, for example. | |
CDATA (#IMPLIED ) | ||
start-date | When the player started this phase in the career. | |
CDATA (#IMPLIED ) | ||
type | Value can be college or professional, etc. Controlled vocabulary. | |
CDATA (#IMPLIED ) |
event-actions. event-actions.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as event-actions-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
TBD. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
end-date-time | Time the game ends. | |
CDATA (#IMPLIED ) | ||
end-weekday | Day of the week in which the game ends. | |
['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'] (#IMPLIED ) | ||
event-key | The symbol for the identified sports-event. | |
CDATA (#IMPLIED ) | ||
event-name | A displayable name for the key. | |
CDATA (#IMPLIED ) | ||
event-number | TBD. | |
CDATA (#IMPLIED ) | ||
event-source | The maintainer of the controlled vocabulary for the key. | |
CDATA (#IMPLIED ) | ||
event-status | pre-event, mid-event, post-event. | |
['pre-event', 'mid-event', 'post-event'] (#IMPLIED ) | ||
event-style | Indicates whether competitors are trying to defeat each other - head-to-head - or just outdo one another - ranked. | |
['head-to-head', 'ranked'] (#IMPLIED ) | ||
heat-number | TBD. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
postponement-note | TBD. | |
CDATA (#IMPLIED ) | ||
postponement-status | TBD. | |
['none', 'weather-delay', 'other'] (#IMPLIED ) | ||
site-alignment | Whether the site is neutral with respect to the competitors, or is the often-used site of the home team. | |
['home', 'neutral'] (#IMPLIED ) | ||
site-attendance | How many spectators attended during the event. | |
CDATA (#IMPLIED ) | ||
site-capacity | How many spectators can fill the site. | |
CDATA (#IMPLIED ) | ||
site-city | City in which the site is located. | |
CDATA (#IMPLIED ) | ||
site-country | Country in which the site is located. Generally, a two-letter ISO code. | |
CDATA (#IMPLIED ) | ||
site-county | County in which the site is located. | |
CDATA (#IMPLIED ) | ||
site-key | The symbol for the site at which the event is played. | |
CDATA (#IMPLIED ) | ||
site-name | A displayable name for the key. | |
CDATA (#IMPLIED ) | ||
site-source | The maintainer of the controlled vocabulary for the key. | |
CDATA (#IMPLIED ) | ||
site-state | State or province in which the site is located. | |
CDATA (#IMPLIED ) | ||
site-style | Whether it is an indoor or outdoor site. Controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
site-surface | Describes the surface upon which events are played. For example, in tennis, could be hard-court or grass or clay. Controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
site-temperature | Temperature of the event recorded during the competition. | |
CDATA (#IMPLIED ) | ||
site-temperature-units | Units of the temperature value. | |
CDATA (#IMPLIED ) | ||
site-weather-label | Additional comment about the weather. | |
CDATA (#IMPLIED ) | ||
site-weather-wind | Wind reading of the event recorded during the competition. | |
CDATA (#IMPLIED ) | ||
start-date-time | Time the game starts. Generally in 20011116T152300 format. | |
CDATA (#IMPLIED ) | ||
start-weekday | Day of the week in which the game starts. | |
['sunday', 'monday', 'tuesday', 'wednesday', 'thursday', 'friday', 'saturday'] (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as event-metadata-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
previous-record | The score value of the previously-held record. | |
CDATA (#IMPLIED ) | ||
type | The type or record. | |
CDATA (#IMPLIED ) |
A sponsor for an event. Events can have more than one sponsor.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
name | The name of the sponsor. | |
CDATA (#IMPLIED ) | ||
type | Could be main, supporting, etc. | |
CDATA (#IMPLIED ) |
A textual highlight. Can hold plain text, or could hold NITF.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
class | An open placeholder for categorization. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
style | An open placeholder for reference by an external stylesheet. | |
CDATA (#IMPLIED ) |
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
city | The city. | |
CDATA (#IMPLIED ) | ||
country | The country. Generally, an ISO two-letter country-code. | |
CDATA (#IMPLIED ) | ||
county | The county. | |
CDATA (#IMPLIED ) | ||
state | The state or province. | |
CDATA (#IMPLIED ) |
associate-metadata official-metadata player-metadata team-metadata
Name of a player, official, associate, team, etc. Sometimes a person is referred-to by different names, depending upon the language in which the document is displayed.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
first | The first name refered to. | |
CDATA (#IMPLIED ) | ||
full | The entire name. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
language | A language code in which it is appropriate to display this name. | |
CDATA (#IMPLIED ) | ||
last | The first name referred to. | |
CDATA (#IMPLIED ) | ||
middle | The middle name refered to. | |
CDATA (#IMPLIED ) | ||
nickname | A nickname ascribed to the person or team. | |
CDATA (#IMPLIED ) |
associate-metadata official-metadata player-metadata team-metadata
Also referred to as umpire or referre. Ensures that the sports-event is played according to its rules.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Metadata about the official. Generally does not change over the course of a sports-events.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
official-key | TBD. | |
CDATA (#IMPLIED ) | ||
official-source | TBD. | |
CDATA (#IMPLIED ) | ||
position | TBD. | |
CDATA (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as official-metadata-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
Statistics about the official. Generally does change over the course of a sports-events..
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as official-stats-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
A set of officials. May hold zero or more.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
A report on the number of wins, losses, etc., the team or player had during a particular time period. Can also be scoped with various coverage qualifications, such as just events played at home.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
losses | Number of losses. | |
CDATA (#IMPLIED ) | ||
points-scored-against | The number of points scored against a team by its opponents during an extended time period. | |
CDATA (#IMPLIED ) | ||
points-scored-for | The number of points a team has scored against its opponents during an extended time period. | |
CDATA (#IMPLIED ) | ||
standing-points | A quantity used to rank teams, usually within a division, in order to decide who comes in first at the end of a season. Localized to the coverage-attributes. | |
CDATA (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) | ||
ties | Number of ties. | |
CDATA (#IMPLIED ) | ||
undecideds | Number of events that were started, but ended up undecided. | |
CDATA (#IMPLIED ) | ||
winning-percentage | The winning percentage. Generally, wins divided by total events completed. | |
CDATA (#IMPLIED ) | ||
wins | Number of wins. | |
CDATA (#IMPLIED ) |
Statistics that detail the number of each type of penalty. Can be recorded for either a team or a player.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
count | The number of that type of penalities for this team or player. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
type | Could be a numeric value like 2, 5 or 10 for ice hockey, or yellow-card or red-card for soccer etc. | |
CDATA (#IMPLIED ) |
A competitor. Their athletic talents help them decide who wins a sports-event.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
sports-event standing statistic team tournament-round
Metadata that describes a player. Generally does not change over the course of a sports-events.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
date-of-birth | The day on which a player was born. Generally in ISO format. | |
CDATA (#IMPLIED ) | ||
health | An indication of the health of the player. Values will probably be moved to a separate controlled vocabulary. | |
['injured', 'fine'] (#IMPLIED ) | ||
height | Height of the player. Generally in cm. | |
CDATA (#IMPLIED ) | ||
home-page-url | The fully-qualified URL for the official home page of the team. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
player-key | The symbol for the player. | |
CDATA (#IMPLIED ) | ||
player-source | The maintainer of the controlled vocabulary for the key. | |
CDATA (#IMPLIED ) | ||
position-event | The code for the position played by the player at this particular sports-event. Sport-specific controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
position-regular | The code for the typical position at which this player playes. Sport-specific controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
status | Whether a player starts playing at the beginning of a sports-event, joins mid-game, or is not available to participate. | |
['starter', 'bench', 'scratched'] (#IMPLIED ) | ||
team-idref | A reference to the team for which this player competes. | |
IDREF (#IMPLIED ) | ||
uniform-number | The number currently displayed on the uniform or jersey of the player. | |
CDATA (#IMPLIED ) | ||
weight | Weight of a player. Generally in kg. | |
CDATA (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as player-metadata-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
Statistics that capture how a player has performed. Generally does change over the course of a sports-event.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
event-odds | The odds that this team or player would win the event. | |
CDATA (#IMPLIED ) | ||
event-outcome | Whether the competitor won, lost, or tied. | |
['win', 'loss', 'tie', 'undecided'] (#IMPLIED ) | ||
event-points | How many new points were earned as a result of the outcome of this particular event. | |
CDATA (#IMPLIED ) | ||
event-rank | Rank of the team or player amidst its competitors. | |
CDATA (#IMPLIED ) | ||
event-score | Final or current score of the team or player. | |
CDATA (#IMPLIED ) | ||
event-score-attempts | Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal. | |
CDATA (#IMPLIED ) | ||
event-score-percentage | Percentage of attempted scores that reached their mark. | |
CDATA (#IMPLIED ) | ||
event-score-units | Describes how the score is valued. Controlled vocabulary: time-absolute, time-relative, below-par. | |
CDATA (#IMPLIED ) | ||
events-played | Number of sports-events the player has participated in. | |
CDATA (#IMPLIED ) | ||
events-started | Number of sports-events the player has played in since the start of the event. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
result-effect | Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division. Values kept in controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
time-played-event | Value for the amount of time played by this player in a particular sports-event. | |
CDATA (#IMPLIED ) | ||
time-played-total | Value for the amount of time played by the player over the course particular time-span, such as a season. | |
CDATA (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as player-stats-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
TBD. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
currency | The units of currency for the value attribute. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
place | The place for which this prize is offered. For example, place=1 means the first-place prize. | |
CDATA (#IMPLIED ) | ||
value | The amount of money earned by the player who came in this place. | |
CDATA (#IMPLIED ) |
How a team is doing in comparison to other teams or players. May be qualified, so that one ranks teams or players according to, say, how they play at home, or within their division.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) | ||
value | The value of the rank. | |
CDATA (#IMPLIED ) |
A series of games. A series of games.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
content-label | Displayable label that describes what events this schedule includes. | |
CDATA (#IMPLIED ) | ||
date-label | Displayable label that describes what dates this schedule covers. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
TBD. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) |
Metadata and coverage of sporting news. Good for scores, schedules, standings, statistics, etc.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
An individual code that describes an entity one may want to filter for. Describes what sports, leagues, teams, etc., are covered.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
code-key | The symbol for the identified content. | |
CDATA (#IMPLIED ) | ||
code-name | A displayable name for the code. | |
CDATA (#IMPLIED ) | ||
code-source | The maintainer of the controlled vocabulary for the code. | |
CDATA (#IMPLIED ) | ||
code-type | What type of item is being described. May be moved to an external controlled vocabulary. | |
['sport-class', 'sport-category', 'sport', 'sport-competition', 'league', 'conference', 'division', 'team', 'special-event', 'site'] (#REQUIRED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
sports-content-codes team-metadata
A container for content-codes. Can hold as many codes as needed to describe all contents at this level and below.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
event-metadata schedule-metadata sports-metadata standing-metadata statistic-metadata tournament-metadata
Further refinement/elaboration of a sports-content-code. If the document covers more than one of these, additional sports-content-qualifier elements may be used.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
age-group | If the events covered are limited to a specific age-range. (controlled vocabulary) | |
CDATA (#IMPLIED ) | ||
gender | One specific gender or mixed. (controlled vocabulary) | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
participant-count | Number of participants playing on a team or side in the events covered. (controlled vocabulary) | |
CDATA (#IMPLIED ) | ||
professional-status | The professional-status of the events covered. (controlled vocabulary) | |
CDATA (#IMPLIED ) | ||
special-group | If the events covered are for special groups. The samples listed here are school-oriented but it could be things like the firefighters world championships. (controlled vocabulary) | |
CDATA (#IMPLIED ) | ||
special-needs | Events for persons with special-needs. (controlled vocabulary) | |
CDATA (#IMPLIED ) |
sports-content-code tournament-division-metadata
A sporting competition. A contest that generally ends with a winner.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
schedule sports-content sports-event tournament-round
Metadata for the document being published. Holds metadata applying to the document as a whole.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
date-time | Date-timestamp for the document. Final format TBD. | |
CDATA (#IMPLIED ) | ||
doc-id | The often-unique ID of the document, tracked by publishers. Final format TBD. | |
CDATA (#REQUIRED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
feature-name | A publisher-created subset of the fixture-key. | |
CDATA (#IMPLIED ) | ||
fixture-key | A consistent key for the type of regularly-published document being transmitted. | |
CDATA (#IMPLIED ) | ||
fixture-name | A displayable name for the fixture-key. | |
CDATA (#IMPLIED ) | ||
fixture-source | The maintainer of the controlled-vocabulary of fixture-keys. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
language | The default language of the document. May be overridden via xml:lang. In ISO format - example: en-US. | |
CDATA (#IMPLIED ) | ||
publisher | Publisher of the data. | |
CDATA (#IMPLIED ) | ||
slug | A keyword used by editors to refer to the document. | |
CDATA (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) |
A short textual description of the document. Can show up in search results.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
A series of team or individual records. A series of team or individual records.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
content-label | TBD. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
A series of team or individual records. A series of team or individual records.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) |
TBD. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
content-label | Displayable label that describes what content this statistic covers. | |
CDATA (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) | ||
type | The type of statistic. | |
CDATA (#IMPLIED ) |
A series of team or individual records. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment-scope | Indicates that the included statistics apply only to events played either at home or away. | |
['events-home', 'events-away'] (#IMPLIED ) | ||
competition-scope | Indicates that the included statistics apply only to events against particular groups of opponents, such as those in the same division. | |
['division', 'division-opposing', 'conference', 'conference-opposing', 'league', 'top-25'] (#IMPLIED ) | ||
date-coverage-type | Describes what time period the statistics describe. Examples: just this week, this event, or this playoff season. | |
['period', 'event', 'tournament', 'tournament-pool', 'tournament-seed', 'recent-ten-events', 'hourly', 'daily', 'weekly', 'monthly', 'season-exhibition', 'season-regular', 'season-playoffs', 'season-full'] (#IMPLIED ) | ||
date-coverage-value | Value that further describes the dates covered. Example: if type is season, value can be 2001-2002. | |
CDATA (#IMPLIED ) | ||
duration-scope | Indicates what class of events the included statistics apply. Example: those events that went into overtime. | |
['events-overtime', 'events-shootout', 'events-most-recent-10'] (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
stats-coverage | A relative indication of how many statistics are included in the item. | |
['compact', 'standard', 'expanded'] (#IMPLIED ) | ||
team-coverage | Indicates whether the item contains information about one team, or many teams. | |
['single-team', 'multi-team'] (#IMPLIED ) |
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
period-value | Could be quarter-1, period-2, inning-5, etc. | |
CDATA (#IMPLIED ) | ||
score | The score for that period. | |
CDATA (#IMPLIED ) |
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
period-value | Could be quarter-1, period-2, inning-5, etc. | |
CDATA (#IMPLIED ) | ||
score-attempts | The score for that period. | |
CDATA (#IMPLIED ) |
A team participating in a sporting event. Holds code and names for team.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
sports-event standing statistic tournament-round
Info about the team. Properties of a team that are not based on their competitive performance. An included sports-content-code element can hold what division it is in, etc.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
alignment | Home or visiting. | |
['home', 'away', 'none'] (#IMPLIED ) | ||
home-page-url | The fully-qualified URL for the official home page of the team. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
team-idref | Optional reference to a team in which this team is a member. Example: The U.S. Davis Cup team consists of many sub-teams. | |
IDREF (#IMPLIED ) | ||
team-key | A unique identifier for the team. | |
CDATA (#IMPLIED ) | ||
team-source | The maintainer of the controlled vocabulary for the team-key. | |
CDATA (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as team-metadata-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
Statistics that apply to the team as a whole. Not all stats are used in every sport.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
event-odds | The odds that this team or player would win the event. | |
CDATA (#IMPLIED ) | ||
event-outcome | Whether the competitor won, lost, or tied. | |
['win', 'loss', 'tie', 'undecided'] (#IMPLIED ) | ||
event-points | How many new points were earned as a result of the outcome of this particular event. | |
CDATA (#IMPLIED ) | ||
event-rank | Rank of the team or player amidst its competitors. | |
CDATA (#IMPLIED ) | ||
event-score | Final or current score of the team or player. | |
CDATA (#IMPLIED ) | ||
event-score-attempts | Final or current number of attempts to score by a team or player. Example: in ice hockey, would represent total shots on goal. | |
CDATA (#IMPLIED ) | ||
event-score-percentage | Percentage of attempted scores that reached their mark. | |
CDATA (#IMPLIED ) | ||
event-score-units | Describes how the score is valued. Controlled vocabulary: time-absolute, time-relative, below-par. | |
CDATA (#IMPLIED ) | ||
events-played | The number of sports-events in which this team has already participated. | |
CDATA (#IMPLIED ) | ||
games-back | A number used to measure how behind one team is from first place. The first place team is 0 games back. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) | ||
result-effect | Describes the effect that the result of the event or rank changing has had on the team. Example: Whether or not a team has qualified for the playoffs, or has been promoted or demoted to a different division. Values kept in controlled vocabulary. | |
CDATA (#IMPLIED ) | ||
standing-points | A quantity used to rank teams, usually within a division, in order to decide who comes in first at the end of a season. | |
CDATA (#IMPLIED ) | ||
streak | A value used to say how many events in a row the team has most recently won or lost. Format is win-3 or loss-4 or tie-1. | |
CDATA (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as team-stats-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
A structured series of competitions within one sport. Generally organized by a particular sponsoring body. Can happen all in one day, or be spread out - like the Davis Cup in tennis.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
A tournament subcategory, often with its own trophy and prize. Like Mens 30k Nordic Skiing, Womens Doubles.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |
Not an actual SportsML element. This is where a plug-in element, such as tournament-division-ice-hockey, would fit in.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
id | The XML ID. | |
ID (#IMPLIED ) |
TBD. TBD.
Name | Description | |
---|---|---|
Type (Declaration) | Default | |
division-key | TBD. | |
CDATA (#IMPLIED ) | ||
division-name | TBD. | |
CDATA (#IMPLIED ) | ||
division-source | TBD. | |
CDATA (#IMPLIED ) | ||
end-date-time | TBD. | |
CDATA (#IMPLIED ) | ||
id | An XML-specific identifier for the element. | |
ID (#IMPLIED ) |