Routes Preferred API در حال حاضر فقط برای مشتریان منتخب در دسترس است. برای کسب اطلاعات بیشتر با واحد فروش تماس بگیرید.

این صفحه به‌وسیله ‏Cloud Translation API‏ ترجمه شده است.

Package google.maps.routes.v1

شاخص

RoutesPreferred (رابط)
ComputeCustomRoutesRequest (پیام)
ComputeCustomRoutesResponse (پیام)
ComputeCustomRoutesResponse.FallbackInfo (پیام)
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective (enum)
ComputeRouteMatrixRequest (پیام)
ComputeRoutesRequest (پیام)
ComputeRoutesResponse (پیام)
CustomRoute (پیام)
FallbackInfo (پیام)
FallbackReason (تعدادی)
FallbackRoutingMode (enum)
Location (پیام)
Maneuver (enum)
NavigationInstruction (پیام)
Polyline (پیام)
PolylineEncoding (enum)
PolylineQuality (تعدادی)
Route (پیام)
RouteLeg (پیام)
RouteLegStep (پیام)
RouteLegStepTravelAdvisory (پیام)
RouteLegTravelAdvisory (پیام)
RouteMatrixDestination (پیام)
RouteMatrixElement (پیام)
RouteMatrixElementCondition (enum)
RouteMatrixOrigin (پیام)
RouteModifiers (پیام)
RouteObjective (پیام)
RouteObjective.RateCard (پیام)
RouteObjective.RateCard.MonetaryCost (پیام)
RouteTravelAdvisory (پیام)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (پیام)
SpeedReadingInterval.Speed (enum)
TollInfo (پیام)
TollPass (تعدادی)
Units (تعدادی)
VehicleEmissionType (تعدادی)
VehicleInfo (پیام)
Waypoint (پیام)

Routes Preferred

Routes Preferred API.

ComputeCustomRoutes

ComputeCustomRoutes
`rpc ComputeCustomRoutes( ComputeCustomRoutesRequest ) returns ( ComputeCustomRoutesResponse )` با توجه به مجموعه ای از ایستگاه های پایانه و میانی و یک هدف مسیر، بهترین مسیر را برای هدف مسیر محاسبه می کند. همچنین سریع ترین مسیر و کوتاه ترین مسیر را به عنوان مسیرهای مرجع برمی گرداند. توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا `fields` `$fields` ، یا با استفاده از هدر HTTP/gRPC `X-Goog-FieldMask` تهیه کنید (به پارامترها و سرصفحه‌های URL موجود مراجعه کنید. مقدار فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. این مستندات دقیق در مورد نحوه ساخت مسیرهای فیلد را ببینید. برای مثال در این روش: ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): `X-Goog-FieldMask: ` ماسک میدانی از فواصل مسیر، مدت زمان، نشانه و اطلاعات عوارض: `X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo` Google از استفاده از ماسک فیلد پاسخ ( `` ) یا مشخص کردن ماسک فیلد در سطح بالا ( `routes` ) جلوگیری می کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم. انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود. انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/maps-platform.routespreferred` برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

rpc ComputeCustomRoutes( ComputeCustomRoutesRequest ) returns ( ComputeCustomRoutesResponse )

با توجه به مجموعه ای از ایستگاه های پایانه و میانی و یک هدف مسیر، بهترین مسیر را برای هدف مسیر محاسبه می کند. همچنین سریع ترین مسیر و کوتاه ترین مسیر را به عنوان مسیرهای مرجع برمی گرداند.

توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا fields $fields ، یا با استفاده از هدر HTTP/gRPC X-Goog-FieldMask تهیه کنید (به پارامترها و سرصفحه‌های URL موجود مراجعه کنید. مقدار فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. این مستندات دقیق در مورد نحوه ساخت مسیرهای فیلد را ببینید.

برای مثال در این روش:

ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): X-Goog-FieldMask: *
ماسک میدانی از فواصل مسیر، مدت زمان، نشانه و اطلاعات عوارض: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google از استفاده از ماسک فیلد پاسخ ( * ) یا مشخص کردن ماسک فیلد در سطح بالا ( routes ) جلوگیری می کند، زیرا:

انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم.
انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود.
انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

https://www.googleapis.com/auth/maps-platform.routespreferred

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ComputeRouteMatrix

ComputeRouteMatrix
`rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )` فهرستی از مبدا و مقصد را می گیرد و جریانی حاوی اطلاعات مسیر را برای هر ترکیب مبدا و مقصد برمی گرداند. توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا `fields` `$fields` ، یا با استفاده از هدر HTTP/gRPC `X-Goog-FieldMask` تهیه کنید (به پارامترها و سرصفحه‌های URL موجود مراجعه کنید. مقدار فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. این مستندات دقیق در مورد نحوه ساخت مسیرهای فیلد را ببینید. برای مثال در این روش: ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): `X-Goog-FieldMask: ` ماسک میدانی از مدت‌زمان مسیر، مسافت‌ها، وضعیت عنصر، وضعیت و شاخص‌های عنصر (نمونه‌ای از راه‌اندازی تولید): `X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration` بسیار مهم است که `status` در ماسک فیلد خود وارد کنید زیرا در غیر این صورت همه پیام‌ها درست به نظر می‌رسند. گوگل استفاده از ماسک فیلد پاسخ ( `` ) را منع می کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم. انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود. انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/maps-platform.routespreferred` برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )

فهرستی از مبدا و مقصد را می گیرد و جریانی حاوی اطلاعات مسیر را برای هر ترکیب مبدا و مقصد برمی گرداند.

برای مثال در این روش:

ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): X-Goog-FieldMask: *
ماسک میدانی از مدت‌زمان مسیر، مسافت‌ها، وضعیت عنصر، وضعیت و شاخص‌های عنصر (نمونه‌ای از راه‌اندازی تولید): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

بسیار مهم است که status در ماسک فیلد خود وارد کنید زیرا در غیر این صورت همه پیام‌ها درست به نظر می‌رسند. گوگل استفاده از ماسک فیلد پاسخ ( * ) را منع می کند، زیرا:

انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم.
انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود.
انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

https://www.googleapis.com/auth/maps-platform.routespreferred

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ComputeRoutes

ComputeRoutes
`rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )` با توجه به مجموعه ای از ایستگاه های پایانه و میانی، مسیر اصلی را به همراه مسیرهای جایگزین اختیاری برمی گرداند. توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا `fields` `$fields` ، یا با استفاده از هدر HTTP/gRPC `X-Goog-FieldMask` ارائه دهید (به پارامترها و سرصفحه‌های URL موجود مراجعه کنید. مقدار، فهرستی از مسیرهای فیلد جدا شده با کاما است. رجوع کنید به مستندات دقیق در مورد نحوه ساخت مسیرهای میدانی . برای مثال در این روش: ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): `X-Goog-FieldMask: ` ماسک میدانی از مدت زمان، فاصله و چند خط سطح مسیر (نمونه ای از تنظیمات تولید): `X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline` Google از استفاده از ماسک فیلد پاسخ ( `` ) یا مشخص کردن ماسک فیلد در سطح بالا ( `routes` ) جلوگیری می کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم. انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه قسمت ها را انتخاب کنید ، یا اگر همه قسمت ها را در سطح بالا انتخاب می کنید ، ممکن است تخریب عملکرد را تجربه کنید زیرا هر زمینه جدیدی که اضافه می کنیم به طور خودکار در پاسخ گنجانده می شود. انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود. محدوده مجوز به محدوده OAuth زیر نیاز دارد: `https://www.googleapis.com/auth/maps-platform.routespreferred` برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )

