---
title: 医院机构搜索与建档方案
description: 说明如何利用机构搜索、详情和科室数据构建稳定的医院机构库。
sidebar_position: 3
---


# 医院机构搜索与建档方案

本方案面向医院机构检索、挂号导流、机构主数据建设、服务商目录管理和地理化搜索等场景，重点解决医院名称不统一、机构信息不完整、院区与科室结构难以维护的问题。

## 适用场景

- 医院搜索与筛选页
- 挂号、转诊、导医导诊中的机构落点能力
- 医院机构主数据建档与信息补全
- 区域化医疗资源目录建设
- 基于地理位置的附近医院搜索

## 典型业务问题

医院机构类业务通常面临以下问题：

- 医院全称过长，用户更常使用简称、别名或历史名称
- 同一机构可能存在多个院区，信息拆散后难以统一管理
- 医院详情、联系电话、官网、公众号和交通信息分散
- 不同医院科室命名不统一，难以做稳定的业务映射
- 地域筛选和经纬度搜索常常依赖多套数据源拼接

## 推荐方案

医院机构建档建议按「先建立地区维度，再做机构搜索，再补全详情和科室结构」的方式进行。

### 1. 先准备地区维度

如果产品有省市筛选器、地区选择器或区域化检索入口，建议先调用 [基础·全国城市列表查询](/doc/nc.ms.location.list/description)。

这适合用来：

- 构建省市联动筛选
- 为医院搜索的 `region` 参数提供标准输入
- 统一本地地区编码和展示名称

### 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) 获取科室结构

## 建档建议

如果目标是建设本地医院机构主数据，建议至少落以下字段：

- `hospital_id`
- `hospital_name`
- `grade`
- `type`
- `province` / `city` / `location_code`
- `address`
- `branches`
- `contact`
- `organization_type`

在此基础上，再结合详情和科室结构做本地展示、搜索索引和业务映射。

## 交付结果

完成机构搜索与建档后，通常可以得到：

- 一套可检索、可筛选、可展示的医院机构目录
- 稳定的机构唯一标识和院区结构
- 更适合挂号导流和导诊落点的机构详情页
- 可用于服务分发的医院科室结构

## 实施建议

- 搜索阶段建议优先用关键词召回，地理位置作为排序或补充条件
- 对热门医院可做本地缓存，但仍建议保留基于 `hospital_id` 的标准引用
- 前台展示医院名称时，可保留标准名称；搜索时则兼容简称和别名输入
- 若导诊流程需要把推荐科室落到具体医院，建议将本页方案与「智能接口」目录联动使用