تجنّب منعطفات انعطاف على شكل حرف 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 لأنّها تمنع العديد من هذه المنعطفات من خلال توجيه المركبة إلى جانب الطريق الأقرب إلى الوجهة. يؤدي ذلك إلى توجيه المركبة إلى الاقتراب من موقع الزيارة من اتجاه معيّن، ما يلغي الحاجة إلى الانعطاف بزاوية 180 درجة.

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

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

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

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

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

القيود

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

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