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

Package google.maps.routing.v2

شاخص

Routes (رابط)
ComputeRouteMatrixRequest (پیام)
ComputeRouteMatrixRequest.ExtraComputation (enum)
ComputeRoutesRequest (پیام)
ComputeRoutesRequest.ExtraComputation (enum)
ComputeRoutesRequest.ReferenceRoute (enum)
ComputeRoutesResponse (پیام)
FallbackInfo (پیام)
FallbackReason (تعدادی)
FallbackRoutingMode (enum)
GeocodedWaypoint (پیام)
GeocodingResults (پیام)
LocalizedTime (پیام)
Location (پیام)
Maneuver (enum)
NavigationInstruction (پیام)
Polyline (پیام)
PolylineEncoding (enum)
PolylineQuality (تعدادی)
Route (پیام)
Route.RouteLocalizedValues (پیام)
RouteLabel (enum)
RouteLeg (پیام)
RouteLeg.RouteLegLocalizedValues (پیام)
RouteLeg.StepsOverview (پیام)
RouteLeg.StepsOverview.MultiModalSegment (پیام)
RouteLegStep (پیام)
RouteLegStep.RouteLegStepLocalizedValues (پیام)
RouteLegStepTransitDetails (پیام)
RouteLegStepTransitDetails.TransitDetailsLocalizedValues (پیام)
RouteLegStepTransitDetails.TransitStopDetails (پیام)
RouteLegStepTravelAdvisory (پیام)
RouteLegTravelAdvisory (پیام)
RouteMatrixDestination (پیام)
RouteMatrixElement (پیام)
RouteMatrixElement.LocalizedValues (پیام)
RouteMatrixElementCondition (enum)
RouteMatrixOrigin (پیام)
RouteModifiers (پیام)
RouteTravelAdvisory (پیام)
RouteTravelMode (enum)
RoutingPreference (enum)
SpeedReadingInterval (پیام)
SpeedReadingInterval.Speed (enum)
TollInfo (پیام)
TollPass (تعدادی)
TrafficModel (enum)
TransitAgency (پیام)
TransitLine (پیام)
TransitPreferences (پیام)
TransitPreferences.TransitRoutingPreference (enum)
TransitPreferences.TransitTravelMode (enum)
TransitStop (پیام)
TransitVehicle (پیام)
TransitVehicle.TransitVehicleType (enum)
Units (تعدادی)
VehicleEmissionType (تعدادی)
VehicleInfo (پیام)
Waypoint (پیام)

مسیرها

Routes API.

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` در ماسک فیلد خود وارد کنید زیرا در غیر این صورت همه پیام‌ها درست به نظر می‌رسند. گوگل استفاده از ماسک فیلد پاسخ ( `` ) را منع می کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم. انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود. انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود.

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 در ماسک فیلد خود وارد کنید زیرا در غیر این صورت همه پیام‌ها درست به نظر می‌رسند. گوگل استفاده از ماسک فیلد پاسخ ( * ) را منع می کند، زیرا:

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

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` ) جلوگیری می کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می کند تا چرخه های محاسباتی را ذخیره کند و به ما امکان می دهد نتیجه را با تاخیر کمتری به شما برگردانیم. انتخاب تنها زمینه هایی که در کار تولیدی خود به آن نیاز دارید، عملکرد تاخیر پایدار را تضمین می کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسبات اضافی نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدها را در سطح بالا انتخاب کنید، ممکن است با کاهش عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه کنیم به طور خودکار در پاسخ گنجانده می شود. انتخاب تنها فیلدهایی که به آنها نیاز دارید باعث می‌شود که اندازه پاسخ کوچک‌تر و در نتیجه توان عملیاتی شبکه بیشتر شود.

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 ) جلوگیری می کند، زیرا:

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

ComputeRouteMatrixRequest

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

