Documentazione · Percorsi

Località attuale, {location}, e Metadati

Usa una posizione d’origine nel formato della voce senza aggiungere automaticamente YAML o campi inline. Acquisizione della posizione e metadati sono scelte esplicite separate per ogni Percorso.

Aggiornato il 21 agosto 2026 Acquisizione singola Nessun tracciamento in background Guida completa funzioni

Acquisire la posizione non implica metadati

Ogni Percorso ha due controlli di posizione separati. Usa posizione corrente decide se il percorso richiede una posizione al momento d’origine. Scrivi metadati sulla posizione decide se l’istantanea è scritta anche come metadati iniziali o inline.

ControlloCosa significaCosa non significa
Permesso di posizione del sistemaConsente a Vox.md di richiedere la posizione mentre usi l’app o una superficie di acquisizione supportata.Non attiva la posizione per alcun Percorso.
Usa posizione correnteRichiede una posizione per questo percorso e la rende disponibile a {location}.Non scrive automaticamente YAML o metadati inline.
Scrivi metadati sulla posizioneScrive i campi strutturati selezionati o YAML avanzato validato dall’istantanea acquisita.Non controlla se {location} può generare.
L’intenzione è nel percorso, non nel permesso

Concedere il permesso Durante l’uso apre soltanto l’accesso del sistema operativo. Vox.md richiede comunque la posizione solo per l’azione indipendente Località attuale della Barra di acquisizione o per un Percorso in cui hai attivato Usa posizione corrente.

Configura Località attuale per un percorso

  1. Apri Percorsi.Su iPhone/iPad apri Impostazioni → Percorsi. Su Mac apri Impostazioni e Percorsi.
  2. Modifica il percorso.Scegli il percorso che usa la posizione d’origine. L’impostazione è solo sua e non influenza gli altri.
  3. Apri Posizione.Attiva Usa posizione corrente. Mantieni Scrivi metadati sulla posizione spento per il solo token.
  4. Scegli la precisione.Usa Esatto per la posizione d’origine o Città per coordinate arrotondate a due decimali senza etichetta di punto d’interesse.
  5. Scegli il comportamento se assente.Chiedi, Invia senza posizione o Annulla acquisizione decide cosa succede se manca la posizione d’origine.
  6. Aggiungi {location} se desiderato.Metti il token in un modello di voce, prefisso o suffisso o modello Markdown del vault.

Al primo uso può apparire il permesso posizione. Se negato prima, abilitalo per Vox.md nelle impostazioni iOS, iPadOS o macOS.

Scegli i minimi dati di posizione necessari

Risultato desideratoUsa posizione correnteScrivi metadati sulla posizioneTemplate
Nessuna posizione del percorsoDisattivatoDisattivatoNon usare {location}, oppure resta vuoto.
Solo link cliccabileAttivoDisattivatoAggiungi {location}. Non vengono scritti campi di posizione.
Solo metadatiAttivoAttivoOmetti {location}. Vengono scritti solo i campi configurati.
Link e metadatiAttivoAttivoAggiungi {location} e configura i metadati.

Spegnere Usa posizione corrente impedisce token e metadati, anche se le vecchie scelte di formato restano configurate per dopo.

Usa {location} Senza modificare i metadati della nota

Con Usa posizione corrente e istantanea d’origine disponibile, {location} genera un link Markdown Google Maps validato:

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

Il token funziona in modelli riutilizzabili, prefissi e suffissi e Markdown del vault. Usa le stesse coordinate Esatto o Città scelte per il percorso.

Esempio con solo token

Per un suffisso come:

Captured from {location}

Vox.md può produrre:

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

Con Scrivi metadati sulla posizione spento, il link è l’unico dato di posizione aggiunto. Nessuna raccolta locations: né campi location.*:: vengono scritti.

Correzione con un tocco nell’editor

Se prefisso, suffisso o modello di voce riutilizzabile effettivo usa {location} con Località attuale spenta, l’editor spiega il token vuoto e propone Usa posizione corrente per [Route]. Attiva la posizione del percorso lasciando spenti i metadati, così il prossimo invio risolve il token senza cambiarli. I file modello del vault sono letti solo all’invio e non attivano il suggerimento: attiva manualmente la posizione se usano il token.

