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 // 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 للاطّلاع على التفاصيل.