فیلدها
`origins[]`	`RouteMatrixOrigin` مورد نیاز. آرایه مبدا، که ردیف های ماتریس پاسخ را تعیین می کند. چندین محدودیت اندازه برای اصلی بودن مبدا و مقصد اعمال می شود: مجموع تعداد مبدا + تعداد مقصدهای مشخص شده به عنوان `place_id` یا `address` نباید بیشتر از 50 باشد. حاصل ضرب تعداد مبدا × تعداد مقصد در هر صورت نباید بیشتر از 625 باشد. اگر routing_preference روی `TRAFFIC_AWARE_OPTIMAL` تنظیم شده باشد، حاصل ضرب تعداد مبدا × تعداد مقصد نباید بیشتر از 100 باشد. حاصل ضرب تعداد مبدا × تعداد مقصدها نباید بیشتر از 100 باشد اگر travel_mode روی `TRANSIT` تنظیم شده باشد.
`destinations[]`	`RouteMatrixDestination` مورد نیاز. آرایه ای از مقاصد، که ستون های ماتریس پاسخ را تعیین می کند.
`travel_mode`	`RouteTravelMode` اختیاری. نحوه حمل و نقل را مشخص می کند.
`routing_preference`	`RoutingPreference` اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. شما می توانید این گزینه را فقط زمانی مشخص کنید که `travel_mode` `DRIVE` یا `TWO_WHEELER` باشد، در غیر این صورت درخواست با شکست مواجه می شود.
`departure_time`	`Timestamp` اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. توجه: زمانی که `RouteTravelMode` روی `TRANSIT` تنظیم شده باشد، می‌توانید `departure_time` در گذشته مشخص کنید.
`arrival_time`	`Timestamp` اختیاری. زمان رسیدن. توجه: فقط زمانی می توان تنظیم کرد که `RouteTravelMode` روی `TRANSIT` تنظیم شده باشد. شما می توانید `departure_time` یا `arrival_time` را مشخص کنید، اما نه هر دو را.
`language_code`	`string` اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل مبدا اول استنباط می شود.
`region_code`	`string` اختیاری. کد منطقه که به عنوان یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") مشخص شده است. برای اطلاعات بیشتر به دامنه های سطح بالای کد کشور مراجعه کنید.
`units`	`Units` اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند.
`extra_computations[]`	`ExtraComputation` اختیاری. فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ بازگرداند. این فیلدهای اضافی نیز باید در فیلد ماسک برای بازگشت در پاسخ مشخص شوند.
`traffic_model`	`TrafficModel` اختیاری. مفروضاتی را برای محاسبه زمان در ترافیک مشخص می کند. این تنظیم بر مقدار بازگشتی در قسمت مدت زمان در `RouteMatrixElement` که شامل زمان پیش‌بینی‌شده در ترافیک بر اساس میانگین‌های تاریخی است، تأثیر می‌گذارد. `RoutingPreference` به `TRAFFIC_AWARE_OPTIMAL` و `RouteTravelMode` به `DRIVE` . اگر ترافیک درخواست شده باشد و `TrafficModel` مشخص نشده باشد به `BEST_GUESS` پیش‌فرض می‌شود.
`transit_preferences`	`TransitPreferences` اختیاری. تنظیمات برگزیده را مشخص می کند که بر مسیر برگشتی برای مسیرهای `TRANSIT` تأثیر می گذارد. توجه: فقط زمانی می توانید یک `transit_preferences` را مشخص کنید که `RouteTravelMode` روی `TRANSIT` تنظیم شده باشد.

محاسبات اضافی

محاسبات اضافی برای انجام در هنگام تکمیل درخواست.

