تحسين المسار هي واجهة برمجة تطبيقات على منصة خرائط Google تقبل أهداف توجيه المركبات والقيود التشغيلية في شكل بيانات منظَّمة لتوفير خطة مسار لمركبة واحدة أو أكثر.
أهمية تحسين المسار
باستخدام Route Optimization API، يمكنك إنشاء أو تحسين عملية مبرمَجة لتخطيط المسار أو الإرسال بهدف تحسين الكفاءة التشغيلية لاحتياجات وسائل النقل. تنشئ الخدمة أفضل خطط مسارات ممكنة لتلبية تلك العقبات، وذلك من خلال معلَمات تعبّر عن أهدافك وقيودك التشغيلية الفريدة، وخوارزمية تستند إلى بيانات "خرائط Google" الموثوق بها. في ما يلي بعض أمثلة حالات الاستخدام:
- تستخدم شركة خدمات لوجستية ميزة تحسين المسار لتحسين المهام المتعلقة بجميع الشحنات في اليوم التالي، مما يوفر مسارًا لكل شحنة مما يحسن فعالية المسافة والوقت، وتوفير التكاليف، والتسليم في الوقت المحدد، ورضا السائق والرضا النهائي.
- شركة توصيل الطعام عند الطلب تستخدم Route Optimization (تحسين المسار) في الوقت الفعلي لاختيار أفضل سائق نشط لتلقّي العديد من الطلبات الجديدة وإدراجه في مساراته الحالية.
- يستخدم مقدّم الخدمات الطبية ميزة "تحسين المسار" لربط مقدّمي الخدمات الصحية بالمواعيد، ما يؤدي إلى تحسين كفاءة المسارات بالنسبة إلى كل مقدّم خدمة على مدار يومهم.
- يستخدم مقدّم الخدمة الميداني ميزة تحسين المسار للعثور على المسار والتسلسل الأمثل لمواعيد الصيانة مع الفنيين، وإعادة التحسين عند حدوث تغييرات في الحالة، مثل تأخيرات الطريق.
الإجراءات التي يمكنك اتّخاذها باستخدام ميزة "تحسين المسار"
باستخدام Route Optimization API، يمكنك تحسين المسارات ومهام المهام لأسطول من المركبات، مع مراعاة الأهداف والقيود المختلفة.
أمثلة على الأهداف:
- كفاءة السفر: حدِّد متطلباتك لكفاءة السفر استنادًا إلى معلَمات مثل المسافة والوقت إلى الوجهة.
- الوصول في الوقت المحدَّد: عليك التأكّد من وصول المركبات لمهامها في الوقت المحدَّد. على سبيل المثال، حدِّد فترة زمنية معيّنة لإجراء الاستلام أو التوصيل أو الخدمة.
- تكلفة استخدام المركبات: قلِّل عدد المركبات المطلوبة لأداء المهام لتوفير التكلفة.
- موازنة الحمل: تأكَّد من توزيع المهام بشكل عادل على أسطول المركبات والموظفين.
أمثلة على القيود:
- ساعات عمل السائقين: وقت البدء والانتهاء للعمل ووقت الاستراحات.
- سعة المركبة: الحدّ الأقصى للحمولة التي يمكن أن تحملها مركبة في وقت معيّن.
- الفترات الزمنية: يجب إدخال فترة زمنية محدّدة للوصول، مثل مدى توفّر العملاء أو ساعات عمل المتاجر.
التبعيات والتوافق: يمكنك تحديد تبعيات العمل بإحدى الطرق التالية:
- تتطلب استخدام أنواع محددة من المركبات أو الموظفين.
- يتطلب تنفيذ عمل آخر أولاً
- يجب أن تكون الشحنة هي السلعة الوحيدة في المركبة في وقت معيّن.
راجِع الأدلة المرجعية للمطوّرين (REST وgRPC) للحصول على التفاصيل وجميع المَعلمات المتاحة.
طريقة عمل ميزة "تحسين المسار"
تستخدم Route Optimization API عددًا من الإدخالات لعرض مخطط مسار. تشمل المدخلات المركبات والمهام أو الشحنات والأهداف والقيود. تتضمن خطة المسار مهام تُسند إلى المركبات، والمسارات متعددة المحطات لكل مركبة، والمقاييس ذات الصلة.
تحقِّق واجهة برمجة تطبيقات Route Optimization API ذلك بطريقتَين:
- OptimizeTours: يشير ذلك إلى واجهة برمجة تطبيقات متزامنة تتطلّب من العميل انتظار استجابة الخادم قبل متابعة المهام الأخرى.
- BatchOptimizeTours: واجهة برمجة تطبيقات غير متزامنة تتيح للعميل متابعة المهام الأخرى قبل أن ينتهي الخادم ويستجيب.
تشترك كلتا الطريقتين في نفس الواجهة والمعلمات المتوافقة. يمكنك الاطّلاع على مزيد من المعلومات عن BatchOptimizeTours في صفحة نقاط النهاية المتزامنة وغير المتزامنة.
تقبل Route Optimization API طلب HTTP POST مع نص طلب JSON يحتوي على تفاصيل الإدخال.
طلب OptimizeTours
يتألف الطلب من العناصر المطلوبة التالية:
- النموذج: كيان عام يتم فيه ضبط الإعدادات والقيود على المستوى العام. وتحتوي أيضًا على الشحنات والمركبات.
- الشحن: تُستخدم لتحديد مهمة أو شحنة فعلية يمكن أن تشمل مهمة الاستلام وزيارة التسليم والسمات المقابلة، بما في ذلك المواقع الجغرافية والسمات الأخرى والقيود ووظائف التكلفة. لمزيد من التفاصيل، يمكنك الاطّلاع على المستندات المرجعية للشحن (REST، وgRPC).
- المركبة: تُستخدَم لتحديد مركبة (أو سائق أو موظفين) وسمات السفر المقابل لها، بما في ذلك مواقع الانطلاق وغيرها من سمات المركبة أو السفر والقيود ووظائف التكلفة. يمكنك الاطّلاع على ( REST، gRPC) للحصول على مزيد من التفاصيل.
يمكنك الاطّلاع على مقالة تحسين طلبات إيقاف الاستلام والتسليم للاطّلاع على مثال بسيط.
استجابة OptimizeTours
تعرض Route Optimization API استجابة JSON تتضمّن خطة المسار للمركبات والمهام أو الشحنات.
- المسارات: تحتوي على المسارات لكل مركبة مع المهام المسندة إليها (أو الشحنات).
- المقاييس: مقاييس مجمّعة عن خطة المسار التي تمّ إنشاؤها
يمكنك الاطّلاع على مقالة تحسين طلبات إيقاف الاستلام والتسليم للاطّلاع على مثال بسيط.
يمكنك قراءة المزيد من التفاصيل حول إنشاء الطلب وتفسير الرد في تفسير الرد.
المراجع
يلخص الجدول التالي الموارد المتاحة من خلال Route Optimization API بالإضافة إلى البيانات التي تعرضها.
| موارد البيانات | البيانات التي تم عرضها | تنسيق الإرجاع |
batchOptimizeTours
(REST,
gRPC)
|
لعرض اسم المورد لعملية تشغيل طويلة، ما يشير إلى اكتمال المعالجة. | نموذج JSON أو gRPC |
optimizeTours
(REST,
gRPC)
|
تعرض مسارًا محسّنًا مع تفاصيل الزيارات والمقاييس. | نموذج JSON أو gRPC |
كيفية استخدام ميزة "تحسين المسار"
| 1 | بدء الإعداد | ابدأ بمقالة إعداد مشروعك على Google Cloud وأكمِل تعليمات الإعداد أدناه. |
| 2 | تنفيذ طلب أساسي وتلقّي ردّ | بعد الإعداد، يمكنك البدء بإرسال طلب أساسي وتلقّي الردّ من خلال اتّباع إنشاء طلب وتفسير الردّ. |
| 3 | تجربة سيناريو أكثر تقدّمًا والبدء في إنشاء طلبك الخاص | اطّلِع على أمثلة للسيناريوهات بدءًا من تحسين طلبات إيقاف استلام الطلبات وإيقاف التسليم، ثم ابدأ في إنشاء الطلبات التي تتطابق مع حالات الاستخدام الخاصة بك. |
مكتبات العملاء المتاحة
للحصول على قائمة بمكتبات العملاء المتاحة لواجهة برمجة تطبيقات Route Optimization API، راجِع المقالة استخدام مكتبات العملاء.
الخطوات التالية
- بدء استخدام Route Optimization API: انتقِل إلى تشغيل طلب أساسي.
- فهم الفوترة: الاستخدام والفوترة
- الاطّلاع على نموذج الرموز والمكتبات: مكتبات العميل والبرامج المفتوحة المصدر