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:

NameProperty TypeType of ChangeDescription
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.

NameProperty TypeType of ChangeDescription
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.