Enums
`EXTRA_COMPUTATION_UNSPECIFIED`	استفاده نشده است. درخواست های حاوی این مقدار با شکست مواجه خواهند شد.
`TOLLS`	اطلاعات عوارض برای عنصر(های) ماتریس.

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` اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. توجه: زمانی که `RouteTravelMode` روی `TRANSIT` تنظیم شده باشد، می‌توانید `departure_time` در گذشته مشخص کنید. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند.
`arrival_time`	`Timestamp` اختیاری. زمان رسیدن. توجه: فقط زمانی می توان تنظیم کرد که `RouteTravelMode` روی `TRANSIT` تنظیم شده باشد. شما می توانید `departure_time` یا `arrival_time` را مشخص کنید، اما نه هر دو را. سفرهای ترانزیت تا 7 روز در گذشته یا 100 روز در آینده در دسترس هستند.
`compute_alternative_routes`	`bool` اختیاری. تعیین می کند که آیا مسیرهای جایگزین علاوه بر مسیر محاسبه شود یا خیر. هیچ مسیر جایگزینی برای درخواست هایی که دارای ایستگاه های بین راهی هستند بازگردانده نمی شود.
`route_modifiers`	`RouteModifiers` اختیاری. مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد.
`language_code`	`string` اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.
`region_code`	`string` اختیاری. کد منطقه که به عنوان یک مقدار دو نویسه ccTLD ("دامنه سطح بالا") مشخص شده است. برای اطلاعات بیشتر به دامنه های سطح بالای کد کشور مراجعه کنید.
`units`	`Units` اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این فیلدها شامل فیلد `instruction` در `NavigationInstruction` است. واحدهای اندازه گیری مورد استفاده برای مسیر، پا، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی گیرند. اگر این مقدار را ارائه نکنید، واحدهای نمایش از محل مبدا اول استنتاج می شوند.
`optimize_waypoint_order`	`bool` اختیاری. اگر روی true تنظیم شود، سرویس تلاش می کند تا هزینه کلی مسیر را با مرتب کردن مجدد ایستگاه های بین راهی مشخص شده به حداقل برساند. در صورتی که هر یک از ایستگاه های بین راهی یک ایستگاه بین `via` باشد، درخواست با شکست مواجه می شود. از `ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index` برای پیدا کردن سفارش جدید استفاده کنید. اگر `ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index` در هدر `X-Goog-FieldMask` درخواست نشود، درخواست با شکست مواجه می شود. اگر `optimize_waypoint_order` روی false تنظیم شود، `ComputeRoutesResponse.optimized_intermediate_waypoint_index` خالی خواهد بود.
`requested_reference_routes[]`	`ReferenceRoute` اختیاری. مشخص می کند چه مسیرهای مرجعی علاوه بر مسیر پیش فرض به عنوان بخشی از درخواست محاسبه شود. مسیر مرجع مسیری با هدف محاسبه مسیر متفاوت از مسیر پیش‌فرض است. برای مثال یک محاسبه مسیر مرجع `FUEL_EFFICIENT` پارامترهای مختلفی را در نظر می گیرد که یک مسیر کارآمد سوخت بهینه ایجاد می کند.
`extra_computations[]`	`ExtraComputation` اختیاری. فهرستی از محاسبات اضافی که ممکن است برای تکمیل درخواست استفاده شود. توجه: این محاسبات اضافی ممکن است فیلدهای اضافی را در پاسخ بازگرداند. این فیلدهای اضافی نیز باید در فیلد ماسک برای بازگشت در پاسخ مشخص شوند.
`traffic_model`	`TrafficModel` اختیاری. مفروضاتی را برای محاسبه زمان در ترافیک مشخص می کند. این تنظیم بر مقدار بازگشتی در قسمت مدت زمان در `Route` و `RouteLeg` تأثیر می‌گذارد که شامل زمان پیش‌بینی‌شده در ترافیک بر اساس میانگین‌های تاریخی است. `TrafficModel` فقط برای درخواست‌هایی در دسترس است که `RoutingPreference` روی `TRAFFIC_AWARE_OPTIMAL` و `RouteTravelMode` روی `DRIVE` تنظیم کرده‌اند. اگر ترافیک درخواست شده باشد و `TrafficModel` مشخص نشده باشد به `BEST_GUESS` پیش‌فرض می‌شود.
`transit_preferences`	`TransitPreferences` اختیاری. تنظیمات برگزیده را مشخص می کند که بر مسیر برگشتی برای مسیرهای `TRANSIT` تأثیر می گذارد. توجه: فقط زمانی می توانید یک `transit_preferences` را مشخص کنید که `RouteTravelMode` روی `TRANSIT` تنظیم شده باشد.

محاسبات اضافی

محاسبات اضافی برای انجام در هنگام تکمیل درخواست.

Enums
`EXTRA_COMPUTATION_UNSPECIFIED`	استفاده نشده است. درخواست های حاوی این مقدار با شکست مواجه خواهند شد.
`TOLLS`	اطلاعات عوارض برای مسیر(های)
`FUEL_CONSUMPTION`	مصرف سوخت تخمینی برای مسیر(های)
`TRAFFIC_ON_POLYLINE`	چند خط آگاه از ترافیک برای مسیر(های)
`HTML_FORMATTED_NAVIGATION_INSTRUCTIONS`	`NavigationInstructions` به عنوان یک رشته متن فرمت شده HTML ارائه شده است. این محتوا باید همانطور که هست خوانده شود. این محتوا فقط برای نمایش است. به صورت برنامه نویسی آن را تجزیه نکنید.

ReferenceRoute

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

Enums
`REFERENCE_ROUTE_UNSPECIFIED`	استفاده نشده است. درخواست های حاوی این مقدار با شکست مواجه می شوند.
`FUEL_EFFICIENT`	مسیر مصرف سوخت مسیرهایی که با این مقدار برچسب گذاری شده اند برای پارامترهایی مانند مصرف سوخت بهینه شده اند.

ComputeRoutesResponse

ComputeRoute پیام پاسخ.

فیلدها

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

routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

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

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

فیلدها

فیلدها
`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` `RoutingPreference` برای محاسبه پاسخ استفاده شده است.
`FALLBACK_TRAFFIC_AWARE`	نشان می دهد که `TRAFFIC_AWARE` `RoutingPreference` برای محاسبه پاسخ استفاده شده است.

GeocedWaypoint

جزئیات در مورد مکان های استفاده شده به عنوان ایستگاه های بین راه. فقط برای نقاط راه آدرس پر شده است. شامل جزئیاتی در مورد نتایج کدگذاری جغرافیایی به منظور تعیین اینکه آدرس به چه مکانی کدگذاری شده است.

فیلدها
`geocoder_status`	`Status` کد وضعیت حاصل از عملیات کدگذاری جغرافیایی را نشان می دهد.
`type[]`	`string` نوع (های) نتیجه، به صورت تگ های صفر یا بیشتر. انواع پشتیبانی شده: انواع آدرس و انواع اجزای آدرس .
`partial_match`	`bool` نشان می دهد که geocoder مطابقت دقیقی با درخواست اصلی برنگردانده است، اگرچه می تواند بخشی از آدرس درخواستی را مطابقت دهد. ممکن است بخواهید درخواست اصلی برای غلط املایی و/یا آدرس ناقص را بررسی کنید.
`place_id`	`string` شناسه مکان برای این نتیجه.
`intermediate_waypoint_request_index`	`int32` شاخص نقطه میانی مربوطه در درخواست. فقط در صورتی پر می شود که نقطه بین راه مربوطه یک ایستگاه بین راهی باشد.

نتایج جغرافیایی

شامل GeocodedWaypoints برای مبدا، مقصد و ایستگاه های بین راهی. فقط برای نقاط راه آدرس پر شده است.

فیلدها

فیلدها
`origin`	`GeocodedWaypoint` نقطه بین مسیرهای جغرافیایی کدگذاری شده مبدا.
`destination`	`GeocodedWaypoint` نقطه گذر جغرافیایی مقصد.
`intermediates[]`	`GeocodedWaypoint` فهرستی از نقاط بین راهی با کدهای جغرافیایی میانی که هر کدام حاوی یک فیلد شاخص است که به ترتیبی که در درخواست مشخص شده است، با موقعیت صفر نقطه راه مطابقت دارد.

origin

GeocodedWaypoint

نقطه بین مسیرهای جغرافیایی کدگذاری شده مبدا.

destination

GeocodedWaypoint

نقطه گذر جغرافیایی مقصد.

intermediates[]

GeocodedWaypoint

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

LocalizedTime

توصیف موضعی زمان

فیلدها

فیلدها
`time`	`LocalizedText` زمان مشخص شده به عنوان یک رشته در یک منطقه زمانی معین.
`time_zone`	`string` شامل منطقه زمانی است. مقدار، نام منطقه زمانی است که در پایگاه داده منطقه زمانی IANA تعریف شده است، به عنوان مثال "America/New_York".

time

LocalizedText

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

time_zone

string

شامل منطقه زمانی است. مقدار، نام منطقه زمانی است که در پایگاه داده منطقه زمانی IANA تعریف شده است، به عنوان مثال "America/New_York".

مکان

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

فیلدها

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

lat_lng

LatLng

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

heading

Int32Value

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

مانور

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

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

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

دستورالعمل‌های ناوبری را برای یک RouteLegStep در بر می‌گیرد.

فیلدها

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` تاخیر درخواست کمتری دارد.