Quando il token è vuoto

{location} diventa stringa vuota se la posizione è spenta, indisponibile o l’acquisizione continua senza. Considera punteggiatura ed etichette attorno alle righe facoltative.

Azione indipendente della Barra

L’acquisizione rapida Località attuale inserisce direttamente un link Google Maps singolo nella bozza. È indipendente dai Percorsi e non cambia i due controlli di posizione.

Scrivi campi strutturati solo quando lo scegli

Attiva Scrivi metadati sulla posizione per campi leggibili dalle macchine oltre o al posto del {location} come link.

Metadati iniziali della nota

Aggiunge ogni posizione a una raccolta chiamata locations per impostazione predefinita, con ID acquisizione come chiave. I metadati iniziali esistenti non correlati sono preservati.

Campi inline delle voci

Scrive campi in stile Dataview location.key:: value accanto alla voce acquisita. Non viene aggiunta una raccolta di metadati iniziali.

Campi strutturati

Seleziona e rinomina coordinate, latitudine, longitudine, luogo, città, regione, paese, link dei provider, URI geo, precisione, orario, origine e ID.

YAML avanzato

Usa un modello YAML validato e limitato per i metadati iniziali della nota. YAML avanzato non è disponibile per i campi inline delle singole voci.

Esempio di metadati iniziali strutturati

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

Le note periodiche possono conservare più acquisizioni nella raccolta. La protezione dai nuovi tentativi è integrata nell’unione delle posizioni: un nuovo tentativo con lo stesso ID dell’acquisizione non può aggiungere la stessa posizione due volte. Se la chiave della raccolta scelta contiene già un valore incompatibile scritto dall’utente, Vox.md si ferma invece di sovrascriverlo.

Esempio di voce inline

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

Captured text

Segnaposto YAML avanzati

I modelli avanzati usano segnaposto come {{coordinates}}, {{latitude}}, {{longitude}}, {{place}}, {{city}}, {{region}}, {{country}}, {{appleMapsURL}}, {{googleMapsURL}}, {{openStreetMapURL}}, {{geoURI}}, {{accuracy}}, {{timestamp}}, {{source}}, e {{id}}. Controlla l’anteprima nelle impostazioni del percorso prima di salvare.

Esatto e Città usano un’istantanea coerente

PrecisioneCoordinateEtichetteLink e campi
EsattoMantiene la posizione d’origine con sei decimali visibili.Può includere punti d’interesse se un campo li richiede.Ogni valore derivato usa le coordinate Esatto.
CittàArrotonda latitudine e longitudine a due decimali prima di conservare l’istantanea.Rimuove punti d’interesse; città, regione e paese possono restare.Ogni URL provider, URI geo, token e campo usa le coordinate arrotondate.

Il geocoder inverso di sistema Apple si usa solo quando Scrivi metadati sulla posizione è attivo e un campo strutturato selezionato o un segnaposto avanzato richiede luogo, città, regione o paese. Il solo token evita la ricerca. Se il luogo manca, restano le coordinate.

L’istantanea appartiene all’origine

Località attuale viene valutata nel punto d’origine dell’acquisizione. Nuovi tentativi e recupero riutilizzano quel risultato persistente invece di ottenere silenziosamente una posizione più recente.

Fonte di acquisizionePunto di acquisizione
Acquisizione rapida iPhone e iPadinviare
Foglio di condivisioneInvio nell’estensione condivisione
Intent testo, link e file in coda direttaInvocazione intent
Comandi, widget, controlli e link che aprono Rapida catturaInvio nell’editor
Comando, widget, controllo, voce immediata e percorso dalla tastieraArresto della registrazione
Invio normale Apple WatchArresto della registrazione su Watch; iPhone non sostituisce la propria posizione
Acquisizione MacInvio, o arresto della registrazione per l’invio vocale immediato

Watch Solo registrazione esporta audio M4A grezzo in File senza Markdown: non richiede posizione anche se il percorso la usa altrove.

