forked from zhouruizhe/gmTouringMiniApp
61 lines
2.8 KiB
Markdown
61 lines
2.8 KiB
Markdown
# 高德 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 个或出现明显遮挡时，先实现聚合或视野内渲染。
|