Dokumentacja · Trasy

Bieżąca lokalizacja, {location}, i metadane

Użyj jednej pierwotnej lokalizacji w formatowaniu bez automatycznego YAML czy pól liniowych. Pobieranie pozycji i metadane to osobne, jawne decyzje na każdej trasie.

Aktualizacja 21 sierpnia 2026 Jednorazowe pobranie Bez śledzenia w tle Pełny poradnik funkcji

Pobranie lokalizacji nie oznacza zapisu metadanych

Każda trasa ma dwie osobne opcje lokalizacji. Użyj bieżącej lokalizacji określa żądanie jednej lokalizacji z chwili powstania. Zapisuj metadane lokalizacji określa, czy migawka trafi także do frontmatter lub pól wpisu.

KontrolkaCo to znaczyCzego to nie oznacza
Systemowe uprawnienie lokalizacjiPozwala Vox.md żądać lokalizacji przy użyciu aplikacji lub obsługiwanego interfejsu.Nie włącza lokalizacji żadnej trasy.
Użyj bieżącej lokalizacjiŻąda jednej lokalizacji trasy i udostępnia ją dla {location}.Nie zapisuje automatycznie YAML lub pól liniowych.
Zapisuj metadane lokalizacjiZapisuje wybrane pola strukturalne lub poprawny zaawansowany YAML z pobranej migawki.Nie określa, czy {location} może wyświetlić.
Intencję sygnalizuje trasa, nie zgoda

Uprawnienie „Podczas używania” jedynie otwiera dostęp na poziomie systemu operacyjnego. Vox.md nadal żąda lokalizacji tylko dla niezależnego działania „Aktualna lokalizacja” na pasku przechwytywania lub dla trasy, na której włączono „Użyj bieżącej lokalizacji”.

Ustaw lokalizację dla jednej trasy

  1. Otwórz trasy.Na iPhone lub iPad otwórz Ustawienia → Trasy. Na Mac wybierz Trasy w ustawieniach.
  2. Edytuj trasę.Wybierz trasę używającą pierwotnej pozycji. Ustawienie należy do niej i nie dotyka innych.
  3. Otwórz lokalizację.Włącz Użyj bieżącej lokalizacji. Zostaw Zapisuj metadane lokalizacji wyłączone dla samego tokena.
  4. Wybierz precyzję.Użyj „Dokładne” dla pierwotnych współrzędnych lub „Miasto” dla zaokrąglenia do dwóch miejsc bez nazwy obiektu.
  5. Wybierz reakcję na niedostępność.Zapytaj, wyślij bez lokalizacji lub anuluj określa reakcję na brak pierwotnej pozycji.
  6. Dodaj {location} jeśli chcesz.Umieść token w szablonie wpisu, prefiksie, sufiksie lub szablonie Markdown skarbca.

Przy pierwszym użyciu system operacyjny może wyświetlić prośbę o uprawnienie lokalizacji. Jeśli wcześniej odmówiono, włącz dostęp Vox.md do lokalizacji w ustawieniach systemowych iOS, iPadOS lub macOS.

Wybierz najmniejszy potrzebny zakres lokalizacji

Oczekiwany wynikUżyj bieżącej lokalizacjiZapisuj metadane lokalizacjiŚwiątynia
Bez lokalizacji trasyWyłączoneWyłączoneNie używaj {location}, inaczej jest pusty.
Tylko klikalny linkWł.WyłączoneDodaj {location}. Pola lokalizacji nie są zapisywane.
Tylko metadaneWł.Wł.Pomiń {location}. Zapisuje tylko skonfigurowane pola.
Link i metadaneWł.Wł.Dodaj {location} i skonfiguruj pola metadanych.

Wyłączenie lokalizacji blokuje token i metadane trasy nawet przy zachowanych wcześniejszych formatach na przyszłość.

Użyj {location} Bez zmiany metadanych notatki

Przy włączonej pozycji i dostępnej pierwotnej migawce {location} tworzy poprawny link Markdown Google Maps:

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

Token działa w wielokrotnych szablonach wpisu, własnych prefiksach i sufiksach wpisów oraz szablonach Markdown skarbca. Używa tych samych współrzędnych „Dokładne” lub „Miasto”, które wybrano dla trasy.

Przykład samego tokena

Dla sufiksu, np.:

Captured from {location}

Vox.md może tworzyć:

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

Bez zapisu metadanych ten link jest jedyną lokalizacją dodaną przez trasę. Bez locations: kolekcji ani location.*:: pola są zapisywane.

Naprawa jednym stuknięciem

Jeśli aktywny prefiks, sufiks lub szablon wpisu używa {location} gdy bieżąca lokalizacja wybranej trasy jest wyłączona, edytor wyjaśnia, że token zostanie wyświetlony jako pusty, i proponuje Użyj bieżącej lokalizacji dla [Route]. To działanie włącza bieżącą lokalizację trasy, celowo pozostawiając zapis metadanych lokalizacji wyłączony, aby następne wysłanie mogło rozwinąć token bez zmiany metadanych notatki. Aktualne pliki szablonów skarbca są odczytywane dopiero podczas dostawy, więc ich treść nie może wywołać tej wskazówki w edytorze; włącz bieżącą lokalizację ręcznie, gdy szablon skarbca używa tokena.

