llm_wiki/wiki/Obsidian Maps选点建笔记操作指南.md

title, type, created, tags, para, source, description

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

Obsidian Maps 选点建笔记操作指南

[!abstract] 核心流程 创建 Base 文件 → 添加 Map 视图 → 配置坐标属性 → 右键地图选点 → 自动创建带坐标的笔记

---

一、前置条件

条件	状态	检查方法
Maps 插件已启用	✅	设置 → 社区插件 → Maps 开启
瓦片代理已启动	需确认	浏览器访问 http://127.0.0.1:18090/status
地图背景已配置	✅	设置 → Maps → 应有5个背景选项

[!warning] 代理必须运行 瓦片代理（端口 18090）是地图加载的前提。如果没启动：

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 属性来定位标记点。格式为 [纬度, 经度]。

---
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 属性

---
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. 创建地点笔记

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