نظرة عامة على Route Optimization API

تحسين المسار هي واجهة برمجة تطبيقات في "منصة خرائط 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) لعرض اسم المورد لـ Long جارٍ تشغيل العملية، التي تشير إلى اكتمال المعالجة. نموذج JSON أو نموذج gRPC
optimizeTours (REST، gRPC) عرض مسار محسن، مع التفاصيل الزيارات والمقاييس. نموذج JSON أو نموذج gRPC

كيفية استخدام ميزة تحسين المسارات

1 البدء البدء بـ إعداد مشروعك على Google Cloud وأكمل تعليمات الإعداد التالية.
2 تنفيذ طلب أساسي وتلقّي ردّ بعد الإعداد، ابدأ إرسال طلب أساسي والحصول على الرد، باتباع إنشاء طلب أو تفسير الردّ:
3 تجربة سيناريو أكثر تقدّمًا وبدء إنشاء طلبك الخاص استكشاف أمثلة السيناريوهات التي تبدأ بـ تحسين طلبات الاستلام والتسليم وبدء إنشاء الطلبات التي تتوافق مع حالات استخدامك

مكتبات العملاء المتاحة

للاطّلاع على قائمة بمكتبات العملاء المتوفّرة لواجهة Route Optimization API، يمكنك الاطّلاع على مكتبات العميل:

الخطوات التالية