本地就医信息如何组合位置与天气，真正困难的通常不是完成一次 API 调用，而是让结果可以校验、失败可以定位、后续能够回到原始证据。本文围绕“如何组合地区、定位、医院主体、天气和空气质量数据提供本地就医信息”给出一套可以直接落到任务状态和数据契约上的实现方式。
问题与结果
位置推断、医院信息和环境数据独立标注来源与时间，用户可以修正自动定位。
最终交付不是一段不可追溯的模型回答，而是一组带来源、版本、状态和失败记录的数据。这样既方便接入后续系统，也能在接口、页面或模型输出变化时定位问题。
适用场景
- 城市医院信息检索
- 出行前环境信息提示
- 本地公共服务问答
实现前先确定边界
- IP 定位只能作为默认值，必须允许用户确认城市
- 坐标系转换前后要记录类型
- 医院主体信息与挂号、科室和急诊能力不能混为一谈
可验证工作流
API 编排与职责
| 步骤 | 接口 | 请求方式 | 用途 |
|---|---|---|---|
| 行政区查询 | 全国省市区街道村信息 | GET | 规范化省、市、区等地区字段 |
| IP 定位 | 国内 IP 地址定位 | GET | 在用户未输入城市时提供粗定位参考 |
| 坐标转换 | 地理坐标系转换 | GET | 对接地图或定位系统时统一坐标 |
| 医院查询 | 全国三甲医院主体信息 | GET | 按省、市、区或关键词查询医院 |
| 天气信息 | 全国天气预报信息 | GET | 展示出行相关天气 |
| 空气质量 | 全国实时空气质量指数 | GET | 补充空气质量参考 |
最小可运行实现
按城市查询三甲医院：
curl -G "https://api.gugudata.com/location/hospital-3a" \ --data-urlencode "appkey=YOUR_APPKEY" \ --data-urlencode "province=江苏省" \ --data-urlencode "city=南京市" \ --data-urlencode "pageIndex=1" \ --data-urlencode "pageSize=20"查询行政区信息：
curl -G "https://api.gugudata.com/location/chinaregions" \ --data-urlencode "appkey=YOUR_APPKEY" \ --data-urlencode "regioncode=320100" \ --data-urlencode "version=3"查询天气预报：
curl -G "https://api.gugudata.com/weather/weatherinfo" \ --data-urlencode "appkey=YOUR_APPKEY" \ --data-urlencode "city=南京"Agent 可以先把位置字段规范化：
def normalize_location(input_text: str, fallback_city: str | None = None) -> dict: """Build a location query object for local service search.""" return { "keyword": input_text.strip(), "city": fallback_city, "needs_region_lookup": bool(input_text and not fallback_city), }输出怎么组织
本地服务类结果建议拆成三部分：
| 区块 | 内容 |
|---|---|
| 查询条件 | 用户输入、省市区、是否使用定位辅助 |
| 医院列表 | 医院名称、别名、所在地区、地址、电话 |
| 出行参考 | 天气、空气质量、数据更新时间 |
如果用于医疗服务入口，页面文案应保持谨慎。系统可以帮助用户查找医院主体信息，但不应替代医生诊断，也不应根据症状直接给治疗方案。
失败分类与降级
如果用户拒绝提供位置，Agent 应允许按城市或关键词检索。若 IP 定位和用户输入城市不一致，应优先使用用户明确输入，并在结果中说明查询条件。
如果医院查询无结果，可以由用户选择放宽到市级或省级范围。不要为了给出结果而返回无关城市的医院。
数据契约与留痕
建议至少保存以下字段；真实项目可以继续拆分，但不要删除来源、版本和状态信息。
| 字段 | 作用 |
|---|---|
region_code | 业务数据字段，保存时记录来源、口径和缺失状态 |
location_source | 原始来源或原始响应，供后续复核 |
coordinate_system | 业务数据字段，保存时记录来源、口径和缺失状态 |
hospital_id | 稳定业务标识，用于关联记录并避免名称冲突 |
weather_checked_at | 带时区的采样或生成时间，判断数据新鲜度 |
air_quality_checked_at | 带时区的采样或生成时间，判断数据新鲜度 |
user_confirmation | 业务数据字段，保存时记录来源、口径和缺失状态 |
所有派生结果都应带生成时间和输入版本。发生重试时新增尝试记录，不要覆盖最后一次失败，以免排查时只剩“最终成功”而看不到中间问题。
验收清单
- 自动定位可被用户覆盖
- 天气和空气质量包含采样时间
- 医院信息不包含未经验证的实时诊疗承诺
能力边界
内容仅提供公开主体和环境信息，不替代医疗建议、急救服务、实时挂号或医院官方通知。
示例中的YOUR_APPKEY仅为占位符。真实密钥只能放在服务端环境变量或密钥管理系统中，不应进入前端、文章、日志或版本库。
