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