تجنّب منعطفات انعطاف على شكل حرف U

هذا المنتج أو الميزة في مرحلة تجريبية (ما قبل التوفر للجمهور العام). قد يكون الدعم المقدّم للمنتجات والميزات في مرحلة ما قبل التوفّر للجمهور العام محدودًا، وقد لا تكون التغييرات التي يتم إجراؤها على المنتجات والميزات هنا متوافقة مع الإصدارات الأخرى من هذه المرحلة. تخضع عروض مرحلة ما قبل التوفّر للجمهور العام لبنود الخدمة المحدّدة في "منصة خرائط Google". لمزيد من المعلومات، يُرجى الاطّلاع على أوصاف مراحل الإطلاق.

تجنُّب الانعطاف على شكل حرف U هي ميزة لتحسين المسار تمنع المركبات من الانعطاف على شكل حرف U في موقع الاستلام أو التسليم المحدّد للزيارة. من خلال ضبط إعداد تجنُّب الانعطاف على شكل حرف U، يمكنك تحديد أنّ المركبة يجب أن تتّجه في الاتجاه نفسه عند الوصول إلى موقع الزيارة وعند المغادرة منه.

تعمل ميزة "تجنُّب الانعطاف على شكل حرف U" بالطريقة التالية:

1. يمكنك ضبط السمة "تجنُّب الرجوع" لزيارة معيّنة.
2. تأخذ واجهة برمجة التطبيقات في الاعتبار اتجاهَي السير على الطرق ذات الاتجاهين وتختار المسار الأنسب.
3. تنشئ واجهة برمجة التطبيقات مسارًا تصل فيه المركبة وتغادر بدون أن تنعطف على شكل حرف U في الموقع الجغرافي للزيارة. قد يحتاج السائق إلى عبور الطريق للوصول إلى هذا الموقع الجغرافي.

هذه السمة مثالية للحالات التي يصعب فيها أو يستحيل فيها الالتفاف بسبب حجم المركبة أو إشارات المرور أو أحوال حركة المرور المعتادة.

الخصائص

يتم تحديد سمة تجنُّب المنعطف على شكل حرف U ضمن العنصر VisitRequest. يُستخدَم هذا العنصر داخل مصفوفتَي pickups وdeliveries الخاصة بالشحنة.

الموقع	النوع	الوصف
avoidUTurns	قيمة منطقية	عند ضبط القيمة على true، تمنع واجهة برمجة التطبيقات المركبة من الدوران في الاتجاه المعاكس في موقع الزيارة هذا. ستصل المركبة وتغادر وهي متجهة إلى الاتجاه نفسه.

أمثلة

يتناول هذا القسم نوعَين من الأمثلة:

• عيّنات التعليمات البرمجية التي توضّح بنية تجنُّب الانعطاف على شكل حرف U
• مثال على طلب يتضمّن الميزة

عيّنات تعليمات برمجية

يوضّح المثال التالي بنيةavoidUTurns ضمن عملية استلام وتسليم:

"pickups":[
  {
    "arrivalLocation": {
      "latitude": 37.42506261000996,
      "longitude": -122.09535511930135
    },
    "avoidUTurns": true
  }
],
"deliveries":[
  {
    "arrivalLocation": {
      "latitude": 37.42421503206021,
      "longitude": -122.09526063135228
    },
    "avoidUTurns": true
  }
]

مثال على الطلب

يعرض المثال التالي طلب optimizeTours أساسيًا يتضمّن تجنُّب المنعطفات الحادة. يتضمّن هذا الطلب العناصر التالية:

• شحنة تتضمّن عملية استلام وتسليم داخل العنصر model
• يجب ضبط السمة avoidUTurns على القيمة true في كل من موقعَي الاستلام والتسليم لمنع المركبة من تغيير اتجاهها عند هاتين المحطتين.

  {
    "model": {
      "shipments":[
        {
          "pickups":[
            {
              "arrivalLocation": {
                "latitude": 37.42506261000996,
                "longitude": -122.09535511930135
              },
              "avoidUTurns": true
            }
          ],
          "deliveries":[
            {
              "arrivalLocation": {
                "latitude": 37.42421503206021,
                "longitude": -122.09526063135228
              },
              "avoidUTurns": true
            }
          ]
        }
      ],
      "vehicles":[
        {
          "travelMode": "DRIVING",
          "costPerKilometer": 1.0
        }
      ]
    }
  }

تجنُّب المنعطفات على شكل حرف U باستخدام sideOfRoad

على الرغم من أنّ ميزة sideOfRoad هي ميزة منفصلة، إلا أنّها مرتبطة ارتباطًا وثيقًا بميزة تجنُّب الانعطاف على شكل حرف U لأنّها تمنع العديد من الانعطافات على شكل حرف U من خلال توجيه المركبة إلى جانب الطريق الأقرب إلى الوجهة. يؤدي ذلك إلى توجيه المركبة إلى الاقتراب من موقع الزيارة من اتجاه معيّن، ما يلغي الحاجة إلى الانعطاف على شكل حرف U.

في الواقع، يجب استخدام ميزة تجنُّب الانعطاف على شكل حرف U عندما يكون من الآمن عبور الطريق سيرًا على الأقدام للوصول إلى موقع الزيارة. إذا كان عبور الطريق غير مستحسَن أو غير ممكن، ننصحك بضبط sideOfRoad على true بدلاً من ذلك.

يتم تحديد السمة sideOfRoad ضمن عنصر Waypoint.

التفاعل مع الميزات الأخرى

تتفاعل ميزة تجنُّب الانعطاف على شكل حرف U مع ميزات التوجيه الأخرى بالطرق التالية:

• جانب الطريق: يؤدي ضبط كل من avoidUTurns وsideOfRoad على true إلى زيادة فرص تجنُّب الانعطاف على شكل حرف U بشكل طفيف أثناء توجيه المركبة إلى جانب الطريق الأقرب إلى موقع الزيارة. ومع ذلك، يؤدي ذلك إلى تعقيدات إضافية متعلّقة بقيود تجنُّب الانعطاف على شكل حرف U. بالنسبة إلى معظم مواقع الزيارات، يكفي ضبط سمة واحدة فقط من هذه السمات لتجنُّب الانعطافات.
• الحلول التي تم إدخالها: عند استخدام ميزة تجنُّب الانعطاف على شكل حرف U، يتضمّن الردّ من واجهة برمجة التطبيقات injectedSolutionLocationToken داخل ShipmentRoute.Visit الذي تم إنشاؤه لتسجيل الجانب الذي تم اختياره من الطريق. إذا أعدت استخدام هذه الزيارة كحلّ مُدرَج في طلب مستقبلي، عليك إعادة تمرير هذا الرمز المميز إلى واجهة برمجة التطبيقات.

القيود

ميزة تجنُّب الانعطاف على شكل حرف U هي ميزة نبذل قصارى جهدنا لتوفيرها. قد تظل واجهة برمجة التطبيقات تتضمّن منعطفات على شكل حرف U في مسار تم إنشاؤه في الحالات التالية:

• تم ضبط وضع السفر على وضع آخر غير DRIVING.
• أن تكون مواقع الوصول والمغادرة لموقع جغرافي معيّن مختلفَين. في هذه الحالة، ستعرض واجهة برمجة التطبيقات رسالة خطأ.
• يقع المكان على طريق مسدود، ما يتطلّب إجراء انعطاف على شكل حرف U للخروج.
• يحدث الانعطاف على شكل حرف U على طول المسار، وليس في الموقع الجغرافي الفعلي للزيارة.
• المناورة هي منعطف حاد جدًا إلى طريق آخر، ولا تصنّفها واجهة برمجة التطبيقات على أنّها انعطاف على شكل حرف U.