با توجه به مجموعه ای از ایستگاه های پایانه و میانی، مسیر اصلی را به همراه مسیرهای جایگزین اختیاری برمی گرداند.

توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا fields $fields ، یا با استفاده از هدر HTTP/gRPC X-Goog-FieldMask ارائه دهید (به پارامترها و سرصفحه‌های URL موجود مراجعه کنید. مقدار، فهرستی از مسیرهای فیلد جدا شده با کاما است. رجوع کنید به مستندات دقیق در مورد نحوه ساخت مسیرهای میدانی .

برای مثال در این روش:

ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): X-Goog-FieldMask: *
ماسک میدانی از مدت زمان، فاصله و چند خط سطح مسیر (نمونه ای از تنظیمات تولید): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google از استفاده از ماسک فیلد پاسخ ( * ) یا مشخص کردن ماسک فیلد در سطح بالا ( routes ) جلوگیری می کند، زیرا:

انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم.
انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه قسمت ها را انتخاب کنید ، یا اگر همه قسمت ها را در سطح بالا انتخاب می کنید ، ممکن است تخریب عملکرد را تجربه کنید زیرا هر زمینه جدیدی که اضافه می کنیم به طور خودکار در پاسخ گنجانده می شود.
انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود.

محدوده مجوز

به محدوده OAuth زیر نیاز دارد:

https://www.googleapis.com/auth/maps-platform.routespreferred

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ComputeCustomRoutesRequest

پیام درخواست computecustomroutes.

فیلدها
`origin`	`Waypoint` مورد نیاز. نقطه راه مبدأ
`destination`	`Waypoint` مورد نیاز. ایستگاه بین راهی مقصد
`intermediates[]`	`Waypoint` اختیاری. مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود.
`travel_ mode`	`RouteTravelMode` اختیاری. نحوه حمل و نقل را مشخص می کند. فقط `DRIVE` و "TWO_WHEELER" پشتیبانی می شوند.
`routing_ preference`	`RoutingPreference` اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر ترجیح مسیریابی منجر به خطا یا تأخیر طولانی مدت شود ، خطایی بازگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که `travel_mode` `DRIVE` یا `TWO_WHEELER` باشد، در غیر این صورت درخواست با شکست مواجه می شود.
`polyline_ quality`	`PolylineQuality` اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند.
`polyline_ encoding`	`PolylineEncoding` اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند.
`departure_ time`	`Timestamp` اختیاری. زمان حرکت اگر این مقدار را تنظیم نکردید ، این مقدار به زمانی که درخواست را انجام داده اید پیش فرض می شود. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً رخ داده است، درخواست با شکست مواجه می شود.
`route_ modifiers`	`RouteModifiers` اختیاری. مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد.
`route_ objective`	`RouteObjective` مورد نیاز. یک هدف مسیر برای بهینه سازی.
`language_ code`	`string` اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.
`units`	`Units` اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این شامل فیلد `instruction` در `NavigationInstruction` است. واحدهای اندازه گیری مورد استفاده برای مسیر، پا، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل درخواست استنتاج می شوند.

ComputeCustomRoutesResponse

پیام پاسخ ComputeCustomRoutes.

فیلدها
`routes[]`	`CustomRoute` "بهترین" مسیرها برای هدف مسیر ورودی.
`fastest_ route`	`CustomRoute` سریعترین مسیر مرجع.
`shortest_ route`	`CustomRoute` کوتاه ترین مسیر مرجع
`fallback_ info`	`FallbackInfo` اطلاعات برگشتی برای مسیرهای سفارشی.

اطلاعات برگشتی

اطلاعات بازگشتی را برای ComputeCustomRoutes در خود محفوظ می‌دارد. ComputeCustomRoutes دو نوع بازگشتی را انجام می دهد:

اگر نتواند مسیر را با استفاده از routing_preference درخواست شده توسط مشتری محاسبه کند، به حالت مسیریابی دیگر باز می گردد. در این مورد fallback_routing_mode و routing_mode_fallback_reason برای ارتباط حالت مسیریابی بازگشتی استفاده شده و همچنین دلیل بازگشت مجدد استفاده می‌شوند.
اگر نتواند یک "بهترین" مسیر را برای هدف مسیر مشخص شده توسط مشتری محاسبه کند، ممکن است به هدف دیگری بازگردد. fallback_route_objective برای برقراری ارتباط با هدف مسیر بازگشتی استفاده می شود.

فیلدها

فیلدها
`routing_ mode`	`FallbackRoutingMode` حالت مسیریابی برای پاسخ استفاده می شود. اگر بازگشت مجدد فعال شد، حالت ممکن است با اولویت مسیریابی تنظیم شده در درخواست مشتری اصلی متفاوت باشد.
`routing_ mode_ reason`	`FallbackReason` دلیل استفاده از پاسخ بازگشتی به جای پاسخ اصلی. این فیلد تنها زمانی پر می شود که حالت بازگشتی فعال شود و پاسخ بازگشتی برگردانده شود.
`route_ objective`	`FallbackRouteObjective` هدف مسیر مورد استفاده برای پاسخ. اگر بازگشت مجدد راه اندازی شد، ممکن است هدف با هدف مسیر ارائه شده در درخواست مشتری اصلی متفاوت باشد.

routing_ mode

FallbackRoutingMode

حالت مسیریابی برای پاسخ استفاده می شود. اگر بازگشت مجدد فعال شد، حالت ممکن است با اولویت مسیریابی تنظیم شده در درخواست مشتری اصلی متفاوت باشد.

routing_ mode_ reason

FallbackReason

دلیل استفاده از پاسخ بازگشتی به جای پاسخ اصلی. این فیلد تنها زمانی پر می شود که حالت بازگشتی فعال شود و پاسخ بازگشتی برگردانده شود.

route_ objective

FallbackRouteObjective

هدف مسیر مورد استفاده برای پاسخ. اگر بازگشت مجدد راه اندازی شد، ممکن است هدف با هدف مسیر ارائه شده در درخواست مشتری اصلی متفاوت باشد.

فال بازپرداخت

RouteObjective برای پاسخ استفاده می شود.

Enums
`FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED`	هدف مسیر بازگشتی مشخص نشده است.
`FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA`	اگر مشتری `RateCard` درخواست کند و include_tolls را روی true تنظیم کند و Google داده‌های قیمت عوارض مسیر را نداشته باشد، API بدون در نظر گرفتن قیمت عوارض به `RateCard` برمی‌گردد.

ComputeRouteMatrixRequest

پیام درخواست ComputeRouteMatrix

فیلدها
`origins[]`	`RouteMatrixOrigin` مورد نیاز. آرایه مبدا، که ردیف های ماتریس پاسخ را تعیین می کند. چندین محدودیت اندازه برای اصلی بودن مبدا و مقصد اعمال می شود: تعداد عناصر (منشا × مقصد) در هر صورت نباید بیشتر از 625 باشد. اگر routing_preference روی `TRAFFIC_AWARE_OPTIMAL` تنظیم شده باشد، تعداد عناصر (منشا × مقصد) نباید بیشتر از 100 باشد. تعداد نقاط راه (مبداء + مقصد) مشخص شده به عنوان `place_id` نباید بیشتر از 50 باشد.
`destinations[]`	`RouteMatrixDestination` مورد نیاز. آرایه ای از مقاصد، که ستون های ماتریس پاسخ را تعیین می کند.
`travel_ mode`	`RouteTravelMode` اختیاری. نحوه حمل و نقل را مشخص می کند.
`routing_ preference`	`RoutingPreference` اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که `travel_mode` `DRIVE` یا `TWO_WHEELER` باشد، در غیر این صورت درخواست با شکست مواجه می شود.
`departure_ time`	`Timestamp` اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً اتفاق افتاده است، درخواست با شکست مواجه می شود.

