تحسين المسار هي واجهة برمجة تطبيقات في "منصة خرائط Google" تقبل أهداف توجيه المركبات والقيود التشغيلية على شكل بيانات منظَّمة، وذلك لتقديم خطة مسار لمركبة واحدة أو أكثر.
أسباب استخدام ميزة تحسين المسارات
باستخدام واجهة برمجة التطبيقات Route Optimization API، يمكنك إنشاء أو تحسين عملية إرسال أو تخطيط للمسارات مبرمَجة تحسِّن الكفاءة التشغيلية لتلبية احتياجات وسائل النقل. وباستخدام معلَمات للتعبير عن الأهداف والقيود التشغيلية الفريدة، وخوارزمية تستند إلى بيانات "خرائط Google" الموثوقة، تنشئ الخدمة أفضل خطط مسارات ممكنة لتلبية هذه القيود. في ما يلي بعض الأمثلة على حالة الاستخدام:
- تستخدم شركة لوجستية ميزة "تحسين المسار" لتحسين عمليات تعيين جميع الشحنات في اليوم التالي، مما يوفر مسارًا لكل شحنة تتحسن من حيث المسافة والوقت وتوفير التكلفة والتسليم في الوقت المحدد ورضا السائقين ورضا العملاء.
- تستخدم إحدى شركات توصيل الطعام عند الطلب ميزة "تحسين المسار" في عملية الإرسال في الوقت الفعلي لاختيار أفضل سائق نشِط لاستلام العديد من الطلبات الجديدة وإدخالها في مساراتها الحالية.
- يستخدم مقدّم الخدمات الطبية ميزة "تحسين المسار" لربط مقدّمي الخدمات الصحية بالمواعيد، ما يحسّن كفاءة المسارات لكل مقدّم خدمة على مدار يومهم.
- يستخدم مقدّم الخدمة الميدانية ميزة "تحسين المسار" للعثور على المسار والتسلسل الأمثل لمواعيد الخدمة مع الفني، وإعادة التحسين عند حدوث تغييرات في الحالة، مثل التأخيرات في المسار.
الإجراءات التي يمكنك تنفيذها من خلال تحسين المسار
باستخدام 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: انتقِل إلى تشغيل طلب أساسي.
- فهم الفوترة: الاستخدام والفوترة
- الاطّلاع على نموذج الرموز البرمجية والمكتبات: مكتبات العميل والبرامج المفتوحة المصدر