板块与字段 / 导出范围

三块数据,先看清字段再取用

亚博线上主站的公开数据按三条主线分列:比赛层面的伤停与阵容变动、逐次主罚的点球序列、以及教练的执教阶段。 本页把每块收录到什么颗粒度、有哪些字段、能按什么范围取用写清楚,方便引用前先做一次判断。

分列起点
2019 赛季
累计场次
821
覆盖赛事
14
口径版本
手册第 7
几何切割的暗色数据面板抽象构图,荧光青与暖金高光沿切面排布
三块数据板块共用一套字段口径,导出范围以赛季、赛事与轮次为边界。

节奏说明

先确认颗粒度,再决定是否深入

三块板块的收录层级并不相同:赛事板块以场为单位,点球记录以单次主罚为单位,教练履历以执教阶段为单位。 同一场比赛在赛事板块只出现一次,却可能在点球记录里展开成若干条序列,在教练履历中对应两段阶段记录。 引用前先想清楚需要的是哪一种颗粒度,可以省去后续再回查口径的步骤。

三块内容

三个数据板块

板块 01

亚博线上赛事

场次级 · 覆盖 20192025 赛季

这块收录比赛前后的可核对信息:伤停条目、阵容变动类型与赛前前瞻的结论标签。 每场比赛在库中只有一条主记录,伤停与变动作为附属条目挂在主记录之下,条目的增减都会留下一次编辑时间锚点。

至 2025 赛季,赛事板块累计分列 821 场完整数据,覆盖 14 项联赛与杯赛。 同一项赛事在不同赛季的字段含义保持一致,若某赛季新增字段,会在赛况观察栏目里留一条说明。

  • 收录内容伤停条目、阵容变动、赛前前瞻
  • 颗粒度单场比赛
  • 赛事范围14 项联赛与杯赛
  • 主记录量821 场
足球场俯视图上的阵型站位线条,低饱和暗调
赛事板块的站位与变动记录以场为锚点,同一场的条目不会拆散到不同轮次。

板块 02

亚博线上点球记录

主罚级 · 2021 赛季增设

罚球点与球门网局部特写,琥珀红高光
每一次主罚单独成条,序列号在同一场点球大战内连续编号。

这块以单次主罚为最小单位。同一场点球大战里的每次罚球各成一条序列,按主罚顺序连续编号, 常规时间内的判罚与点球大战分开标记,两类的编号彼此独立。

板块累计 687 条主罚序列,其中点球大战 46 场。凡出现重罚的场次,重罚条目单独成条并标注与原始主罚的对应关系, 避免把重罚计入命中率的分子。

  • 收录内容主罚顺序、判罚结果、重罚标记
  • 颗粒度单次主罚
  • 序列总量687 条
  • 点球大战46 场

板块 03

亚博线上教练履历

阶段级 · 2023 赛季增设

这块按执教阶段分列,而不是按人一条。一名教练在同一支队伍的多段任期各自成条, 代理任期与青训阶段使用不同的阶段类型标记,阶段起止以赛季与轮次同时限定。

板块累计收录 412 位教练的执教阶段。教练以编号标识,页面不出现任何真实姓名, 阶段编号在教练内部连续,跨教练不重复比较。

  • 收录内容阶段起止、阶段类型、所属范围
  • 颗粒度单个执教阶段
  • 收录教练412 位
  • 阶段类型正式、代理、青训
空置教练席与战术板剪影,冷银灰色调
教练履历以阶段路径线串联,同一教练的不同任期不会合并成一段。

字段清单

每块板块的核心字段

下表列出三块板块对外呈现的核心字段。字段名固定,含义以《数据口径手册》第 7 版为准。 悬停或聚焦字段名可查看该字段的口径摘要;数字列全部右对齐,便于逐列比对。

抽象数据节点与轨迹线条网络图,暗底局部高光
字段之间的关系由口径手册统一定义,同一字段名不允许在不同板块漂移含义。

赛事板块字段

赛事板块核心字段与取值说明
字段名 含义 取值数
赛season 比赛所属赛季标识,从 2019 起连续编号口径摘要:赛季以开赛赛季命名,跨年赛制归入起始年份。 7
round_no 轮次序号,同一赛事内唯一口径摘要:淘汰赛与小组赛分别编号,不合并连续。
squad_change 阵容变动类型,标注进出方向与变动口径口径摘要:以赛前登记名单为基准比对,临场调整不计入。 6
absence_item 伤停条目,逐条列出并附条目状态口径摘要:条目随名单变化增删,历史条目保留不覆盖。 4
preview_tag 赛前前瞻的结论标签口径摘要:仅标记可核对的事实项,不含推测性表述。 5

