تعيّن Route Optimization API المهام والمسارات لأسطول من المركبات، وتحسّنها وفقًا للأهداف والقيود التي تقدّمها، مثل الفترات الزمنية وسعة المركبة وساعات عمل السائق والتكاليف. يمكنك استدعاء واجهة برمجة التطبيقات هذه من خلال REST أو gRPC أو مكتبات العملاء، وهي تعرض تسلسلات الزيارات ومهام الشحن والأوقات المقدَّرة ومقاييس المسارات.
Route Optimization API: معلومات أساسية
- المنتج: Route Optimization API
- يُعرف أيضًا باسم: GMPRO
- الفئة: المسارات
- المنصة: خدمة ويب (REST)
- يتم تشغيلها على: الخادم (رمز الخلفية)
- مرحلة الإطلاق: GA
- Lifecycle: نشط
- نظرة عامة: نظرة عامة على Route Optimization API
Route Optimization API: حالات الاستخدام
استخدام Route Optimization API في الحالات التالية:
- عليك تعيين شحنات أو مهام لعدة مركبات مع مراعاة الفترات الزمنية وسعة المركبة وساعات عمل السائق والتكاليف.
- تحتاج إلى أفضل تسلسل محطات توقّف لمركبة واحدة مع عدة عمليات استلام أو تسليم أو مواعيد.
- عليك إعادة تحسين المسارات النشطة للطلبات الجديدة (مثل الإرسال عند الطلب) باستخدام
injectedFirstSolutionRoutesأوinjectedSolutionConstraint. - تحتاج إلى رموز مميّزة للمسارات لكل جزء من خطة محسّنة لتمريرها إلى حزمة تطوير البرامج (SDK) للتنقّل.
لا تستخدِم Route Optimization API في الحالات التالية:
- تحتاج إلى تتبُّع مباشر لكيفية تنفيذ السائقين للخطة، ولكن تعرض واجهة برمجة التطبيقات خطوطًا متعدّدة مخطَّطًا لها، وليس مسارات المركبات في الوقت الفعلي. استخدِم خدمة Fleet Engine بدلاً من ذلك.
- تحتاج إلى اتّجاهات مفصّلة داخل التطبيق للسائقين على طول المسار المحسّن. يمكنك استخدام حزمة تطوير البرامج للتنقّل على أجهزة Android بدلاً من ذلك.
- تحتاج إلى إرشادات مفصّلة داخل التطبيق للسائقين على أجهزة iOS على طول المسار المحسّن. يمكنك استخدام حزمة تطوير البرامج للتنقّل على أجهزة iOS بدلاً من ذلك.
Route Optimization API: الإعداد
- الخدمة المطلوب تفعيلها:
routeoptimization.googleapis.com - المصادقة: OAuth 2.0، حساب الخدمة
- البدء: إعداد Route Optimization API
- المرجع: مرجع Route Optimization API
- الأسعار: استخدام Route Optimization API والفوترة
- السياسات: سياسات Route Optimization API
- ملاحظات الإصدار: ملاحظات إصدار Route Optimization API
حِزم Route Optimization API الرسمية:
- npm:
@googlemaps/routeoptimization - pypi:
google-maps-routeoptimization - go:
cloud.google.com/go/maps - maven:
com.google.maps:google-maps-routeoptimization
Route Optimization API: المنتجات ذات الصلة
- تُستخدم غالبًا مع: حزمة تطوير البرامج (SDK) للتنقّل في Android وحزمة تطوير البرامج (SDK) للتنقّل في iOS وخدمة Fleet Engine وMaps JavaScript API
Route Optimization API: الأخطاء الشائعة
- المشكلة: بالنسبة إلى طلبات REST إلى نقطة النهاية
OptimizeToursالخاصة بالحظر، تلغي المهلة التلقائية التي تبلغ 60 ثانية أيّtimeoutفي نص الطلب تزيد مدته عن 60 ثانية. الحلّ: اضبط عنوانX-Server-Timeout(بالثواني، بدون اللاحقة "s") لتمديد الموعد النهائي. يتم ضبط مكتبات العملاء وgRPC تلقائيًا على 3600 ثانية. يُرجى الاطّلاع على /maps/documentation/route-optimization/timeouts. - المشكلة: يتم تحديد قيم
timeoutوالموعد النهائي بـ 1800 ثانية. الحلّ: اضبطallowLargeDeadlineDespiteInterruptionRiskعلىtrueللسماح بمدة تصل إلى 3, 600 ثانية، مع قبول مخاطر أعلى لحدوث أخطاء في الانقطاع. يُرجى الاطّلاع على /maps/documentation/route-optimization/timeouts. - المشكلة: بدون مَعلمات التكلفة (مثل
costPerHourأوcostPerKilometer)، يتعامل المحسِّن مع جميع الحلول على أنّها متساوية. الحلّ: حدِّد مَعلمات التكلفة للمركبات التي تعكس تكاليف مؤسستك. يُرجى الاطّلاع على /maps/documentation/route-optimization/make-first-request. - المشكلة: يتعذّر تنفيذ الطلبات التي تمت مصادقتها باستخدام مفتاح واجهة برمجة التطبيقات، لأنّ كل طلب يحتاج إلى رمز OAuth مميّز. الحلّ: استخدِم رمز OAuth مميزًا مع نطاق
https://www.googleapis.com/auth/cloud-platform، على سبيل المثال من خلال "بيانات الاعتماد التلقائية للتطبيق" أو حساب خدمة. يُرجى الاطّلاع على /maps/documentation/route-optimization/cloud-setup#create-an-oauth-token.
ما يمكنك تنفيذه باستخدام Route Optimization API
يمكنك الاطّلاع على الأدلة المرتبطة أدناه لكل مهمة، أو المقارنة بين المنتجات في مستكشف الإمكانات.
- عرض خطة توصيل متعددة المحطات، محسّنة استنادًا إلى قيود محدّدة للمسار والتكلفة والشحنة والمركبة
- عرض أوقات البدء والانتهاء لكل محطة توقّف في خطة تسليم محسّنة
- يمكنك عرض مُدد السفر والتأخير والاستراحة والانتظار بين كل محطة في خطة تسليم محسّنة.
- عرض معلومات حمولة المركبة في كل محطة توقّف ضمن خطة تسليم محسّنة
- عرض معلومات التكلفة لكل شحنة في خطة تسليم محسّنة
- عرض خطوط متعدّدة مرمّزة للمسار بين كل محطة توقّف في خطة تسليم محسّنة
- عرض رمز مميّز لمسار التنقّل بين كل محطة في خطة توصيل محسّنة
- عرض المقاييس المجمّعة للشحنات والمركبات والتكاليف من أجل خطة تسليم محسّنة
- تحديد الفترة الزمنية للبدء والانتهاء لخطة تسليم متعددة المحطات
- حدِّد وقت البدء والانتهاء والمواقع الجغرافية لكل مركبة في خطة تسليم متعددة المحطات.
- تحديد تكاليف الوقت لكل مركبة في خطة توصيل متعددة المحطات
- تحديد مَعلمات نموذج التكلفة لخطة تسليم متعدّدة المحطات
- تحديد قيود وقت الاستلام والتسليم لكل شحنة في خطة تسليم متعددة المحطات
- تحديد المركبات المخصّصة لخطة توصيل متعددة المحطات
- تحديد حدود الحمولة لكل مركبة في خطة توصيل متعددة المحطات
- تحديد ما إذا كان يجب مراعاة معلومات حركة المرور المباشرة في خطة تسليم متعددة المحطات
- يمكنك معالجة طلب تحسين خطة توصيل متعددة المحطات على دفعات وكتابة الردّ في Google Cloud Storage.
- خصِّص وقتًا لركن السيارة قبل إجراء عمليات التسليم.
- إعطاء الأولوية للزيارات القريبة التي تتم بشكل متتالٍ:
- تجنُّب إجراء انعطاف للخلف في مسار مركبة يتضمّن محطات توقّف متعددة تجريبية ملاحظة: هذه ميزة تجريبية تخضع لبنود وقيود مرحلة ما قبل التوفّر للجمهور العام.
- التحسين لتحقيق أهداف محدّدة مسبقًا: تجريبية ملاحظة: هذه ميزة تجريبية تخضع لبنود وقيود مرحلة ما قبل التوفّر للجمهور العام.
- تسليم الشحنات الأثقل أولاً ميزة تجريبية ملاحظة: هذه ميزة تجريبية تخضع لبنود وقيود مرحلة ما قبل التوفّر للجمهور العام.