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

5.6 KiB
Raw Permalink Blame History

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

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

来源

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