یک نقطه مسیر را در بر میگیرد. نقاط مسیر، ابتدا و انتهای یک مسیر را مشخص میکنند و شامل توقفگاههای میانی در طول مسیر نیز میشوند.
نمایش 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
این نقطهی مسیر را به عنوان یک نقطهی عطف به جای یک نقطهی توقف علامتگذاری میکند. برای هر نقطهی مسیر غیر از via در درخواست، پاسخ یک ورودی به آرایهی legs اضافه میکند تا جزئیات مربوط به توقف در آن بخش از سفر را ارائه دهد. وقتی میخواهید مسیر بدون توقف از این نقطهی مسیر عبور کند، این مقدار را روی true تنظیم کنید. نقاط مسیر via باعث اضافه شدن ورودی به آرایهی legs نمیشوند، اما سفر را از طریق نقطهی مسیر هدایت میکنند. شما فقط میتوانید این مقدار را روی نقاط مسیر میانی تنظیم کنید. اگر این فیلد را روی نقاط مسیر انتهایی تنظیم کنید، درخواست با شکست مواجه میشود. اگر ComputeRoutesRequest.optimize_waypoint_order روی true تنظیم شده باشد، این فیلد را نمیتوان روی true تنظیم کرد. در غیر این صورت، درخواست با شکست مواجه میشود.
vehicleStopover
boolean
نشان میدهد که نقطه مسیر برای توقف وسایل نقلیه در نظر گرفته شده است، جایی که قصد سوار کردن یا پیاده کردن مسافر را دارند. وقتی این مقدار را تنظیم میکنید، مسیر محاسبهشده شامل نقاط مسیر غیر via جادههایی که برای سوار کردن و پیاده کردن مسافر نامناسب هستند، نمیشود. این گزینه فقط برای حالتهای سفر DRIVE و TWO_WHEELER و زمانی که locationTypeLocation باشد، کار میکند.
sideOfRoad
boolean
نشان میدهد که موقعیت این نقطه مسیر طوری تنظیم شده است که وسیله نقلیه ترجیح میدهد در سمت خاصی از جاده توقف کند. وقتی این مقدار را تنظیم میکنید، مسیر از این موقعیت عبور میکند تا وسیله نقلیه بتواند در سمتی از جاده که موقعیت از مرکز جاده به سمت آن متمایل است، توقف کند. این گزینه فقط برای DRIVE و TWO_WHEELERRouteTravelMode کار میکند.
فیلد واحد location_type . روشهای مختلف برای نمایش یک مکان. location_type فقط میتواند یکی از موارد زیر باشد:
تاریخ آخرین بهروزرسانی 2026-03-05 بهوقت ساعت هماهنگ جهانی.
[[["درک آسان","easyToUnderstand","thumb-up"],["مشکلم را برطرف کرد","solvedMyProblem","thumb-up"],["غیره","otherUp","thumb-up"]],[["اطلاعاتی که نیاز دارم وجود ندارد","missingTheInformationINeed","thumb-down"],["بیشازحد پیچیده/ مراحل بسیار زیاد","tooComplicatedTooManySteps","thumb-down"],["قدیمی","outOfDate","thumb-down"],["مشکل ترجمه","translationIssue","thumb-down"],["مشکل کد / نمونهها","samplesCodeIssue","thumb-down"],["غیره","otherDown","thumb-down"]],["تاریخ آخرین بهروزرسانی 2026-03-05 بهوقت ساعت هماهنگ جهانی."],[],["Waypoints, marking route start, end, and intermediate stops, are defined using a JSON format. Key properties include `via` (boolean) for non-stopping waypoints, `vehicleStopover` (boolean) for pickup/drop-off locations, and `sideOfRoad` (boolean) for preferred stopping side. A waypoint's `location_type` can be specified via geographic coordinates (`location`), a place ID (`placeId`), or a human-readable address (`address`). `via` cannot be true for terminal waypoints or if `optimize_waypoint_order` is true.\n"]]
