从研究需求，
到采集工具。
不是再做一个地图导航入口，而是把重复查询、任务安排和研究数据整理连接起来。
- 业务场景
- 同一批起终点需要在不同日期、时段和去返程方向重复查询，结果还要进入后续可达性计算。地点、计划和采集记录需要统一管理。
- 个人职责
- 负责需求拆解、原型框架与功能规划，明确批量导入、定时启动、状态查看和结果导出等使用要求，并在实际研究中使用工具。
- AI 实现
- 程序由 AI Agent 完成，通过浏览器界面、本地 API、采集执行与本地数据存储衔接任务；个人贡献与程序实现分别说明。
一次研究采集，需要留下什么？
- 输入
- 起点、目标地点、坐标字段与坐标系。
- 计划
- 日期、时段、去返程方向及允许执行窗口。
- 过程
- 任务状态、实际请求时间、失败原因与重试记录。
- 输出
- 可核对的路线明细、质量信息和分析数据文件。
交通采集工具的
实机界面。
首页、任务中心与任务详情，按实际任务流程展开。
点击图片可放大查看。
- 服务接入
- 首页提供高德 Key 申请说明与设置入口，正式采集前通过少量真实查询确认权限。
- 本地组织
- 任务、点位与数据管理入口集中在侧栏，首页计数用于观察本机运行情况。
- 执行跟踪
- 区分任务状态、用途及成功 / 失败数量，随后进入明细定位需要处理的记录。
- 操作衔接
- 任务活跃、暂停与结束对应不同后续操作，不把网页关闭误当作任务停止。
- 结果核查
- 结合批次、方向和实际请求时间检查结果，区分缺测、失败与有效观测。
- 后续分析
- 导出 Excel 明细与含 CSV 的数据包，将输入、计划和请求记录带入后续整理。
把容易混淆的，
变成明确规则。
批量采集的难点不只是发出请求，还包括输入是否有效、时间是否可解释，以及异常之后怎样继续。产品把这些要求放进任务流程，而不是只交付一张结果表。
- 先校验输入，再创建任务
- CSV / XLSX 导入先完成字段映射与坐标校验，识别无效行和重复信息；保留原始输入，方便后续核查。
- 计划时间与实际时间分开
- 定时启动对应计划批次，每条路线保留实际发出请求的时刻。错过窗口时记录原因，不用当前结果冒充历史时刻。
- 成功结果保留，异常单独处理
- 暂停或恢复后保留已经完成的结果，失败项按规则处理；查询失败、缺测与不可达分开解释。
把研究条件，
变成可执行的规则。
查看完整流程- 输入先校验
支持 CSV / XLSX 字段映射与坐标系选择，先区分有效输入、异常行和重复信息。
- 计划有边界
配置即时或定时、多日期时段、去返程和采集窗口，把研究条件固化为任务计划。
- 异常可处理
区分请求启动频率、并发、重试与本地调用预算；凭据和预算异常需要暂停处理。
- 结果能核对
查看任务状态及路线明细，核查批次、方向、完整性和实际采集时间，再导出文件。
文字摘要
创建任务后校验输入，按指定日期与时段发起查询；可重试错误记录尝试，凭据或预算异常暂停处理，最后核对并导出结果。
异常发生后，任务怎样继续？
- 临时请求失败
- 按既定规则重试，保留请求尝试与错误信息，便于区分偶发失败和持续异常。
- 凭据或预算异常
- 暂停后续调用，处理权限、配置或本地预算后，再检查并继续未完成任务。
- 错过计划窗口
- 记录错过原因与缺测状态，不将稍后查询的数据标记为原计划时点的观测。
界面之外，
每次请求也有记录。
技术服务于采集流程，而不是作为术语堆叠。
- 浏览器界面
- HTML、CSS、JavaScript
- 本地API
- Python、FastAPI、Uvicorn
- 采集执行
- httpx、高德路线服务
- 本地数据
- SQLite、CSV、Excel
负责地点与任务配置、进度呈现和结果筛选，操作通过本地 API 传递。
校验输入、连接页面与后台操作，承接任务、结果和导出等本地接口。
执行地图路线查询，分别处理启动频率、并发、重试和调用预算。
保存任务、观测和请求尝试；以 Excel 和含 CSV 的数据包交付结果。
用于真实采集，
交付可分析的数据。
工具已用于两篇论文的数据采集，导出结果进入后续交通可达性整理与计算。
23,986历史API请求
首次请求成功率100%。由项目提出者提供，原始日志未公开，不代表其他条件下的表现。
- 本地应用
交付 macOS 本地应用，通过浏览器界面配置任务，采集记录与结果保存在本机。
- 数据交付
输出路线明细、汇总和质量信息；数据包包含 CSV、计划、输入与请求记录，便于核查来源。
- 产品资料
提供在线 PRD、任务创建与异常处理流程图，以及公开项目仓库，衔接功能说明和实现证据。
后续验证重点是独立用户试用与人工计时对照；当前不填写未经测量的节省时间或效率提升比例。