مسیر

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

فیلدها
`route_labels[]`	`RouteLabel` برچسب‌هایی برای `Route` که برای شناسایی ویژگی‌های خاص مسیر برای مقایسه با دیگران مفید هستند.
`legs[]`	`RouteLeg` مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو `Waypoints` غیر `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` اگر `optimize_waypoint_order` را روی true تنظیم کنید، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. برای مثال، اگر ورودی Origin را بدهید: LA; ایستگاه های بین راهی: دالاس، بانگور، فینیکس؛ مقصد: نیویورک؛ و ترتیب میانی بهینه شده Phoenix، Dallas، Bangor است، سپس این فیلد حاوی مقادیر [2، 0، 1] است. شاخص با 0 برای اولین نقطه میانی ارائه شده در ورودی شروع می شود.
`localized_values`	`RouteLocalizedValues` نمایش متنی ویژگی های `Route` .
`route_token`	`string` یک توکن مسیر ایمن و با کد base64 که می‌تواند به Navigation SDK ارسال شود، که به Navigation SDK اجازه می‌دهد مسیر را در حین پیمایش بازسازی کند و در صورت تغییر مسیر، هنگام ایجاد مسیر با تماس، به هدف اصلی احترام بگذارد. ComputeRoutes. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند. ارزش آن را در بین درخواست ها مقایسه نکنید - این نشانه ممکن است تغییر کند حتی اگر دقیقا همان مسیر بازگردانده شود. توجه: `Route.route_token` فقط برای درخواست‌هایی در دسترس است که `ComputeRoutesRequest.routing_preference` را روی `TRAFFIC_AWARE` یا `TRAFFIC_AWARE_OPTIMAL` تنظیم کرده‌اند. `Route.route_token` برای درخواست هایی که دارای ایستگاه های بین راه هستند پشتیبانی نمی شود.

RouteLocalizedValues

نمایش متنی از ویژگی های خاص.

فیلدها
`distance`	`LocalizedText` مسافت سفر به صورت متنی نشان داده شده است.
`duration`	`LocalizedText` مدت زمان با در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است. توجه: اگر اطلاعات ترافیک را درخواست نکرده باشید، این مقدار همان مقدار `static_duration` خواهد بود.
`static_duration`	`LocalizedText` مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است.
`transit_fare`	`LocalizedText` کرایه حمل و نقل به صورت متنی نشان داده شده است.

RouteLabel

برچسب‌هایی برای Route که برای شناسایی ویژگی‌های خاص مسیر برای مقایسه با دیگران مفید هستند.

