---
title: Obsidian Maps 选点建笔记操作指南
type: reference
created: 2026-04-10
tags:
- wiki
- tools/obsidian
- tools/map
- type/指南
para:
- resources
source: '[[Obsidian Maps选点建笔记操作指南]]'
description: 在 Obsidian 中通过 Maps 插件选点创建带坐标的笔记，完整操作流程
categories:
- '[[LLM Wiki]]'
---

# 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 卫星 |

## 来源

> **溯源规则**：所有数字/百分比/具体结论必须标注 `[raw:{文件名}:{行号}]` 格式。

- [[Obsidian Maps选点建笔记操作指南]]