این صفحه به‌وسیله ‏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` پارامترهای مختلفی را در نظر می گیرد که یک مسیر کارآمد سوخت بهینه ایجاد می کند. هنگام استفاده از این ویژگی، به دنبال `route_labels` در مسیرهای حاصل بگردید.
`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` یک نشانه مات که می تواند به Navigation SDK منتقل شود تا مسیر را در حین ناوبری بازسازی کند و در صورت تغییر مسیر، به هدف اصلی هنگام ایجاد مسیر احترام بگذارد. با این نشانه به عنوان یک لکه مات رفتار کنید. مقدار آن را در بین درخواست‌ها مقایسه نکنید زیرا ممکن است ارزش آن تغییر کند حتی اگر سرویس دقیقاً همان مسیر را برگرداند. توجه: `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` اعمال می شود.

مربوط به مسیریابی

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

فیلدها
`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` بازگردانده می شود و فقط برای مسیرهایی که اطلاعات کرایه برای کلیه مراحل ترانزیت در دسترس است.

روش

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

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

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

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

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

سرعت خواندن

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

فیلدها
`start_polyline_point_index`	`int32` شاخص شروع این بازه در پلی خط.
`end_polyline_point_index`	`int32` شاخص پایان این بازه در پلی خط.
Union Field `speed_type` . `speed_type` فقط می تواند یکی از موارد زیر باشد:
`speed`	`Speed` سرعت ترافیک در این بازه.

سرعت

طبقه بندی سرعت پلیین بر اساس داده های ترافیکی.

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

کول

اطلاعات عوارض را در یک Route یا در یک RouteLeg محاصره می کند.

فیلدها

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

estimated_price[]

Money

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

عوارض

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

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 لازم است. به عنوان مثال - Mandiri Bank 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. نسخه جدید و غیره با تخفیف بیشتر و ارتباطات دو طرفه بین دستگاه های موجود در وسایل نقلیه و آنتن در جاده. 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`	آل ، ایالات متحده
`US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS`	AK ، ایالات متحده
`US_CA_FASTRAK`	کالیفرنیا ، ایالات متحده
`US_CA_FASTRAK_CAV_STICKER`	نشان می دهد که راننده علاوه بر برچسب DMV صادر شده با هوای تمیز (CAV) دارای هر پاس Fastrak است. https://www.bayareafastrak.org/en/guide/doineedflex.shtml
`US_CO_EXPRESSTOLL`	شرکت ، ایالات متحده
`US_CO_GO_PASS`	شرکت ، ایالات متحده
`US_DE_EZPASSDE`	د ، ایالات متحده
`US_FL_BOB_SIKES_TOLL_BRIDGE_PASS`	FL ، ایالات متحده
`US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD`	FL ، ایالات متحده
`US_FL_EPASS`	FL ، ایالات متحده
`US_FL_GIBA_TOLL_PASS`	FL ، ایالات متحده
`US_FL_LEEWAY`	FL ، ایالات متحده
`US_FL_SUNPASS`	FL ، ایالات متحده
`US_FL_SUNPASS_PRO`	FL ، ایالات متحده
`US_IL_EZPASSIL`	ایل ، ایالات متحده
`US_IL_IPASS`	ایل ، ایالات متحده
`US_IN_EZPASSIN`	در ، ایالات متحده
`US_KS_BESTPASS_HORIZON`	KS ، ایالات متحده.
`US_KS_KTAG`	KS ، ایالات متحده.
`US_KS_NATIONALPASS`	KS ، ایالات متحده.
`US_KS_PREPASS_ELITEPASS`	KS ، ایالات متحده.
`US_KY_RIVERLINK`	کی ، ایالات متحده
`US_LA_GEAUXPASS`	LA ، ایالات متحده
`US_LA_TOLL_TAG`	LA ، ایالات متحده
`US_MA_EZPASSMA`	MA، ایالات متحده آمریکا
`US_MD_EZPASSMD`	دکتر ، ایالات متحده.
`US_ME_EZPASSME`	من ، ایالات متحده
`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`	NJ ، ایالات متحده.
`US_NJ_EZPASSNJ`	NJ ، ایالات متحده.
`US_NY_EXPRESSPASS`	نیویورک، ایالات متحده آمریکا
`US_NY_EZPASSNY`	نیویورک، ایالات متحده آمریکا
`US_OH_EZPASSOH`	اوه ، ایالات متحده
`US_PA_EZPASSPA`	PA ، ایالات متحده
`US_RI_EZPASSRI`	ری ، ایالات متحده
`US_SC_PALPASS`	SC، ایالات متحده آمریکا
`US_TX_AVI_TAG`	TX ، ایالات متحده.
`US_TX_BANCPASS`	TX ، ایالات متحده.
`US_TX_DEL_RIO_PASS`	TX ، ایالات متحده.
`US_TX_EFAST_PASS`	TX ، ایالات متحده.
`US_TX_EAGLE_PASS_EXPRESS_CARD`	TX ، ایالات متحده.
`US_TX_EPTOLL`	TX ، ایالات متحده.
`US_TX_EZ_CROSS`	TX ، ایالات متحده.
`US_TX_EZTAG`	TX ، ایالات متحده.
`US_TX_FUEGO_TAG`	TX ، ایالات متحده.
`US_TX_LAREDO_TRADE_TAG`	TX ، ایالات متحده.
`US_TX_PLUSPASS`	TX ، ایالات متحده.
`US_TX_TOLLTAG`	TX ، ایالات متحده.
`US_TX_TXTAG`	TX ، ایالات متحده.
`US_TX_XPRESS_CARD`	TX ، ایالات متحده.
`US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD`	UT ، ایالات متحده
`US_VA_EZPASSVA`	VA ، ایالات متحده
`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 ، ایالات متحده.

حالت ترافیک

فرضیات استفاده شده در هنگام محاسبه زمان در ترافیک را مشخص می کند. این تنظیم بر مقدار برگشتی در زمینه 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 خیابان محلی".
`uri`	`string` URI برای این خط ترانزیت همانطور که توسط آژانس ترانزیت ارائه شده است.
`color`	`string` رنگی که معمولاً در این علائم در علائم استفاده می شود. در hexadecimal نماینده است.
`icon_uri`	`string` URI برای نماد مرتبط با این خط.
`name_short`	`string` نام کوتاه این خط ترانزیت. این نام معمولاً یک شماره خط مانند "M7" یا "355" خواهد بود.
`text_color`	`string` رنگی که معمولاً در متن روی علائم برای این خط استفاده می شود. در hexadecimal نماینده است.
`vehicle`	`TransitVehicle` نوع وسیله نقلیه ای که در این خط ترانزیت کار می کند.

ترانزیت

ترجیحات مربوط به مسیرهای مبتنی بر TRANSIT که بر مسیری که بازگردانده می شود تأثیر می گذارد.

فیلدها

allowed_travel_modes[]

TransitTravelMode

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

routing_preference

TransitRoutingPreference

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

پیش نمایش

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

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

حالت حمل و نقل

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

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

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

اطلاعات مربوط به توقف حمل و نقل.

فیلدها

name

string

نام ترانزیت توقف.

location

Location

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

حمل و نقل

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

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

نوع حمل و نقل

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

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`	Taxi Share نوعی اتوبوس است که توانایی رها کردن و انتخاب مسافر در هر نقطه از مسیر خود را دارد.
`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` این نقطه را به عنوان یک نقطه عطف و نه یک نقطه توقف نشان می دهد. برای هر یک از ایستگاه های غیر VIA در درخواست ، پاسخ ورود به آرایه `legs` را به شما ارائه می دهد تا جزئیات مربوط به توقف در آن پای سفر را ارائه دهد. وقتی می خواهید مسیر از این نقطه عبور کند بدون اینکه متوقف شود ، این مقدار را درست تنظیم کنید. از طریق ایستگاه های راه باعث نمی شود که ورود به آرایه `legs` اضافه شود ، اما آنها سفر را از طریق ایستگاه راه طی می کنند. فقط می توانید این مقدار را در ایستگاه های راه که واسطه هستند تنظیم کنید. اگر این قسمت را در ایستگاه های راه ترمینال تنظیم کنید ، درخواست انجام نمی شود. اگر `ComputeRoutesRequest.optimize_waypoint_order` تنظیم شده باشد ، این قسمت نمی تواند روی درست تنظیم شود. در غیر این صورت ، درخواست انجام نمی شود.
`vehicle_stopover`	`bool` نشان می دهد که ایستگاه راه برای متوقف کردن وسایل نقلیه در آن قرار دارد ، جایی که قصد وانت یا کشویی است. هنگامی که این مقدار را تعیین می کنید ، مسیر محاسبه شده شامل غیر `via` ایستگاه های راه در جاده هایی نیست که برای وانت و رها کردن نامناسب هستند. این گزینه فقط برای حالت های مسافرتی `DRIVE` و `TWO_WHEELER` کار می کند ، و هنگامی که `location_type` `Location` است.
`side_of_road`	`bool` نشان می دهد که مکان این نقطه راه به معنای اولویت برای متوقف کردن وسیله نقلیه در یک طرف خاص از جاده است. هنگامی که این مقدار را تعیین کردید ، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده متوقف شود که مکان از مرکز جاده مغرضانه باشد. این گزینه فقط برای `DRIVE` و `TWO_WHEELER` `RouteTravelMode` کار می کند.
Union Field `location_type` . روش های مختلف برای نشان دادن یک مکان. `location_type` فقط می تواند یکی از موارد زیر باشد:
`location`	`Location` نکته ای که با استفاده از مختصات جغرافیایی ، از جمله عنوان اختیاری مشخص شده است.
`place_id`	`string` شناسه Poi Place در ارتباط با نقطه راه.
`address`	`string` آدرس قابل خواندن انسان یا یک کد به علاوه. برای جزئیات بیشتر به https://plus.codes مراجعه کنید.