hehaiguang1123
a6f05ab2d5
- Phase 0: AGENTS.md cleanup (dedup quotes, renumber sections, merge qmd) - Phase 1: typed relations (manage-relations.py, graph-search.py, check-staleness.py, detect-conflicts.py) - Phase 2: frontmatter validator, weekly lint, knowledge promotion, git hooks - Fix .gitignore to track tools/ and .githooks/ - Fix git remote URL (remove plaintext token) - New wiki pages: 504 pages, 34 raw sources
198 lines
5.4 KiB
Markdown
198 lines
5.4 KiB
Markdown
---
|
||
title: Obsidian Maps 选点建笔记操作指南
|
||
type: reference
|
||
created: 2026-04-10
|
||
tags:
|
||
- tools/obsidian
|
||
- tools/map
|
||
- type/指南
|
||
para:
|
||
- resources
|
||
source: "[[Obsidian Maps选点建笔记操作指南]]"
|
||
description: "在 Obsidian 中通过 Maps 插件选点创建带坐标的笔记，完整操作流程"
|
||
---
|
||
|
||
# Obsidian Maps 选点建笔记操作指南
|
||
|
||
> [!abstract] 核心流程
|
||
> 创建 Base 文件 → 添加 Map 视图 → 配置坐标属性 → 右键地图选点 → 自动创建带坐标的笔记
|
||
|
||
---
|
||
|
||
## 一、前置条件
|
||
|
||
| 条件 | 状态 | 检查方法 |
|
||
| ---------- | --- | ------------------------------------- |
|
||
| Maps 插件已启用 | ✅ | 设置 → 社区插件 → Maps 开启 |
|
||
| 瓦片代理已启动 | 需确认 | 浏览器访问 `http://127.0.0.1:18090/status` |
|
||
| 地图背景已配置 | ✅ | 设置 → Maps → 应有5个背景选项 |
|
||
|
||
> [!warning] 代理必须运行
|
||
> 瓦片代理（端口 18090）是地图加载的前提。如果没启动：
|
||
> ```powershell
|
||
> Start-Process node -ArgumentList "D:\TC_UP\2023card\tools\tile-proxy.js","18090" -WindowStyle Hidden
|
||
> ```
|
||
|
||
---
|
||
|
||
## 二、创建地图（3步）
|
||
|
||
### 步骤 1：新建 Base 文件
|
||
|
||
在 Obsidian 中创建一个新的 `.base` 文件，例如 `地图.base`。
|
||
|
||
### 步骤 2：添加 Map 视图
|
||
|
||
1. 打开 `.base` 文件
|
||
2. 点击右上角视图切换
|
||
3. 选择 **Map** 视图类型
|
||
|
||
### 步骤 3：配置地图选项
|
||
|
||
点击 Map 视图的设置齿轮，配置以下选项：
|
||
|
||
| 配置项 | 推荐值 | 说明 |
|
||
|--------|--------|------|
|
||
| **Marker coordinates** | `location` | 笔记中存坐标的属性名 |
|
||
| Marker icon | （可选） | 图标属性名 |
|
||
| Marker color | （可选） | 颜色属性名 |
|
||
| Center coordinates | `[39.9042, 116.4074]` | 默认中心（北京） |
|
||
| Default zoom | `12` | 默认缩放级别 |
|
||
| Background | 腾讯矢量 | 推荐日常使用 |
|
||
|
||
> [!important] `location` 属性是关键
|
||
> Maps 插件读取笔记的 `location` 属性来定位标记点。格式为 `[纬度, 经度]`。
|
||
>
|
||
> ```yaml
|
||
> ---
|
||
> location: [39.9042, 116.4074]
|
||
> ---
|
||
> ```
|
||
>
|
||
> 也支持字符串格式：`location: "39.9042, 116.4074"`
|
||
|
||
---
|
||
|
||
## 三、选点建笔记（2种方式）
|
||
|
||
### 方式 A：右键地图创建（推荐 ✨）
|
||
|
||
1. 在地图上**右键点击**目标位置
|
||
2. 弹出菜单选择 **"New note"**
|
||
3. 自动创建新笔记，`location` 属性自动填入坐标
|
||
|
||
> [!tip] 右键菜单还有这些功能
|
||
>
|
||
> | 选项 | 功能 |
|
||
> |------|------|
|
||
> | **New note** | 创建带坐标的新笔记 |
|
||
> | **Copy coordinates** | 复制坐标到剪贴板（如 `39.9042, 116.4074`） |
|
||
> | **Set default center point** | 设置为地图默认中心 |
|
||
> | **Set default zoom** | 设置为默认缩放级别 |
|
||
|
||
### 方式 B：手动给现有笔记加坐标
|
||
|
||
1. 在腾讯地图网页版找到位置：`https://map.qq.com/`
|
||
2. 右键目标点 → 复制坐标
|
||
3. 在笔记 frontmatter 中添加 `location` 属性
|
||
|
||
```yaml
|
||
---
|
||
title: 故宫博物院
|
||
created: 2026-04-10
|
||
location: [39.9163, 116.3972]
|
||
tags:
|
||
- place/北京
|
||
---
|
||
```
|
||
|
||
笔记保存后，地图上自动出现标记点。
|
||
|
||
---
|
||
|
||
## 四、地图数据源说明
|
||
|
||
所有标记点来自 **同一 Base 文件的查询结果**。Base 文件决定了哪些笔记出现在地图上。
|
||
|
||
### 典型 Base 配置
|
||
|
||
```
|
||
# 地图.base 查询条件
|
||
# 显示所有带 location 属性的笔记
|
||
Filter: location IS NOT EMPTY
|
||
```
|
||
|
||
这样所有有 `location` 属性的笔记都会在地图上显示为标记点。
|
||
|
||
### 按标签过滤
|
||
|
||
```
|
||
# 只显示地点类笔记
|
||
Filter: tags CONTAINS "place"
|
||
```
|
||
|
||
---
|
||
|
||
## 五、完整示例
|
||
|
||
### 1. 创建地点笔记
|
||
|
||
```markdown
|
||
---
|
||
title: 天安门广场
|
||
created: 2026-04-10
|
||
location: [39.9054, 116.3976]
|
||
tags:
|
||
- place/北京
|
||
- travel
|
||
---
|
||
|
||
# 天安门广场
|
||
|
||
位于北京市中心，是世界上最大的城市广场之一。
|
||
```
|
||
|
||
### 2. 创建地图 Base
|
||
|
||
新建 `地点地图.base`，添加 Map 视图：
|
||
|
||
- Marker coordinates → `location`
|
||
- Center → `[39.9042, 116.4074]`
|
||
- Background → 腾讯矢量
|
||
|
||
### 3. 结果
|
||
|
||
- 地图自动显示天安门广场的标记点
|
||
- 点击标记可查看笔记预览
|
||
- 右键地图可继续添加新地点
|
||
|
||
---
|
||
|
||
## 六、坐标获取参考
|
||
|
||
| 方法 | 操作 | 精度 |
|
||
|------|------|------|
|
||
| Maps 右键 → New note | 地图内直接操作 | 高（地图级别） |
|
||
| Maps 右键 → Copy coordinates | 复制后手动粘贴 | 高 |
|
||
| 腾讯地图网页 | map.qq.com 右键复制 | 高 |
|
||
| 高德地图网页 | uri.amap.com/marker | 高 |
|
||
| 手机 GPS | 实地定位 | 最高 |
|
||
|
||
> [!note] 坐标系注意
|
||
> 腾讯/高德使用 **GCJ-02** 坐标系（国测局坐标），GPS 使用 **WGS-84**。
|
||
> 两者在国内有 50-500 米偏移。Obsidian Maps 插件不做坐标转换，直接使用原始值。
|
||
> 日常使用建议统一用腾讯/高德获取的坐标，保持一致。
|
||
|
||
---
|
||
|
||
## 七、常见问题
|
||
|
||
| 问题 | 原因 | 解决 |
|
||
|------|------|------|
|
||
| 地图空白 | 代理未启动 | 启动 tile-proxy.js |
|
||
| 右键没出现菜单 | 插件版本旧 | 确认 Maps v0.1.6+ |
|
||
| 标记点不显示 | location 属性格式错误 | 检查是否为 `[纬度, 经度]` 列表格式 |
|
||
| 标记点位置偏移 | WGS-84 vs GCJ-02 | 统一用腾讯/高德获取坐标 |
|
||
| 新笔记没出现在地图 | Base 查询条件不匹配 | 检查 Filter 是否包含该笔记 |
|
||
| 卫星图模糊 | 缩放级别过高 | 降低缩放或切换到 ESRI 卫星 |
|