按球场 ID 查询板球球场详情,返回球场名称、城市、国家、时区、主队、容量与图片信息
查看 板球数据 API:实时比分、记分卡与球员统计 的全部接口 →返回某一座板球球场的基本资料。唯一必填的路径参数是 venueId,即数字类型的球场 ID,取自系列赛球场接口返回的 id 字段,默认示例值为 45。根据源响应示例,返回内容是一个扁平的 JSON 对象,包含 ground、city、country、timezone、homeTeam、ends、capacity、imageId 和 imageUrl。示例中的 capacity 是带千位分隔符的字符串(如 11,600),imageId 是字符串,ends 用一个以逗号分隔的字符串列出球场两端的名称,timezone 则是 +13:00 这样的 UTC 偏移字符串。本接口没有记录过实时探测,上述字段均来自未经验证的源示例,请把每个字段都当作可选字段处理,不同球场的取值也会有差异。示例中没有坐标、球场状况报告或票务字段。
API 功能
在线 API 演示
未找到可用的 API Key,请前往控制台创建后刷新本页。 控制台 →
/api/project/cricbuzz-cricket/venues-get-info API 响应 (JSON)
{} curl -X GET 'https://api.opendata-api.com/api/project/cricbuzz-cricket/venues-get-info?key=<API_KEY>&venueId=45'
查询结果
使用场景
- 在系列赛球场列表或比赛页面中选中某个球场后,用它的 id 调用本接口,打开球场详情页。
- 为赛前预览的球场介绍部分填充球场名称、城市、国家、主队和球场两端名称。
- 在赛程组件中套用返回的时区偏移,把预定开赛时间换算成球场当地时间。
- 为以 venueId 为键的内部球场表补充容量和图片引用,缺失的值则以 null 保存。
- 把球场资料与该球场的赛程和统计接口结合,为编辑团队搭建一个统一的球场专题页。
常见问题
venues-get-info 接口会返回什么内容?
返回 venueId 所指的单个球场的详情。源示例显示这是一个扁平对象,包含 ground、city、country、timezone、homeTeam、ends、capacity、imageId 和 imageUrl。
有效的 venueId 从哪里获取?
使用系列赛球场接口返回的球场 id 字段。预填的 45 只是取自源文档的默认示例值。
这个响应是否经过实时调用验证?
没有。该操作没有记录过探测调用,字段列表来自源响应示例,在依赖任何字段之前,请先用你自己的 venueId 发起真实请求加以核对。
capacity 和 ends 一定会返回吗?
不要这样假设。示例中的 capacity 是格式化字符串(11,600),ends 是一个以逗号分隔的字符串,但其他球场可能缺少这些字段,或者格式不同。请做好防御式解析,把两者都当作可选字段。
响应里有坐标或票务信息吗?
源示例中既没有坐标,也没有票务或球场状况报告字段,因此不要规划依赖这些数据的功能。请使用示例中已有的字段:ground、city、country、timezone、homeTeam、ends、capacity 以及图片引用。
怎样查询这个球场上进行的比赛?
本接口只描述球场本身。要查看预定赛程,请用相同的 venueId 调用球场赛程接口;要查看球场纪录,请使用球场统计接口。