مرجع سريع حول Route Optimization API

تعيّن 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: الإعداد

حِزم 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: الأخطاء الشائعة

  • المشكلة: بالنسبة إلى طلبات 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

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