نظرة عامة على توجيه المركبات الكبيرة

صورة لشاحنة كبيرة على سطح الطريق

ميزة تحديد مسارات المركبات الكبيرة في Routes API هي مجموعة من الخدمات التي تحتسب المسارات وأوقات الوصول المقدّرة للمركبات الكبيرة. من خلال قبول الطلبات التي تحدّد سمات المركبة، مثل الارتفاع والوزن والطول وتصنيفات المواد الخطرة، يعرض هذا الخيار مسارًا محسّنًا لتجنُّب القيود ذات الصلة. تنشئ الخدمة أيضًا رمزًا مميّزًا للمسار يمكن تمريره إلى Navigation SDK لتزويد السائقين بتوجيهات مفصّلة على طول المسار المخصّص للشاحنات.

أسباب استخدام ميزة "تحديد مسار المركبات الكبيرة"

استخدام خدمة "تحديد مسار المركبات الكبيرة" لإنشاء تطبيقات تحلّ تحديات الخدمات اللوجستية لمجموعات المركبات الكبيرة

المزايا سلوك التطبيق
تحسين دقة الأسعار والتخطيط إنشاء تقديرات لوقت الوصول تستند إلى بيانات حركة المرور وتسمح بتقديم عروض أسعار وفترات تسليم أكثر دقة للمركبات الكبيرة، مثل الشاحنات والحافلات
تعزيز سلامة السائقين وكفاءتهم توجيه السائقين على طول مسارات تتجنّب الجسور المنخفضة والطرق التي تفرض قيودًا على الوزن والمخاطر الأخرى
تبسيط العمليات على مستوى أسطول المركبات استخدِم ميزة "تحسين المسار" مع ميزة "تحديد مسار المركبات الكبيرة" لتحسين مهام التحميل وترتيب محطات التوقف لأسطول كامل. استخدِم Fleet Engine لإتاحة إمكانية الاطّلاع في الوقت الفعلي على المهام والمواقع الجغرافية للمركبات.
تقليل التدريب وزيادة الاستخدام توفير تجربة التنقّل باتّجاهات مفصّلة في "خرائط Google" المألوفة لسائقي المركبات الكبيرة أو الشاحنات ضمن تطبيقك

الإجراءات التي يمكنك تنفيذها باستخدام ميزة "تحديد مسار المركبات الكبيرة"

باستخدام ميزة "توجيه المركبات الكبيرة"، يمكنك تنفيذ العمليات الرئيسية التالية:

  • تحديد ملفات تعريف تفصيلية للمركبات، بما في ذلك الارتفاع والوزن والطول والعرض وعدد المحاور وتصنيفات السلع الخطرة
  • الحصول على مسار ومدة الرحلة ومسافة السفر محسوبة خصيصًا وفقًا لسمات المركبة، وذلك باستخدام بيانات الطرق الشاملة ونماذج حركة المرور من Google
  • حساب وقت وصول تقديري أكثر دقة باستخدام نموذج وقت الوصول التقديري الجديد الخاص بالشاحنات يجمع النموذج بين سرعات تنقّل الشاحنات المرصودة وبيانات حركة المرور في الوقت الفعلي والبيانات التوقعية لتقديم تقديرات أكثر دقة للمركبات الكبيرة.
  • تفعيل ميزة "الاتجاهات المفصّلة" في Navigation SDK باستخدام رمز مميّز للمسار لنقل مسار آمن للشاحنات من Routes API
  • حساب مصفوفات الطرق لتحديد أوقات التنقّل والمسافات بين نقاط انطلاق ووجهات متعدّدة من أجل التخطيط على مستوى أسطول المركبات
  • تحسين خطة المسار لمجموعة شاحناتك لتحقيق الكفاءة التشغيلية بشكل عام مع مراعاة الجدوى والسلامة

طريقة عمل توجيه المركبات الكبيرة

تعمل ميزة توجيه المركبات الكبيرة من خلال الخدمات التالية:

نقطة نهاية العملية الناتج
Routes API طلب HTTPS إلى نقطة نهاية في Routes API (‫computeRoutes أو computeRouteMatrix) مع نص طلب يتضمّن نقطة الأصل والوجهة يجب ضبط travelMode على TRUCK ويجب أن يتضمّن العنصر routeModifiers ملف المركبة. خط متعدد يمثل المسار وقائمة بأجزاء المسار وخطواته والوقت المقدّر للرحلة ورمز مميز للمسار
Route Optimization API طلب HTTPS إلى نقطة نهاية واجهة برمجة التطبيقات Route Optimization API يجب ضبط travelMode على TRUCK ويجب أن يتضمّن العنصر routeModifiers ملف المركبة. وسيلة النقل وملف تعريف المركبة في العنصر routeModifiers خطة مسار محسّنة للمجموعة مصمَّمة لملف تعريف المركبة المحدّد، ورموز مميّزة للمسار لكل رحلة
Navigation SDK أدرِج رمزًا مميّزًا للمسار (تم إنشاؤه من Routes API أو Route Optimization API with Large Vehicle Routing) عند طلب setDestination. تجربة اتجاهات مفصّلة مخصّصة للشاحنات وتتّبع مسارًا يلتزم بملف تعريف المركبة المحدّد في طلب بيانات من واجهة برمجة التطبيقات Routes API أو Route Optimization API الأصلي

