Location အမိန့် (နိုဒ်များ)¶

အကျဉ်းချုပ်¶

• location.get သည် နိုဒ် အမိန့်တစ်ခု ဖြစ်သည် (node.invoke မှတစ်ဆင့်)။
• မူလအနေဖြင့် ပိတ်ထားသည်။
• ဆက်တင်များတွင် ရွေးချယ်ကိရိယာကို အသုံးပြုသည်: Off / While Using / Always။
• သီးခြား toggle: Precise Location။

Selector ကို အသုံးပြုရသည့် အကြောင်းရင်း (switch တစ်ခုတည်း မဟုတ်ခြင်း)¶

23. in-app အတွင်း selector တစ်ခုကို expose လုပ်နိုင်သော်လည်း အမှန်တကယ် grant ကို OS က ဆုံးဖြတ်သည်။ We can expose a selector in-app, but the OS still decides the actual grant.

• iOS/macOS: user can choose While Using or Always in system prompts/Settings. 26. Optional ဖြစ်သည်။
• Android: နောက်ခံ Location သည် သီးခြား ခွင့်ပြုချက်တစ်ခု ဖြစ်သည်; Android 10+ တွင် Settings လုပ်ငန်းစဉ် လိုအပ်တတ်သည်။
• Precise location သည် သီးခြား ခွင့်ပြုချက်တစ်ခု ဖြစ်သည် (iOS 14+ “Precise”, Android “fine” နှင့် “coarse” ခြားနားမှု)။

UI အတွင်း Selector သည် ကျွန်ုပ်တို့ တောင်းဆိုမည့် မုဒ်ကို ညွှန်ပြပေးပြီး အမှန်တကယ် ခွင့်ပြုချက်သည် OS Settings ထဲတွင် တည်ရှိသည်။

Settings မော်ဒယ်¶

နိုဒ် စက်တစ်ခုချင်းစီအလိုက်:

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

UI အပြုအမူ:

• whileUsing ကို ရွေးချယ်ပါက foreground ခွင့်ပြုချက်ကို တောင်းဆိုသည်။
• always ကို ရွေးချယ်ပါက whileUsing ကို ဦးစွာ သေချာစေပြီး၊ ထို့နောက် နောက်ခံ ခွင့်ပြုချက်ကို တောင်းဆိုသည် (လိုအပ်ပါက အသုံးပြုသူကို Settings သို့ ပို့သည်)။
• OS က တောင်းဆိုထားသော အဆင့်ကို ငြင်းပယ်ပါက၊ ခွင့်ပြုထားသည့် အမြင့်ဆုံး အဆင့်သို့ ပြန်လည်သတ်မှတ်ပြီး အခြေအနေကို ပြသသည်။

ခွင့်ပြုချက်များ ကိုက်ညီမှု (node.permissions)¶

27. macOS node သည် permissions map မှတဆင့် location ကို report လုပ်ပြီး iOS/Android တွင် မပါဝင်နိုင်ပါ။ 28. iOS: Always permission နှင့် background location mode လိုအပ်သည်။

အမိန့်: location.get¶

node.invoke မှတစ်ဆင့် ခေါ်ယူသည်။

Params (အကြံပြု):

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

တုံ့ပြန်မှု payload:

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

Errors (တည်ငြိမ်သော ကုဒ်များ):

• LOCATION_DISABLED: selector ပိတ်ထားသည်။
• LOCATION_PERMISSION_REQUIRED: တောင်းဆိုထားသော မုဒ်အတွက် ခွင့်ပြုချက် မရှိပါ။
• LOCATION_BACKGROUND_UNAVAILABLE: အက်ပ်သည် နောက်ခံတွင် ရှိနေပြီး While Using သာ ခွင့်ပြုထားသည်။
• LOCATION_TIMEOUT: သတ်မှတ်ချိန်အတွင်း fix မရပါ။
• LOCATION_UNAVAILABLE: စနစ် ချို့ယွင်းမှု / ပံ့ပိုးသူ မရှိပါ။

နောက်ခံ အပြုအမူ (အနာဂတ်)¶

ရည်မှန်းချက်: နိုဒ်သည် နောက်ခံတွင် ရှိနေသည့်အချိန်တွင်ပါ မော်ဒယ်က Location ကို တောင်းဆိုနိုင်ရန် — အောက်ပါ အခြေအနေများ ပြည့်မီရပါမည်။

• အသုံးပြုသူက Always ကို ရွေးချယ်ထားသည်။
• OS က နောက်ခံ Location ကို ခွင့်ပြုထားသည်။
• အက်ပ်ကို Location အတွက် နောက်ခံတွင် လည်ပတ်ခွင့် ပေးထားသည် (iOS background mode / Android foreground service သို့မဟုတ် အထူး ခွင့်ပြုချက်)။

Push ဖြင့် အစပြုသော လုပ်ငန်းစဉ် (အနာဂတ်):

1. Gateway（ဂိတ်ဝေး） က နိုဒ်သို့ push တစ်ခု ပို့သည် (silent push သို့မဟုတ် FCM data)။
2. နိုဒ်သည် ခဏတာ နိုးထပြီး စက်မှ Location ကို တောင်းဆိုသည်။
3. နိုဒ်က payload ကို Gateway（ဂိတ်ဝေး） သို့ ပြန်လည်ပို့သည်။

မှတ်ချက်များ:

• 29. Silent push ကို throttled လုပ်နိုင်သဖြင့် intermittent failures များကို မျှော်လင့်ပါ။ Silent push may be throttled; expect intermittent failures.
• Android: နောက်ခံ Location အတွက် foreground service လိုအပ်နိုင်သည်; မဟုတ်ပါက ငြင်းပယ်ခံရနိုင်သည်။

မော်ဒယ်/ကိရိယာ ပေါင်းစည်းမှု¶

• Tool surface: nodes tool သည် location_get action ကို ထည့်သွင်းပေးသည် (နိုဒ် လိုအပ်)။
• CLI: openclaw nodes location get --node <id>။
• Agent လမ်းညွှန်ချက်များ: အသုံးပြုသူက Location ကို ဖွင့်ထားပြီး အကျယ်အဝန်းကို နားလည်ထားသောအခါတွင်သာ ခေါ်ယူရန်။

UX စာသား (အကြံပြု)¶

• Off: “Location မျှဝေမှုကို ပိတ်ထားသည်။”
• While Using: “OpenClaw ဖွင့်ထားချိန်တွင်သာ။”
• 31. Requires system permission.” 32. Precise: “Use precise GPS location.
• 33. Toggle off to share approximate location.” 34. OpenClaw သည် reply pipeline မစတင်မီ inbound media (image/audio/video) ကို summarize လုပ်နိုင်သည်။