Skip to contents

Game-center bundle of one match as one row: game data, team stats, goal and penalty lists.

Wraps GET https://s3.eu-west-1.amazonaws.com/icehl.hokejovyzapis.cz/widget/esports/match/{match_id}.json of the ICE Hockey League eSports bucket. Example: https://s3.eu-west-1.amazonaws.com/icehl.hokejovyzapis.cz/widget/esports/match/8161.json. Seasons are END years (2027 = 2026/27); every request waits at least one second after the last one to the same host.

Usage

icehl_game_center(match_id, return_parsed = TRUE)

Arguments

match_id

Match id (per-bucket match key space: match_id in icehl_schedule). Not the league website's game id.

return_parsed

Parse the payload into a tibble (default TRUE); FALSE returns the raw decoded JSON body (a nested list).

Value

A tibble::tibble() with one row per row of the file (zero rows, carrying the documented columns, for an empty frame); the raw JSON list when return_parsed = FALSE. Columns:

col_nametypedescription
status_idintegerWidget API status code, a code and not a joinable id: 1 = OK.
status_msgcharacterWidget API status text, Ok.
data_game_data_idintegerMatch id (match key space, per bucket); joins to league-matches matches[].id and the {match_id} path param.
data_game_data_division_idintegerLeague part id under the widget's name divisionId (league-part key space, per bucket: one stage of a competition, e.g. ICEHL 56 = 2026/27 regular season); joins to league_part_id in league-matches and the {league_part_id} path param.
data_game_data_division_longnamecharacterLeague part name, e.g. ICEHL 2026/27.
data_game_data_division_shortnamecharacterLeague part name, e.g. ICEHL 2026/27.
data_game_data_scheduled_date_formatted_shortcharacterShort display text DD.MM.YY (plus HH:MM for times).
data_game_data_scheduled_date_formatted_longcharacterLong display text, e.g. 18.September. 2026.
data_game_data_scheduled_date_timestampnumericEpoch milliseconds.
data_game_data_scheduled_date_valuecharacterISO text YYYY-MM-DD (plus HH:MM for times).
data_game_data_scheduled_date_diff_to_nowintegerDifference to now as computed by the widget server; 0 in the samples.
data_game_data_scheduled_timecharacterLocal time HH:MM (scheduled face-off, actual start, actual end).
data_game_data_start_timecharacterLocal time HH:MM (scheduled face-off, actual start, actual end).
data_game_data_end_timecharacterLocal time HH:MM (scheduled face-off, actual start, actual end).
data_game_data_is_overtimeintegerOvertime flag sent as an integer, 1 = yes.
data_game_data_is_shoot_outintegerShootout flag sent as an integer, 1 = yes.
data_game_data_home_team_idintegerTeam id (team key space, per bucket, stable across seasons); joins to league-matches home.id / guest.id and the {team_id} path param.
data_game_data_home_team_longnamecharacterTeam name: long, short (three-letter code) or display ('flavour') form.
data_game_data_home_team_shortnamecharacterTeam name: long, short (three-letter code) or display ('flavour') form.
data_game_data_home_team_flavournamecharacterTeam name: long, short (three-letter code) or display ('flavour') form.
data_game_data_home_team_scoreintegerFinal goals of the home or away team (by name).
data_game_data_away_team_idintegerTeam id (team key space, per bucket, stable across seasons); joins to league-matches home.id / guest.id and the {team_id} path param.
data_game_data_away_team_longnamecharacterTeam name: long, short (three-letter code) or display ('flavour') form.
data_game_data_away_team_shortnamecharacterTeam name: long, short (three-letter code) or display ('flavour') form.
data_game_data_away_team_flavournamecharacterTeam name: long, short (three-letter code) or display ('flavour') form.
data_game_data_away_team_scoreintegerFinal goals of the home or away team (by name).
data_game_data_game_statusintegerGame status code; 4 = finished in the samples (other codes unverified).
data_game_data_game_extended_statusintegerExtended status code; 0 in the samples.
data_game_data_game_extended_status_info_textcharacterExtended status text; empty string in the samples.
data_game_data_game_namecharacterGame number sent as a string (e.g. "66").
data_game_data_game_daycharacterMatchday number sent as a string ("1"); null in Denmark.
data_game_data_game_roundintegerRound number; 0 in the samples.
data_game_data_location_longnamecharacterArena name; empty string when not set.
data_game_data_location_shortnamecharacterArena name; empty string when not set.
data_game_data_location_coordinates_latintegerLatitude / longitude; 0 placeholder in the samples.
data_game_data_location_coordinates_lngintegerLatitude / longitude; 0 placeholder in the samples.
data_game_data_attendanceintegerSpectators at the game (attendance).
data_game_data_live_timeintegerGame clock, seconds of game time from the opening face-off (0-3600 in regulation, continuing through overtime). 3600 at the end of regulation.
data_game_data_live_time_formattedcharacterClock text; the placeholder END-GAME after the game, m:ss while live.
data_game_data_live_time_periodintegerCurrent period number; 4 after the game.
data_game_data_live_time_stringcharacterClock text; the placeholder END-GAME after the game, m:ss while live.
data_game_data_live_time_game_phasecharacterGame phase text, e.g. END OF GAME.
data_game_data_period_statscharacterPer-period score and shots.
data_game_data_game_officials_ref1_lastnamecharacterLast name of that official or coach.
data_game_data_game_officials_ref1_firstnamecharacterFirst name of that official or coach.
data_game_data_game_officials_ref2_lastnamecharacterLast name of that official or coach.
data_game_data_game_officials_ref2_firstnamecharacterFirst name of that official or coach.
data_game_data_game_officials_linesman1_lastnamecharacterLast name of that official or coach.
data_game_data_game_officials_linesman1_firstnamecharacterFirst name of that official or coach.
data_game_data_game_officials_linesman2_lastnamecharacterLast name of that official or coach.
data_game_data_game_officials_linesman2_firstnamecharacterFirst name of that official or coach.
data_game_data_team_officials_headcoachhome_lastnamecharacterLast name of that official or coach.
data_game_data_team_officials_headcoachhome_firstnamecharacterFirst name of that official or coach.
data_game_data_team_officials_headcoachaway_lastnamecharacterLast name of that official or coach.
data_game_data_team_officials_headcoachaway_firstnamecharacterFirst name of that official or coach.
data_game_data_live_time_period_barcharacterPeriod progress bar; null in the samples, so unobserved.
data_game_data_you_tube_linkcharacterVideo link; null in the samples, so unobserved.
data_game_data_number_of_periodsintegerRegulation periods (3) or the maximum overtimes allowed.
data_game_data_length_of_periodintegerLength of a period or overtime, seconds (1200).
data_game_data_number_of_overtimesintegerRegulation periods (3) or the maximum overtimes allowed.
data_game_data_length_of_overtimeintegerLength of a period or overtime, seconds (1200).
data_game_data_shootout_shotsintegerShootout attempts in the game.
data_game_data_images_home_team_logocharacterTeam logo; null in the samples, so unobserved.
data_game_data_images_away_team_logocharacterTeam logo; null in the samples, so unobserved.
data_game_data_streamscharacterVideo streams; empty array in the samples.
data_game_data_home_team_logo_urlcharacterTeam logo URL; null in the samples, so unobserved.
data_game_data_away_team_logo_urlcharacterTeam logo URL; null in the samples, so unobserved.
data_home_goalscharacterGoals scored by that team.
data_home_penaltiescharacterPenalties of that team.
data_home_field_playerscharacterSkaters of that team with their game stats.
data_home_goal_keeperscharacterGoalies of that team with their game stats.
data_home_team_stats_faceoffs_wonintegerFace-offs the team won in this game.
data_home_team_stats_faceoffs_totalintegerFace-offs the team took in this game.
data_home_team_stats_shots_on_goalintegerTeam shots that reached the goalie in this game.
data_home_team_stats_shots_blockedintegerTeam blocked-shot count in this game (direction unverified).
data_home_team_stats_penalty_minutesintegerPenalty minutes assessed to the team in this game.
data_home_team_stats_powerplay_goalsintegerGoals the team scored on the power play in this game.
data_home_team_stats_powerplay_opportunitiesintegerPower plays the team had in this game.
data_home_team_stats_penaltykill_successesintegerPenalties killed without conceding.
data_home_team_stats_penaltykill_situationsintegerTimes the team had to kill a penalty in this game.
data_home_team_stats_time_values_leadingintegerSeconds spent leading, tied or trailing (by name).
data_home_team_stats_time_values_tiedintegerSeconds spent leading, tied or trailing (by name).
data_home_team_stats_time_values_trailingintegerSeconds spent leading, tied or trailing (by name).
data_home_team_stats_time_values_time_game_strength_evenintegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_home_team_stats_time_values_time_game_strength_plus_oneintegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_home_team_stats_time_values_time_game_strength_plus_twointegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_home_team_stats_time_values_time_game_strength_minus_oneintegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_home_team_stats_time_values_time_game_strength_minus_twointegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_home_team_stats_time_values_time_on_powerplayintegerSeconds on the power play.
data_home_team_stats_time_values_time_while_shorthandedintegerSeconds the team played shorthanded in this game.
data_away_goalscharacterGoals scored by that team.
data_away_penaltiescharacterPenalties of that team.
data_away_field_playerscharacterSkaters of that team with their game stats.
data_away_goal_keeperscharacterGoalies of that team with their game stats.
data_away_team_stats_faceoffs_wonintegerFace-offs the team won in this game.
data_away_team_stats_faceoffs_totalintegerFace-offs the team took in this game.
data_away_team_stats_shots_on_goalintegerTeam shots that reached the goalie in this game.
data_away_team_stats_shots_blockedintegerTeam blocked-shot count in this game (direction unverified).
data_away_team_stats_penalty_minutesintegerPenalty minutes assessed to the team in this game.
data_away_team_stats_powerplay_goalsintegerGoals the team scored on the power play in this game.
data_away_team_stats_powerplay_opportunitiesintegerPower plays the team had in this game.
data_away_team_stats_penaltykill_successesintegerPenalties killed without conceding.
data_away_team_stats_penaltykill_situationsintegerTimes the team had to kill a penalty in this game.
data_away_team_stats_time_values_leadingintegerSeconds spent leading, tied or trailing (by name).
data_away_team_stats_time_values_tiedintegerSeconds spent leading, tied or trailing (by name).
data_away_team_stats_time_values_trailingintegerSeconds spent leading, tied or trailing (by name).
data_away_team_stats_time_values_time_game_strength_evenintegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_away_team_stats_time_values_time_game_strength_plus_oneintegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_away_team_stats_time_values_time_game_strength_plus_twointegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_away_team_stats_time_values_time_game_strength_minus_oneintegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_away_team_stats_time_values_time_game_strength_minus_twointegerSeconds at that skater difference (even, +1, +2, -1, -2).
data_away_team_stats_time_values_time_on_powerplayintegerSeconds on the power play.
data_away_team_stats_time_values_time_while_shorthandedintegerSeconds the team played shorthanded in this game.
data_home_goal_keeper_changescharacterGoalie on/off events of that team.
data_away_goal_keeper_changescharacterGoalie on/off events of that team.
data_game_actionscharacterEmpty array in both samples; item shape unobserved.
data_faceoffs_head_to_headcharacterEmpty array in both samples; item shape unobserved.
data_faceoffs_individualcharacterEmpty array in both samples; item shape unobserved.
data_game_situationscharacterEmpty array in both samples; item shape unobserved.
data_shootoutscharacterEmpty array in both samples; item shape unobserved.
calc_timeintegerServer computation time; 0 in the samples.
last_update_formatted_shortcharacterShort display text DD.MM.YY (plus HH:MM for times).
last_update_formatted_longcharacterLong display text, e.g. 18.September. 2026.
last_update_timestampnumericEpoch milliseconds.
last_update_valuecharacterISO text YYYY-MM-DD (plus HH:MM for times).
served_by_servercharacterHost that built the bundle, e.g. icehl.hokejovyzapis.cz.

