# 高德 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. 数据流

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

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

## 3. 重新采集

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

```bash
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 个或出现明显遮挡时，先实现聚合或视野内渲染。
