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 // 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".
حقل الاتحاد location_type. الطرق المختلفة لتمثيل الموقع الجغرافي. يمكن أن يكون location_type واحدًا فقط مما يلي:
location	object (Location) نقطة يتم تحديدها باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري.
placeId	string رقم تعريف مكان نقطة الاهتمام المرتبط بالنقطة الوسيطة.