Errors

Signalled as classed conditions: fastRhockey_no_data when the bucket has no such key (S3 404 NoSuchKey: unknown season, competition, match or team) or the file holds no rows (an unplayed game, an empty shot shell); fastRhockey_asset_fetch for any other non-2xx answer (403 AccessDenied), a connection failure after retries, an empty or unreadable 200 body, an error envelope, a body of the wrong shape, or a body for another season or game; fastRhockey_bad_request for an HTTP 400/422 or an invalid argument. All three also inherit fastRhockey_error. Wrappers raise; they never warn and return an empty frame.

Examples

# \donttest{
  try(icehl_game_center(match_id = 8161))
#> ── ICE Hockey League game_center from the eSports hokejovyzapis bucket ─────────
#> ℹ Data updated: 2026-10-13 01:54:22 UTC
#> # A tibble: 1 × 126
#>   status_id status_msg data_game_data_id data_game_data_division_id
#>       <int> <chr>                  <int>                      <int>
#> 1         1 Ok                      8161                         56
#> # ℹ 122 more variables: data_game_data_division_longname <chr>,
#> #   data_game_data_division_shortname <chr>,
#> #   data_game_data_scheduled_date_formatted_short <chr>,
#> #   data_game_data_scheduled_date_formatted_long <chr>,
#> #   data_game_data_scheduled_date_timestamp <dbl>,
#> #   data_game_data_scheduled_date_value <chr>,
#> #   data_game_data_scheduled_date_diff_to_now <int>, …
# }