ما هي واجهة برمجة تطبيقات تحسين المسار؟

وقت القراءة: 4 دقائق

تحديث في: 18 يونيو، 2025

تبدأ كل طرد أو مكالمة خدمة أو طلب بقالة كبيانات - عنوان ونافذة زمنية ومركبة كبيرة بما يكفي لحمل الحمولة.

تقوم واجهة برمجة تطبيقات تحسين المسار بربط هذه الأجزاء معًا وإنتاج مسار يستهلك وقودًا أقل ويصل إلى باب العميل عند الوعد بذلك.

لا توجد لوحات معلومات، ولا سحب بالماوس، ولا يوجد كود يتحدث إلى كود.

قم بتوصيل نظام تخطيط موارد المؤسسات (ERP) أو عربة التجارة الإلكترونية أو أداة الحجز بنقطة النهاية، وسوف تقوم واجهة برمجة التطبيقات (API) بإرسال خطة توقف تلو الأخرى في ثوانٍ.

يقع Zeo Route Planner في هذا الأنبوب: ترتبط واجهة برمجة التطبيقات الخاصة به بـ Shopify وWooCommerce وZapier والعديد من الخدمات الأخرى تكامل الطرف الثالثتعمل هذه الأداة على ضمان وصول الطلبات الطازجة إلى السائق الصحيح قبل أن يبرد شريط التغليف.

ما هي واجهة برمجة تطبيقات تحسين المسار؟

واجهة برمجة تطبيقات تحسين المسار عبارة عن خدمة ويب تقبل بيانات التسليم وتعيد ترتيب التوقف الأكثر ذكاءً من حيث استهلاك الوقود والوقت.

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

لماذا يهم

باستخدام واجهة برمجة تطبيقات تحسين المسار، يمكنك إلغاء قفل الميزات التالية:

استقبال العناوين بالجملة
قم بتضمين مئات - بل آلاف - من نقاط التوقف في حمولة JSON واحدة. مثالي لشركات التوصيل والبقالة وفرق الخدمات الميدانية التي تسعى جاهدةً لتضييق نطاق العمل.

التسلسل الذكي
يزن المحرك المسافة وحركة المرور والحدود القانونية (مثل الوزن أو الارتفاع) قبل إغلاق المسار. تطفو الطرود العاجلة إلى الأعلى، بينما تهبط الطرود ذات الأولوية المنخفضة إلى النهاية.

صديقة للأسطول الكبير
سواءً كان عدد الشاحنات خمس شاحنات أو خمسمائة شاحنة، فإن واجهة برمجة التطبيقات (API) قابلة للتوسع. بمكالمة واحدة، يُمكن تقسيم العمل على عدة مستودعات، مع الموازنة بين عدد الأميال وساعات العمل.

واجهة برمجة التطبيقات Zeo لتحسين المسار

باستخدام واجهة برمجة التطبيقات الخاصة بـ Zeo لتحسين المسار، يمكنك الحصول على ما يلي:

الطلب إلى التوجيه في مكالمة واحدة
يتم تشغيل الطلب المدفوع ➜ يقوم برنامج الوسيط الخاص بك بالتقاط العنوان ➜ يقوم POST /stops بإسقاطه مباشرة في Zeo.

لا جداول بيانات، لا نسخ ولصق. مكالمة متابعة لـ POST /optimize تُرسل أفضل أمر إيقاف بالإضافة إلى أوقات الوصول المتوقعة.

ملفات تعريف السائق والسيارة حسب الطلب
استعمل POST /drivers لإنشاء ساعي بريد جديد فور إضافته إلى قائمة رواتب قسم الموارد البشرية. حدّد سعة الشاحنة، أو احتياجات التبريد، أو احتياجات البوابة الخلفية، وسيلتزم المُحسِّن تلقائيًا بكل حد.

التعامل مع الأولويات والنوافذ الزمنية
كل محطة تقبل حقول مثل priority, service_timeو time_windowتظهر الطرود ذات القيمة العالية أو طلبات "التسليم قبل الظهر" في أعلى القائمة دون الحاجة إلى وجود موظف توصيل يتواصل مع العملاء عبر مكالمات هاتفية.

إعادة التوجيه المباشر دون فتح لوحة المعلومات
تم إلغاء الطلب الساعة 2 ظهرًا؟

ضرب حذف /stops/{id} و اتصل POST /تحسين مرة أخرى. يتلقى السائقون المسار المُحدّث على هواتفهم أثناء استمرار القيادة.

تحديثات Webhook لـ ETA وإثبات التسليم
الاشتراك في /webhooks/route_completed and /webhooks/pod_uploaded.

يرسل متجرك إلى العملاء رسائل بريد إلكتروني حول الحالة في الوقت الفعلي، ويشاهد موظفو الدعم التوقيعات في اللحظة التي يتم التقاطها فيها.

صندوق الرمل أولاً، ثم الإنتاج لاحقًا
يتم شحن كل مفتاح مع رابط أساسي مؤقت. اختبر الحمولات، وتحقق من استجابات JSON، وعدّلها، ثم انتقل إلى الوضع النشط بمجرد أن تبدو الأرقام صحيحة.

زيادة توفير الوقود

توفير 200 دولار على الوقود شهريا!

قم بتحسين المسارات باستخدام الخوارزمية الخاصة بنا، مما يقلل وقت السفر والتكاليف بكفاءة.

ابدأ مجانا

كيف تعمل واجهة برمجة تطبيقات تحسين المسار؟

دعونا نلقي نظرة على ما يحدث خلف الكواليس. واجهة برمجة تطبيقات تحسين المسارات لا تقتصر على إعادة ترتيب نقاط التوقف، بل هي محرك ذكي يستمع ويحسب ويستجيب فورًا.

