Waypoint

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

تمثيل JSON 
{
  "via": boolean,
  "vehicleStopover": boolean,
  "sideOfRoad": boolean,

  // The following is a list of mutually exclusive fields. At most one of the
  // fields will be set in a response:
  "location": {
    object (Location)
  },
  "placeId": string,
  "address": string,
  "navigationPointToken": string
  // End of mutually exclusive fields.
}
الحقول
via

boolean

يضع علامة على نقطة الطريق هذه كمعلم رئيسي بدلاً من نقطة توقّف. لكل نقطة على المسار غير نقطة المرور في الطلب، يضيف الردّ إدخالاً إلى مصفوفة legs لتقديم تفاصيل عن محطات التوقف في هذا الجزء من الرحلة. اضبط هذه القيمة على "صحيح" عندما تريد أن يمرّ المسار بنقطة الطريق هذه بدون التوقف فيها. لا تؤدي نقاط الطريق إلى إضافة إدخال إلى مصفوفة legs، ولكنّها توجّه الرحلة عبر نقطة الطريق. يمكنك ضبط هذه القيمة فقط على نقاط الطريق التي تكون وسيطة. يتعذّر تنفيذ الطلب إذا ضبطت هذا الحقل على نقاط الطريق النهائية. في حال ضبط ComputeRoutesRequest.optimize_waypoint_order على "صحيح"، لا يمكن ضبط هذا الحقل على "صحيح"، وإلا سيفشل الطلب.
vehicleStopover

boolean

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

boolean

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

object (Location)

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

string

تمثّل هذه السمة رقم تعريف المكان الخاص بنقطة الاهتمام المرتبطة بنقطة على المسار.
address

string

عنوان يمكن لشخص عادي قراءته أو رمز Plus Codes لمزيد من التفاصيل، يُرجى الانتقال إلى https://plus.codes.
navigationPointToken

string

رمز مميز يعرّف NavigationPoint، ويتم الحصول عليه من طريقة SearchDestinations في Geocoding API.
نهاية الحقول التي يستبعد كلّ منها الآخر