---
title: 医院信息能力与数据说明
description: 汇总医院信息相关能力、推荐调用方式和使用建议。
sidebar_position: 2
---


# 医院信息能力与数据说明

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

如需先了解医院实体数据的定义、范围和适用场景，可先阅读 [医院主数据：定义与应用](/doc/capability-overview/hospital-master-data-overview)。医院信息目录对应的是医院主数据能力在开放接口层的结构化输出，适合用于机构搜索、详情补齐、科室映射和本地机构建档等任务。

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

## 适用场景

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

## 能力范围

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

### 1. 地区基础数据

- [基础·全国城市列表查询](/doc/nc.ms.location.list/description)

适合用于：

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

### 2. 机构搜索与定位

- [基础·医院信息查询](/doc/nc.ms.hospital.search/description)

适合用于：

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

### 3. 机构详情补齐

- [基础·医院信息详情](/doc/nc.ms.hospital.detail.get/description)

适合用于：

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

### 4. 真实科室结构

- [基础·医院科室](/doc/nc.ms.hospital.department.list/description)

适合用于：

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

## 推荐调用方式

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

1. 通过 [全国城市列表查询](/doc/nc.ms.location.list/document) 构建地区维度
2. 通过 [医院信息查询](/doc/nc.ms.hospital.search/document) 获取候选机构列表
3. 通过返回的 `hospital_id` 调用 [医院信息详情](/doc/nc.ms.hospital.detail.get/document) 补齐详情
4. 如需真实科室结构，再通过 `hospital_id` 调用 [医院科室](/doc/nc.ms.hospital.department.list/document)

如果场景涉及导诊分流和医院落点，建议与 [医院机构搜索与建档方案](/doc/solutions/hospital-search-and-profiling-solution) 配合阅读。

## 使用建议

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

## 能力边界

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

使用时应注意：

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