في اللحظة التي يصل فيها الطلب، يتم تشغيله، وبناء المسار الأكثر منطقية مع عدم وجود أي لمسة بشرية تقريبًا.

التدفق في العالم الحقيقي

تُرسل عربة التسوق طلبًا إلى واجهة برمجة التطبيقات (API)؛ ويُحلل المحرك البيانات ويُرسل قائمة مُرتبة بالإضافة إلى أوقات الوصول المُقدرة. يشاهد السائقون الخطة على هواتفهم بينما يُواصل فريق المستودع تحميل الشاحنة.

1. إدخال
   نقطة البداية هي حمولة JSON بسيطة، لكن ما بداخلها مهم للغاية. تتضمن كل محطة معلومات دقيقة عن خطوط العرض والطول، والعنوان، وفترة التسليم (مثلاً، من 9 إلى 11 صباحًا)، والمدة المتوقعة لتفريغ الحمولة، والمركبة المتاحة. يمكنك أيضًا إضافة قيود مثل "شاحنات مبردة فقط" أو "طرود قابلة للكسر".

   إن هذه المرونة هي ما يجعل واجهة برمجة التطبيقات عملية حقًا - فهي تأخذ الظروف الواقعية وتدمجها في بيانات يمكن للمحرك فهمها.

2. اﻟﻤﻌﺎﻟﺠﺔ
   الآن يأتي دور العمل الشاق. يقوم محرك تحسين Zeo بتحليل هذه البيانات ويبدأ بفهمها.

   

   يتحقق من حركة المرور الحالية، وقواعد السير باتجاه واحد، وسعات المركبات. ماذا لو كان حدّ شاحنتك ١٠٠ كجم، وحمولتك ١٢٠ كجم؟

   سيُقسّم هذا النظام التوقفات بين مركبتين. كما أنه يلتزم باتفاقيات مستوى الخدمة - فإذا احتاج العميل إلى التوصيل قبل الساعة العاشرة صباحًا، يُرفع هذا التوقف إلى أعلى. وبفضل جميع الأجزاء المتحركة، يجد المحرك المسار الأنظف والأخف وزنًا.

3. الناتج
   بمجرد الانتهاء من التحليل، ترسل واجهة برمجة التطبيقات خطة كاملة: تسلسل التوقف تلو الآخر، والوقت المقدر للوصول لكل منها، وإجمالي وقت السفر، والروابط المباشرة للملاحة.

   لا يحتاج السائقون إلى التفكير مرتين، ما عليهم سوى النقر والقيادة والمتابعة. كل هذا يحدث في ثوانٍ دون الحاجة إلى فريق إرسال لرسم خريطة لأي شيء يدويًا.

   مكافأة Zeo: تقوم واجهة برمجة التطبيقات أيضًا بتحديث ملفات تعريف السائق.

   

   تستخدم جولة أسطول Zeo معلومات السائق لتعيين المحطات تلقائيًا وإنشاء المسار.

كيفية تكوين واجهة برمجة تطبيقات تحسين المسار

يبدو إطلاق واجهة برمجة تطبيقات أمرًا غريبًا، لكن قائمة التحقق موجزة ومنظمة. اتبع الخطوات الأربع التالية، وستُفعّل حلول التوجيه لديك دون الحاجة إلى تدريبات إخلاء في وقت متأخر من الليل.

التحقّق من المُستخدم
احصل على مفتاح API من لوحة معلومات Zeo، وخزّنه في مخزن أسرارك، ثم مرره في رأس كل مكالمة. مفتاح واحد لكل بيئة يُبقي بيانات الاختبار منفصلة عن بيانات البث المباشر.

إعداد نقطة النهاية
تدفع خطافات الويب الاختيارية تحديثات الحالة مرة أخرى إلى نظامك عندما يتم قفل المسار.

• /السائقين - إنشاء أو تحديث أسماء السائقين وأرقام الهواتف وحدود المركبات.
• /توقف - نشر الطلبات الجديدة مع الإحداثيات وعدد الطرود وأوقات الخدمة.
• /تحسين - قم بتشغيل بناء المسار؛ واستقبل أوامر التوقف، وأوقات الوصول المتوقعة، وروابط الخريطة.

تنسيق البيانات
استخدم JSON—الإحداثيات بالدرجات العشرية والأوقات بالدرجات العشرية ايزو 8601، والأوزان بالكيلوجرام أو الباوند. أضف حقولاً مخصصة - مثل "الأولوية" و"درجة الحرارة" - إذا احتاجها المحرك لتحسين المسار بشكل أذكى.

الاختبار
وجّه مكالماتك إلى بيئة Zeo التجريبية أولًا. نفّذ خمس عمليات إيقاف وهمية، وافحص الاستجابة، وعدّل القيود، وكرّر العملية. عند الانتهاء، انقل رابط URL الأساسي إلى الإنتاج، وجدول مهام دفعية ليلية أو مُحفّزات فورية.

خاتمة

واجهة برمجة تطبيقات لتحسين المسارات تُحوّل بيانات الطلبات الخام إلى مسار مُحسّن بينما يستمتع الناس بفنجان القهوة. تُنجز نقطة نهاية Zeo المهمة الشاقة لشركات التوصيل والبقالة والفنيين الميدانيين، أي شخص يسعى إلى تقليل أوقات الوصول المُقدّرة وخفض فواتير الوقود.

هل أنت مستعد لإضافة تحسين المسار إلى مجموعتك؟

احجز عرضًا توضيحيًا لـ Zeoشاهد الطلب يصل إلى سلة التسوق، ويمر عبر واجهة برمجة التطبيقات، ويظهر على هاتف السائق في وقت أقل من الوقت الذي يستغرقه طباعة الملصق.