ComputeRoutesRequest

پیام درخواست ComputeRoutes .

فیلدها
`origin`	`Waypoint` مورد نیاز. نقطه راه مبدأ
`destination`	`Waypoint` مورد نیاز. ایستگاه بین راهی مقصد
`intermediates[]`	`Waypoint` اختیاری. مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود.
`travel_ mode`	`RouteTravelMode` اختیاری. نحوه حمل و نقل را مشخص می کند.
`routing_ preference`	`RoutingPreference` اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که `travel_mode` `DRIVE` یا `TWO_WHEELER` باشد، در غیر این صورت درخواست با شکست مواجه می شود.
`polyline_ quality`	`PolylineQuality` اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند.
`polyline_ encoding`	`PolylineEncoding` اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند.
`departure_ time`	`Timestamp` اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً رخ داده است، درخواست با شکست مواجه می شود.
`compute_ alternative_ routes`	`bool` اختیاری. تعیین می کند که آیا مسیرهای جایگزین علاوه بر مسیر محاسبه شود یا خیر. هیچ مسیر جایگزینی برای درخواست هایی که دارای ایستگاه های بین راهی هستند بازگردانده نمی شود.
`route_ modifiers`	`RouteModifiers` اختیاری. مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد.
`language_ code`	`string` اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.
`units`	`Units` اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این شامل فیلد `instruction` در `NavigationInstruction` است. واحدهای اندازه گیری مورد استفاده برای مسیر، پا، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل درخواست استنتاج می شوند.
`optimize_ waypoint_ order`	`bool` اگر optimizeWaypointOrder روی true تنظیم شده باشد، تلاش می‌شود تا ایستگاه‌های میانی مشخص شده را مجدداً ترتیب دهیم تا هزینه کلی مسیر به حداقل برسد. اگر هر یک از ایستگاه های بین راهی از طریق ایستگاه بین راه باشد، درخواست با شکست مواجه می شود. از `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` برای پیدا کردن سفارش جدید استفاده کنید. اگر `routes.optimized_intermediate_waypoint_index` در هدر `X-Goog-FieldMask` درخواست نشود، درخواست با شکست مواجه می شود. اگر `optimize_waypoint_order` روی FALSE تنظیم شده باشد ، `ComputeRoutesResponse.optimized_intermediate_waypoint_index` خالی است.

ComputeRoutesResponse

رایانه پیام پاسخ را انجام می دهد.

فیلدها

فیلدها
`routes[]`	`Route` حاوی آرایه‌ای از مسیرهای محاسبه‌شده (حداکثر سه) زمانی که شما `compute_alternatives_routes` مشخص می‌کنید، و فقط شامل یک مسیر است، در صورتی که این کار را نکنید. هنگامی که این آرایه حاوی چندین ورودی باشد، اولین مسیر توصیه شده است. اگر آرایه خالی باشد، به این معنی است که هیچ مسیری پیدا نشد.
`fallback_ info`	`FallbackInfo` در برخی موارد، زمانی که سرور قادر به محاسبه نتایج مسیر با تمام تنظیمات برگزیده ورودی نیست، ممکن است از روش دیگری برای محاسبه استفاده کند. هنگامی که از حالت بازگشتی استفاده می شود، این فیلد حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است.

routes[]

Route

حاوی آرایه‌ای از مسیرهای محاسبه‌شده (حداکثر سه) زمانی که شما compute_alternatives_routes مشخص می‌کنید، و فقط شامل یک مسیر است، در صورتی که این کار را نکنید. هنگامی که این آرایه حاوی چندین ورودی باشد، اولین مسیر توصیه شده است. اگر آرایه خالی باشد، به این معنی است که هیچ مسیری پیدا نشد.

fallback_ info

FallbackInfo

در برخی موارد، زمانی که سرور قادر به محاسبه نتایج مسیر با تمام تنظیمات برگزیده ورودی نیست، ممکن است از روش دیگری برای محاسبه استفاده کند. هنگامی که از حالت بازگشتی استفاده می شود، این فیلد حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است.

مسیر سفارشی

یک مسیر سفارشی محاسبه شده بر اساس هدف مسیر مشخص شده توسط مشتری را در بر می گیرد. CustomRoute حاوی یک مسیر و یک نشانه مسیر است که می‌تواند به NavSDK ارسال شود تا مسیر سفارشی را برای پیمایش نوبتی بازسازی کند.

فیلدها

فیلدها
`route`	`Route` مسیر "بهترین" برای هدف مسیر ورودی در نظر گرفته شده است.
`token`	`string` Web-Safe Base64 نشانه مسیر رمزگذاری شده که می تواند به NAVSDK منتقل شود ، که به NAVSDK اجازه می دهد مسیر را در حین ناوبری بازسازی کند ، و در صورت استفاده مجدد از افتخار قصد اصلی را هنگامی که `ComputeCustomRoutes` `RoutesPreferred` نامیده می شود. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند.

route

Route

مسیر "بهترین" برای هدف مسیر ورودی در نظر گرفته شده است.

token

string

Web-Safe Base64 نشانه مسیر رمزگذاری شده که می تواند به NAVSDK منتقل شود ، که به NAVSDK اجازه می دهد مسیر را در حین ناوبری بازسازی کند ، و در صورت استفاده مجدد از افتخار قصد اصلی را هنگامی که ComputeCustomRoutes RoutesPreferred نامیده می شود. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند.

اطلاعات برگشتی

اطلاعات مربوط به چگونگی و چرایی استفاده از یک نتیجه بازگشتی. اگر این فیلد تنظیم شده باشد، به این معنی است که سرور از یک حالت مسیریابی متفاوت از حالت دلخواه شما به عنوان بازگشت استفاده کرده است.

فیلدها

فیلدها
`routing_ mode`	`FallbackRoutingMode` حالت مسیریابی برای پاسخ استفاده می شود. اگر بازگشت مجدد فعال شد، حالت ممکن است با اولویت مسیریابی تنظیم شده در درخواست مشتری اصلی متفاوت باشد.
`reason`	`FallbackReason` دلیل استفاده از پاسخ بازگشتی به جای پاسخ اصلی. این فیلد تنها زمانی پر می شود که حالت بازگشتی فعال شود و پاسخ بازگشتی برگردانده شود.

routing_ mode

FallbackRoutingMode

reason

FallbackReason

FallbackReason

دلایل استفاده از پاسخ بازگشتی

Enums
`FALLBACK_REASON_UNSPECIFIED`	دلیل بازگشتی مشخص نشده است.
`SERVER_ERROR`	خطای سرور هنگام محاسبه مسیرها با حالت مسیریابی مورد نظر شما اتفاق افتاد ، اما ما توانستیم نتیجه محاسبه شده توسط یک حالت جایگزین را برگردانیم.
`LATENCY_EXCEEDED`	ما نتوانستیم محاسبه را با حالت مسیریابی دلخواه شما به موقع به پایان برسانیم، اما توانستیم یک نتیجه محاسبه شده توسط یک حالت جایگزین را برگردانیم.

حالت FallbackRouting

حالت مسیریابی واقعی برای پاسخ بازگشتی برگشتی استفاده می شود.

