Tài liệu · Lộ trình

Vị trí hiện tại, {location}, và siêu dữ liệu

Dùng một vị trí tại gốc khi định dạng mục, không tự thêm YAML hay trường nội tuyến. Lấy vị trí và xuất siêu dữ liệu là lựa chọn rõ ràng, riêng biệt trên mỗi Lộ trình.

Cập nhật 21 tháng 8 năm 2026 Lấy một lần Không theo dõi nền Hướng dẫn tính năng đầy đủ

Lấy vị trí không có nghĩa xuất siêu dữ liệu

Mỗi Lộ trình có hai điều khiển vị trí riêng. Sử dụng vị trí hiện tại quyết định lộ trình có yêu cầu một vị trí tại thời điểm gốc hay không. Ghi siêu dữ liệu vị trí quyết định vị trí lấy có ghi thêm frontmatter hay nội tuyến không.

Điều khiểnÝ nghĩaĐiều không có nghĩa
Quyền vị trí hệ thốngCho phép Vox.md yêu cầu vị trí khi dùng ứng dụng hoặc giao diện ghi nhanh hỗ trợ.Không bật vị trí cho bất cứ Lộ trình nào.
Sử dụng vị trí hiện tạiYêu cầu một vị trí cho lộ trình này và cung cấp cho {location}.Không tự ghi YAML hay siêu dữ liệu nội tuyến.
Ghi siêu dữ liệu vị tríGhi trường có cấu trúc đã chọn hoặc YAML nâng cao đã kiểm chứng từ vị trí lấy được.Không kiểm soát việc {location} có thể hiển thị.
Lộ trình thể hiện ý định, không phải quyền

Cấp quyền Khi dùng chỉ mở cổng hệ điều hành. Vox.md vẫn chỉ yêu cầu vị trí cho tác vụ Vị trí hiện tại độc lập trên Thanh ghi nhanh hoặc Lộ trình đã bật Sử dụng vị trí hiện tại.

Thiết lập Vị trí hiện tại cho một lộ trình

  1. Mở Lộ trình.iPhone hoặc iPad mở Cài đặt → Lộ trình. Mac mở Cài đặt, chọn Lộ trình.
  2. Sửa lộ trình.Chọn lộ trình cần dùng vị trí gốc. Cài đặt thuộc lộ trình đó, không tác động lộ trình khác.
  3. Mở Vị trí.Bật Sử dụng vị trí hiện tại. Giữ Ghi siêu dữ liệu vị trí tắt cho chỉ token.
  4. Chọn độ chính xác.Dùng Chính xác cho vị trí gốc hoặc Thành phố cho tọa độ làm tròn hai chữ số thập phân, không có nhãn điểm quan tâm.
  5. Chọn hành vi không sẵn.Hỏi, Gửi không vị trí hoặc Hủy ghi quyết định khi không lấy được vị trí gốc.
  6. Thêm {location} nếu muốn.Đặt token trong mẫu mục, tiền tố hoặc hậu tố tùy chỉnh, hay mẫu Markdown kho.

Lần sử dụng đầu tiên có thể hiện hộp thoại xin quyền vị trí của hệ điều hành. Nếu trước đó đã từ chối, hãy bật quyền truy cập vị trí cho Vox.md trong cài đặt hệ thống iOS, iPadOS hoặc macOS.

Chọn phạm vi vị trí nhỏ nhất cần

Kết quả muốn cóSử dụng vị trí hiện tạiGhi siêu dữ liệu vị tríĐền Thờ
Không vị trí lộ trìnhTắtTắtKhông dùng {location}, hoặc hiện rỗng.
Chỉ liên kết bấm đượcBậtTắtThêm {location}. Không ghi trường vị trí.
Chỉ siêu dữ liệuBậtBậtBỏ qua {location}. Chỉ ghi các trường đã cấu hình.
Liên kết và siêu dữ liệuBậtBậtThêm {location} và đặt các trường siêu dữ liệu.

Tắt Sử dụng vị trí hiện tại ngăn cả token và siêu dữ liệu của lộ trình, dù cài định dạng siêu dữ liệu trước vẫn giữ cho sau.

Dùng {location} Không đổi siêu dữ liệu ghi chú