Gdy token jest pusty

{location} staje się pustym ciągiem znaków, gdy bieżąca lokalizacja jest wyłączona, niedostępna lub przechwytywanie jest kontynuowane bez niej. Projektując opcjonalne wiersze szablonu, uwzględnij otaczającą interpunkcję i etykiety.

Niezależne działanie paska

Szybki zapis Aktualna lokalizacja bezpośrednio wstawia jednorazowy link Google Maps do bieżącej wersji roboczej. Działa niezależnie od tras i nie zmienia ani „Użyj bieżącej lokalizacji”, ani „Zapisuj metadane lokalizacji”.

Zapisuj pola strukturalne tylko z własnego wyboru

Włącz metadane pozycji dla maszynowo czytelnych pól obok lub zamiast {location} odnośnik.

Frontmatter notatki

Dopisuje każdą pozycję do kolekcji o nazwie locations domyślnie, według ID przechwycenia. Pozostałe istniejące frontmatter zostają.

Pola liniowe wpisu

Zapisuje w stylu Dataview location.key:: value wiersze obok wpisu. Nie dodaje kolekcji frontmatter.

Pola strukturalne

Wybieraj i zmieniaj nazwy współrzędnych, szerokości, długości, miejsca, miasta, regionu, kraju, linków dostawców, geo URI, dokładności, czasu, źródła i ID.

Zaawansowany YAML

Używa sprawdzonego szablonu YAML z ograniczeniami dla frontmatter notatki. Zaawansowany YAML nie jest dostępny dla liniowych pól wpisu.

Przykład strukturalnego frontmatter

---
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"
---

Notatki okresowe trzymają wiele przechwyceń w kolekcji. Ochrona jest w scalaniu pozycji: ten sam ID nie doda jej dwukrotnie. Przy niezgodnej własnej wartości klucza Vox.md zatrzymuje, nie nadpisuje.

Przykład pól liniowych wpisu

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

Captured text

Symbole zaawansowanego YAML

Zaawansowane szablony używają symboli zastępczych, np. {{coordinates}}, {{latitude}}, {{longitude}}, {{place}}, {{city}}, {{region}}, {{country}}, {{appleMapsURL}}, {{googleMapsURL}}, {{openStreetMapURL}}, {{geoURI}}, {{accuracy}}, {{timestamp}}, {{source}}, i {{id}}. Przed zapisem sprawdź podgląd w ustawieniach trasy.

Dokładne i Miasto używają jednej spójnej migawki

PrecyzjaWspółrzędneEtykietyLinki i pola
DokładneZachowuje pierwotną pozycję z sześcioma wyświetlanymi miejscami dziesiętnymi.Może zawierać nazwę obiektu, gdy potrzebna w polu.Każda wartość pochodna używa dokładnych współrzędnych.
MiastoZaokrągla szerokość i długość do dwóch miejsc przed zachowaniem migawki.Usuwa nazwy obiektów; miasto, region i kraj mogą zostać.Każdy URL dostawcy, geo URI, token i pole używa zaokrąglonych współrzędnych.

Systemowy geokoder odwrotny Apple jest używany tylko przy włączonym zapisie metadanych lokalizacji, gdy wybrane pole strukturalne lub zaawansowany symbol zastępczy potrzebuje miejsca, miasta, regionu lub kraju. Trasa z samym tokenem pomija geokodowanie odwrotne. Jeśli wyszukiwanie etykiety się nie powiedzie, wynik oparty na współrzędnych pozostaje dostępny.

Migawka należy do źródła zapisu

Bieżąca lokalizacja jest ustalana w chwili powstania przechwycenia. Ponowienie i odzyskiwanie używają tego trwałego wyniku zamiast potajemnie pobierać nowszą lokalizację.

Źródło przechwyceniaMoment pobrania
Szybki zapis iPhone i iPadWyślij
Arkusz udostępnianiaWyślij w udostępnianiu
Bezpośrednie intencje tekstu, linku i pliku do kolejkiWywołanie intencji
Skróty, widżety, kontrolki i głębokie linki otwierające edytorWysłanie w edytorze
Skrót, widżet, kontrolka, natychmiastowy głos i klawiaturowa trasaZatrzymanie nagrania
Zwykła dostawa Apple WatchZatrzymanie nagrania na zegarku; iPhone nie podstawia własnej lokalizacji
Zapis MacWysłanie lub zatrzymanie nagrania przy natychmiastowym głosie

Tylko nagranie zegarka eksportuje surowe audio M4A do Plików bez zapisu w Markdown, więc nie żąda lokalizacji nawet wtedy, gdy trasa poza tym używa bieżącej lokalizacji.

