简体中文 | English
在 TREK 里直接搜遍高德地图——餐厅、景点、宝藏小店都能找，一键复制详情或添加进当前行程，坐标/地图链接/电话自动带上。
Search Amap POIs right inside TREK — find restaurants, sights & hidden gems, copy details or add them to your current trip with coordinates, map link & phone in one click.
- 🛠️ 存量坐标批量修复：装插件之前添加的旧地点（坐标偏 ~500m 或缺失），一键扫描 → 预览候选 → 确认后批量修正，地图位置不再偏移
- 🏷️ 添加时自动匹配分类：新地点按高德 type + 名称自动归入你的 TREK 分类，分类改名/增删后依然匹配
- 🔼 兼容 TREK 4.x（范围扩至
<5.0.0）
完整版本历史见 CHANGELOG.md。
找地方 以 trip-page 类型挂在行程规划器内部（TREK 3.4+），始终跟随当前打开的行程。搜索高德上的任意地点，然后复制详情或直接写进行程。
- 🗺️ 高德 POI 关键字搜索（可指定城市，不填则自动识别行程城市；识别不到再全国搜索）
- 🏙️ 城市自动识别（v1.1.5）：行程标题匹配内置城市列表 → 首个有坐标地点反查 → 地址解析，三级推断当前行程城市，无需手动填
- 📐 坐标自动转换（v1.1.5）：高德返回 GCJ-02（火星坐标）→ 自动转成 WGS-84 存进 TREK，地图上位置不再偏移约 500 米
- 📋 复制地址：一键复制 名称 / 完整地址（中国·省·市·区·街道）/ 经纬度 / 地图链接 / 类型 / 电话
- ➕ 添加进行程：写入当前行程，自动带上：
- 坐标（经纬度，已转 WGS-84）
- 地址
- 类型 → 描述
- 高德地图链接 → 「网站」字段（点击地点卡片的"打开链接"跳转高德）
- 电话 → 「备注」字段（另起一行）
- 🔀 结果排序（v1.1.0）：评分 / 人均 / 默认，纯客户端排序（距离排序已屏蔽：SDK 无「选中地点」事件，v1.3.2 起；距离从卡片删除 v1.3.17）
- 🖥️ 响应式按钮列（v1.1.6）：移动端复制/添加按钮并排带文字；网页端（≥641px）按钮垂直排列在卡片右侧、只显示图标（Lucide Copy / Plus，悬停有提示）
- 🔑 每个用户自己填高德 Key（设置 → 插件，加密存储，不进代码）
- 💡 Key 引导语智能显隐：没填 Key 时显示申请引导，填好或搜索成功后自动隐藏
- 🏷️ 添加时自动匹配分类（v1.3.30）：新地点写入行程时按高德 type + 名称自动归入你的 TREK 分类——名称信号优先（高德可能把餐饮标成"购物/其他"，如"百益桑拿鸡"会按名称正确归"餐厅"）；分类名动态解析，你的分类改名/增删后依然能匹配
- 🛠️ 存量坐标批量修复（v1.4.0）：对装插件前已添加/导入的旧地点，一键扫描并修复坐标（GCJ-02 偏移或缺失）——扫描预览候选 → 勾选确认后批量写入，避免地图位置偏约 500 米
TREK 自带的搜索用的是 OpenStreetMap，找地标没问题，但找那些让旅程变特别的小店（隐藏咖啡馆、小吃摊、精品店）就抓瞎了。高德是中国最详细的地图，本插件让你在 TREK 里直接用上它：
- 按关键词搜索中国 POI（试试 故宫 / 长城 / 西湖，或任何本地小店名）
- 一键复制完整地址——街道、区、市、国家——外加经纬度和高德地图链接
- 一键把地点添加进当前行程，坐标、地址、地图链接自动填好
唯一要求是一个高德 Web 服务 API Key（console.amap.com）。个人开发者配额每天 50 万次调用——注册可能需要中国手机号，但拿到 Key 之后，搜中国地点比只用 OSM 容易太多了。
TREK 官方有一个关于中国地图模式的讨论（#1636、#1673），方向是把高德作为内置的 place search provider，并考虑高德瓦片/路线。该方案仍在讨论阶段，尚未有代码，且核心难点是坐标系（GCJ-02 vs WGS-84 转换涉及法律灰色地带）。
本插件的定位与官方方案不同：
- 纯搜索增强：只做高德 POI 搜索与结果展示，不涉及地图渲染与路线
- 坐标已解决（v1.1.5+）：插件内置 GCJ-02 → WGS-84 转换（eviltransform 算法），高德坐标存进 TREK 后地图位置精确，不再存在"坐标偏 500 米"问题
- 即插即用：官方落地前，本插件是 TREK 里可立即使用的高德搜索方案；官方落地后，其搜索能力仍可与官方功能互补
- 持续可用：插件独立于官方路线，不受官方讨论进度影响
⚠️ 合规声明：本插件的坐标转换仅用于修正高德（GCJ-02）与 OpenStreetMap（WGS-84）之间的地图显示偏差，以确保地点在行程地图上位置准确。请在使用前了解并遵守所在国家/地区的法律法规。
插件界面自动跟随 TREK 的亮/暗主题。
激活时 TREK 会向管理员展示此列表。本插件只申请四个权限，且仅与高德搜索接口通信。
| 权限 | 用途 |
|---|---|
db:read:trips |
读取当前行程上下文 |
db:write:places |
在行程中创建地点 |
db:read:categories |
读取你的行程分类列表——添加地点时按分类名自动匹配（你的分类可改名/增删，按名称动态解析） |
http:outbound:restapi.amap.com |
调用高德 POI 搜索/坐标修复接口（服务端，唯一网络请求） |
- 打包：
npx trek-plugin-sdk pack→plugin.zip - TREK → Admin → Plugins → Upload → 选择 zip
- 激活并同意权限
- 高德开放平台：https://console.amap.com/
- 注册（支付宝/手机号即可）→ 控制台 → 应用管理 → 创建新应用 → 添加 Key
- 类型选 Web 服务（不是 Web 端 JS API！）
- 个人开发者配额 50 万次/天，搜地点根本用不完
- 打开任意行程 → 顶部 tab 栏出现「找地方」
- 输入关键词（如：故宫 / 长城 / 西湖）+ 城市（可选）→ 搜索
- 📋 复制地址 → 复制完整地址 / 经纬度 / 地图链接
- ➕ 添加进行程 → 写入当前行程（坐标 / 地址 / 类型 / 网站链接 / 电话备注一步到位）
- 高德地图链接自动存入地点的「网站」字段，点击地点卡片底部的"打开链接"即可跳转至高德地图。
- 其他链接（官网/小红书/抖音等）：编辑该地点的「备注」添加，一行一个（备注里链接可点击）。例：
小红书: http://xhslink.cn/xxx
- 需要 TREK >=3.4.0（
>=3.4.0 <5.0.0，含 TREK 4.x） - 无原生模块，无付费 API（高德 API 个人开发者配额 50 万次/天）
- Issues & questions: https://github.com/imusic-487/Trek-Amap-search/issues
- Source & changelog: https://github.com/imusic-487/Trek-Amap-search
🛠️ 坐标批量修复（本版主功能）
- 行程里在装插件之前添加/导入的旧地点，坐标可能因未做 GCJ-02→WGS-84 转换而偏移约 500 米，或干脆缺失
- 新增「修复坐标」：批量扫描行程内地点 → 逐个向高德核实 → 预览候选（新坐标 / 偏移米数 / 名称匹配度）→ 勾选后批量写入
- 防误伤策略：有旧坐标时默认围绕原坐标周边搜索（防止同名连锁店/跨区同名点被匹配到别的分店）；半径与并发数可调
- 偏移 ≤50m 的地点自动跳过不打扰；高德搜不到 / 接口失败安全跳过
- 新增 3 项用户设置：并发请求数（1-5，默认 3）、周边搜索开关、搜索半径（默认 5000m）
🏷️ 分类自动匹配（v1.3.30-32，未单独发布、随本版首次上架）
- v1.3.30：添加 POI 自动匹配 TREK 分类——按高德 type/typecode 归入语义分类（餐厅/酒吧咖啡/酒店/景点/购物/交通/活动/沙滩/自然/其他），再按分类名称从你的真实分类列表动态解析 id（你的分类可改名/增删/重建，不再因硬编码 id 失效）
- v1.3.31：名称信号优先——高德 type 可能把餐饮标成"购物/其他"（如"百益桑拿鸡大良店"），POI 名称含餐饮特征词时按用户意图归"餐厅"；修复分类下拉被下一张卡片盖住（宿主 select 浮层 z-index）
- v1.3.32：版本收尾
完整历史（v1.0.1 → v1.3.29，含历次试装迭代细节）见 CHANGELOG.md。
MIT — 见 LICENSE。
- 坐标批量修复功能（v1.4.0）设计参考 chondaen12/Trek-Amap-search（MIT）——两段式「扫描预览 → 用户确认写入」方案源自其 fork 中的 coord-scan 实现，代码注释已保留出处。
社区插件，非 TREK 核心团队维护。