تجنُّب الانعطاف للخلف في المواقع الجغرافية لاستلام الطلب والتسليم
تنظيم صفحاتك في مجموعات
يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
بشكل تلقائي، يمكن للمركبات الوصول إلى موقع استلام أو تسليم من أي اتجاه، ثم المغادرة في أي اتجاه. في بعض الحالات، يؤدي ذلك إلى إجبار المركبة على الانعطاف على شكل حرف U في الموقع الجغرافي للزيارة، وهو ما قد يكون صعبًا أو مستحيلاً بسبب حجم المركبة أو إشارات المرور في الموقع الجغرافي أو ظروف حركة المرور المعتادة.
لمنع المركبات من تغيير اتجاهها بين الوصول والمغادرة في موقع جغرافي محدّد للاستلام أو التسليم، يمكنك ضبط قيمة avoid_u_turns على "صحيح" لهذا الموقع الجغرافي. بموجب هذا الإعداد، ستصل المركبة إلى الموقع الجغرافي وتغادره بالاتجاه نفسه، ما يمنعها من الدوران. في الطرق ذات الاتجاهين، سيأخذ برنامج الحلّ كلا الاتجاهين في الاعتبار ويختار أحدهما كجزء من عملية تحسين المسار.
يمكنك أيضًا ضبط side_of_road على "صحيح" للحصول على مسار تصل فيه المركبة وتغادر من جانب الطريق الأقرب إلى نقطة الطريق. في هذه الحالة، لا تغيّر المركبة اتجاهها أيضًا بين وقت الوصول ووقت المغادرة. يمكن ضبط كلّ من side_of_road وavoid_u_turns على القيمة true
لتحقيق النتيجة نفسها. لمزيد من التفاصيل، يُرجى الاطّلاع على التفاعل مع الميزات الأخرى.
من الناحية العملية، يجب استخدام avoid_u_turns عندما يكون من الآمن عبور الطريق للوصول إلى نقطة الطريق. استخدِم side_of_road عندما لا يُنصح بالعبور أو عندما يكون غير ممكن.
مثال: تقديم طلب OptimizeTours باستخدام avoid_u_turns
يمكن تقديم طلبات OptimizeTours باستخدام REST أو gRPC.
قبل تقديم طلب، استبدِل المَعلمات التالية بقيم مناسبة لبيئتك:
يمكن استخدام avoid_u_turns مع side_of_road = true. في هذه الحالة، يتم تجنُّب المنعطفات على شكل حرف U، ولكن يختار الحلّ مسارًا يكون فيه مسار المركبة على الجانب نفسه من الطريق الذي تقع فيه نقطة الطريق، على غرار ضبط side_of_road = true فقط.
عندما تكون قيمة avoid_u_turns = true لطلب زيارة معيّن هي "صحيح"، يتم ضبط الحقل injected_solution_location_token في الردّ المقابل على "صحيح".ShipmentRoute.Visit إنّ المعنى الدقيق لقيمة هذا الحقل هو تفصيل تنفيذي، ولكنّه يشفّر المعلومات حول جانب الطريق الذي اختاره محلّل المشاكل.
عند استخدام ShipmentRoute.Visit كجزء من طلب الإدخال، إذا كان ShipmentRoute.Visit يتوافق مع VisitRequest الذي يتضمّن avoid_u_turns = true، يجب أن يحتوي ShipmentRoute.Visit على injected_solution_location_token سبق أن عرضته أداة حلّ المشاكل.
القيود
يتم بذل أقصى جهد لتجنُّب الانعطافات على شكل حرف U. في بعض الحالات، قد يظل المسار يتضمّن منعطفات على شكل حرف U:
لا يعمل avoid_u_turns إلا مع وسائل النقل التي تتيح استخدام side_of_road.
على وجه التحديد، لا يتوافق مع وضع السفر WALKING.
لا يمكن استخدام avoid_u_turns لعمليات الاستلام والتسليم التي لا تتطابق فيها نقطتا المغادرة والوصول.
عندما يكون مكان الاستلام أو التسليم في طريق مسدود، يجب إجراء انعطاف على شكل حرف U لمغادرة الطريق.
تهدف هذه الميزة إلى تجنُّب الانعطافات على شكل حرف U في مواقع الاستلام والتسليم.
لا يتم تجنُّب المنعطفات على شكل حرف U بين نقاط الطريق.
لا تُعتبر المنعطفات الحادة جدًا إلى طريق آخر منعطفات على شكل حرف U، ولن يتم تجنُّبها بشكل عام.
هناك قيود إضافية أثناء تطوير هذه الميزة. ونتوقّع أن يتم رفع هذه القيود مع تطوّر الميزة.
تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)
[null,null,["تاريخ التعديل الأخير: 2025-08-29 (حسب التوقيت العالمي المتفَّق عليه)"],[[["\u003cp\u003eVehicles typically arrive and depart from locations in any direction, potentially requiring u-turns.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eavoid_u_turns\u003c/code\u003e setting prevents vehicles from changing direction at a pickup or delivery location, ensuring arrival and departure with the same heading.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eside_of_road\u003c/code\u003e setting ensures vehicles arrive and leave on the side of the road closest to the waypoint, also avoiding changes in heading.\u003c/p\u003e\n"],["\u003cp\u003e\u003ccode\u003eavoid_u_turns\u003c/code\u003e and \u003ccode\u003eside_of_road\u003c/code\u003e can be used together to prevent u-turns while also maintaining the vehicle's position on the correct side of the road.\u003c/p\u003e\n"],["\u003cp\u003eU-turn avoidance is not supported in all travel modes, such as \u003ccode\u003eWALKING\u003c/code\u003e mode, and is also not supported when the arrival and departure locations for a delivery or pickup differ.\u003c/p\u003e\n"]]],[],null,["\u003cbr /\u003e\n\n| This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the [Google\n| Maps Platform Service Specific Terms](https://cloud.google.com/maps-platform/terms/maps-service-terms). For more information, see the [launch stage descriptions](/maps/launch-stages).\n\n\u003cbr /\u003e\n\nBy default, vehicles can arrive at a pickup or a delivery location from any\ndirection, and then leave in any direction. In some cases, this forces\nthe vehicle to make a u-turn at the visit location, which may be difficult or\nimpossible because of vehicle size, traffic signs at the location, or usual\ntraffic conditions.\n\nTo prevent vehicles from changing direction between the arrival and departure\nfor a given pickup or delivery location, you can set [`avoid_u_turns`](/maps/tt/route-optimization/experimental/u-turn-avoidance/reference/rest/v1/ShipmentModel#VisitRequest.FIELDS.avoid_u_turns) to\ntrue for this location. Under this setting, the vehicle will arrive and leave\nthe location with the same heading, thus avoiding the u-turn. On two-way roads\nthe solver will consider both directions and choose one as part of the route\noptimization.\n\nYou can also set [`side_of_road`](/maps/tt/route-optimization/experimental/u-turn-avoidance/reference/rest/v1/projects/optimizeTours#google.maps.routeoptimization.v1.Waypoint.FIELDS.bool.google.maps.routeoptimization.v1.Waypoint.side_of_road) to true to obtain a route where the vehicle\narrives and leaves on the side of the road closest to the waypoint. In this\ncase, the vehicle also does not change heading between the arrival and the\ndeparture. It is possible to set both `side_of_road` and `avoid_u_turns` to true\nto achieve the same result. For details, see [Interaction with other\nfeatures](#interaction_with_other_features).\n\nIn practice, `avoid_u_turns` should be used when it is safe to cross the road to\nget to the waypoint. Use `side_of_road` when crossing is discouraged or not\npossible.\n\nExample: Make an `OptimizeTours` request with `avoid_u_turns`\n\n`OptimizeTours` requests can be made using either [REST](/maps/tt/route-optimization/experimental/u-turn-avoidance/reference/rest/v1/projects/optimizeTours) or [gRPC](/maps/tt/route-optimization/experimental/u-turn-avoidance/reference/rpc/google.maps.routeoptimization.v1#routeoptimization).\n\nBefore making a request, replace the following parameters with values\nappropriate for your environment:\n\n- Ensure you have [Application Default Credentials](https://cloud.google.com/docs/authentication/provide-credentials-adc) configured as described in [Use OAuth](/maps/documentation/route-optimization/oauth-token).\n- Set \u003cvar label=\"project_number\" translate=\"no\"\u003ePROJECT_NUMBER_OR_ID\u003c/var\u003e to your Cloud\n project number or ID.\n\n The following command sends an `OptimizeTours` request to the Route\n Optimization API and receives a response synchronously. \n\n ```scdoc\n curl -X POST 'https://routeoptimization.googleapis.com/v1/projects/PROJECT_NUMBER_OR_ID:optimizeTours' \\\n -H \"Content-Type: application/json\" \\\n -H \"Authorization: Bearer $(gcloud auth application-default print-access-token)\" \\\n --data @- \u003c\u003cEOM\n {\n \"model\": {\n \"shipments\": [\n {\n \"pickups\": [\n {\n \"arrivalLocation\": {\n \"latitude\": 37.42506261000996,\n \"longitude\": -122.09535511930135\n },\n \"avoidUTurns\": true\n }\n ],\n \"deliveries\": [\n {\n \"arrivalLocation\": {\n \"latitude\": 37.42421503206021,\n \"longitude\": -122.09526063135228\n },\n \"avoidUTurns\": true\n }\n ]\n }\n ],\n \"vehicles\": [\n {\n \"travelMode\": \"DRIVING\",\n \"costPerKilometer\": 1.0\n }\n ],\n }\n }\n EOM\n ```\n | **Note:** this example uses the `--data @-` to read a request from standard input. Use `--data @`\u003cvar label=\"curl_filename\" translate=\"no\"\u003eFilename\u003c/var\u003e to read from a file.\n\nOnce the request completes, you'll receive a response message.\n\nInteraction with other features\n\n- `avoid_u_turns` can be used together with `side_of_road = true`. In this case, u-turns are avoided, but the solver selects a route that the vehicle is on the same side of the road as the waypoint, similar to setting `side_of_road = true` alone.\n- When `avoid_u_turns = true` for a certain visit request, then the `ShipmentRoute.Visit` in the corresponding response has the field `injected_solution_location_token` set. The precise meaning of its value is an implementation detail, but it encodes the information about the side of the road picked by the solver.\n- When you use a `ShipmentRoute.Visit` as part of the input request, if that `ShipmentRoute.Visit` corresponds to a `VisitRequest` in which `avoid_u_turns = true`, then `ShipmentRoute.Visit` must contain an `injected_solution_location_token` previously returned by the solver.\n\nLimitations\n\nU-turn avoidance is best effort. In certain situations, the route may still\ncontain u-turns:\n\n- `avoid_u_turns` works only with travel modes that support [`side_of_road`](/maps/tt/route-optimization/experimental/u-turn-avoidance/reference/rest/v1/projects/optimizeTours#google.maps.routeoptimization.v1.Waypoint.FIELDS.bool.google.maps.routeoptimization.v1.Waypoint.side_of_road). Specifically, it is not supported for the `WALKING` travel mode.\n- `avoid_u_turns` can't be used for pickups and deliveries where the arrival and departure are not the same.\n- When a pickup or a delivery is on a dead-end road, it is necessary to make a u-turn to leave the road.\n- The aim of this feature is avoiding u-turns at pickup and delivery locations. U-turns between waypoints are not avoided.\n- Very sharp turns to a different road are not considered u-turns, and they will generally not be avoided.\n\nThere are additional limitations while this feature is under development. We\nexpect them to be lifted as the feature evolves.\n\n- `avoid_u_turns` can't be used together with [`interpret_injected_solutions_using_labels`](/maps/tt/route-optimization/experimental/u-turn-avoidance/reference/rest/v1/projects/optimizeTours#google.maps.routeoptimization.v1.OptimizeToursRequest.FIELDS.bool.google.maps.routeoptimization.v1.OptimizeToursRequest.interpret_injected_solutions_using_labels)."]]