OpenClawDocs
View as MarkdownView this page as plain textOpen in ChatGPTAsk questions about this pageOpen in ClaudeAsk questions about this page

Nodes and media

Konum komutu

Kısaca

  • location.get, node.invoke veya openclaw nodes location get aracılığıyla çağrılan bir Node komutudur.
  • Varsayılan olarak kapalıdır.
  • Android üçüncü taraf derlemeleri bir seçici kullanır: Kapalı / Kullanırken / Her Zaman. Play derlemelerinde Kapalı / Kullanırken seçenekleri bulunmaya devam eder.
  • Hassas Konum ayrı bir açma/kapama seçeneğidir.

Neden yalnızca anahtar değil de seçici kullanılıyor?

İşletim sistemi konum izinleri birden çok düzeye sahiptir. Hassas konum da ayrı bir işletim sistemi iznidir (iOS 14+ sürümlerinde "Hassas", Android'de "ince" ve "kaba"). Uygulama içi seçici, istenen modu belirler ancak verilecek gerçek izne yine işletim sistemi karar verir.

Ayarlar modeli

Her Node cihazı için:

  • location.enabledMode: off | whileUsing | always
  • location.preciseEnabled: bool

Kullanıcı arayüzü davranışı:

  • whileUsing seçildiğinde ön plan izni istenir.
  • Android üçüncü taraf derlemesinde always seçildiğinde önce ön plan izni istenir, arka plan erişimi açıklanır ve ardından ayrı Allow all the time izni için Android uygulama ayarları açılır.
  • Android Play derlemeleri arka planda konum iznini bildirmez veya always seçeneğini göstermez.
  • İşletim sistemi istenen düzeyi reddederse uygulama, izin verilen en yüksek düzeye geri döner ve durumu gösterir.

İzin eşlemesi (node.permissions)

İsteğe bağlıdır. macOS Node'u, node.list/node.describe üzerindeki permissions eşlemesi aracılığıyla location değerini bildirir; iOS/Android bunu atlayabilir.

Komut: location.get

node.invoke veya CLI yardımcısı aracılığıyla çağrılır:

bash
openclaw nodes location get --node <idOrNameOrIp>openclaw nodes location get --node <idOrNameOrIp> --accuracy precise --max-age 15000 --location-timeout 10000

Parametreler:

json
{  "timeoutMs": 10000,  "maxAgeMs": 15000,  "desiredAccuracy": "coarse|balanced|precise"}

CLI bayrakları doğrudan eşlenir: --location-timeout -> timeoutMs, --max-age -> maxAgeMs, --accuracy -> desiredAccuracy.

Yanıt yükü:

json
{  "lat": 48.20849,  "lon": 16.37208,  "accuracyMeters": 12.5,  "altitudeMeters": 182.0,  "speedMps": 0.0,  "headingDeg": 270.0,  "timestamp": "2026-01-03T12:34:56.000Z",  "isPrecise": true,  "source": "gps|wifi|cell|unknown"}

Hatalar (kararlı kodlar):

  • LOCATION_DISABLED: seçici kapalıdır.
  • LOCATION_PERMISSION_REQUIRED: istenen mod için gerekli izin eksiktir.
  • LOCATION_BACKGROUND_UNAVAILABLE: uygulama arka plandadır ancak yalnızca Kullanırken izni verilmiştir.
  • LOCATION_TIMEOUT: zamanında konum belirlenemedi.
  • LOCATION_UNAVAILABLE: sistem hatası oluştu veya kullanılabilir sağlayıcı yok.

Arka plan davranışı

  • Android üçüncü taraf derlemeleri, arka plandaki location.get çağrısını yalnızca kullanıcı Always seçeneğini belirlediğinde ve Android arka planda konum izni verdiğinde kabul eder. Mevcut kalıcı Node hizmeti, location hizmet türünü ekler ve etkinken Location: Always ifadesini gösterir.
  • Android Play derlemeleri ve While Using modu, uygulama arka plandayken location.get çağrısını reddeder.
  • Diğer Node platformlarında davranış farklı olabilir.

Model/araç entegrasyonu

  • Aracı aracı: nodes aracının location_get eylemi (Node gereklidir).
  • CLI: openclaw nodes location get --node <id>.
  • Aracı yönergeleri: yalnızca kullanıcı konumu etkinleştirmiş ve kapsamını anlamışsa çağırın.

Kullanıcı deneyimi metni (önerilen)

  • Kapalı: "Konum paylaşımı devre dışı."
  • Kullanırken: "Yalnızca OpenClaw açıkken."
  • Her Zaman: "OpenClaw arka plandayken istenen konum denetimlerine izin ver."
  • Hassas: "Hassas GPS konumunu kullan. Yaklaşık konum paylaşmak için kapatın."

İlgili

Was this useful?
On this page

On this page