تحسب ميزة تحديد مسارات المركبات الكبيرة في Routes API المسارات والوقت المقدَّر للوصول للمركبات الكبيرة. تعرض هذه الخدمة مسارات محسّنة تتجنّب القيود استنادًا إلى ارتفاع المركبة ووزنها وطولها وتصنيفات المواد الخطرة. تنشئ الخدمة أيضًا رمزًا مميزًا للمسار يمكن تمريره إلى حزمة Navigation SDK لتوفير اتّجاهات مفصّلة.
أسباب استخدام ميزة "تحديد مسار المركبات الكبيرة"
استخدِم خدمة "تحديد مسار المركبات الكبيرة" لإنشاء تطبيقات تحلّ تحديات الخدمات اللوجستية التي تواجه أساطيل المركبات الكبيرة.
| المزايا | الوصف |
|---|---|
| تحسين دقة الأسعار والتخطيط | إنشاء تقديرات لوقت الوصول تستند إلى بيانات حركة المرور وتسمح بتقديم عروض أسعار وفترات تسليم أكثر دقة للمركبات الكبيرة، مثل الشاحنات والحافلات |
| تعزيز سلامة السائقين وكفاءتهم | توجيه السائقين على طول مسارات تتجنّب الجسور المنخفضة والطرق التي تفرض قيودًا على الوزن والمخاطر الأخرى |
| تبسيط العمليات على مستوى أسطول المركبات | استخدِم ميزة "تحسين المسار" مع ميزة "تحديد مسار المركبات الكبيرة" لتحسين مهام التحميل وترتيب محطات التوقف لجميع المركبات. استخدِم Fleet Engine لتفعيل إمكانية الاطّلاع في الوقت الفعلي على المهام والمواقع الجغرافية للمركبات. |
| تقليل التدريب وزيادة الاستخدام | توفير تجربة التنقّل باتّجاهات مفصّلة في "خرائط Google" المألوفة لسائقي المركبات الكبيرة أو الشاحنات ضمن تطبيقك |
الإجراءات التي يمكنك تنفيذها باستخدام ميزة "تحديد مسار المركبات الكبيرة"
باستخدام ميزة "توجيه المركبات الكبيرة"، يمكنك تنفيذ العمليات الرئيسية التالية:
- تحديد خصائص تفصيلية للمركبة، بما في ذلك الارتفاع والوزن والطول والعرض وعدد المحاور وتصنيفات السلع الخطرة
- الحصول على مسار ومدة الرحلة ومسافة السفر محسوبة خصيصًا لسمات المركبة
- إنشاء مسارات محسّنة لتسهيل المناورة من خلال تجنُّب المنعطفات على شكل حرف U وتفضيل الطرق السريعة والطرق الرئيسية تلقائيًا ويساعد ذلك في إبقاء المركبات الكبيرة على الطرق التي تلبي احتياجات السائقين وتوقعاتهم.
- احتساب موعد وصول متوقّع أكثر دقة باستخدام نموذج موعد وصول متوقّع خاص بالشاحنات يجمع النموذج بين سرعات تنقّل الشاحنات المرصودة وبيانات حركة المرور في الوقت الفعلي والبيانات التوقعية لتقديم تقديرات أكثر دقة للمركبات الكبيرة.
- تفعيل ميزة "الاتجاهات المفصّلة" في Navigation SDK باستخدام رمز مميّز للمسار من أجل نقل مسار آمن للشاحنات من Routes API
- حساب مصفوفات الطرق لتحديد أوقات التنقّل والمسافات بين نقاط انطلاق ووجهات متعددة من أجل التخطيط على مستوى أسطول المركبات
- تحسين خطة المسار لمجموعة شاحناتك لتحقيق الكفاءة التشغيلية الإجمالية مع مراعاة الجدوى والسلامة
طريقة عمل ميزة "تحديد مسار المركبات الكبيرة"
تعمل ميزة "توجيه المركبات الكبيرة" من خلال الخدمات التالية:
| نقطة نهاية | العملية | الناتج |
|---|---|---|
| Routes API | طلب HTTPS إلى نقطة نهاية في Routes API (computeRoutes أو computeRouteMatrix) مع نص طلب يتضمّن نقطة الأصل والوجهة يجب ضبط travelMode على TRUCK ويجب أن يتضمّن العنصر routeModifiers السمة vehicleInfo.
|
خط متعدد الأضلاع للمسار وقائمة بأجزاء المسار وخطواته والوقت المقدّر للرحلة ورمز مميّز للمسار |
| Route Optimization API | طلب HTTPS إلى نقطة نهاية واجهة برمجة التطبيقات Route Optimization API يجب ضبط travelMode على TRUCK ويجب أن يتضمّن العنصر routeModifiers السمة vehicleInfo.
|
خطة مسار محسّنة لأسطول المركبات مصمّمة للمركبة المحدّدة، ورموز مميّزة للمسار لكل رحلة |
| Navigation SDK (Android وiOS) | أدرِج رمزًا مميزًا للمسار (تم إنشاؤه من Routes API أو Route Optimization API with Large Vehicle Routing) عند ضبط الوجهات في أداة الاستكشاف. | تجربة اتجاهات مفصّلة مخصّصة للشاحنات وتتّبع مسارًا يلتزم بمعلومات المركبة المحدّدة في طلب بيانات من واجهة برمجة التطبيقات Routes API أو Route Optimization API الأصلي |
مثال
يركّز المثال التالي على استخدام توجيه المركبات الكبيرة مع Routes API.
على سبيل المثال، يبدو نص طلب computeRoutes الأساسي على النحو التالي:
{
"origin": { "location": { "latLng": { "latitude": 41.31, "longitude": -74.75 }}},
"destination": { "location": { "latLng": { "latitude": 41.30, "longitude": -74.78 }}},
"travelMode": "TRUCK",
"routeModifiers": {
"vehicleInfo": {
"totalHeightMm": 4114,
"totalLengthMm": 21945,
"totalWeightKg": 32658,
... // other vehicle attributes
}
}
}
مطلوبة: يجب أن يضبط طلبك قيمة travelMode على TRUCK وأن يملأ عنصر vehicleInfo بالأبعاد والسمات المحدّدة لمركبتك.
تعرض واجهة Routes API مسارًا يأخذ في الاعتبار معلومات المركبة المحدّدة. يمكن أن تتضمّن الاستجابة شكل متعدّد الخطوط الخاص بالمسار، والوقت المقدر للوصول الخاص بالشاحنة، ومسافة الرحلة، ورمز مميز للمسار الذي يمكن استخدامه مع حزمة تطوير البرامج (SDK) للتنقّل، وذلك استنادًا إلى fieldmask المحدّد. تشير الاستجابة أيضًا إلى ما إذا كان يتعذّر العثور على مسار متوافق تمامًا.
محتوى الطلب والاستجابة
يسرد الجدول التالي البيانات التي ترسلها وتتلقّاها عند تقديم طلب توجيه مركبات كبير باستخدام طريقة computeRoutes في Routes API.
| طلب المحتوى | محتوى الرد | تنسيق الإرجاع |
|---|---|---|
|
|
JSON |
القيود
قبل البدء، يجب أن تكون على دراية بالقيود والمتطلبات التالية.
- التوفّر الجغرافي: تتوفّر ميزة توجيه المركبات الكبيرة في الولايات المتحدة الـ 48 المتجاورة (متاحة للجميع) واليابان (تجريبية). لا تتوفّر هذه الخدمة في ألاسكا أو هاواي أو الأقاليم التابعة للولايات المتحدة.
- نصائح السائق والسلامة يجب ألّا يعتمد السائقون بشكل كامل على المسارات التي تعرضها واجهة برمجة التطبيقات هذه لضمان السلامة أو الالتزام بالقانون. لا نضمن أن تكون الطرق مناسبة للمركبة، وقد يؤدي اتّباعها إلى تعرّض السائقين لمخاطر، مثل الجسور المنخفضة أو الطرق التي يُحظر فيها مرور المركبات الكبيرة.
- المسارات التي يتم تحديدها بأفضل جهد: في بعض الحالات، لا يمكن لواجهة برمجة التطبيقات العثور على مسار يلتزم بشكل كامل بقيود السفر. بدلاً من ذلك، تعرض الخدمة مسارًا "بأفضل ما يمكن"، وقد يمرّ هذا المسار بمناطق محظورة. تحدّد استجابة Routes API هذه الطرق بوضوح في الحقل
routeRestrictionsPartiallyIgnored. لذا، عليك التخطيط لمسارك بعناية في هذه الحالات، ويُفضّل استخدام بيانات مصدر أخرى. لا تستخدِم مسارًا تم الإبلاغ عنه كمصدر وحيد للحقيقة عند التخطيط أو التنقّل. - الميزات غير المتوافقة: لا يتيح توجيه المركبات الكبيرة استخدام ما يلي:
- أسعار رسوم عبور الشاحنات
- حدود السرعة
- تحديد مسار المواد الخطرة المشعّة
- حدود الاستخدام: تخضع جميع الطلبات لحدود الطلبات في الثانية (QPS) العادية.
كيفية استخدام ميزة "تحديد مسار المركبات الكبيرة"
اتّبِع الخطوات التالية لاستخدام ميزة توجيه المركبات الكبيرة مع Routes API:
- إعداد مشروعك: تأكَّد من إنشاء مشروعك على Google Cloud وتفعيله لاستخدام Routes API.
- توفير ميزة توجيه المركبات الكبيرة: تتوفّر ميزة توجيه المركبات الكبيرة لمجموعة محدودة من العملاء، يُرجى التواصل معنا لطلب الوصول إليها وتوفير مشروعك لهذه الميزة.
- إنشاء طلب: استدعِ نقطة النهاية
computeRoutesأوcomputeRouteMatrixمع ضبطtravelModeعلىTRUCK، وضبطroutingPreferenceعلىTRAFFIC_AWARE_OPTIMAL، وحدِّد سمات مركبتك باستخدام العنصرvehicleInfo. - توفير اتّجاهات مفصّلة (اختياري): إذا أجريت طلبًا إلى
computeRoutes، مرِّرrouteTokenمن الردّ إلى حزمة Navigation SDK لبدء جلسة تنقّل.
الخطوات التالية
- البدء: إنشاء مسارات الشاحنات والأوقات المقدّرة للوصول باستخدام Routes API
- إضافة ميزة التنقّل: يمكنك توفير اتجاهات مفصّلة باستخدام مسارات مخصّصة للشاحنات في حزمة تطوير البرامج للتنقّل على Android أو iOS.