gmTouringMiniApp/docs/高德POI离线采集与数据快照说明.md

高德 POI 离线采集与数据快照说明

1. 本次结果

• 采集时间：2026-07-30（Asia/Shanghai）。
• 接口：高德 Web Service POI 2.0 关键字搜索。
• 固定区域：深圳市光明区，region=440311、city_limit=true。
• 查询：4 组文旅类型扫描及 21 个补召回关键词，共 62 次请求。
• 原始结果：1185 条；按高德 POI ID 合并 475 条重复后为 710 个候选。
• 本地发布：人工剔除企业、餐饮、普通培训机构、内部设施、重复入口和低价值点位后，精选 30 个 POC 点位。

这 30 个点位用于提升地图探索密度，不是项目方签字确认的权威全域基准清单。正式版本仍需内容负责人逐点确认纳入范围、名称、坐标、分类和来源。

2. 数据流

高德 POI 2.0
  -> 光明区严格过滤
  -> 高德 ID 去重
  -> 文旅价值与主资源人工筛选
  -> POC 字段映射
  -> src/data/poi/dataset.ts 本地冻结数据
  -> 微信小程序随包读取

微信客户端不调用高德 Web Service，不携带 Key，也不依赖运行时网络获取 POI。

3. 重新采集

Key 只通过单次进程环境变量提供；默认输出到系统临时目录，不写入源码：

AMAP_WEB_SERVICE_KEY=... corepack pnpm fetch:amap-pois
corepack pnpm test:amap-fetch

如指定 --output，采集器会拒绝写入 src、scripts、test 或 tests。候选 JSON 仍不得直接进入客户端，必须经过人工筛选和数据审核。

4. 字段口径

项目字段	当前来源与处理
名称	高德候选名称，已有业务点保留稳定业务 ID；别名单独保存
经纬度	高德返回 GCJ-02 坐标，并通过光明区 POC 包络校验
地址	高德候选地址；缺失时使用明确的待核验说明
简介	POC 原创说明，只描述候选用途，不冒充景点官方介绍
开放时间	一律为“待确认”；高德营业时间不直接发布
推荐指数	POC 默认值，页面标注“待审核”；高德评分不参与换算
特色标签	映射到项目受控标签库，每个点位 1-5 个
图片	使用包内统一占位图；未使用高德图片 URL
来源标识	仅保存 amap:<poiId>，不保存 Key、请求 URL或带凭证参数

5. 正式发布门槛

• 内容负责人冻结全域基准清单，并记录纳入与排除理由。
• 对同名、别名、父子景区和 30-50 米近邻点进行人工去重。
• 逐点确认坐标、地址、简介、开放时间、标签及官方推荐指数。
• 为每张真实图片补齐来源、授权证据和审核记录。
• 在 iOS 微信真机逐个验证全部 marker 可点击且详情不串点。
• 发布 POI 超过 50 个或出现明显遮挡时，先实现聚合或视野内渲染。