Enums
`FALLBACK_ROUTING_MODE_UNSPECIFIED`	استفاده نشده است.
`FALLBACK_TRAFFIC_UNAWARE`	نشان می دهد که از حالت مسیریابی `TRAFFIC_UNAWARE` برای محاسبه پاسخ استفاده شده است.
`FALLBACK_TRAFFIC_AWARE`	نشان می دهد که از حالت مسیریابی `TRAFFIC_AWARE` برای محاسبه پاسخ استفاده شده است.

مکان

یک مکان (نقطه جغرافیایی و عنوان اختیاری) را در بر می گیرد.

فیلدها

فیلدها
`lat_ lng`	`LatLng` مختصات جغرافیایی نقطه راه.
`heading`	`Int32Value` عنوان قطب نما با جهت جریان ترافیک مرتبط است. این مقدار سمت جاده را مشخص می کند که برای سوار شدن و رها کردن از آن استفاده کنید. مقادیر سرفصل می تواند از 0 تا 360 باشد، که در آن 0 عنوان شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند. شما می توانید از این قسمت فقط برای حالت های مسافرتی `DRIVE` و `TWO_WHEELER` استفاده کنید.

lat_ lng

LatLng

مختصات جغرافیایی نقطه راه.

heading

Int32Value

عنوان قطب نما با جهت جریان ترافیک مرتبط است. این مقدار سمت جاده را مشخص می کند که برای سوار شدن و رها کردن از آن استفاده کنید. مقادیر سرفصل می تواند از 0 تا 360 باشد، که در آن 0 عنوان شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند. شما می توانید از این قسمت فقط برای حالت های مسافرتی DRIVE و TWO_WHEELER استفاده کنید.

مانور

مجموعه‌ای از مقادیر که عمل ناوبری را برای مرحله فعلی مشخص می‌کند (مثلاً گردش به چپ، ادغام یا مستقیم).

Enums
`MANEUVER_UNSPECIFIED`	استفاده نشده است.
`TURN_SLIGHT_LEFT`	کمی به سمت چپ بپیچید.
`TURN_SHARP_LEFT`	به شدت به سمت چپ بپیچید.
`UTURN_LEFT`	یک چرخش U سمت چپ درست کنید.
`TURN_LEFT`	به چپ بپیچید.
`TURN_SLIGHT_RIGHT`	کمی به سمت راست بپیچید.
`TURN_SHARP_RIGHT`	به شدت به سمت راست بپیچید.
`UTURN_RIGHT`	یک دور به راست بپیچید.
`TURN_RIGHT`	به راست بپیچید.
`STRAIGHT`	مستقیم برو
`RAMP_LEFT`	رمپ سمت چپ را بگیرید.
`RAMP_RIGHT`	از رمپ سمت راست بروید.
`MERGE`	ادغام در ترافیک
`FORK_LEFT`	چنگال چپ را بردارید.
`FORK_RIGHT`	چنگال مناسب را بردارید.
`FERRY`	سوار کشتی شوید.
`FERRY_TRAIN`	سوار قطار منتهی به کشتی شوید.
`ROUNDABOUT_LEFT`	در دوربرگردان به چپ بپیچید.
`ROUNDABOUT_RIGHT`	به سمت راست در دور دور بپیچید.
`DEPART`	مانور اولیه
`NAME_CHANGE`	برای نشان دادن تغییر نام خیابان استفاده می شود.

راهنمای ناوبری

فیلدها

maneuver

Maneuver

دستورالعمل‌های پیمایش مرحله فعلی را در بر می‌گیرد (به عنوان مثال، گردش به چپ، ادغام یا مستقیم). این فیلد تعیین می کند که کدام نماد نمایش داده شود.

instructions

string

دستورالعمل پیمایش در این مرحله

پلی لاین

یک چند خط کدگذاری شده را در بر می گیرد.

فیلدها

فیلدها
فیلد اتحادیه `polyline_type` . نوع پلی لاین را کپسوله می کند. پیش‌فرض encoded_polyline است. `polyline_type` می تواند تنها یکی از موارد زیر باشد:
`encoded_ polyline`	`string` رمزگذاری رشته چند خط با استفاده از الگوریتم رمزگذاری چند خطی .
`geo_ json_ linestring`	`Struct` با استفاده از قالب GeoJSON LineString یک چند خط را مشخص می کند.

فیلد اتحادیه polyline_type . نوع پلی لاین را کپسوله می کند. پیش‌فرض encoded_polyline است. polyline_type می تواند تنها یکی از موارد زیر باشد:

encoded_ polyline

string

رمزگذاری رشته چند خط با استفاده از الگوریتم رمزگذاری چند خطی .

geo_ json_ linestring

Struct

با استفاده از قالب GeoJSON LineString یک چند خط را مشخص می کند.

PolylineEncoding

نوع ترجیحی چند خطی که باید برگردانده شود را مشخص می کند.

Enums
`POLYLINE_ENCODING_UNSPECIFIED`	هیچ نوع اولویت چند خطی مشخص نشده است. پیش‌فرض `ENCODED_POLYLINE` است.
`ENCODED_POLYLINE`	چند خطی را مشخص می کند که با استفاده از الگوریتم کدگذاری چند خطی کدگذاری شده است.
`GEO_JSON_LINESTRING`	با استفاده از قالب GeoJSON LineString یک چند خط را مشخص می کند.

کیفیت پلی لاین

مجموعه ای از مقادیر که کیفیت چند خط را مشخص می کند.

Enums
`POLYLINE_QUALITY_UNSPECIFIED`	هیچ اولویت کیفیت چند خطی مشخص نشده است. به طور پیش‌فرض به `OVERVIEW` .
`HIGH_QUALITY`	یک خط چند خطی با کیفیت بالا را مشخص می کند - که با استفاده از نقاط بیشتری نسبت به `OVERVIEW` ساخته شده است، به قیمت افزایش اندازه پاسخ. زمانی که به دقت بیشتری نیاز دارید از این مقدار استفاده کنید.
`OVERVIEW`	یک چند خط نمای کلی را مشخص می کند - که با استفاده از تعداد کمی از نقاط تشکیل شده است. هنگام نمایش یک نمای کلی از مسیر از این مقدار استفاده کنید. استفاده از این گزینه در مقایسه با استفاده از گزینه `HIGH_QUALITY` تاخیر درخواست کمتری دارد.

مسیر

یک مسیر را در بر می گیرد که شامل یک سری از بخش های جاده متصل است که به ایستگاه های ابتدایی، انتهایی و میانی می پیوندند.

فیلدها
`legs[]`	`RouteLeg` مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو نقطه راه غیر `via` است. به عنوان مثال، مسیری که هیچ ایستگاه بین راهی ندارد، تنها یک پا دارد. مسیری که شامل یک ایستگاه بین راهی غیر `via` ، دو پا دارد. مسیری که شامل یک مسیر `via` ایستگاه بین راهی است، یک پا دارد. ترتیب پاها با ترتیب نقاط راه از `origin` تا `intermediates` تا `destination` مطابقت دارد.
`distance_ meters`	`int32` مسافت طی مسیر، بر حسب متر.
`duration`	`Duration` مدت زمان لازم برای پیمایش مسیر. اگر `routing_preference` را روی `TRAFFIC_UNAWARE` تنظیم کنید، این مقدار همان `static_duration` است. اگر `routing_preference` را روی `TRAFFIC_AWARE` یا `TRAFFIC_AWARE_OPTIMAL` تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می‌شود.
`static_ duration`	`Duration` مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی.
`polyline`	`Polyline` چند خط کلی مسیر. این چند خط، چند خط ترکیبی همه `legs` است.
`description`	`string` شرح مسیر.
`warnings[]`	`string` مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر.
`viewport`	`Viewport` جعبه محدودیت نمای Polyline.
`travel_ advisory`	`RouteTravelAdvisory` اطلاعات تکمیلی در مورد مسیر.
`optimized_ intermediate_ waypoint_ index[]`	`int32` اگر `ComputeRoutesRequest.optimize_waypoint_order` روی true تنظیم شده باشد، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. برای مثال، فرض کنید ورودی Origin: LA باشد. واسطه ها: دالاس، بانگور، فینیکس؛ مقصد: نیویورک؛ و ترتیب میانی بهینه سازی شده عبارت است از: فونیکس، دالاس، بنگور. سپس این فیلد حاوی مقادیر [2، 0، 1] است. شاخص برای اولین نقطه میانی با 0 شروع می شود.

