Schema.org COVID-19:美国 CDC 数据表字段
Schema.org COVID-19:美国 CDC 数据表字段
编辑者:Dan Brickley danbri@google.com
最后更新:2020-04-02
本文档指定了以下美国 CDC(疾病控制与预防中心)数据格式定义的 Schema.org 表示:
- 标题:导入 COVID-19 患者模块分母数据以用于患者安全组件 (PSC)
- URL:https://www.cdc.gov/nhsn/pdfs/covid19/import-covid19-data-508.pdf
此处定义的表示旨在与原始表示保持 1:1 对应,并可进行往返格式转换。CDC 文档以表格格式定义了几个数据字段。这些在 Schema.org 中表示为类型为 CDCPMDRecord 的对象的属性。
对于下表中列出的属性的所有正式解释事宜,请参考源 CDC 文档以获取权威定义和官方更新。本文档(及附带模式)可能会在未来更新以跟踪 CDC 的更改,但我们无法保证立即这样做。实施者应注意检查 CDC 网站以获取更新和澄清。我们预计 CDC 定义的某些方面可能会发生变化。
此模式定义的目的是提供基于标准的表示,可用于编码和交换与 CDC 格式对应的记录。根据上下文,任何与 Schema.org 配合使用的格式和标准都可能适用,包括 Microdata、RDFa 和 JSON-LD 数据格式,以及相关技术如 W3C SPARQL 用于数据查询。在大多数情况下,JSON-LD 可能是最合适的格式。没有假设使用此模式编码的数据必须在公共 Web 上发布,也不会被搜索引擎使用。
- https://www.cdc.gov/nhsn/acute-care-hospital/covid19/index.html
- 上述源 PDF 在资源部分链接,
- “如何导入 COVID-19 汇总数据 [PDF – 200 KB]“,以及 “CSV 文件模板 [CSV – 250 B]“
- https://www.cms.gov/files/document/32920-hospital-letter-vice-president-pence.pdf
Schema.org 词汇表
以下是对 Schema.org 的添加(在待定区域,待审查和实施反馈):
- 1 个新类型:Thing > Intangible > StructuredValue > CDCPMDRecord
- 14 个新属性:cvdCollectionDate、cvdNumBeds、cvdNumTotBeds、cvdNumBedsOcc、cvdNumICUBeds、cvdNumICUBedsOcc、cvdNumVent、cvdNumVentUse、cvdNumC19HospPats、cvdNumC19MechVentPats、cvdNumC19HOPats、cvdNumC19OverflowPats、cvdNumC19OFMechVentPats、cvdNumC19Died。
- 此外,一个新的 healthcareReportingData 属性可用于将 Hospital 与 CDCPMDRecord 关联。
- datePosted 属性也可用于 CDCPMDRecord。
- 使用 cvdFacilityId 来标识 NHSN 设施,以及(可选)cvdFacilityCounty 用于其县名。
新属性:这添加了几个新属性(见 “Schema.org 名称” 列)。大多数是 Number(具有附加应用级约束,在 “注释” 列中总结)。
为每个名称添加 cvd 前缀的原因是为了避免与 Schema.org 中已在使用的类似或相同名称冲突。例如,https://schema.org/numberOfBeds 已存在用于描述酒店房间、公寓等;在 COVID-19 情况下,最简单的方法是保持相对独立。
CDC 名称 | Schema.org 名称 | 预期值 | 注释(请参考 CDC 获取权威指导) | 定义 |
---|---|---|---|---|
collectiondate | cvdCollectionDate | Text, mm/dd/yyyy [或 ISO 8601 DateTime] |
CDC 必需。 collectiondate 的原始日期格式为 mm/dd/yyyy,在美国上下文之外可能有歧义,因此我们提供使用 ISO-8601 日期的选项 |
报告患者数量的日期。 |
numbeds | cvdNumBeds | Number | CDC 必需。 0 到 10000 必须是整数 必须 <= numTotBeds |
医院住院床位:包括所有配备人员、许可和溢出(激增)床位,用于住院患者。 |
numtotbeds | cvdNumTotBeds | Number | 必须是整数 0 到 10000 |
所有医院床位:所有住院和门诊床位的总数,包括所有配备人员、ICU、许可和溢出(激增)床位,用于住院或门诊患者。 |
numbedsocc | cvdNumBedsOcc | Number | 0 到 10000 必须是整数 必须 <= numBeds |
医院住院床位占用:配备人员的住院床位总数已被占用。 |
numicubeds | cvdNumICUBeds | Number | 0 到 10000 必须是整数 必须 <= numBeds |
ICU 床位:配备人员的住院重症监护室 (ICU) 床位总数。 |
numicubedsocc | cvdNumICUBedsOcc | Number | 0 到 10000 必须是整数 必须 <= numICUBeds |
ICU 床位占用:配备人员的住院 ICU 床位总数已被占用。 |
numvent | cvdNumVent | Number | 0 到 10000 必须是整数 必须 <= numTotBeds 或 <= 10,000 |
机械呼吸机:可用的呼吸机总数。 |
numventuse | cvdNumVentUse | Number | 0 到 10000 必须是整数 必须 <= numVent 或 <= 10,000 |
使用中的机械呼吸机:使用中的呼吸机总数。 |
numc19hosppats | cvdNumC19HospPats | Number | 0 到 10000 必须是整数 必须 <= numBedsOcc |
住院:目前在住院护理地点住院的疑似或确诊 COVID-19 患者。 |
numc19mechventpats | cvdNumC19MechVentPats | Number | 0 到 10000 必须是整数 必须 <= numVentUse |
住院并使用呼吸机:住院在 NHSN 住院护理地点、疑似或确诊 COVID-19 并使用机械呼吸机的患者。 |
numc19hopats | cvdNumC19HOPats | Number | 0 到 10000 必须是整数 必须 <= numBedsOcc |
医院发病:住院在 NHSN 住院护理地点、疑似或确诊 COVID-19 发病时间在住院后 14 天或更长的患者。 |
numc19overflowpats | cvdNumC19OverflowPats | Number | 0 到 2000 必须是整数 必须 <= 2000 |
ED/溢出:疑似或确诊 COVID-19、在急诊室或任何溢出地点等待住院床位的患者。 |
numc19ofmechventpats | cvdNumC19OFMechVentPats | Number | 0 到 10000 必须是整数 必须 <= numVentUse |
ED/溢出并使用呼吸机:疑似或确诊 COVID-19、在急诊室或任何溢出地点等待住院床位并使用机械呼吸机的患者。 |
numc19died | cvdNumC19Died | Number | 0 到 1500 必须是整数 必须 <= 1500 |
死亡:在医院、急诊室或任何溢出地点死亡的疑似或确诊 COVID-19 患者。 |
变更日志
- 2020-04-02:初始版本。