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 پشتیبانی می شود.
`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". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.
`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

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

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". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.
`units`	`Units` اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این شامل فیلد `instruction` در `NavigationInstruction` است. واحدهای اندازه گیری مورد استفاده برای مسیر، پا، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل درخواست استنتاج می شوند.
`optimize_waypoint_order`	`bool` اگر optimizeWaypointOrder روی true تنظیم شده باشد، تلاش می‌شود تا ایستگاه‌های میانی مشخص شده را مجدداً ترتیب دهیم تا هزینه کلی مسیر به حداقل برسد. اگر هر یک از ایستگاه های بین راهی از طریق ایستگاه بین راه باشد، درخواست با شکست مواجه می شود. از ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index برای پیدا کردن سفارش جدید استفاده کنید. اگر routes.optimized_intermediate_waypoint_index در هدر `X-Goog-FieldMask` درخواست نشود، درخواست با شکست مواجه می شود. اگر optimizeWaypointOrder روی false تنظیم شده باشد، ComputeRoutesResponse.optimized_intermediate_waypoint_index خالی است.

ComputeRoutesResponse

ComputeRoute پیام پاسخ.

فیلدها

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

routes[]

Route

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

fallback_info

FallbackInfo

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

مسیر سفارشی

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

فیلدها

فیلدها
`route`	`Route` مسیر "بهترین" برای هدف مسیر ورودی در نظر گرفته شده است.
`token`	`string` توکن مسیر کدگذاری شده مبتنی بر وب base64 که می‌تواند به NavSDK ارسال شود، که به NavSDK اجازه می‌دهد مسیر را در طول ناوبری بازسازی کند و در صورت تغییر مسیر، هنگام فراخوانی RoutesPreferred ComputeCustomRoutes، هدف اصلی را رعایت کند. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند.

route

Route

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

token

string

توکن مسیر کدگذاری شده مبتنی بر وب base64 که می‌تواند به NavSDK ارسال شود، که به NavSDK اجازه می‌دهد مسیر را در طول ناوبری بازسازی کند و در صورت تغییر مسیر، هنگام فراخوانی RoutesPreferred ComputeCustomRoutes، هدف اصلی را رعایت کند. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند.

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

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

فیلدها

فیلدها
`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`	یک چرخش به چپ انجام دهید.
`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`	در دوربرگردان به راست بپیچید.

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

فیلدها

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` کادر محدودکننده نما در چند خط.
`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` فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی `TRAFFIC_AWARE` و `TRAFFIC_AWARE_OPTIMAL` . فواصل، کل چند خط RouteLegStep را بدون همپوشانی پوشش می دهند. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است. مثال: `polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).`

speed_reading_intervals[]

SpeedReadingInterval

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

مثال:

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

RouteLegTravelAdvisory

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

فیلدها

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

toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

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

مثال:

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

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

RouteModifiers

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

فیلدها
`avoid_tolls`	`bool` مشخص می کند که آیا در صورت معقول بودن از جاده های عوارضی اجتناب شود یا خیر. اولویت با مسیرهایی است که دارای عوارضی نیستند. فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` اعمال می‌شود.
`avoid_highways`	`bool` مشخص می کند که آیا در صورت لزوم از بزرگراه ها اجتناب شود یا خیر. اولویت با مسیرهای فاقد بزرگراه خواهد بود. فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` اعمال می‌شود.
`avoid_ferries`	`bool` مشخص می‌کند که آیا در صورت لزوم از کشتی‌ها اجتناب شود یا خیر. اولویت با مسیرهایی است که شامل سفر با کشتی نباشد. فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` اعمال می‌شود.
`avoid_indoor`	`bool` مشخص می کند که آیا از پیمایش در داخل خانه در صورت لزوم اجتناب شود. اولویت به مسیرهایی داده می شود که دارای ناوبری داخلی نیستند. فقط برای حالت سفر `WALK` اعمال می شود.
`vehicle_info`	`VehicleInfo` اطلاعات خودرو را مشخص می کند.
`toll_passes[]`	`TollPass` اطلاعات مربوط به مجوزهای دریافت عوارض را در خود گنجانده است. اگر مجوزهای عوارضی ارائه شود، API سعی می‌کند قیمت گذر را برگرداند. اگر مجوزهای دریافت عوارض ارائه نشود، API کارت عوارضی را ناشناخته تلقی می کند و سعی می کند قیمت نقدی را برگرداند. فقط برای حالت‌های سفر DRIVE و TWO_WHEELER اعمال می‌شود.

