Waypoint

• تمثيل JSON

تغليف نقطة طريق تشير نقاط الطريق إلى بداية المسار ونهايته، وتشمل محطات التوقف الوسيطة على طول المسار.

تمثيل JSON
{ "via": boolean, "vehicleStopover": boolean, "sideOfRoad": boolean, // Union field location_type can be only one of the following: "location": { object (Location) }, "placeId": string, "address": string, "navigationPointToken": string // End of list of possible types for union field location_type. }

الحقول
via	boolean يضع علامة على نقطة الطريق هذه كمعلم رئيسي بدلاً من نقطة توقّف. لكل نقطة على المسار غير نقطة المرور في الطلب، يضيف الردّ إدخالاً إلى مصفوفة legs لتقديم تفاصيل عن محطات التوقف في هذا الجزء من الرحلة. اضبط هذه القيمة على "صحيح" عندما تريد أن يمرّ المسار بنقطة الطريق هذه بدون التوقف فيها. لا تؤدي نقاط الطريق إلى إضافة إدخال إلى مصفوفة legs، ولكنها توجّه الرحلة عبر نقطة الطريق. يمكنك ضبط هذه القيمة فقط على نقاط الطريق التي تكون وسيطة. يتعذّر تنفيذ الطلب إذا ضبطت هذا الحقل على نقاط الطريق النهائية. إذا تم ضبط ComputeRoutesRequest.optimize_waypoint_order على "صحيح"، لا يمكن ضبط هذا الحقل على "صحيح"، وإلا سيفشل الطلب.
vehicleStopover	boolean تشير إلى أنّ نقطة على المسار مخصّصة لتوقّف المركبات، حيث يكون الهدف إما استلام أو تسليم. عند ضبط هذه القيمة، لن يتضمّن المسار المحسوب نقاط على المسار غير via على الطرق غير المناسبة للاستلام والتسليم. لا يعمل هذا الخيار إلا مع وسيلتَي النقل DRIVE وTWO_WHEELER، وعندما تكون قيمة locationType هي Location.
sideOfRoad	boolean تشير إلى أنّ الموقع الجغرافي لنقطة على المسار هذه يهدف إلى أن تفضّل المركبة التوقف على جانب معيّن من الطريق. عند ضبط هذه القيمة، سيمرّ المسار بالموقع الجغرافي ليتمكّن من التوقف على جانب الطريق الذي يميل إليه الموقع الجغرافي من وسط الطريق. لا يعمل هذا الخيار إلا على DRIVE وTWO_WHEELER RouteTravelMode.
حقل الربط location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن يكون التعليق location_type إحدى القيم التالية فقط:
location	object (Location) تمثّل هذه السمة نقطة محدّدة باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري.
placeId	string تمثّل هذه السمة رقم تعريف المكان الخاص بنقطة الاهتمام المرتبط بنقطة على المسار.
address	string عنوان يمكن لشخص عادي قراءته أو رمز Plus Code لمزيد من التفاصيل، يُرجى الانتقال إلى https://plus.codes.
navigationPointToken	string رمز مميز يعرّف NavigationPoint، ويتم الحصول عليه من طريقة SearchDestinations في Geocoding API.