Waypoint

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

تمثيل 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 لتقديم تفاصيل محطات التوقف في تلك المرحلة من الرحلة. عيّن هذه القيمة على "true" عندما تريد أن يمر المسار خلال نقطة الطريق هذه بدون التوقف. لا تتسبب نقاط الطريق في إضافة مدخل إلى مصفوفة legs، ولكنها توجّه الرحلة خلال نقطة الطريق. يمكنك فقط ضبط هذه القيمة على نقاط الطريق التي تكون وسيطة. يتعذّر الطلب في حال ضبط هذا الحقل على نقاط الطريق الطرفية. إذا تم ضبط ComputeRoutesRequest.optimize_waypoint_order على "صحيح"، لا يمكن ضبط هذا الحقل على "صحيح" وإلا سيتعذّر تنفيذ الطلب.

vehicleStopover

boolean

تشير هذه القيمة إلى أنّ نقطة الطريق مخصّصة للمركبات للتوقف عندها، والهدف من ذلك هو الاستلام أو النزول. وعند ضبط هذه القيمة، لن يتضمّن المسار المحسوب على طرق غير مناسبة للاستلام والتسليم. ويعمل هذا الخيار فقط مع أوضاع السفر DRIVE وTWO_WHEELER، وعندما تكون قيمة locationType هي Location.via

sideOfRoad

boolean

تشير هذه القيمة إلى أن الموقع الجغرافي لنقطة الطريق هذه يهدف إلى تفضيل المركبة للتوقف على جانب معين من الطريق. عند تعيين هذه القيمة، سيمر المسار عبر الموقع بحيث يمكن للمركبة أن تتوقف على جانب الطريق الذي ينحني الموقع نحوه من مركز الطريق. لا يعمل هذا الخيار إلا مع DRIVE وTWO_WHEELER RouteTravelMode.

حقل الاتحاد location_type طرق مختلفة لتمثيل موقع جغرافي يمكن أن تكون السمة "location_type" واحدة فقط مما يلي:
location

object (Location)

نقطة محددة باستخدام الإحداثيات الجغرافية، بما في ذلك عنوان اختياري.

placeId

string

رقم تعريف مكان نقطة الاهتمام المرتبط بالنقطة الوسيطة.

address

string

عنوان يمكن لشخص عادي قراءته أو رمز موقع مفتوح. لمزيد من التفاصيل، يمكنك الاطّلاع على https://plus.codes.