按 venueId 查询某个板球场的历史统计:比赛场次、先击球与先投球获胜数、平均得分以及最高和最低总分,以键值对形式返回
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回某一个板球场的历史统计摘要。venueId 通过 URL 路径传入(必填数字,默认值 24 是文档中的示例值),该 ID 来自本产品「系列赛场馆」接口返回的 id 字段。根据源 200 示例,响应是一个对象,其中 venueStats 数组由键和值均为字符串的对象组成,共八项:Total Matches(48)、Matches won batting first(7)、Matches won bowling first(19)、Avg. scores recorded(多行字符串,1st inns-310、2nd inns-337、3rd inns-261、4th inns-159,以换行符分隔)、Highest total recorded(765/6(248.5) by PAK vs SL)、Lowest total recorded(80/10(53.1) by AUS vs PAK)、Highest score chased(315/9(106.1) by PAK vs AUS)和 Lowest score defended(149/10(47.1) by SL vs PAK)。所有取值都是文本,包括场次和比分;示例中的总场次与各结果场次不保证相加一致,因此在没有核实之前不要据此推算百分比。现有依据没有说明示例对应哪个球场、统计了哪些赛制,也没有说明其他球场的条目列表会如何变化。本接口没有记录过实时探测,这里描述的所有响应字段均来自源示例,未经独立验证。这些都是历史数据,不是球场报告、天气信息或预测。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/venues-get-stats API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/venues-get-stats?key=<API_KEY>&venueId=24'
查询结果
使用场景
- 在所选板球场的信息页上增加一个场馆统计标签页,直接用键值对渲染出统计内容。
- 做一张赛前背景卡片,对比该球场先击球获胜与先投球获胜的次数,并明确标注为历史结果。
- 为一项赛事的全部场馆做对比表:遍历系列赛场馆接口返回的 ID,每个场馆请求一次即可。
- 在赛事前瞻稿中引用 Highest score chased 与 Lowest score defended,并在自己的代码里把文本拆分为比分、回合数和球队。
- 把解析后的场馆总分存入研究数据集,把平均得分字符串按换行符拆开,得到每一局的单独数值。
常见问题
场馆统计接口会返回什么内容?
根据源 200 示例,返回一个带 venueStats 数组的对象,每个条目都是包含 key 和 value 字符串的对象,例如 Total Matches、Matches won batting first 或 Highest total recorded。本接口没有记录过实时探测,这些字段尚未经过独立验证。
这个接口有哪些参数?
只有 venueId。它为必填,通过 URL 路径以数字传入,默认值为 24,即文档中的示例值。文档中没有查询参数或请求体参数。
venueId 从哪里获取?
使用本产品「系列赛场馆」接口返回的 id 字段,该接口会列出某个系列赛的所有球场。请把这个 ID 原样放入路径中。
平均得分这一项是什么格式?
在源示例中,它是一个包含四行的字符串:1st inns-310、2nd inns-337、3rd inns-261 和 4th inns-159,以换行符分隔。先按换行符拆分,再按连字符拆分,就能得到每一局的数值。
返回的值是数字还是文本?
是文本。像 48 这样的场次以及 765/6(248.5) by PAK vs SL 这样的总分都是字符串。请在自己的代码中解析数字,如果只用于展示,则保留原始文本。
可以用这些场次数据计算胜率百分比吗?
请谨慎。在示例中,先击球获胜与先投球获胜的场次相加并不等于 Total Matches,而且现有依据没有解释这个差异。除非你已经核实了剩余场次的含义,否则请按返回值原样展示场次。
这是球场报告或天气预报吗?
不是。这些条目都是球场的历史数据。接口不会返回场地状况、天气,也不会预测未来比赛的得分情况;如需针对具体比赛的球场备注,请使用本产品的场馆与球场研究类接口。
统计涵盖哪些赛制和年份?
现有依据没有说明。它只记录了一个有数据的 200 示例,没有场馆名称、赛制或日期范围,所以在发布数据之前,请针对你自己的场馆核实这些数字的统计口径。