Enums
`ROUTE_LABEL_UNSPECIFIED`	پیش فرض - استفاده نشده است.
`DEFAULT_ROUTE`	مسیر پیش‌فرض "بهترین" برای محاسبه مسیر برگردانده شد.
`DEFAULT_ROUTE_ALTERNATE`	جایگزینی برای مسیر پیش‌فرض "بهترین" مسیرهایی مانند این زمانی که `compute_alternative_routes` مشخص شده باشد بازگردانده می شوند.
`FUEL_EFFICIENT`	مسیر مصرف سوخت مسیرهایی که با این مقدار برچسب گذاری شده اند برای پارامترهای Eco مانند مصرف سوخت بهینه شده اند.

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` حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک، در یک مسیر.
`localized_values`	`RouteLegLocalizedValues` نمایش متنی ویژگی های `RouteLeg` .
`steps_overview`	`StepsOverview` اطلاعات کلی در مورد مراحل این `RouteLeg` . این قسمت فقط برای مسیرهای TRANSIT پر شده است.

RouteLegLocalizedValues

نمایش متنی از ویژگی های خاص.

فیلدها

distance

LocalizedText

مسافت سفر به صورت متنی نشان داده شده است.

duration

LocalizedText

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

static_duration

LocalizedText

مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است.

StepsOverview

اطلاعات کلی درباره لیستی از RouteLegStep را ارائه می دهد.

فیلدها

فیلدها
`multi_modal_segments[]`	`MultiModalSegment` اطلاعات خلاصه شده در مورد بخش های مختلف چند وجهی `RouteLeg.steps` . اگر `RouteLeg` شامل بخش‌های چند وجهی در مراحل نباشد، این فیلد پر نمی‌شود.

multi_modal_segments[]

MultiModalSegment

اطلاعات خلاصه شده در مورد بخش های مختلف چند وجهی RouteLeg.steps . اگر RouteLeg شامل بخش‌های چند وجهی در مراحل نباشد، این فیلد پر نمی‌شود.

MultiModalSegment

اطلاعات خلاصه ای را در مورد بخش های مختلف چند وجهی RouteLeg.steps ارائه می دهد. یک بخش چند وجهی به عنوان یک یا چند RouteLegStep به هم پیوسته تعریف می‌شود که RouteTravelMode یکسان دارند. اگر RouteLeg شامل بخش‌های چند وجهی در مراحل نباشد، این فیلد پر نمی‌شود.

فیلدها
`navigation_instruction`	`NavigationInstruction` راهنمای ناوبری برای بخش چند وجهی.
`travel_mode`	`RouteTravelMode` حالت سفر بخش چند وجهی.
`step_start_index`	`int32` شاخص `RouteLegStep` مربوطه که شروع یک بخش چند وجهی است.
`step_end_index`	`int32` شاخص `RouteLegStep` مربوطه که انتهای یک بخش چند وجهی است.

RouteLegStep

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

فیلدها
`distance_meters`	`int32` مسافت طی این مرحله، بر حسب متر است. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.
`static_duration`	`Duration` مدت زمان سفر در این مرحله بدون در نظر گرفتن شرایط ترافیکی. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.
`polyline`	`Polyline` چند خط مرتبط با این مرحله.
`start_location`	`Location` محل شروع این مرحله.
`end_location`	`Location` محل پایان این مرحله.
`navigation_instruction`	`NavigationInstruction` دستورالعمل های ناوبری.
`travel_advisory`	`RouteLegStepTravelAdvisory` حاوی اطلاعات اضافی است که کاربر باید از آنها مطلع شود، مانند محدودیت های احتمالی منطقه ترافیک، در یک گام.
`localized_values`	`RouteLegStepLocalizedValues` نمایش متنی خصوصیات `RouteLegStep` .
`transit_details`	`RouteLegStepTransitDetails` جزئیات مربوط به این مرحله اگر حالت سفر `TRANSIT` باشد.
`travel_mode`	`RouteTravelMode` حالت سفر استفاده شده برای این مرحله.

RouteLegStepLocalizedValues

نمایش متنی از ویژگی های خاص.

فیلدها

distance

LocalizedText

مسافت سفر به صورت متنی نشان داده شده است.

static_duration

LocalizedText

مدت زمان بدون در نظر گرفتن شرایط ترافیک، به صورت متن نشان داده شده است.

RouteLegStepTransitDetails

اطلاعات اضافی برای RouteLegStep مربوط به مسیرهای TRANSIT .

فیلدها
`stop_details`	`TransitStopDetails` اطلاعات در مورد ورود و خروج توقف برای مرحله.
`localized_values`	`TransitDetailsLocalizedValues` نمایش متنی خصوصیات `RouteLegStepTransitDetails` .
`headsign`	`string` جهت حرکت در این خط را همانطور که روی وسیله نقلیه یا در ایستگاه خروج مشخص شده است مشخص می کند. جهت اغلب ایستگاه پایانه است.
`headway`	`Duration` زمان مورد انتظار را به عنوان مدت زمان بین خروج از همان توقف در این زمان مشخص می کند. به عنوان مثال، با مقدار 600 ثانیه پیشروی، اگر اتوبوس خود را از دست بدهید، انتظار دارید ده دقیقه صبر کنید.
`transit_line`	`TransitLine` اطلاعات مربوط به خط ترانزیت مورد استفاده در این مرحله.
`stop_count`	`int32` تعداد توقف ها از مبدأ تا توقف ورود. این شمارش شامل توقف ورود است، اما توقف خروج را شامل نمی شود. به عنوان مثال، اگر مسیر شما از ایستگاه A خارج شود، از ایستگاه های B و C عبور کند و به ایستگاه D برسد، stop_count عدد 3 را برمی گرداند.
`trip_short_text`	`string` متنی که در جدول ها و تابلوهای علامت برای شناسایی یک سفر ترانزیت به مسافران ظاهر می شود. متن باید به طور منحصر به فرد یک سفر در یک روز خدمات را مشخص کند. به عنوان مثال، "538" `trip_short_text` قطار Amtrak است که سن خوزه، کالیفرنیا را در ساعت 15:10 روزهای هفته به سمت ساکرامنتو، کالیفرنیا ترک می کند.

TransitDetailsLocalizedValues

توضیحات محلی مقادیر برای RouteTransitDetails .

فیلدها

فیلدها
`arrival_time`	`LocalizedTime` زمان در نمایش متن قالب بندی شده با منطقه زمانی مربوطه.
`departure_time`	`LocalizedTime` زمان در نمایش متن قالب بندی شده با منطقه زمانی مربوطه.

arrival_time

LocalizedTime

زمان در نمایش متن قالب بندی شده با منطقه زمانی مربوطه.

departure_time

LocalizedTime

زمان در نمایش متن قالب بندی شده با منطقه زمانی مربوطه.

TransitStopDetails

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

فیلدها
`arrival_stop`	`TransitStop` اطلاعات در مورد توقف رسیدن برای مرحله.
`arrival_time`	`Timestamp` زمان تخمینی رسیدن به مرحله.
`departure_stop`	`TransitStop` اطلاعات در مورد توقف حرکت برای پله.
`departure_time`	`Timestamp` زمان تخمینی حرکت برای مرحله.

RouteLegStepTravelAdvisory

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

فیلدها

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

speed_reading_intervals[]

SpeedReadingInterval

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

RouteLegTravelAdvisory

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

فیلدها

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

فیلدها
`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` در برخی موارد که سرور قادر به محاسبه مسیر با ترجیحات داده شده برای این جفت مبدا/مقصد خاص نیست، ممکن است به استفاده از حالت دیگری از محاسبه بازگردد. هنگامی که از حالت بازگشتی استفاده می شود، این قسمت حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است.
`localized_values`	`LocalizedValues` نمایش متنی خصوصیات `RouteMatrixElement` .
`origin_index`	`int32` شاخص مبتنی بر صفر مبدا در درخواست.
`destination_index`	`int32` شاخص مبتنی بر صفر مقصد در درخواست.

Localized Values

نمایش متنی از ویژگی های خاص.

فیلدها
`distance`	`LocalizedText` مسافت سفر به صورت متنی نشان داده شده است.
`duration`	`LocalizedText` مدت زمان به صورت متنی با در نظر گرفتن شرایط ترافیک نشان داده می شود. توجه: اگر اطلاعات ترافیک درخواست نشده باشد، این مقدار همان مقدار static_duration است.
`static_duration`	`LocalizedText` مدت زمان به صورت متنی بدون در نظر گرفتن شرایط ترافیک نشان داده می شود.
`transit_fare`	`LocalizedText` کرایه حمل و نقل به صورت متنی نشان داده شده است.

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` وقتی روی true تنظیم شود، در صورت معقول بودن از جاده‌های عوارضی اجتناب می‌کند و به مسیرهایی که شامل جاده‌های عوارضی نیستند، ترجیح می‌دهد. فقط برای `DRIVE` و `TWO_WHEELER` `RouteTravelMode` اعمال می شود.
`avoid_highways`	`bool` وقتی روی true تنظیم شود، از بزرگراه‌هایی که معقول باشد اجتناب می‌کند و به مسیرهایی که شامل بزرگراه نیستند ترجیح می‌دهد. فقط برای `DRIVE` و `TWO_WHEELER` `RouteTravelMode` اعمال می شود.
`avoid_ferries`	`bool` وقتی روی true تنظیم شود، در صورت معقول بودن از کشتی‌ها اجتناب می‌کند و به مسیرهایی که شامل کشتی نیستند ترجیح می‌دهد. فقط برای `DRIVE` و `TWO_WHEELER` `RouteTravelMode` اعمال می شود.
`avoid_indoor`	`bool` وقتی روی true تنظیم شود، از پیمایش در داخل خانه در جایی که معقول باشد اجتناب می‌کند، و ترجیح می‌دهد مسیرهایی که حاوی ناوبری داخلی نیستند. فقط برای `WALK` `RouteTravelMode` اعمال می شود.
`vehicle_info`	`VehicleInfo` اطلاعات خودرو را مشخص می کند.
`toll_passes[]`	`TollPass` اطلاعات مربوط به مجوزهای دریافت عوارض را در خود گنجانده است. اگر مجوزهای عوارضی ارائه شود، API سعی می‌کند قیمت گذر را برگرداند. اگر مجوزهای دریافت عوارض ارائه نشود، API کارت عوارضی را ناشناخته تلقی می کند و سعی می کند قیمت نقدی را برگرداند. فقط برای `DRIVE` و `TWO_WHEELER` `RouteTravelMode` اعمال می شود.