RouteLeg

قسمتی را بین نقاط راه غیر via کپسوله می کند.

فیلدها
`distance_ meters`	`int32` مسافت طی مسیر، بر حسب متر.
`duration`	`Duration` مدت زمان لازم برای حرکت در پا. اگر `route_preference` روی `TRAFFIC_UNAWARE` تنظیم شود، این مقدار همان `static_duration` است. اگر `route_preference` یا `TRAFFIC_AWARE` یا `TRAFFIC_AWARE_OPTIMAL` باشد، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.
`static_ duration`	`Duration` مدت زمان سفر از طریق پا، بدون در نظر گرفتن شرایط ترافیک محاسبه شده است.
`polyline`	`Polyline` چند خط کلی برای این پا. این شامل چند خط هر `step` است.
`start_ location`	`Location` محل شروع این پا. این ممکن است با `origin` ارائه شده متفاوت باشد. به عنوان مثال، زمانی که `origin` ارائه شده نزدیک جاده نباشد، این نقطه ای از جاده است.
`end_ location`	`Location` محل انتهایی این پا. این ممکن است با `destination` ارائه شده متفاوت باشد. به عنوان مثال ، هنگامی که `destination` ارائه شده در نزدیکی یک جاده نیست ، این یک نقطه در جاده است.
`steps[]`	`RouteLegStep` مجموعه‌ای از مراحل که بخش‌های درون این پا را نشان می‌دهد. هر مرحله نشان دهنده یک دستورالعمل ناوبری است.
`travel_ advisory`	`RouteLegTravelAdvisory` اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی و غیره در یک مسیر را در بر می گیرد.

RouteLegStep

قسمتی از RouteLeg را در بر می گیرد. یک مرحله مربوط به یک دستورالعمل ناوبری است. پایه های مسیر از پله ها تشکیل شده است.

فیلدها
`distance_ meters`	`int32` مسافت طی این مرحله، بر حسب متر است. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.
`static_ duration`	`Duration` مدت زمان سفر در این مرحله بدون در نظر گرفتن شرایط ترافیکی. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.
`polyline`	`Polyline` چند خط مرتبط با این مرحله.
`start_ location`	`Location` محل شروع این مرحله.
`end_ location`	`Location` محل پایان این مرحله.
`navigation_ instruction`	`NavigationInstruction` دستورالعمل های ناوبری.
`travel_ advisory`	`RouteLegStepTravelAdvisory` اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی در یک پله پا، در بر می گیرد.

RouteLegStepTravelAdvisory

اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی در یک پله پا، در بر می گیرد.

فیلدها

فیلدها
`speed_ reading_ intervals[]`	`SpeedReadingInterval` توجه: این فیلد در حال حاضر پر نشده است.

speed_ reading_ intervals[]

SpeedReadingInterval

توجه: این فیلد در حال حاضر پر نشده است.

RouteLegTravelAdvisory

اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی و غیره در یک مسیر را در بر می گیرد.

فیلدها

فیلدها
`toll_ info`	`TollInfo` اطلاعات مربوط به عوارض در `RouteLeg` خاص را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم عوارضی در `RouteLeg` وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد `estimated_price` پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد وجود نداشته باشد، هیچ عوارضی در `RouteLeg` وجود ندارد.
`speed_ reading_ intervals[]`	`SpeedReadingInterval` فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی `TRAFFIC_AWARE` و `TRAFFIC_AWARE_OPTIMAL` . فواصل، کل چند خط `RouteLeg` را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است. مثال: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_ info

TollInfo

اطلاعات مربوط به عوارض در RouteLeg خاص را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم عوارضی در RouteLeg وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد estimated_price پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد وجود نداشته باشد، هیچ عوارضی در RouteLeg وجود ندارد.

speed_ reading_ intervals[]

SpeedReadingInterval

فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL . فواصل، کل چند خط RouteLeg را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است.

مثال:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteMatrixDestination

یک مقصد واحد برای ComputeRouteMatrixRequest

فیلدها

فیلدها
`waypoint`	`Waypoint` مورد نیاز. ایستگاه بین راهی مقصد

waypoint

Waypoint

مورد نیاز. ایستگاه بین راهی مقصد

RouteMatrixElement

اطلاعات مسیر محاسبه شده برای یک جفت مبدا/مقصد را در ComputeRouteMatrix API محصور می کند. این پروتو را می توان برای مشتری پخش کرد.

فیلدها
`origin_ index`	`int32` شاخص مبتنی بر صفر مبدا در درخواست.
`destination_ index`	`int32` شاخص مبنی بر صفر مقصد در درخواست.
`status`	`Status` کد وضعیت خطا برای این عنصر.
`condition`	`RouteMatrixElementCondition` نشان می دهد که آیا مسیر پیدا شده است یا خیر. مستقل از وضعیت
`distance_ meters`	`int32` مسافت طی مسیر، بر حسب متر.
`duration`	`Duration` مدت زمان لازم برای پیمایش مسیر. اگر `routing_preference` را روی `TRAFFIC_UNAWARE` تنظیم کنید، این مقدار همان `static_duration` است. اگر `routing_preference` را روی `TRAFFIC_AWARE` یا `TRAFFIC_AWARE_OPTIMAL` تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می‌شود.
`static_ duration`	`Duration` مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی.
`travel_ advisory`	`RouteTravelAdvisory` اطلاعات تکمیلی در مورد مسیر به عنوان مثال: اطلاعات محدودیت و اطلاعات عوارض
`fallback_ info`	`FallbackInfo` در برخی موارد که سرور قادر به محاسبه مسیر با ترجیحات داده شده برای این جفت مبدا/مقصد خاص نیست، ممکن است به استفاده از حالت دیگری از محاسبه بازگردد. هنگامی که از حالت بازگشتی استفاده می شود، این قسمت حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است.

RouteMatrixElementCondition

وضعیت مسیر در حال برگشت.

Enums
`ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED`	فقط زمانی استفاده می شود که `status` عنصر خوب نباشد.
`ROUTE_EXISTS`	یک مسیر پیدا شد و اطلاعات مربوطه برای عنصر پر شد.
`ROUTE_NOT_FOUND`	هیچ مسیری پیدا نشد فیلدهای حاوی اطلاعات مسیر، مانند `distance_meters` یا `duration` ، در عنصر پر نمی‌شوند.

RouteMatrixOrigin

یک مبدا واحد برای ComputeRouteMatrixRequest

فیلدها

فیلدها
`waypoint`	`Waypoint` مورد نیاز. نقطه راه مبدأ
`route_ modifiers`	`RouteModifiers` اختیاری. اصلاح‌کننده‌ها برای هر مسیری که این را مبدأ می‌گیرد

waypoint

Waypoint

مورد نیاز. نقطه راه مبدأ

route_ modifiers

RouteModifiers

اختیاری. اصلاح‌کننده‌ها برای هر مسیری که این را مبدأ می‌گیرد