Khi Sử dụng vị trí hiện tại bật và vị trí gốc sẵn, {location} tạo liên kết Markdown Google Maps đã kiểm chứng:

[Location](https://www.google.com/maps/search/?api=1&query=45.501235%2C-73.567890)

Token dùng trong mẫu mục dùng lại, tiền tố hậu tố tùy chỉnh và mẫu Markdown kho. Dùng cùng tọa độ Chính xác hoặc Thành phố đã chọn cho lộ trình.

Ví dụ chỉ token

Với hậu tố như:

Captured from {location}

Vox.md có thể tạo:

Captured from [Location](https://www.google.com/maps/search/?api=1&query=45.501235%2C-73.567890)

Khi Ghi siêu dữ liệu vị trí tắt, liên kết này là nội dung vị trí duy nhất lộ trình thêm. Không có locations: làm tập hợp, không có location.*:: là các trường được ghi.

Sửa một chạm trình soạn

Nếu tiền tố, hậu tố hoặc mẫu mục dùng lại đang có hiệu lực dùng {location} khi lộ trình chọn tắt Vị trí hiện tại, trình soạn giải thích token rỗng, cung cấp Sử dụng vị trí hiện tại cho [Route]. Tác vụ đó bật Vị trí hiện tại cho lộ trình nhưng cố ý giữ Ghi siêu dữ liệu vị trí tắt, để lần Gửi tiếp theo có thể phân giải token mà không thay đổi siêu dữ liệu ghi chú. Tệp mẫu đọc trực tiếp từ kho chỉ được đọc khi gửi, nên nội dung của chúng không thể kích hoạt gợi ý này trong trình soạn; hãy bật Vị trí hiện tại thủ công khi mẫu trong kho dùng token.

Khi token rỗng

{location} thành chuỗi rỗng khi Vị trí hiện tại tắt, không có hoặc ghi tiếp không vị trí. Lưu ý dấu câu và nhãn xung quanh khi tạo dòng mẫu tùy chọn.

Tác vụ Thanh ghi nhanh độc lập

nhanh capture Vị trí hiện tại chèn thẳng liên kết Google Maps một lần vào nháp. Độc lập Lộ trình, không đổi Sử dụng vị trí hiện tại hay Ghi siêu dữ liệu vị trí.

Chỉ ghi trường có cấu trúc khi bạn chọn

Bật Ghi siêu dữ liệu vị trí khi ghi chú cần trường vị trí máy đọc thêm hoặc thay {location} liên kết.

Frontmatter ghi chú

Nối mỗi vị trí vào tập hợp tên locations theo mặc định, khóa bằng ID ghi nhanh. Frontmatter không liên quan có sẵn được giữ nguyên.

Trường mục nội tuyến

Ghi kiểu Dataview location.key:: value thành các dòng bên cạnh mục đã ghi. Không thêm tập hợp frontmatter.

Trường có cấu trúc

Chọn và đổi tên tọa độ, vĩ độ, kinh độ, địa điểm, thành phố, vùng, quốc gia, liên kết nhà cung cấp, geo URI, độ chính xác, thời gian, nguồn và ID.

YAML nâng cao

Dùng mẫu YAML kiểm chứng, giới hạn cho Frontmatter ghi chú. YAML nâng cao không dùng cho trường mục nội tuyến.

Ví dụ frontmatter có cấu trúc

---
title: Field Notes
locations:
  - id: "aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee"
    coordinates: [45.501235, -73.567890]
    place: "Café & Main"
    appleMapsURL: "https://maps.apple.com/?ll=45.501235%2C-73.567890&q=Caf%C3%A9%20%26%20Main"
    timestamp: "2023-11-14T22:13:20.000Z"
    source: "app"
---

Ghi chú liên tục có thể giữ nhiều lần ghi nhanh trong cùng tập hợp. Tính năng gộp vị trí đã tích hợp bảo vệ khi thử lại: lần thử lại có cùng ID ghi nhanh không thể nối cùng vị trí hai lần. Nếu khóa tập hợp đã chọn chứa giá trị không tương thích do người dùng viết, Vox.md sẽ dừng thay vì ghi đè giá trị đó.

Ví dụ mục nội tuyến

location.id:: aaaaaaaa-bbbb-cccc-dddd-eeeeeeeeeeee
location.coordinates:: [45.501235, -73.567890]
location.place:: "Café & Main"

Captured text

Chỗ giữ YAML nâng cao

Mẫu nâng cao có thể dùng các mã giữ chỗ như {{coordinates}}, {{latitude}}, {{longitude}}, {{place}}, {{city}}, {{region}}, {{country}}, {{appleMapsURL}}, {{googleMapsURL}}, {{openStreetMapURL}}, {{geoURI}}, {{accuracy}}, {{timestamp}}, {{source}}, và {{id}}. Xem trước cấu hình trong cài đặt lộ trình trước khi lưu.

Chính xác và Thành phố dùng cùng ảnh vị trí nhất quán

Độ chính xácTọa độNhãnLiên kết và trường
Chính xácGiữ vị trí gốc với sáu chữ số thập phân hiển thị.Có thể kèm nhãn điểm quan tâm khi trường chọn cần.Mọi giá trị dẫn xuất dùng tọa độ Chính xác.
Thành phốLàm tròn vĩ độ và kinh độ hai chữ số thập phân trước khi giữ vị trí.Bỏ nhãn điểm quan tâm; thành phố, vùng và nước có thể còn.Mọi URL nhà cung cấp, geo URI, token và trường dùng tọa độ làm tròn.

Bộ mã hóa địa lý ngược của hệ thống Apple chỉ được dùng khi bật Ghi siêu dữ liệu vị trí và một trường có cấu trúc đã chọn hoặc mã giữ chỗ nâng cao cần địa điểm, thành phố, vùng hoặc quốc gia. Lộ trình chỉ dùng token bỏ qua tra cứu này. Nếu tra cứu nhãn thất bại, đầu ra dựa trên tọa độ vẫn khả dụng.

Ảnh vị trí thuộc nguồn ghi

Vị trí hiện tại được xác định tại thời điểm nguồn tạo ghi nhanh. Thử lại và khôi phục dùng lại kết quả được lưu bền vững đó, không âm thầm lấy vị trí mới.

Nguồn ghi nhanhThời điểm lấy vị trí
nhanh capture trên iPhone và iPadGửi
Bảng chia sẻGửi trong phần chia sẻ
Intent chữ, liên kết và tệp vào hàng trực tiếpGọi intent
Shortcuts, tiện ích, điều khiển, liên kết sâu mở nhanh captureGửi trong trình soạn
Shortcut, tiện ích, điều khiển, giọng nói tức thì và ghi lộ trình bàn phímDừng ghi âm
Gửi ghi bình thường Apple WatchDừng ghi trên Watch; iPhone không thay bằng vị trí của mình
Ghi nhanh MacGửi, hoặc dừng ghi để gửi giọng nói ngay

Watch Chỉ ghi âm xuất âm thanh M4A thô vào Files không có phần Markdown, nên không xin vị trí dù lộ trình dùng Vị trí hiện tại cho cách khác.

Chọn cách mỗi lộ trình xử lý vị trí không có

  • Hỏi: ghi tương tác có thể thử lại, hủy, gửi một lần không vị trí hoặc chọn Luôn gửi không vị trí cho lộ trình.
  • Gửi không vị trí: tiếp tục gửi mà không có giá trị token hoặc đầu ra siêu dữ liệu.
  • Hủy ghi nhanh: dừng gửi thay vì tạo ghi chú không có vị trí gốc yêu cầu.
  • Đặt lại lựa chọn lưu: dùng Đặt lại lựa chọn vị trí không khả dụng trong cài đặt Vị trí lộ trình.

Yêu cầu Hỏi không giám sát giữ kết quả không khả dụng tại gốc cho xem sau. Thử mục chờ hoặc lỗi không thay vị trí sau. Công việc chờ chỉ giữ ảnh vị trí chỉnh riêng tư hoặc kết quả không sẵn cần khôi phục cục bộ.

Nâng cấp giữ hành vi siêu dữ liệu cũ

Tách lấy dữ liệu và xuất an toàn khi chuyển đổi:

  • Lộ trình mới: Sử dụng vị trí hiện tại và Ghi siêu dữ liệu vị trí đều bắt đầu tắt.
  • Lộ trình vị trí đã bật trước: cả hai vẫn bật sau nâng cấp, giữ siêu dữ liệu đã ghi.
  • Lộ trình vị trí từng tắt: cả hai vẫn tắt; nâng cấp không tạo đầu ra siêu dữ liệu mới.

Để đổi lộ trình ghi siêu dữ liệu thành chỉ token, giữ Sử dụng vị trí hiện tại bật, tắt Ghi siêu dữ liệu vị trí. Markdown cũ không viết lại hay xóa.

Một lần lấy rõ ràng, không theo dõi nền

  • Vox.md không theo dõi vị trí liên tục hay nền.
  • Vị trí không gửi đến máy chủ Vox.md, phân tích, quảng cáo hay dịch vụ AI bên thứ ba.
  • URL token và nhà cung cấp định dạng cục bộ. Apple Maps, Google Maps hoặc OpenStreetMap chỉ nhận tọa độ khi mở liên kết của họ.
  • Bộ mã hóa địa lý ngược hệ thống Apple có thể gọi mạng chỉ khi siêu dữ liệu chọn cần nhãn địa điểm. Vị trí chỉ token bỏ truy vấn này.
  • Sau khi gửi thành công, các yêu cầu có thể khôi phục được rút gọn thành biên nhận không chứa nội dung; lịch sử ghi nhanh đã hoàn tất không giữ tọa độ, nhãn, URL nhà cung cấp hoặc mẫu vị trí.
  • Nếu siêu dữ liệu vị trí hoặc liên kết từ token được ghi vào Markdown, nó trở thành một phần của tệp bạn đã chọn. Nhà cung cấp đồng bộ tệp của bạn có thể xử lý tệp đó theo các điều khoản riêng của họ.
Quyền vẫn bật, lộ trình vẫn riêng tư

Giữ quyền hệ thống cho Vị trí hiện tại độc lập và vẫn tắt Sử dụng vị trí hiện tại trên mỗi Lộ trình được.

Xem Chính sách bảo mật để biết đầy đủ xử lý và lưu dữ liệu.

Sửa lỗi vị trí và mẫu thường gặp

{location} hiện rỗng

Xác nhận mẫu mục, tiền tố, hậu tố hay mẫu kho có hiệu lực dùng đúng token chữ thường {location}. Sau đó bật Sử dụng vị trí hiện tại cho lộ trình gửi. Nút sửa một chạm trong trình soạn có thể bật tính năng này khi phát hiện định dạng mục nội tuyến, mà không bật siêu dữ liệu; tệp mẫu đọc trực tiếp từ kho cần thiết lập lộ trình thủ công. Nếu quyền bị từ chối hoặc không có tùy chọn sửa một chạm, hãy xem lại hành vi khi không lấy được vị trí của lộ trình và cài đặt vị trí hệ thống.

Liên kết hoạt động, không siêu dữ liệu

Đúng như dự kiến với chỉ token. Mở cài đặt Vị trí lộ trình, bật Ghi siêu dữ liệu vị trí, chọn Frontmatter ghi chú hoặc Trường mục nội tuyến và trường cần.

Siêu dữ liệu có nhưng mục không có liên kết

Xuất siêu dữ liệu không tự chèn liên kết. Thêm {location} vào định dạng mục hiệu lực hoặc mẫu Markdown kho.

Thiếu địa điểm hoặc thành phố

Xác nhận chọn trường nhãn. Tra cứu ngược Apple có thể lỗi dù còn tọa độ. Độ chính xác Thành phố cố ý bỏ nhãn điểm quan tâm.

Gửi frontmatter báo xung đột

Khóa tập hợp cấu hình, locations theo mặc định, phải là danh sách vị trí tương thích. Đổi tên tập hợp trong lộ trình hoặc sửa frontmatter người dùng đã viết. Vox.md không ghi đè giá trị không tương thích.

Lần thử lại có vị trí cũ hoặc không có vị trí

Có chủ ý. Yêu cầu giữ kết quả tại gốc để lần thử sau không âm thầm nhận vị trí ghi khác. Bắt đầu ghi mới khi cần vị trí mới.

Đã cấp quyền vị trí nhưng lộ trình không yêu cầu

Quyền hệ thống chỉ là cổng. Sửa Lộ trình đó và bật Sử dụng vị trí hiện tại. Chỉ cấp quyền không tự bật cho lộ trình.