RouteTravelAdvisory

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

فیلدها
`toll_info`	`TollInfo` حاوی اطلاعاتی در مورد عوارض در مسیر است. این فیلد فقط در صورتی پر می شود که عوارضی در مسیر وجود داشته باشد. اگر این فیلد تنظیم شده باشد، اما زیرفیلد `estimatedPrice` پر نشده باشد، مسیر شامل عوارض است، اما قیمت تخمینی ناشناخته است. اگر این فیلد تنظیم نشده باشد، هیچ عوارضی در مسیر وجود ندارد.
`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).`
`fuel_consumption_microliters`	`int64` مصرف سوخت پیش بینی شده بر حسب میکرولیتر
`route_restrictions_partially_ignored`	`bool` مسیر برگشتی ممکن است دارای محدودیت‌هایی باشد که برای حالت سفر یا اصلاح‌کننده‌های مسیر درخواستی مناسب نباشد.
`transit_fare`	`Money` در صورت وجود، شامل کل کرایه یا هزینه‌های بلیت در این مسیر است. این ویژگی فقط برای درخواست‌های `TRANSIT` و فقط برای مسیرهایی که اطلاعات کرایه برای تمام مراحل حمل‌ونقل در دسترس است، بازگردانده می‌شود.

RouteTravelMode