مثال

مطلوبة: يجب أن يضبط طلبك قيمة travelMode على TRUCK وأن يملأ عنصر vehicleInfo بالأبعاد والسمات المحدّدة لمركبتك.

على سبيل المثال، يبدو نص طلب 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
    }
  }
}

تعالج الخدمة هذا الطلب وتعرض مسارًا يراعي ملف المركبة المحدّد. يمكن أن تتضمّن الاستجابة خطًا متعدد الأضلاع للمسار، ووقتًا تقديريًا للوصول خاصًا بالشاحنات، ومسافة التنقّل، ورمزًا مميزًا للمسار يمكن استخدامه مع حزمة تطوير البرامج Navigation SDK، وذلك استنادًا إلى fieldmask المحدّد. يشير الردّ أيضًا إلى ما إذا كان يتعذّر العثور على مسار متوافق تمامًا.

محتوى الطلب والاستجابة

يلخّص الجدول التالي المراجع التي تستخدمها لتقديم طلب توجيه للمركبات الكبيرة والبيانات التي يعرضها.

طلب المحتوى محتوى الرد تنسيق الإرجاع
  • إحداثيات نقطة الانطلاق والوجهة
  • عنصر VehicleInfo يحتوي على أبعاد المركبة ووزنها وأنواع المواد الخطرة.
  • خطوط متعددة للمسار
  • مدة الرحلة المخصّصة للشاحنات وdistanceMeters
  • ‫routeToken لاستخدامها مع حزمة Navigation SDK.
  • عنصر travelAdvisory يشير إلى ما إذا كان routeRestrictionsPartiallyIgnored.
 JSON

القيود

قبل البدء، يجب أن تكون على دراية بالقيود والمتطلبات التالية.

  • مدى التوفّر الجغرافي: تتوفّر ميزة توجيه المركبات الكبيرة فقط في الولايات المتحدة الـ 48 المتجاورة.
  • خدمة توجيه المركبات الكبيرة هي عرض في مرحلة المعاينة. يجب ألّا يعتمد السائقون بشكل كامل على المسارات التي تعرضها واجهة برمجة التطبيقات هذه لضمان السلامة أو الالتزام بالقانون. لا نضمن أن تكون المسارات مناسبة للمركبة، وقد يؤدي اتّباعها إلى تعرّض السائقين لمخاطر مثل الجسور المنخفضة أو الطرق التي يُحظر فيها مرور المركبات الكبيرة.
  • المسارات التي يتم تحديدها بأفضل جهد: في بعض الحالات، لا يمكن لواجهة برمجة التطبيقات العثور على مسار يلتزم بشكل كامل بقيود السفر. بدلاً من ذلك، تعرض الخدمة مسارًا "بأفضل ما يمكن"، وقد يمرّ هذا المسار بمناطق محظورة. تحدّد استجابة Routes API هذه المسارات بوضوح في الحقل routeRestrictionsPartiallyIgnored. لذا، عليك التخطيط لمسارك بعناية في هذه الحالات، ويُفضّل استخدام بيانات مصدر أخرى. لا تستخدِم مسارًا تم الإبلاغ عنه كمصدر وحيد للمعلومات عند التخطيط أو التنقّل.
  • الميزات غير المتوافقة: نعمل على توفير المزيد من الوظائف في هذه الخدمة، ولكن تحديد المسار للمركبات الكبيرة لا يتيح حاليًا ما يلي:
    • أسعار رسوم عبور الشاحنات
    • حدود السرعة
    • تحديد مسار المواد الخطرة المشعّة
  • حدود الاستخدام: تخضع جميع الطلبات لحدود الطلبات في الثانية (QPS) العادية.

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

  1. إعداد مشروعك: تأكَّد من إنشاء مشروعك على Google Cloud وتفعيله لاستخدام Routes API.
  2. توفير ميزة توجيه المركبات الكبيرة: يُرجى التواصل مع ممثل Google لتوفير هذه الميزة التجريبية المحدودة لمشروعك.
  3. إنشاء طلب مسار: استدعِ نقطة النهاية computeRoutes مع ضبط travelMode على TRUCK وتحديد مركبة افتراضية باستخدام العنصر VehicleInfo.
  4. توفير اتّجاهات مفصّلة (اختياري): مرِّر routeToken من الردّ إلى حزمة Navigation SDK لبدء جلسة تنقّل.

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

  • البدء: إنشاء مسارات شاحنات وتقديرات لوقت الوصول باستخدام Routes API
  • إضافة ميزة التنقّل: توفير اتجاهات مفصّلة للتنقّل باستخدام مسارات مخصّصة للشاحنات
  • فهم الفوترة: يُرجى التواصل مع ممثل مبيعات Google