Illustration of event 1771 positions Image Modified Sport specific XML elements and attributesThis section explains what elements / attributes one can expect for ice hockey matches in addition to the standard elements and attributes, and what the meaning of those elements and attributes is. Attributes in the <match> element Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <match betstatus="BETSTOP" connectionstatus="0" dc="1" device="3" extrainfo="0" feedtype="full" matchid="10115268" matchtime="00:00"
start="1464790020000" t1id="5577563" t1name="VSV II" t2id="5273264" t2name="EV AICALL ZELTWEG" timerunning="0">
...
</match> |
XML elements and attributes definition Element | Attributes |
---|
| Attribute | Description | Possible values | Match | extrainfo | Integer specifying special information for the match. | Integer. Possible values: - 0 = Default
- 12 = 10 minutes overtime length
- 13 = 20 minutes overtime length
- 32 = 7 minutes overtime length
- 33 = No overtime
- 56 = 3x10 min periods, 3vs3 or 4vs4 players, half-sized ice rink, penalty shots instead of suspensions)
- 65 = 3 x 4 minutes
- 67 = 3 x 3 minutes
| timerunning | Whether the time is running. | Integer. - 1 = Time is running
- 0 = Time is not running
|
Elements in the <match> element Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <match betstatus="BETSTOP" connectionstatus="0" dc="1" device="3" extrainfo="0" feedtype="full" matchid="10115268" matchtime="00:00"
start="1464790020000" t1id="5577563" t1name="VSV II" t2id="5273264" t2name="EV AICALL ZELTWEG" timerunning="0">
<status id="90" name="ABANDONED" start="1464790489666"/>
<score t1="0" t2="0" type="current"/>
<suspensions t1="1" t2="0"/>
<possession team="home"/>
<iceconditions id="0" name="UNKNOWN"/>
<openingfaceoff1stperiod team="home"/>
<openingfaceoff2ndperiod team="away"/>
<openingfaceoff3rdperiod team="home"/>
<openingfaceoffovertime team="away"/>
<tournament id="4037" name="Oberliga"/>
<category id="65" name="Austria"/>
<sport id="4" name="Ice Hockey"/>
<events/>
</match> |
XML elements and attributes definition Element | Attributes |
---|
| Attribute | Description | Possible values | score | Multiple occurrences possible, each occurrence describes the amount of points for the specified period in the match. This element always gets included in full feed, and in the delta feed for the following events: Score change (30) | t1 | Amount of points home team. | Integer | t2 | Amount of points away team. | Integer | type | For what period in the match the points were scored. | String. Possible values: - current
- period1
- period2
- period3
- overtime
- penalties
| suspensions | This element always gets included in full feed, and in the delta feed for the following events: Suspension (43), Suspension over (1049) | t1 | Amount of suspensions home team. | Integer | t2 | Amount of suspensions away team. | Integer | possession | This element always gets included in full feed (DC matches only), and in the delta feed (DC matches only) for the following events: Possession (110) | team | Which team has possession. | String. Possible values: | iceconditions | This element always gets included in full feed, and in the delta feed for the following events: Ice conditions (1769) | id | Identifier for the surface types. | Integer | name | Textual representation of the surface types. Note that this elements needs to be enabled in the XML configuration section. | String. Possible combinations of id name are: - 0 = Unknown
- 1 = Good
- 2 = Medium
- 3 = Poor
| openingfaceoff1stperiod | This element always gets included in full feed, and in the delta feed for the following events: Faceoff (1771) | team | Which team opened in the first faceoff. Note that this elements needs to be enabled in the XML configuration section. | Integer. Possible values: - 0 = Unknown
- 1 = Home
- 2 = Away
| openingfaceoff2ndperiod | This element always gets included in full feed, and in the delta feed for the following events: Faceoff (1771) | team | Which team opened in the second faceoff. Note that this elements needs to be enabled in the XML configuration section. | Integer. Possible values: - 0 = Unknown
- 1 = Home
- 2 = Away
| openingfaceoff3rdperiod | This element always gets included in full feed, and in the delta feed for the following events: Faceoff (1771) | team | Which team opened in the third faceoff. Note that this elements needs to be enabled in the XML configuration section. | Integer. Possible values: - 0 = Unknown
- 1 = Home
- 2 = Away
| openingfaceoffovertime | This element always gets included in full feed, and in the delta feed for the following events: Faceoff (1771) | team | Which team opened in the OT faceoff. Note that this elements needs to be enabled in the XML configuration section. | Integer. Possible values: - 0 = Unknown
- 1 = Home
- 2 = Away
|
Attributes in the <event> element Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <!-- Example 1 -->
<match matchid="9548197" ... >
<events>
<event extrainfo="7" id="649201877" info="Goal [T2] (even strength)" matchscore="2:3" mtime="14:45" periodnumber="1"
remainingtimeperiod="05:15" side="away" stime="1465519931270" type="30"/>
</events>
</match>
<!-- Example 2 -->
<match matchid="9548197" ... >
<events>
<event id="649208863" info="Puck position" matchscore="2:3" mtime="20:45" periodnumber="2" posx="75" posy="40"
remainingtimeperiod="19:15" side="home" stime="1465521702900" type="1885"/>
</events>
</match>
<!-- Example 3 -->
<match matchid="9548197" ... >
<events>
<event extrainfo="2" extrainfoicehockey="-1" id="649241223" info="[T2] got a 2 minute minor penalty" matchscore="2:4" mtime="59:55"
periodnumber="3" remainingtimeperiod="00:05" side="away" stime="1465527618922" type="43"/>
</events>
</match> |
XML attributes definition Element | Attributes |
---|
| Attribute | Description | Possible values | event | extrainfo | Attribute containing additional information about the event. | Long | posx | Horizontal position on pitch, posx being a number from 0 to 100. The reference point 0 is at home teams goal. | Number | posy | Vertical position on pitch , posy being a number from 0 to 100. The reference point 0 is on top of pitch when home teams goal is on the left hand side. | Number | player1 | Sportradar player id for player 1 connected to this event. | Integer | player2 | Sportradar player id for player 2 connected to this event. | Integer | matchscore | Score for current match. | String. Format: "[home]:[away]" Example: "1:0" | remainingtimeperiod | Remaning time of the period. | String. Format: "MM:SS" | periodnumber | Number of current period in match. | Integer | extrainfoicehockey | Attribute containing additional information about the event. | String |
XML configurationsThis section explains what XML configurations one can expect for this sport in addition to the standard XML configurations, and what the meaning of these configurations is. (ID: 6) Icehockey OT/Pen matchstatusesEnabling this setting will add the following possible match statuses for ice hockey matches: - AWAITING_OT
- AFTER_OT
- AWAITING_PENALTIES
- AFTER_PENALTIES
(ID: 44) Send lineups for ice hockey matches where this is availableIf this setting is enabled, the element <lineups> gets enabled for ice hockey matches which have this configured. Lineups are sent when subscribing to a match, and when the lineup changes. Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <lineups matchid="6856980">
<player id="215564" name="Crosby, Sidney" shirtnumber="5" substitute="false" team="1"/>
<player id="412234" name="Hull, Bobby" shirtnumber="7" substitute="false" team="0"/>
<!-- Remaining message truncated -->
</lineups> |
If this setting is enabled, an additional attribute extrainfoicehockey will be added to the <event> element for events which support this in ice hockey matches. The value of this attribute is explained in the event list. Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <event extrainfo="2" extrainfoicehockey="2" id="469535552" info="[T1] got a 2 minute minor penalty" matchscore="0:0" mtime="60:38"
periodnumber="4" player1="31502" remainingtimeperiod="04:22" side="home" stime="1447850531168" type="43"/> |
Enabling this setting will add child elements to the <match> element in ice hockey, describing the ice conditions and opening faceoff winning teams for each period. Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <match betstatus="BETSTOP" connectionstatus="1" dc="1" distance="0" extrainfo="0" feedtype="full" matchid="1103190023" matchtime="60:18"
start="1447854123000" t1id="1427444" t1name="SILUTE" t2id="1505358" t2name="VILKAI" timerunning="1">
<status id="40" name="OVERTIME" start="1447853377509"/>
<possession team="away"/>
<score t1="0" t2="0" type="current"/>
<suspensions t1="0" t2="0"/>
<iceconditions id="1" name="GOOD"/>
<openingfaceoff1stperiod team="1"/>
<openingfaceoff2ndperiod team="2"/>
<openingfaceoff3rdperiod team="1"/>
<openingfaceoffovertime team="2"/>
<tournament id="5" name="Eliteserien"/>
<category id="5" name="Norway"/>
<sport id="4" name="Ice Hockey"/>
<events>
<!-- events go here -->
</events>
</match> |
(ID: 20) Include goals scored during penalty shootout in the "current" score for ice hockeyIf activated the XML element score type="current" will include goals scored during penalty shootout for ice hockey. (ID: 63) Send periodx score types for ice hockeyThe attribute type in the <score> element (subelement from <match> element) has a set list of possible values. If this setting is enabled, the attribute type can have one of the following values, in addition to the regular values for ice hockey matches:
Code Block |
---|
<match matchid="7440630" ... >
<score t1="14" t2="20" type="period1"/>
<!-- Remaining message truncated -->
</match> |
(ID: 77) Enable puck spotting ice hockeyEnabling this setting will include the puck position event (1885) in ice hockey matches.
(ID: 134) Include early betstatus in ice hockeyRight before one of the teams scores a goal, the match status will be set to betstop. Normally, the match will be on betstop until the match continues, which is after the next kick off. As bookmakers have different requirements in terms of reoffering markets after goals, Betradar allows you to enable early betstart. If you have this setting enabled, information related to early betstart will be sent in addition to the normal betstart information. The behaviour of early betstart is quite similar to the normal betstart, but instead of waiting until the next kick off, early betstart already starts right after the goal was confirmed. If the match is in either betstart or early betstart, the match can be treated as betstart. It is up to the bookmaker to decide whether to receive the new prices right after the score change or after the match continues. Image Modified (ID: 129) Include play resumes after goal in ice hockeyEnabling this setting will allow event 1064 (play resumes after goal) to be sent. (ID: 87) Include players 3 and 4Enabling this setting will include player3 and player4 attribute for events which have this available. A list of events currently supporting this can be found below. Please keep in mind that this list might expand, the client software should be able to handle that additional events might be added. Code Block |
---|
language | xml |
---|
title | XML example |
---|
| <match matchid="10115268" ... >
...
<events>
<event extrainfo="0" id="15984095" info="Goal [T1] -B.Maxwell" matchscore="2:0" mtime="00:54" periodnumber="1" player1="42390"
player2="29525" player3="30509" side="home" stime="1474041000979" type="30"/>
</events>
</match> |
|