مجموعه ای از مقادیر مورد استفاده برای تعیین حالت سفر. توجه: مسیرهای WALK , BICYCLE و TWO_WHEELER در مرحله بتا هستند و ممکن است گاهی اوقات پیاده روهای صاف، مسیرهای عابر پیاده یا مسیرهای دوچرخه سواری را نداشته باشند. شما باید این هشدار را برای تمام مسیرهای پیاده روی، دوچرخه سواری و دو چرخی که در برنامه خود نمایش می دهید به کاربر نمایش دهید.

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

RoutingPreference

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

Enums
`ROUTING_PREFERENCE_UNSPECIFIED`	هیچ اولویت مسیریابی مشخص نشده است. پیش‌فرض `TRAFFIC_UNAWARE` است.
`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` شاخص شروع این بازه در چند خط.
`end_polyline_point_index`	`int32` شاخص پایانی این بازه در چند خط.
`speed_type` فیلد اتحادیه . `speed_type` فقط می تواند یکی از موارد زیر باشد:
`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`	کارت عوارض مکزیک جزئیات بیشتر را در 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_BCPASS`	MI، ایالات متحده آمریکا
`US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG`	MI، ایالات متحده آمریکا
`US_MI_IQ_PROX_CARD`	MI، ایالات متحده آمریکا منسوخ شده است زیرا این نوع مجوز دیگر وجود ندارد. این مورد منسوخ شده است!
`US_MI_IQ_TAG`	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_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، ایالات متحده آمریکا
`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، ایالات متحده آمریکا

TrafficModel

مفروضاتی را برای محاسبه زمان در ترافیک مشخص می کند. این تنظیم بر مقدار بازگشتی در قسمت duration در پاسخ تأثیر می‌گذارد، که شامل زمان پیش‌بینی‌شده در ترافیک بر اساس میانگین‌های تاریخی است.

Enums
`TRAFFIC_MODEL_UNSPECIFIED`	استفاده نشده اگر مشخص شود، به‌طور پیش‌فرض روی `BEST_GUESS` خواهد بود.
`BEST_GUESS`	نشان می دهد که `duration` بازگشت باید بهترین تخمین زمان سفر با توجه به آنچه در مورد شرایط ترافیک تاریخی و ترافیک زنده شناخته شده است باشد. هرچه `departure_time` به زمان کنونی نزدیک‌تر باشد، ترافیک زنده اهمیت بیشتری پیدا می‌کند.
`PESSIMISTIC`	نشان می دهد که مدت زمان بازگشت باید بیشتر از زمان واقعی سفر در بیشتر روزها باشد، اگرچه روزهای گاه به گاه با شرایط ترافیکی به خصوص بد ممکن است از این مقدار فراتر رود.
`OPTIMISTIC`	نشان می‌دهد که مدت زمان بازگشت باید در بیشتر روزها کوتاه‌تر از زمان واقعی سفر باشد، اگرچه ممکن است روزهای گاه به گاه با شرایط ترافیکی خوب سریع‌تر از این مقدار باشد.

آژانس ترانزیت

آژانس ترانزیت که یک خط ترانزیت را اداره می کند.

فیلدها

فیلدها
`name`	`string` نام این آژانس حمل و نقل.
`phone_number`	`string` شماره تلفن قالب‌بندی شده آژانس حمل و نقل.
`uri`	`string` URI آژانس حمل و نقل.

name

string

نام این آژانس حمل و نقل.

phone_number

string

شماره تلفن قالب‌بندی شده آژانس حمل و نقل.

uri

string

URI آژانس حمل و نقل.

ترانزیت لاین

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

فیلدها
`agencies[]`	`TransitAgency` آژانس حمل و نقل (یا آژانس هایی) که این خط ترانزیت را اداره می کند.
`name`	`string` نام کامل این خط ترانزیت، به عنوان مثال، "8 Avenue Local".
`uri`	`string` URI این خط ترانزیت که توسط آژانس حمل و نقل ارائه شده است.
`color`	`string` رنگی که معمولا در تابلوهای این خط استفاده می شود. در هگزادسیمال نشان داده شده است.
`icon_uri`	`string` URI برای نماد مرتبط با این خط.
`name_short`	`string` نام کوتاه این خط ترانزیت. این نام معمولاً یک شماره خط است، مانند "M7" یا "355".
`text_color`	`string` رنگی که معمولاً در متن روی تابلوهای این خط استفاده می شود. در هگزادسیمال نشان داده شده است.
`vehicle`	`TransitVehicle` نوع وسیله نقلیه ای که در این خط ترانزیتی تردد می کند.

