عرض المناديب على الخريطة وخريطة الطرود
خريطتان للمناديب والطرود: التتبع المباشر وزر Map Show في قائمة الطرود؛ ما تعرضه ومن يفتحها ومدى حداثة بياناتها.
آخر تحديث 22 أكتوبر 2026 · آخر تحقق 22 أكتوبر 2026
الغرض#
توفّر المنصة طريقتين لرؤية المناديب والطرود على الخريطة: عرض المناديب المباشر («تتبّع المناديب»)، وزر «Map Show» القديم في قائمة الطرود. تشرح هذه الصفحة ما يعرضه كل منهما ومن يفتحه ومدى حداثة بياناته. وتجد تفاصيل التتبّع المباشر وما يرسله تطبيق المندوب في دليل «تتبّع المناديب المباشر على الخريطة».
من يستطيع الوصول؟#
| الأداة | من يفتحها |
|---|---|
«تتبّع المناديب» وواجهة GET /api/v10/tracking/fleet |
موظفو الشركة (أدمن ومسؤول وفرع)، والتاجر الذي يملك شركة توصيل خاصة؛ بشرط ميزة live_tracking في الباقة |
| زر «Map Show» في قائمة الطرود | يظهر لمن يملك parcel_create |
عرض المناديب المباشر#
من «تتبّع المناديب» في قائمة الشركة (أو تحت «شركتي للتوصيل» للتاجر) ترى كل مناديب شركتك فقط، لكل مندوب حالته وآخر موقع وسرعته وبطاريته والطرود التي معه (توصيل أو استلام). الحالات: «متصل» إذا كان آخر موقع خلال دقيقتين، و«عم يتحرّك» إذا كان متصلاً بسرعة 3 كم/س فأكثر، و«خامل» خلال 15 دقيقة، وبعدها «غير متصل»، و«ما بعت موقعه لسا» لمن لم يرسل شيئاً.
- حداثة البيانات: تُحدَّث الصفحة تلقائياً كل 15 ثانية ما دامت علامة التبويب ظاهرة، والموقع المعروض هو آخر قراءة وصلت من التطبيق (وتطلب إعدادات التتبع منه الإرسال كل 20 ثانية).
- المرشحات: عدّادات أعلى القائمة (الكل، متصل، عم يتحرّك، خامل، غير متصل) وبحث بالاسم أو الهاتف أو رقم التتبع.
- عملاء الواجهة البرمجية للموظفين والتجار يستطيعون قراءة البيانات نفسها عبر
GET /api/v10/tracking/fleet. تتطلب الواجهة ترويسةapiKeyورمز وصول لحساب موظف أو تاجر، وهي محدّدة بـ 30 طلباً في الدقيقة، وتعيد الرمز 403 إذا لم تكن لدى الحساب شركة توصيل أو لم تتضمن الباقة ميزةlive_tracking.
زر «Map Show» في قائمة الطرود#
افتح قائمة الطرود
اختر «الطرود» من القائمة. يظهر زر «Map Show» بجانب أدوات التعيين الجماعي لمن يملك
parcel_create.اضغط الزر
تُفتح خريطة Google في تبويب جديد (تحتاج مفتاح خرائط Google للشركة) وتعرض علامة لكل مندوب له موقع محفوظ، وتجمّع العلامات المتقاربة.
اضغط علامة مندوب
يظهر ما يلي: صورة المندوب واسمه وهاتفه، و«TrackingID» متبوعاً بعدد الطرود وأرقام تتبعها.
- موقع العلامة هو الموقع المحفوظ في سجل المندوب: إما الموقع الذي أدخله الموظف في نموذج المندوب، أو آخر قراءة حيّة إذا كان التتبع المباشر يعمل. ولا يُحدَّث الموقع من الصفحة نفسها، فأعد تحميلها لرؤية الجديد. ولا يظهر مندوب بلا موقع محفوظ.
- تُجمَّع الطرود بحسب مندوب الاستلام المسجَّل في سجل حركة الطرد؛ والطرود المعيّنة للتوصيل لا يُسجَّل لها مندوب استلام، لذلك قد لا يظهر مندوب تقتصر طروده على التوصيل؛ استعمل «تتبّع المناديب» له.
أخطاء شائعة#
- خريطة رمادية أو فارغة. مفتاح خرائط Google غير محفوظ أو غير صالح؛ راجع دليل «الإشعارات والدفع وخرائط Google: إعدادات الشركة».
- غياب مندوب عن «Map Show». إما لا موقع محفوظاً له، أو لا يملك طرود استلام معيّنة حالياً.
- ظهور «تتبّع المناديب مو ضمن باقتك». الميزة غير مفعّلة في الباقة؛ تطلب ترقية.
- اعتبار موقع الصفحة القديمة حياً. الموقع هو آخر ما حُفظ وقت فتح الصفحة.
الحدود والصلاحيات#
- «تتبّع المناديب» يعرض مناديب شركتك فقط، ويحدّث نفسه كل 15 ثانية؛ أما خريطة «Map Show» فلا تتحدّث تلقائياً.
- «Map Show» يحتاج إلى مفتاح خرائط Google.
- «Map Show» يعمل على نطاق الشركة فقط.
API
GET /api/v10/tracking/fleet