SportsML 2.2 Highlights
The most important changes in this new version of Sportsml are 1) Documentation improvments 2) Additions to the core schema 3) Enhancements to the soccer plugin and 4) Adjustments to the tournament model.
This page will guide you through the core and soccer additions and the more important additions to the tournament elements. The tournament model is documented in this general overview of the tournament model. There is also a complete listing of all changes and additions in SportsML 2.2.
Core Highlights
The core schema in SportsML is for properties that apply to many (or all) sports. Here are the highlights:
| Name | Property Type | Type of Change | Description |
|---|---|---|---|
| event-outcome-type | attribute | addition |
Tells you how the game ended, whether in regular time, overtime or other. Limited to the following vocabulary items: regular, overtime, shootout, extra-time, random, authority-decision. This attribute is in the general statAttributes group and would most likely be used in the team-stats or player-stats elements. |
| sports-event | element | change |
Team and player elements are now optional as children of <sports-event>. This is an important change which allows you to code events where the participants are not yet determined, such as in a playoff round. |
| player-metadata | element | change |
Multiple home-location elements allowed as children. This means you can indicate a player's place of birth, and the place being represented. This is important for Olympics athletes who may be representing a country other than the one in which they were born. |
| tournament-status, division-status, stage-status | attributes | additions |
These tournament status elements join "round-status" as attributes describing the status of various levels and divisions of a tournament structure. They mark status of the whole tournament, a tournament division or a tournament stage. |
| tournament-division-metadata, tournament-stage-metadata, tournament-round-metadata | elements | change |
<sports-content-codes> elements are now allowed as children of these element. This is important to indicate what sport or discipline is being played in a multi-sport tournament like the Olympics. |
| locationType | vocabulary | additions |
The following vocabulary items were added: representative, start-location, stage-location, end-location, training-location. "representative" is for the location being represented. "start-location" and "end-location" are for events that move location, like a stage of a cycling tournament. "stage-location" is for tournaments that host stages at different locations, such as the Alpine World Cup season. |
| bodySide | vocabulary | addition |
A vocabulary to express player handedness, injury side, batting side, etc. Allowed values are left, right and both. |
| tournamentStageType | vocabulary | additions |
The following vocabulary items were added: qualification and hosted. "qualification" indicates that the purpose of the tournament phase is to determine the qualifiers for a later stage. Use "hosted" to indicate a stage in a tournament that occurs at multiple locations in the course of a season, such as the Alpine World Cup. |
Soccer Highlights
The soccer schema in SportsML now features the properties list below. Here is a soccer sample file which contains some of these new features.
| Name | Property Type | Type of Change | Description |
|---|---|---|---|
| action-soccer-play | element | addition |
This is a generic replacement for the following now-deprecated elements: action-soccer-score-attempt, action-soccer-offside, action-soccer-foul, action-soccer-timeout. Instead, the type of play will be indicated by the "play-type" attribute. The following vocabulary items are allowed for play type: shot, offside, foul, corner, throw-in, pass, penalty, timeout, cross. |
| action-soccer-play-participant | element | addition |
This is a generic replacement for the following now-deprecated action-soccer-assisting-player element. Multiple roles (not just assists) will be indicated by the "role" attribute. The following roles are covered: on-field, scorer, assist, shooter, blocker, penalty-committed-by, penalty-committed-against, giveaway, takeaway, thrower, corner-kicker, offside, free-kicker, penalty-kicker, goalkeeper. |
| line-formation | attribute | addition |
Represents the formation of the team on the field starting from the back of the field. This can be written as 4-4-2 where the hyphens separates the lines on the field from the defense at left to the forwards to the right. |
| line-formation-position | attribute | addition |
Indicates line-position player had at the start of the game or when the player entered the game. |
| penaltyResult | vocabulary | addition |
The result of a penalty. Values are: indirect-freekick, direct-freekick, penalty-shot, free-kick, play-on. |
| playType | vocabulary | change |
Additional values are: shot, offside, foul, corner, throw-in, pass, penalty, timeout, cross. |
| participantRole | vocabulary | addition |
Used to indicate role in action-soccer-play-participant element. Values are: on-field, scorer, assist, shooter, blocker, penalty-committed-by, penalty-committed-against, giveaway, takeaway, thrower, corner-kicker, offside, free-kicker, penalty-kicker, goalkeeper. |
| scoreAttemptMethod | vocabulary | change |
Additional values are: lob, chip, foot, chest, knee, thigh, back. The values "right-foot" and "left-foot" are deprecated in favour of bodySide (see core addition above) plus "foot" |
| penaltyType | vocabulary | change |
Additional values are: serious-foul-play, violent-conduct, spitting, offensive-language, offensive-gestures, professional-foul, unsporting-behaviour, delaying-restart, illegal-reentry, illegal-entry, required-distance-foul, illegal-exit, hand-ball, tackle. |