Transit Preferences

اولویت‌ها برای مسیرهای مبتنی بر TRANSIT که بر مسیر برگشتی تأثیر می‌گذارند.

فیلدها

allowed_travel_modes[]

TransitTravelMode

مجموعه ای از حالت های سفر برای استفاده در هنگام دریافت مسیر TRANSIT . به طور پیش فرض برای همه حالت های پشتیبانی شده از سفر.

routing_preference

TransitRoutingPreference

یک اولویت مسیریابی که وقتی مشخص شد، بر مسیر TRANSIT برگشتی تأثیر می گذارد.

TransitRoutingPreference

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

Enums
`TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED`	هیچ اولویتی مشخص نشده است.
`LESS_WALKING`	نشان می دهد که مسیر محاسبه شده باید مقادیر محدودی از پیاده روی را ترجیح دهد.
`FEWER_TRANSFERS`	نشان می دهد که مسیر محاسبه شده باید تعداد محدودی از انتقال را ترجیح دهد.

TransitTravelMode

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

Enums
`TRANSIT_TRAVEL_MODE_UNSPECIFIED`	حالت سفر حمل و نقل مشخص نشده است.
`BUS`	با اتوبوس سفر کنید.
`SUBWAY`	با مترو سفر کنید.
`TRAIN`	با قطار سفر کنید.
`LIGHT_RAIL`	با قطار سبک یا تراموا سفر کنید.
`RAIL`	با راه آهن سفر کنید. این معادل ترکیبی از `SUBWAY` ، `TRAIN` ، و `LIGHT_RAIL` است.

TransitStop

اطلاعات در مورد ایستگاه حمل و نقل

فیلدها

name

string

نام ایستگاه حمل و نقل.

location

Location

محل توقف با مختصات طول و عرض جغرافیایی بیان می شود.

وسیله نقلیه ترانزیت

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

فیلدها
`name`	`LocalizedText` نام این وسیله نقلیه با حروف بزرگ نوشته شده است.
`type`	`TransitVehicleType` نوع وسیله نقلیه مورد استفاده.
`icon_uri`	`string` URI برای نماد مرتبط با این نوع خودرو.
`local_icon_uri`	`string` URI برای نماد مرتبط با این نوع وسیله نقلیه، بر اساس علائم حمل و نقل محلی.

Transit VehicleType

نوع وسایل نقلیه برای مسیرهای ترانزیتی.

Enums
`TRANSIT_VEHICLE_TYPE_UNSPECIFIED`	استفاده نشده
`BUS`	اتوبوس
`CABLE_CAR`	وسیله نقلیه ای که روی کابل، معمولاً روی زمین کار می کند. تله کابین های هوایی ممکن است از نوع `GONDOLA_LIFT` باشند.
`COMMUTER_TRAIN`	راه آهن شهری.
`FERRY`	فری
`FUNICULAR`	وسیله نقلیه ای که توسط کابل از شیب تند بالا کشیده می شود. یک فونیکولار معمولاً از دو اتومبیل تشکیل شده است که هر اتومبیل به عنوان وزنه تعادل برای دیگری عمل می کند.
`GONDOLA_LIFT`	یک تله کابین هوایی.
`HEAVY_RAIL`	ریل سنگین
`HIGH_SPEED_TRAIN`	قطار پر سرعت.
`INTERCITY_BUS`	اتوبوس بین شهری.
`LONG_DISTANCE_TRAIN`	قطار راه دور.
`METRO_RAIL`	حمل و نقل ریلی سبک.
`MONORAIL`	مونوریل.
`OTHER`	همه وسایل نقلیه دیگر
`RAIL`	راه آهن.
`SHARE_TAXI`	تاکسی اشتراکی نوعی اتوبوس با قابلیت جابجایی و جابجایی مسافران در هر نقطه از مسیر است.
`SUBWAY`	راه آهن زیرزمینی.
`TRAM`	ریل نوری روی زمین.
`TROLLEYBUS`	واگن برقی.

واحدها

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

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

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

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

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

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

حاوی اطلاعات خودرو، مانند نوع انتشار خودرو.

فیلدها

emission_type

VehicleEmissionType

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

نقطه راه

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

فیلدها
`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` `RouteTravelMode` کار می کند.
`location_type` فیلد اتحادیه روش های مختلف برای نشان دادن یک مکان `location_type` فقط می تواند یکی از موارد زیر باشد:
`location`	`Location` نقطه ای که با استفاده از مختصات جغرافیایی، از جمله عنوان اختیاری مشخص شده است.
`place_id`	`string` شناسه مکان POI مرتبط با ایستگاه بین راه.
`address`	`string` آدرس قابل خواندن توسط انسان یا یک کد مثبت. برای جزئیات بیشتر به https://plus.codes مراجعه کنید.