RouteObjective

یک هدف برای بهینه سازی توسط ComputeCustomRoutes را در خود محفوظ می دارد.

فیلدها

فیلدها
`rate_card`	`RateCard` هدف RateCard

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` اطلاعات مربوط به عوارض در مسیر را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم در مسیر عوارضی وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد تخمینی_قیمت پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد تنظیم نشده باشد، انتظار داریم عوارضی در مسیر وجود نداشته باشد.
`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

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

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 برگردانده می شود.

RoutingPreference

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

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	هیچ اولویت مسیریابی مشخص نشده است. پیش‌فرض `TRAFFIC_AWARE` است.
`TRAFFIC_UNAWARE`	مسیرها را بدون در نظر گرفتن شرایط ترافیکی محاسبه می کند. مناسب زمانی که شرایط ترافیک مهم نیست. استفاده از این مقدار کمترین تاخیر را ایجاد می کند.
`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` مقدار پولی عوارض برای مسیر یا RouteLeg مربوطه. این لیست حاوی مقدار پولی برای هر ارز است که انتظار می رود توسط ایستگاه های عوارضی شارژ شود. معمولاً این لیست فقط شامل یک مورد برای مسیرهای دارای عوارض به یک ارز است. برای سفرهای بین‌المللی، این فهرست ممکن است حاوی چندین مورد باشد تا عوارض را به ارزهای مختلف منعکس کند.

estimated_price[]

Money

مقدار پولی عوارض برای مسیر یا 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.
`MX_TAG_IAVE`	کارت عوارض مکزیک
`MX_TAG_TELEVIA`	شرکت گذر عوارض مکزیک یکی از بسیاری که در مکزیکوسیتی فعالیت می کند. جزئیات بیشتر را در https://www.televia.com.mx ببینید.
`MX_VIAPASS`	کارت عوارض مکزیک جزئیات بیشتر را در https://www.viapass.com.mx/viapass/web_home.aspx ببینید.
`US_AL_FREEDOM_PASS`	AL، ایالات متحده آمریکا
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK، ایالات متحده آمریکا
`US_CA_FASTRAK`	کالیفرنیا، ایالات متحده آمریکا
`US_CA_FASTRAK_CAV_STICKER`	نشان می دهد که راننده علاوه بر برچسب خودروی هوای پاک (CAV) صادر شده توسط DMV، دارای مجوز FasTrak است. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
`US_CO_EXPRESSTOLL`	CO، ایالات متحده آمریکا
`US_CO_GO_PASS`	CO، ایالات متحده آمریکا
`US_DE_EZPASSDE`	DE، ایالات متحده آمریکا
`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، ایالات متحده آمریکا
`US_KS_PREPASS_ELITEPASS`	KS، ایالات متحده آمریکا
`US_KY_RIVERLINK`	KY، ایالات متحده آمریکا
`US_LA_GEAUXPASS`	لس آنجلس، ایالات متحده آمریکا
`US_LA_TOLL_TAG`	لس آنجلس، ایالات متحده آمریکا
`US_MA_EZPASSMA`	MA، ایالات متحده آمریکا
`US_MD_EZPASSMD`	MD، ایالات متحده آمریکا
`US_ME_EZPASSME`	من، ایالات متحده آمریکا
`US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD`	MI، ایالات متحده آمریکا
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI، ایالات متحده آمریکا
`US_MI_IQ_PROX_CARD`	MI، ایالات متحده آمریکا
`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`	نیوجرسی، ایالات متحده آمریکا
`US_NJ_EZPASSNJ`	نیوجرسی، ایالات متحده آمریکا
`US_NY_EXPRESSPASS`	نیویورک، ایالات متحده آمریکا
`US_NY_EZPASSNY`	نیویورک، ایالات متحده آمریکا
`US_OH_EZPASSOH`	اوه، ایالات متحده آمریکا
`US_PA_EZPASSPA`	PA، ایالات متحده آمریکا
`US_RI_EZPASSRI`	RI، ایالات متحده آمریکا
`US_SC_PALPASS`	SC، ایالات متحده آمریکا
`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_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، ایالات متحده آمریکا
`US_WA_BREEZEBY`	WA، ایالات متحده آمریکا
`US_WA_GOOD_TO_GO`	WA، ایالات متحده آمریکا
`US_WV_EZPASSWV`	WV، ایالات متحده آمریکا
`US_WV_MEMORIAL_BRIDGE_TICKETS`	WV، ایالات متحده آمریکا
`US_WV_NEWELL_TOLL_BRIDGE_TICKET`	WV، ایالات متحده آمریکا

