أمر الموقع

# الخلاصة

• location.get هو أمر عقدة (عبر node.invoke).
• معطّل افتراضيًا.
• تستخدم إعدادات تطبيق Android محددًا: إيقاف / أثناء الاستخدام.
• مفتاح تبديل منفصل: الموقع الدقيق.

# لماذا محدد (وليس مجرد مفتاح تبديل)

أذونات نظام التشغيل متعددة المستويات. يمكننا عرض محدد داخل التطبيق، لكن نظام التشغيل يظل هو من يقرر المنح الفعلي.

• قد يعرض iOS/macOS خيار أثناء الاستخدام أو دائمًا في مطالبات/إعدادات النظام.
• يدعم تطبيق Android حاليًا موقع الواجهة الأمامية فقط.
• الموقع الدقيق هو منح منفصل (iOS 14+ "دقيق"، وAndroid "fine" مقابل "coarse").

يقود المحدد في واجهة المستخدم الوضع المطلوب من جانبنا؛ أما المنح الفعلي فيوجد في إعدادات نظام التشغيل.

# نموذج الإعدادات

لكل جهاز عقدة:

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

سلوك واجهة المستخدم:

• يؤدي تحديد whileUsing إلى طلب إذن الواجهة الأمامية.
• إذا رفض نظام التشغيل المستوى المطلوب، فارجع إلى أعلى مستوى ممنوح واعرض الحالة.

# تعيين الأذونات (node.permissions)

اختياري. تبلّغ عقدة macOS عن location عبر خريطة الأذونات؛ وقد يحذفه iOS/Android.

# الأمر: location.get

يُستدعى عبر node.invoke.

المعلمات (مقترحة):

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

حمولة الاستجابة:

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

الأخطاء (رموز مستقرة):

• LOCATION_DISABLED: المحدد في وضع الإيقاف.
• LOCATION_PERMISSION_REQUIRED: الإذن مفقود للوضع المطلوب.
• LOCATION_BACKGROUND_UNAVAILABLE: التطبيق في الخلفية لكن المسموح به هو أثناء الاستخدام فقط.
• LOCATION_TIMEOUT: لم يتم الحصول على تحديد في الوقت المحدد.
• LOCATION_UNAVAILABLE: فشل في النظام / لا توجد موفّرات.

# سلوك الخلفية

• يرفض تطبيق Android الأمر location.get أثناء وجوده في الخلفية.
• أبقِ OpenClaw مفتوحًا عند طلب الموقع على Android.
• قد تختلف منصات العقد الأخرى.

# تكامل النماذج/الأدوات

• سطح الأداة: تضيف أداة nodes إجراء location_get (العقدة مطلوبة).
• CLI: openclaw nodes location get --node <id>.
• إرشادات الوكيل: لا تستدعِها إلا عندما يكون المستخدم قد فعّل الموقع ويفهم النطاق.

# نصوص تجربة المستخدم (مقترحة)

• إيقاف: "مشاركة الموقع معطلة."
• أثناء الاستخدام: "فقط عندما يكون OpenClaw مفتوحًا."
• دقيق: "استخدم موقع GPS الدقيق. أوقف التبديل لمشاركة موقع تقريبي."

# ذو صلة

• تحليل موقع القناة
• التقاط الكاميرا
• وضع التحدث