
本地就医信息如何组合位置与天气真正困难的通常不是完成一次 API 调用而是让结果可以校验、失败可以定位、后续能够回到原始证据。本文围绕“如何组合地区、定位、医院主体、天气和空气质量数据提供本地就医信息”给出一套可以直接落到任务状态和数据契约上的实现方式。问题与结果位置推断、医院信息和环境数据独立标注来源与时间用户可以修正自动定位。最终交付不是一段不可追溯的模型回答而是一组带来源、版本、状态和失败记录的数据。这样既方便接入后续系统也能在接口、页面或模型输出变化时定位问题。适用场景城市医院信息检索出行前环境信息提示本地公共服务问答实现前先确定边界IP 定位只能作为默认值必须允许用户确认城市坐标系转换前后要记录类型医院主体信息与挂号、科室和急诊能力不能混为一谈可验证工作流API 编排与职责步骤接口请求方式用途行政区查询全国省市区街道村信息GET规范化省、市、区等地区字段IP 定位国内 IP 地址定位GET在用户未输入城市时提供粗定位参考坐标转换地理坐标系转换GET对接地图或定位系统时统一坐标医院查询全国三甲医院主体信息GET按省、市、区或关键词查询医院天气信息全国天气预报信息GET展示出行相关天气空气质量全国实时空气质量指数GET补充空气质量参考最小可运行实现按城市查询三甲医院curl -G https://api.gugudata.com/location/hospital-3a \ --data-urlencode appkeyYOUR_APPKEY \ --data-urlencode province江苏省 \ --data-urlencode city南京市 \ --data-urlencode pageIndex1 \ --data-urlencode pageSize20查询行政区信息curl -G https://api.gugudata.com/location/chinaregions \ --data-urlencode appkeyYOUR_APPKEY \ --data-urlencode regioncode320100 \ --data-urlencode version3查询天气预报curl -G https://api.gugudata.com/weather/weatherinfo \ --data-urlencode appkeyYOUR_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仅为占位符。真实密钥只能放在服务端环境变量或密钥管理系统中不应进入前端、文章、日志或版本库。