Scegli come ogni Percorso gestisce una posizione assente

  • Chiedi: le acquisizioni interattive possono riprovare, annullare, inviare una volta senza posizione o scegliere Invia sempre senza posizione per quel percorso.
  • Invia senza posizione: continua senza valore token o metadati.
  • Annulla acquisizione: ferma l’invio invece di creare una nota senza la posizione d’origine richiesta.
  • Reimposta una scelta salvata: usa Reimposta scelta posizione non disponibile nelle impostazioni del percorso.

Una richiesta Chiedi senza supervisione conserva il risultato non disponibile al momento dell’origine per una revisione successiva. Riprovare un’acquisizione in coda o fallita non sostituisce mai quel risultato con una posizione successiva. Il lavoro pendente conserva solo l’istantanea adeguata alla privacy o l’esito non disponibile necessari al recupero locale.

Gli aggiornamenti preservano il comportamento precedente dei metadati

Separare acquisizione e output rende sicura la migrazione:

  • Nuovi percorsi: Usa posizione corrente e Scrivi metadati sulla posizione partono spenti.
  • Percorsi con posizione già attivata: entrambi restano attivi dopo aggiornamento, preservando i metadati già scritti.
  • Percorsi con posizione già spenta: entrambi i controlli restano spenti; l’aggiornamento non aggiunge metadati nuovi.

Per convertire un percorso da metadati a solo token, mantieni Usa posizione corrente e disattiva Scrivi metadati sulla posizione. Il Markdown esistente non cambia.

Un’istantanea esplicita, mai tracciamento in background

  • Vox.md non monitora continuamente né traccia in background.
  • La posizione non viene inviata ai server Vox.md, a sistemi di analisi o pubblicitari né a servizi IA di terzi.
  • Gli URL di token e provider vengono formattati localmente. Apple Maps, Google Maps o OpenStreetMap riceve le coordinate solo all’apertura del link.
  • Il geocoder inverso di sistema Apple può effettuare una richiesta di rete solo quando i metadati selezionati richiedono un’etichetta del luogo. Con solo token la ricerca è omessa.
  • Dopo successo, le richieste diventano ricevute senza contenuto e la cronologia non conserva coordinate, etichette, URL provider o modelli posizione.
  • Metadati o link scritti in Markdown diventano parte del file scelto. Il provider può elaborarlo secondo i termini.
Il permesso può restare attivo mentre i percorsi restano privati

Puoi tenere il permesso per Località attuale indipendente e Usa posizione corrente spento in tutti i Percorsi.

Consulta la Informativa sulla privacy per dettagli completi su gestione e conservazione dati.

Risolvi problemi comuni di posizione e modelli

{location} resta vuoto

Verifica che modello, prefisso, suffisso o template effettivo usi esattamente il token minuscolo {location}. Poi attiva Usa posizione corrente per il percorso d’invio. La correzione con un tocco nell’editor può farlo per la formattazione inline delle voci rilevata, senza attivare i metadati; i file modello attivi del vault richiedono la configurazione manuale del percorso. Se il permesso è negato o la posizione non è disponibile, controlla il comportamento del percorso in assenza di posizione e le impostazioni di localizzazione del sistema.

Il link funziona, ma nessun metadato

È previsto con solo token. Apri Posizione del percorso, attiva Scrivi metadati sulla posizione, scegli metadati iniziali o campi inline e seleziona i campi.

Compaiono metadati, ma nessun link nella voce

I metadati non inseriscono link automaticamente. Aggiungi {location} al formato effettivo o modello Markdown del vault.

Manca luogo o città

Verifica il campo etichetta selezionato. Il geocoder Apple può fallire mentre restano le coordinate. Città elimina intenzionalmente i punti d’interesse.

L’invio dei metadati iniziali segnala un conflitto

La chiave di raccolta configurata, locations per default, deve essere una lista di posizioni compatibile. Rinomina la raccolta o adatta i metadati esistenti. Vox.md non sovrascrive valori incompatibili.

Un nuovo tentativo ha una posizione vecchia o non disponibile

È intenzionale. La richiesta conserva l’origine per non attribuire silenziosamente una nuova posizione a un tentativo successivo. Crea una nuova acquisizione per una nuova istantanea.

Il permesso di posizione è concesso, ma il percorso non la richiede

Il permesso di sistema è solo una porta d’accesso. Modifica il Percorso e attiva Usa posizione corrente. Il solo permesso non attiva mai un percorso.