واحدها

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

Enums
`UNITS_UNSPECIFIED`	واحد اندازه گیری مشخص نشده است. پیش‌فرض‌های واحد اندازه‌گیری استنتاج شده از درخواست.
`METRIC`	واحدهای اندازه گیری متریک
`IMPERIAL`	واحدهای اندازه گیری امپراتوری (انگلیسی).

نوع انتشار خودرو

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

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

اطلاعات خودرو

اطلاعات خودرو مانند آخرین نویسه پلاک خودرو را در خود محفوظ می دارد.

فیلدها

فیلدها
`emission_type`	`VehicleEmissionType` نوع انتشار خودرو را شرح می دهد. فقط برای حالت سفر DRIVE اعمال می شود.

emission_type

VehicleEmissionType

نوع انتشار خودرو را شرح می دهد. فقط برای حالت سفر DRIVE اعمال می شود.

نقطه راه

یک نقطه بین راه را در بر می گیرد. نقاط راه، ابتدا و انتهای مسیر را مشخص می‌کنند و شامل توقف‌های میانی در طول مسیر می‌شوند.

فیلدها
`via`	`bool` این نقطه را به عنوان یک نقطه عطف و نه یک نقطه توقف مشخص می کند. برای هر نقطه غیر از طریق درخواست، پاسخ یک ورودی به آرایه `legs` اضافه می کند تا جزئیات توقف در آن مرحله از سفر را ارائه کند. زمانی که می‌خواهید مسیر بدون توقف از این نقطه عبور کند، این مقدار را روی true تنظیم کنید. از طریق ایستگاه‌های بین راه باعث نمی‌شود که ورودی به آرایه `legs` اضافه شود، اما مسیر را از طریق ایستگاه بین‌المللی هدایت می‌کنند. شما فقط می توانید این مقدار را در نقاطی که متوسط هستند تنظیم کنید. اگر این فیلد را در ایستگاه های پایانه تنظیم کنید، درخواست انجام نمی شود. اگر ComputeRoutesRequest.optimize_waypoint_order روی true تنظیم شده باشد، این فیلد را نمی توان روی true تنظیم کرد. در غیر این صورت، درخواست ناموفق است.
`vehicle_stopover`	`bool` نشان می دهد که ایستگاه بین راه برای توقف وسایل نقلیه در نظر گرفته شده است، جایی که قصد سوار شدن یا رها کردن آن است. وقتی این مقدار را تنظیم می‌کنید، مسیر محاسبه‌شده شامل ایستگاه‌های بین `via` در جاده‌هایی که برای حمل و نقل نامناسب هستند، نمی‌شود. این گزینه فقط برای حالت‌های سفر `DRIVE` و `TWO_WHEELER` و زمانی که `location_type` `location` باشد کار می‌کند.
`side_of_road`	`bool` نشان می دهد که مکان این ایستگاه بین راهی برای توقف خودرو در سمت خاصی از جاده ترجیح داده می شود. هنگامی که این مقدار را تنظیم می کنید، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده ای که مکان از مرکز جاده به سمت آن سوگیری دارد، توقف کند. این گزینه فقط برای حالت‌های سفر «DRIVE» و «TWO_WHEELER» و زمانی که «location_type» روی «location» تنظیم شده باشد، کار می‌کند.
`location_type` فیلد اتحادیه روش های مختلف برای نشان دادن یک مکان `location_type` فقط می تواند یکی از موارد زیر باشد:
`location`	`Location` نقطه ای که با استفاده از مختصات جغرافیایی، از جمله عنوان اختیاری مشخص شده است.
`place_id`	`string` شناسه مکان POI مرتبط با ایستگاه بین راه.