点球记录字段

点球记录板块核心字段与取值说明
字段名 含义 取值数
sequence_id 主罚序列号,同一场点球大战内连续口径摘要:常规时间判罚与点球大战分别独立编号。 687
kick_order 主罚顺序口径摘要:以当场登记顺序为准,重罚不占用新序号。
verdict 判罚结果标记口径摘要:只记录结果类别,不记录过程描述与主观评价。 3
retake_flag 是否重罚,以及与原主罚的对应关系口径摘要:重罚单独成条,不计入命中率分子。 2
shootout_flag 是否属于点球大战口径摘要:点球大战场次共 46 场,与常规判罚分开统计。 2

教练履历字段

教练履历板块核心字段与取值说明
字段名 含义 取值数
coach_ref 教练编号,页面内唯一标识口径摘要:教练一律以编号呈现,不使用姓名。 412
stage_index 执教阶段序号,在同一教练内连续口径摘要:阶段不合并,跨赛季连续任期也拆分为独立阶段。
stage_type 阶段类型:正式、代理、青训口径摘要:代理任期与青训阶段单列,不与正式任期混算。 3
stage_span 阶段起止,以赛季与轮次同时限定口径摘要:起止边界以官方登记变更为准,不以媒体报道为准。
scope_ref 该阶段覆盖的赛事范围口径摘要:同一阶段可覆盖多项赛事,按赛事维度展开。 14

取用范围

导出范围与请求方式

三块板块都可以按赛季区间、赛事项、轮次区间三个维度组合取用。组合越窄,返回的条目越少, 核对所需的时间也越短;如果需要跨板块比对,建议分别按同一轮次区间取用,再按赛事与轮次对齐。

导出以静态文件形式提供,不提供实时推送,也不对接口的长期可用性作任何保证。 请求请通过数据勘误与联系通道提出,说明需要的板块、赛季区间、赛事项与轮次范围, 我们会先确认字段口径版本,再给出该范围内的实际条目量。

若同一赛季存在口径重跑,导出的内容以重跑后的版本为准,重跑说明记录在赛况观察栏目中。

按赛季区间

从 2019 赛季起可任选连续区间,跨赛季取用时字段会按各赛季生效版本对齐。

7 个赛季可选

按赛事项

14 项联赛与杯赛可单选或多选,多选时各赛事分别成组,不混算统计量。

14 项赛事

按轮次区间

可指定某一轮或连续若干轮,适合逐轮核对伤停与阵容变动的先后顺序。

轮次级粒度

按板块组合

三块板块可单独取用,也可组合取用;组合时按板块分别成文件,不做自动关联。

三块独立成组

更新与版本

更新频率与版本对应

  1. 01

    赛后窗口内完成分列

    每轮赛后 120 分钟内由值班编辑完成三块板块的分列,赛事密集日按同一窗口顺延处理。

  2. 02

    一人分列、一人校对

    值班编辑小组为 6 人轮值,更新执行双人复核,复核记录可追溯,出现分歧时以记录为准。

  3. 03

    字段口径与手册版本对齐

    当前所有字段含义以《数据口径手册》第 7 版为准,手册修订后受影响的历史记录按新版本重跑。

  4. 04

    重跑留痕

    每次重跑在赛况观察栏目留下一条说明条目,写明受影响的赛季、赛事与轮次范围。

跨板块对齐

同一字段名,三块板块含义一致

三块板块共用同一套口径定义:赛季标识、轮次序号、赛事项编号这三个字段在赛事、点球记录与教练履历中含义完全相同, 不随页面或板块变化。正因如此,三块数据可以按轮次直接对齐,而不需要做额外的映射转换。

越位次数规则说明与控球率口径同源,随《数据口径手册》版本同步修订;这两项口径的生效范围与更新时点, 在疑问解答中有逐项说明。若发现某条记录与口径手册不符,可通过数据勘误与联系提交。

赛事板块主记录 821
点球主罚序列 687
教练执教阶段收录人数 412
覆盖赛事项 14

取用前的三个提醒

第一,先确认需要的颗粒度是场、是单次主罚还是执教阶段,三者的条目量级差别很大。 第二,跨板块比对时统一按轮次对齐,不要按时间先后拼接。 第三,导出内容以口径手册当前版本为准,引用时请标注版本号与取用日期。

提交导出请求 回到首页索引