> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# أمر الموقع

## الخلاصة

* `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`.

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

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "timeoutMs": 10000,
  "maxAgeMs": 15000,
  "desiredAccuracy": "coarse|balanced|precise"
}
```

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

```json theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
  "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 الدقيق. أوقف التبديل لمشاركة موقع تقريبي."

## ذو صلة

* [تحليل موقع القناة](/ar/channels/location)
* [التقاط الكاميرا](/ar/nodes/camera)
* [وضع التحدث](/ar/nodes/talk)