رویه سازان

مجموعه ای از شرایط اختیاری را در بر می گیرد تا هنگام محاسبه مسیرها برآورده شوند.

فیلدها
`avoid_ tolls`	`bool` وقتی روی true تنظیم شود، در صورت معقول بودن از جاده‌های عوارضی اجتناب می‌کند و به مسیرهایی که شامل جاده‌های عوارضی نیستند، ترجیح می‌دهد. فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` اعمال می‌شود.
`avoid_ highways`	`bool` وقتی روی true تنظیم شود، از بزرگراه‌هایی که معقول باشد اجتناب می‌کند و به مسیرهایی که شامل بزرگراه نیستند ترجیح می‌دهد. فقط مربوط به حالت های مسافرتی `DRIVE` و `TWO_WHEELER` است.
`avoid_ ferries`	`bool` وقتی روی true تنظیم شود، در صورت معقول بودن از کشتی‌ها اجتناب می‌کند و به مسیرهایی که شامل کشتی نیستند ترجیح می‌دهد. فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` اعمال می‌شود.
`avoid_ indoor`	`bool` وقتی روی true تنظیم شود، از پیمایش در داخل خانه در جایی که معقول باشد اجتناب می‌کند، و ترجیح می‌دهد مسیرهایی که حاوی ناوبری داخلی نیستند. فقط برای حالت سفر `WALK` اعمال می شود.
`vehicle_ info`	`VehicleInfo` اطلاعات خودرو را مشخص می کند.
`toll_ passes[]`	`TollPass` اطلاعات مربوط به مجوزهای دریافت عوارض را در خود گنجانده است. اگر مجوزهای عوارضی ارائه شود، API سعی می‌کند قیمت گذر را برگرداند. اگر مجوزهای دریافت عوارض ارائه نشود، API کارت عوارضی را ناشناخته تلقی می کند و سعی می کند قیمت نقدی را برگرداند. فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` اعمال می‌شود.

RouteObjective

هدفی را برای بهینه سازی توسط ComputeCustomRoutes در خود گنجانده است.

فیلدها

فیلدها
`objective` میدانی اتحادیه هدف مسیر `objective` فقط می تواند یکی از موارد زیر باشد:
`rate_ card`	`RateCard` هدف RateCard

objective میدانی اتحادیه هدف مسیر objective فقط می تواند یکی از موارد زیر باشد:

rate_ card

RateCard

هدف RateCard

کارت امتیاز

هدف مسیر RateCard را در بر می گیرد.

فیلدها

فیلدها
`cost_ per_ minute`	`MonetaryCost` اختیاری. هزینه هر دقیقه
`cost_ per_ km`	`MonetaryCost` اختیاری. هزینه هر کیلومتر
`include_ tolls`	`bool` اختیاری. اینکه آیا هزینه عوارض در هزینه کلی لحاظ شود.

cost_ per_ minute

MonetaryCost

اختیاری. هزینه هر دقیقه

cost_ per_ km

MonetaryCost

اختیاری. هزینه هر کیلومتر

include_ tolls

bool

اختیاری. اینکه آیا هزینه عوارض در هزینه کلی لحاظ شود.

هزینه پولی

هزینه استفاده شده در کارت نرخ را در بر می گیرد.

فیلدها

فیلدها
`value`	`double` مورد نیاز. ارزش هزینه به ارز محلی استنتاج شده از درخواست.

value

double

مورد نیاز. ارزش هزینه به ارز محلی استنتاج شده از درخواست.

RouteTravelAdvisory

اطلاعات اضافی را که کاربر باید از آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی و غیره را در بر می گیرد.

فیلدها

فیلدها
`toll_ info`	`TollInfo` اطلاعات مربوط به عوارض در مسیر را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم در مسیر عوارضی وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد `estimated_price` پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد تنظیم نشده باشد، انتظار داریم عوارضی در مسیر وجود نداشته باشد.
`speed_ reading_ intervals[]`	`SpeedReadingInterval` فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی `TRAFFIC_AWARE` و `TRAFFIC_AWARE_OPTIMAL` . فواصل، کل چند خط مسیر را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است. مثال: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

toll_ info

TollInfo

اطلاعات مربوط به عوارض در مسیر را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم در مسیر عوارضی وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد estimated_price پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد تنظیم نشده باشد، انتظار داریم عوارضی در مسیر وجود نداشته باشد.

speed_ reading_ intervals[]

SpeedReadingInterval

فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی TRAFFIC_AWARE و TRAFFIC_AWARE_OPTIMAL . فواصل، کل چند خط مسیر را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است.

مثال:

polyline: A ---- B ---- C ---- D ---- E ---- F ---- G
speed_reading_intervals: [A,C), [C,D), [D,G).

RouteTravelMode

مجموعه ای از مقادیر مورد استفاده برای تعیین حالت سفر.

Enums
`TRAVEL_MODE_UNSPECIFIED`	حالت سفر مشخص نشده است. پیش‌فرض `DRIVE` است.
`DRIVE`	سفر با ماشین مسافر.
`BICYCLE`	با دوچرخه سفر کنید.
`WALK`	سفر با راه رفتن
`TWO_WHEELER`	وسیله نقلیه موتوری دو چرخ. به عنوان مثال ، موتور سیکلت. توجه داشته باشید که این با حالت سفر `BICYCLE` که حالت با نیروی انسانی را پوشش می دهد متفاوت است.
`TAXI`	سفر با تاکسی دارای مجوز، که ممکن است به وسیله نقلیه اجازه دهد در خطوط تعیین شده تاکسی در برخی مناطق حرکت کند. حالت تاکسی یک ویژگی آزمایشی است. اگر مشتری مسیر تاکسی را در شهری که اطلاعات خط تاکسی در آن موجود نیست درخواست کند، یک مسیر DRIVE برگردانده می شود.

پیشروی مسیریابی

مجموعه ای از مقادیر که فاکتورهایی را مشخص می کند که هنگام محاسبه مسیر باید در نظر گرفته شوند.

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	هیچ اولویت مسیریابی مشخص نشده است. پیش‌فرض `TRAFFIC_AWARE` است.
`TRAFFIC_UNAWARE`	مسیرها را بدون در نظر گرفتن شرایط ترافیکی زنده محاسبه می کند. مناسب زمانی که شرایط ترافیک مهم نیست یا قابل اجرا نیست. استفاده از این مقدار کمترین تاخیر را ایجاد می کند. توجه: برای `RouteTravelMode` DRIVE و TWO_WHEELER، مسیر و مدت زمان انتخاب شده بر اساس شبکه جاده و میانگین شرایط ترافیک مستقل از زمان است، نه شرایط فعلی جاده. در نتیجه، مسیرها ممکن است شامل جاده هایی باشد که به طور موقت بسته هستند. نتایج برای یک درخواست معین ممکن است در طول زمان به دلیل تغییرات در شبکه جاده‌ها، میانگین به‌روز شده شرایط ترافیکی و ماهیت توزیع‌شده خدمات متفاوت باشد. نتایج همچنین ممکن است بین مسیرهای تقریباً معادل در هر زمان یا فرکانس متفاوت باشد.
`TRAFFIC_AWARE`	مسیرها را با در نظر گرفتن شرایط ترافیکی محاسبه می کند. برخلاف `TRAFFIC_AWARE_OPTIMAL` ، برخی بهینه‌سازی‌ها برای کاهش قابل توجه تأخیر اعمال می‌شوند.
`TRAFFIC_AWARE_OPTIMAL`	مسیرها را با در نظر گرفتن شرایط ترافیکی، بدون اعمال اکثر بهینه‌سازی‌های عملکرد، محاسبه می‌کند. استفاده از این مقدار بیشترین تاخیر را ایجاد می کند.

SpeedReading Interval

نشانگر تراکم ترافیک در یک بخش پیوسته از چند خط یا مسیر. با توجه به مسیری با نقاط P_0، P_1، ...، P_N (شاخص مبتنی بر صفر)، SpeedReadingInterval یک بازه را تعریف می‌کند و ترافیک آن را با استفاده از دسته‌های زیر توصیف می‌کند.

فیلدها

فیلدها
`start_ polyline_ point_ index`	`int32` شاخص شروع این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.
`end_ polyline_ point_ index`	`int32` شاخص پایانی این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.
`speed`	`Speed` سرعت ترافیک در این بازه.

start_ polyline_ point_ index

int32

شاخص شروع این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.

end_ polyline_ point_ index

int32

شاخص پایانی این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.

speed

Speed

سرعت ترافیک در این بازه.

سرعت

طبقه بندی سرعت چند خط بر اساس داده های ترافیک.

Enums
`SPEED_UNSPECIFIED`	مقدار پیش فرض این مقدار بلااستفاده است.
`NORMAL`	سرعت معمولی، هیچ کاهش سرعت تشخیص داده نمی شود.
`SLOW`	کاهش سرعت شناسایی شد، اما ترافیک ایجاد نشد.
`TRAFFIC_JAM`	ترافیک شناسایی شد

TollInfo

اطلاعات عوارض را در Route یا RouteLeg در خود گنجانده است.

فیلدها

فیلدها
`estimated_ price[]`	`Money` مقدار پولی عوارض برای `Route` یا `RouteLeg` مربوطه. این لیست حاوی مقدار پولی برای هر ارز است که انتظار می رود توسط ایستگاه های عوارضی شارژ شود. معمولاً این لیست فقط شامل یک مورد برای مسیرهایی است که دارای عوارض به یک ارز هستند. برای سفرهای بین‌المللی، این فهرست ممکن است حاوی چندین مورد باشد تا عوارض را به ارزهای مختلف منعکس کند.

estimated_ price[]

Money

مقدار پولی عوارض برای Route یا RouteLeg مربوطه. این لیست حاوی مقدار پولی برای هر ارز است که انتظار می رود توسط ایستگاه های عوارضی شارژ شود. معمولاً این لیست فقط شامل یک مورد برای مسیرهایی است که دارای عوارض به یک ارز هستند. برای سفرهای بین‌المللی، این فهرست ممکن است حاوی چندین مورد باشد تا عوارض را به ارزهای مختلف منعکس کند.

TollPass

لیست عوارضی در سراسر جهان که ما پشتیبانی می کنیم.

Enums
`TOLL_PASS_UNSPECIFIED`	استفاده نشده است. اگر از این مقدار استفاده شود، درخواست با شکست مواجه می شود.
`AU_ETOLL_TAG`	یکی از بسیاری از ارائه دهندگان عوارض سیدنی. https://www.myetoll.com.au
`AU_EWAY_TAG`	یکی از بسیاری از ارائه دهندگان کارت عوارضی سیدنی. https://www.tollpay.com.au/
`AU_LINKT`	مجوز عوارض در سراسر استرالیا جزئیات بیشتر را در https://www.linkt.com.au/ ببینید.
`AR_TELEPASE`	کارت عوارضی آرژانتین جزئیات اضافی را در https://telepase.com.ar مشاهده کنید
`BR_AUTO_EXPRESO`	کارت عوارض برزیل جزئیات اضافی را در https://www.autoexpreso.com مشاهده کنید
`BR_CONECTCAR`	کارت عوارض برزیل جزئیات بیشتر را در https://conectcar.com ببینید.
`BR_MOVE_MAIS`	کارت عوارض برزیل جزئیات بیشتر را در https://movemais.com ببینید.
`BR_PASSA_RAPIDO`	کارت عوارض برزیل جزئیات بیشتر را در https://pasorapido.gob.do/ ببینید
`BR_SEM_PARAR`	کارت عوارض برزیل جزئیات بیشتر را در https://www.semparar.com.br ببینید.
`BR_TAGGY`	کارت عوارض برزیل جزئیات بیشتر را در https://taggy.com.br ببینید.
`BR_VELOE`	کارت عوارض برزیل جزئیات بیشتر را در https://veloe.com.br/site/onde-usar ببینید.
`CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD`	گذرگاه مرزی کانادا به ایالات متحده
`CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD`	گذرگاه مرزی کانادا به ایالات متحده
`CA_US_BLUE_WATER_EDGE_PASS`	انتاریو، کانادا به میشیگان، گذرگاه مرزی ایالات متحده.
`CA_US_CONNEXION`	انتاریو، کانادا به میشیگان، گذرگاه مرزی ایالات متحده.
`CA_US_NEXUS_CARD`	گذرگاه مرزی کانادا به ایالات متحده
`ID_E_TOLL`	اندونزی. کارت الکترونیکی ارائه شده توسط چندین بانک که برای پرداخت عوارض استفاده می شود. همه کارت‌های الکترونیکی از طریق بانک‌ها یکسان شارژ می‌شوند، بنابراین فقط یک مقدار enum مورد نیاز است. به عنوان مثال بانک ماندری https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking /tapcash
`IN_FASTAG`	هند.
`IN_LOCAL_HP_PLATE_EXEMPT`	هند، معافیت پلاک دولتی HP.
`JP_ETC`	ژاپن و غیره سیستم بی سیم الکترونیکی برای جمع آوری عوارض. https://www.go-etc.jp/
`JP_ETC2`	ژاپن ETC2.0. نسخه جدید ETC با تخفیف بیشتر و ارتباط دو طرفه بین دستگاه ها در وسایل نقلیه و آنتن های موجود در جاده. https://www.go-etc.jp/etc2/index.html
`MX_IAVE`	مکزیک https://iave.capufe.gob.mx/#/
`MX_PASE`	مکزیک https://www.pase.com.mx
`MX_QUICKPASS`	مکزیک https://operadoravial.com/quick-pass/
`MX_SISTEMA_TELEPEAJE_CHIHUAHUA`	مکزیک http://appsh.chihuahua.gob.mx/transparencia/?doc=/ingresos/TelepeajeFormato4.pdf
`MX_TAG_IAVE`	مکزیک
`MX_TAG_TELEVIA`	شرکت گذر عوارض مکزیک یکی از بسیاری که در مکزیکوسیتی فعالیت می کند. جزئیات بیشتر را در https://www.televia.com.mx ببینید.
`MX_TELEVIA`	شرکت عوارض مکزیک. یکی از بسیاری از فعالیت های مکزیکو سیتی. https://www.televia.com.mx
`MX_VIAPASS`	عوارض مکزیک. See additional details at https://www.viapass.com.mx/viapass/web_home.aspx .
`US_AL_FREEDOM_PASS`	AL, USA.
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK ، ایالات متحده
`US_CA_FASTRAK`	کالیفرنیا، ایالات متحده آمریکا
`US_CA_FASTRAK_CAV_STICKER`	نشان می دهد که راننده علاوه بر برچسب DMV صادر شده با هوای تمیز (CAV) دارای هر پاس Fastrak است. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO, USA.
`US_CO_GO_PASS`	شرکت ، ایالات متحده
`US_DE_EZPASSDE`	د ، ایالات متحده
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	FL، ایالات متحده آمریکا
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	FL، ایالات متحده آمریکا
`US_FL_EPASS`	FL، ایالات متحده آمریکا
`US_FL_GIBA_TOLL_PASS`	FL، ایالات متحده آمریکا
`US_FL_LEEWAY`	FL، ایالات متحده آمریکا
`US_FL_SUNPASS`	FL، ایالات متحده آمریکا
`US_FL_SUNPASS_PRO`	FL، ایالات متحده آمریکا
`US_IL_EZPASSIL`	IL، ایالات متحده آمریکا
`US_IL_IPASS`	IL، ایالات متحده آمریکا
`US_IN_EZPASSIN`	در ، ایالات متحده
`US_KS_BESTPASS_HORIZON`	KS ، ایالات متحده.
`US_KS_KTAG`	KS ، ایالات متحده.
`US_KS_NATIONALPASS`	KS, USA.
`US_KS_PREPASS_ELITEPASS`	KS ، ایالات متحده.
`US_KY_RIVERLINK`	کی ، ایالات متحده
`US_LA_GEAUXPASS`	LA ، ایالات متحده
`US_LA_TOLL_TAG`	LA ، ایالات متحده
`US_MA_EZPASSMA`	MA، ایالات متحده آمریکا
`US_MD_EZPASSMD`	دکتر ، ایالات متحده.
`US_ME_EZPASSME`	ME, USA.
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	MI, USA.
`US_MI_BCPASS`	MI ، ایالات متحده
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI ، ایالات متحده
`US_MI_IQ_PROX_CARD`	MI ، ایالات متحده از آنجا که این نوع پاس دیگر وجود ندارد ، مستهلک می شود. This item is deprecated!
`US_MI_IQ_TAG`	MI, USA.
`US_MI_MACKINAC_BRIDGE_MAC_PASS`	MI ، ایالات متحده
`US_MI_NEXPRESS_TOLL`	MI ، ایالات متحده
`US_MN_EZPASSMN`	MN ، ایالات متحده.
`US_NC_EZPASSNC`	NC ، ایالات متحده.
`US_NC_PEACH_PASS`	NC ، ایالات متحده.
`US_NC_QUICK_PASS`	NC ، ایالات متحده.
`US_NH_EZPASSNH`	NH ، ایالات متحده.
`US_NJ_DOWNBEACH_EXPRESS_PASS`	NJ ، ایالات متحده.
`US_NJ_EZPASSNJ`	NJ ، ایالات متحده.
`US_NY_EXPRESSPASS`	NY, USA.
`US_NY_EZPASSNY`	NY, USA.
`US_OH_EZPASSOH`	اوه ، ایالات متحده
`US_PA_EZPASSPA`	PA ، ایالات متحده
`US_RI_EZPASSRI`	ری ، ایالات متحده
`US_SC_PALPASS`	SC ، ایالات متحده.
`US_TX_AVI_TAG`	TX ، ایالات متحده.
`US_TX_BANCPASS`	TX ، ایالات متحده.
`US_TX_DEL_RIO_PASS`	TX ، ایالات متحده.
`US_TX_EFAST_PASS`	TX ، ایالات متحده.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	TX ، ایالات متحده.
`US_TX_EPTOLL`	TX ، ایالات متحده.
`US_TX_EZ_CROSS`	TX ، ایالات متحده.
`US_TX_EZTAG`	TX ، ایالات متحده.
`US_TX_FUEGO_TAG`	TX ، ایالات متحده.
`US_TX_LAREDO_TRADE_TAG`	TX ، ایالات متحده.
`US_TX_PLUSPASS`	TX ، ایالات متحده.
`US_TX_TOLLTAG`	TX ، ایالات متحده.
`US_TX_TXTAG`	TX ، ایالات متحده.
`US_TX_XPRESS_CARD`	TX ، ایالات متحده.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT ، ایالات متحده
`US_VA_EZPASSVA`	VA, USA.
`US_WA_BREEZEBY`	WA ، ایالات متحده
`US_WA_GOOD_TO_GO`	WA ، ایالات متحده
`US_WV_EZPASSWV`	WV ، ایالات متحده.
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV ، ایالات متحده.
`US_WV_MOV_PASS`	WV ، ایالات متحده
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV, USA.

واحدها

مجموعه ای از مقادیر که واحد اندازه گیری مورد استفاده در صفحه را مشخص می کند.

Enums
`UNITS_UNSPECIFIED`	Units of measure not specified. پیش فرض به واحد اندازه گیری استنباط شده از درخواست.
`METRIC`	واحدهای متریک اندازه گیری.
`IMPERIAL`	واحدهای اندازه گیری امپریال (انگلیسی).

وسیله نقلیه

مجموعه ای از مقادیر توصیف نوع انتشار وسیله نقلیه. Applies only to the DRIVE travel mode.

Enums
`VEHICLE_EMISSION_TYPE_UNSPECIFIED`	هیچ نوع انتشار مشخص نشده است. پیش فرض بنزین.
`GASOLINE`	وسیله نقلیه بنزین/بنزین سوخت.
`ELECTRIC`	Electricity powered vehicle.
`HYBRID`	سوخت ترکیبی (مانند بنزین + برقی).

وسیله نقلیه

اطلاعات وسیله نقلیه مانند نوع انتشار وسیله نقلیه را محصور می کند.

فیلدها

فیلدها
`emission_ type`	`VehicleEmissionType` نوع انتشار وسیله نقلیه را توصیف می کند. فقط مربوط به `DRIVE` `RouteTravelMode` است.

emission_ type

VehicleEmissionType

نوع انتشار وسیله نقلیه را توصیف می کند. فقط مربوط به DRIVE RouteTravelMode است.

نقطه راه

یک نقطه راه را محاصره می کند. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.

فیلدها
`via`	`bool` این نقطه را به عنوان یک نقطه عطف و نه یک نقطه توقف نشان می دهد. برای هر یک از ایستگاه های غیر VIA در درخواست ، پاسخ ورود به آرایه `legs` را به شما ارائه می دهد تا جزئیات مربوط به توقف در آن پای سفر را ارائه دهد. وقتی می خواهید مسیر از این نقطه عبور کند بدون اینکه متوقف شود ، این مقدار را درست تنظیم کنید. Via waypoints don't cause an entry to be added to the `legs` array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. اگر `ComputeRoutesRequest.optimize_waypoint_order` تنظیم شده باشد ، این قسمت نمی تواند روی درست تنظیم شود. در غیر این صورت ، درخواست انجام نمی شود.
`vehicle_ stopover`	`bool` نشان می دهد که ایستگاه راه برای متوقف کردن وسایل نقلیه در آن قرار دارد ، جایی که قصد وانت یا کشویی است. هنگامی که این مقدار را تعیین می کنید ، مسیر محاسبه شده شامل غیر `via` ایستگاه های راه در جاده هایی نیست که برای وانت و رها کردن نامناسب هستند. این گزینه فقط برای حالت های مسافرتی `DRIVE` و `TWO_WHEELER` کار می کند ، و هنگامی که `location_type` `location` است.
`side_ of_ road`	`bool` نشان می دهد که مکان این نقطه راه به معنای اولویت برای متوقف کردن وسیله نقلیه در یک طرف خاص از جاده است. هنگامی که این مقدار را تعیین کردید ، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده متوقف شود که مکان از مرکز جاده مغرضانه باشد. این گزینه فقط برای حالت های سفر "Drive" و "Two_Wheeler" کار می کند.
Union Field `location_type` . روش های مختلف برای نشان دادن یک مکان. `location_type` فقط می تواند یکی از موارد زیر باشد:
`location`	`Location` نکته ای که با استفاده از مختصات جغرافیایی ، از جمله عنوان اختیاری مشخص شده است.
`place_ id`	`string` شناسه Poi Place در ارتباط با نقطه راه.