Wybierz reakcję każdej trasy na brak pozycji

  • Zapytaj: interaktywne przechwycenia mogą ponowić, anulować, raz wysłać bez lokalizacji lub wybrać zawsze bez niej dla trasy.
  • Wyślij bez lokalizacji: kontynuuje dostawę bez wartości tokena i metadanych.
  • Anuluj przechwycenie: zatrzymuje dostawę zamiast notatki bez żądanej pierwotnej pozycji.
  • Zresetuj wybór: zresetuj wybór niedostępności w lokalizacji trasy.

Żądanie Zapytaj bez nadzoru zachowuje pierwotną niedostępność do przeglądu. Ponowienie kolejki lub błędu nie podstawia późniejszej pozycji. Czekająca praca trzyma tylko prywatną migawkę lub niedostępność potrzebną do lokalnego odzyskania.

Aktualizacje zachowują dotychczasowe metadane

Podział pobierania i zapisu jest bezpieczny przy migracji:

  • Nowe trasy: Użycie lokalizacji i zapis metadanych początkowo wyłączone.
  • Trasy z wcześniej włączoną lokalizacją: obie opcje zostają włączone po aktualizacji dla dotychczasowych metadanych.
  • Wcześniej wyłączone trasy lokalizacji: obie opcje zostają wyłączone; aktualizacja nie dodaje nowych metadanych.

Aby zmienić istniejącą trasę zapisującą metadane na użycie samego tokena, pozostaw „Użyj bieżącej lokalizacji” włączone, a wyłącz „Zapisuj metadane lokalizacji”. Istniejący Markdown nie jest przepisywany ani usuwany.

Jedna jawna migawka, nigdy śledzenie w tle

  • Vox.md nie śledzi pozycji ciągle ani w tle.
  • Lokalizacja nie trafia na serwery Vox.md, do analityki, reklam ani usług AI innych firm.
  • Tokeny i URL dostawców formatują się lokalnie. Apple Maps, Google Maps lub OpenStreetMap otrzymuje współrzędne dopiero po otwarciu linku.
  • Systemowy geokoder odwrotny Apple może wysłać żądanie sieciowe tylko wtedy, gdy wybrane metadane potrzebują etykiety miejsca. Lokalizacja używana wyłącznie przez token pomija to wyszukiwanie.
  • Po dostawie żądania stają się pokwitowaniami bez treści; historia nie trzyma współrzędnych, etykiet, URL dostawców ani szablonów lokalizacji.
  • Metadane lub token w Markdown stają się częścią pliku. Dostawca synchronizacji może go przetwarzać na swoich warunkach.
Zgoda może zostać włączona, a trasy prywatne

Możesz zostawić zgodę systemu dla niezależnej lokalizacji, a na każdej trasie użycie pozycji wyłączone.

Zobacz Polityka prywatności ze szczegółami obsługi i przechowywania danych.

Napraw lokalizację i szablony

{location} jest pusty

Potwierdź, że faktycznie używany szablon wpisu, prefiks, sufiks lub szablon skarbca zawiera dokładnie ten token zapisany małymi literami {location}. Następnie włącz „Użyj bieżącej lokalizacji” dla trasy dostawy. Naprawa jednym stuknięciem w edytorze może zrobić to dla wykrytego liniowego formatowania wpisu bez włączania metadanych; odczytywane na bieżąco pliki szablonów skarbca wymagają ręcznej konfiguracji trasy. Jeśli uprawnienia odmówiono lub pozycja jest niedostępna, sprawdź zachowanie trasy przy niedostępności i systemowe ustawienia lokalizacji.

Link działa, brak metadanych

To oczekiwane przy konfiguracji używającej tylko tokena. Otwórz ustawienia lokalizacji trasy i włącz „Zapisuj metadane lokalizacji”, następnie wybierz frontmatter notatki lub liniowe pola wpisu i zaznacz żądane pola.

Metadane są, linku we wpisie nie ma

Metadane nie wstawiają linku automatycznie. Dodaj {location} do aktywnego formatu lub szablonu Markdown skarbca.

Brakuje miejsca lub miasta

Sprawdź wybór pola etykiety. Geokoder Apple może zawieść mimo współrzędnych. Miasto celowo usuwa nazwy obiektów.

Dostawa frontmatter zgłasza kolizję

Skonfigurowany klucz kolekcji, locations domyślnie, musi być zgodną listą pozycji. Zmień nazwę kolekcji w trasie lub własny frontmatter. Vox.md nie nadpisze niezgodnej wartości.

Ponowienie ma starszą lub niedostępną lokalizację

Celowe. Żądanie zachowuje pierwotny wynik, by ponowienie nie udawało innego miejsca. Nowa migawka wymaga nowego zapisu.

Lokalizacja dozwolona, ale trasa jej nie żąda

Zgoda systemowa to tylko brama. Edytuj trasę i włącz „Użyj bieżącej lokalizacji”. Samo uprawnienie nigdy nie włącza trasy.