医院信息能力与数据说明

本页用于说明医院信息目录下各类接口的能力结构、覆盖范围、推荐调用方式和使用建议。

医院信息类接口更适合承担机构搜索、地区筛选、机构详情补齐、科室结构映射和本地机构建档等任务。

适用场景

• 医院搜索与筛选页
• 导诊后的医院候选机构推荐
• 挂号、转诊、就医服务的机构落点能力
• 医院机构主数据建设与目录治理
• 基于地区和经纬度的机构检索

能力范围

医院信息目录当前主要包含四类能力：

1. 地区基础数据

• 基础·全国城市列表查询

适合用于：

• 构建省市联动选择器
• 为医院搜索提供标准地区输入
• 统一地区展示名称和地区维度筛选

2. 机构搜索与定位

• 基础·医院信息查询

适合用于：

• 根据机构名称关键词搜索医院
• 根据经纬度搜索附近机构
• 基于地区做医院列表筛选
• 兼容全称、简称、曾用名、常用名等多种搜索方式

3. 机构详情补齐

• 基础·医院信息详情

适合用于：

• 补充医院简介、交通信息、官网、联系方式和机构属性
• 建设机构详情页或医院档案页
• 为导诊、挂号、服务分发提供更完整的机构信息

4. 真实科室结构

• 基础·医院科室

适合用于：

• 获取指定医院的真实科室命名和层级结构
• 将导诊结果映射到医院实际科室
• 用于院内服务入口分发和挂号落点

当前文档已披露的数据口径

根据现有接口说明，当前公开文档已披露以下口径：

• 医院信息查询：机构总数已超过 100 万，覆盖全国 31 个省级地区，收录近 50 种机构类型和 14 种等级，并以天为单位持续更新
• 医院信息详情：定级为三级及以上的医院收录 4 千余家，简介覆盖率超过 75%，交通信息覆盖率超过 60%
• 医院科室：当前已覆盖近 1 万家医疗机构，并尽可能反映医院真实科室命名情况

从公开描述看，医院信息目录同时兼顾权威信源和真实世界补充信息，因此适合搜索、筛选和建档，但不同机构的字段完整度可能存在差异。

推荐调用方式

医院信息类场景通常建议按下面的顺序组合：

1. 通过 全国城市列表查询 构建地区维度
2. 通过 医院信息查询 获取候选机构列表
3. 通过返回的 hospital_id 调用 医院信息详情 补齐详情
4. 如需真实科室结构，再通过 hospital_id 调用 医院科室

如果场景涉及导诊分流和医院落点，建议与 医院机构搜索与建档方案 配合阅读。

使用建议

• 搜索阶段建议优先以关键词召回为主，地区和经纬度作为筛选或排序条件
• 本地系统应保留平台返回的 hospital_id 作为标准机构标识，避免多套命名并存造成重复建档
• 前台展示可使用标准名称，搜索输入则应兼容简称、别名和曾用名
• 若业务需要把智能分诊结果落到具体医院科室，应同时接入医院科室接口，而不是只展示通用科室名称
• 对热门机构可做本地缓存，但仍建议保留基于平台 ID 的标准引用方式

能力边界

医院信息目录提供的是机构检索和结构化机构数据能力，不代表所有机构字段都一定完整一致。

使用时应注意：

• 不同等级、不同类型机构的详情覆盖率可能不同
• 搜索接口更适合做候选召回，详情接口才适合做完整展示
• 科室接口反映的是医院真实命名，不一定和标准科室词表一一对应
• 若业务需要更强的导诊落点、机构治理或服务路由，应在平台数据基础上叠加本地映射和业务规则