Package google.maps.routing.v2

شاخصه

• ‫Routes (میان‌گیری)
• ‫ComputeRouteMatrixRequest (پیام)
• ‫ComputeRouteMatrixRequest.ExtraComputation (شمارشی)
• ‫ComputeRoutesRequest (پیام)
• ‫ComputeRoutesRequest.ExtraComputation (شمارشی)
• ‫ComputeRoutesRequest.ReferenceRoute (شمارشی)
• ‫ComputeRoutesResponse (پیام)
• ‫FallbackInfo (پیام)
• ‫FallbackReason (شمارشی)
• ‫FallbackRoutingMode (شمارشی)
• ‫GeocodedWaypoint (پیام)
• ‫GeocodingResults (پیام)
• ‫LocalizedTime (پیام)
• ‫Location (پیام)
• ‫Maneuver (شمارشی)
• ‫NavigationInstruction (پیام)
• ‫Polyline (پیام)
• ‫PolylineDetails (پیام)
• ‫PolylineDetails.BridgeInfo (پیام)
• ‫PolylineDetails.FlyoverInfo (پیام)
• ‫PolylineDetails.NarrowRoadInfo (پیام)
• ‫PolylineDetails.PolylinePointIndex (پیام)
• ‫PolylineDetails.RestrictionInfo (پیام)
• ‫PolylineDetails.RoadFeatureState (شمارشی)
• ‫PolylineDetails.SkywayInfo (پیام)
• ‫PolylineDetails.TunnelInfo (پیام)
• ‫PolylineEncoding (شمارشی)
• ‫PolylineQuality (شمارشی)
• ‫Route (پیام)
• ‫Route.RouteLocalizedValues (پیام)
• ‫RouteLabel (شمارشی)
• ‫RouteLeg (پیام)
• ‫RouteLeg.RouteLegLocalizedValues (پیام)
• ‫RouteLeg.StepsOverview (پیام)
• ‫RouteLeg.StepsOverview.MultiModalSegment (پیام)
• ‫RouteLegStep (پیام)
• ‫RouteLegStep.RouteLegStepLocalizedValues (پیام)
• ‫RouteLegStepTransitDetails (پیام)
• ‫RouteLegStepTransitDetails.TransitDetailsLocalizedValues (پیام)
• ‫RouteLegStepTransitDetails.TransitStopDetails (پیام)
• ‫RouteLegStepTravelAdvisory (پیام)
• ‫RouteLegTravelAdvisory (پیام)
• ‫RouteMatrixDestination (پیام)
• ‫RouteMatrixElement (پیام)
• ‫RouteMatrixElement.LocalizedValues (پیام)
• ‫RouteMatrixElementCondition (شمارشی)
• ‫RouteMatrixOrigin (پیام)
• ‫RouteModifiers (پیام)
• ‫RouteTravelAdvisory (پیام)
• ‫RouteTravelMode (شمارشی)
• ‫RoutingPreference (شمارشی)
• ‫SpeedReadingInterval (پیام)
• ‫SpeedReadingInterval.Speed (شمارشی)
• ‫TollInfo (پیام)
• ‫TollPass (شمارشی)
• ‫TrafficModel (شمارشی)
• ‫TransitAgency (پیام)
• ‫TransitLine (پیام)
• ‫TransitPreferences (پیام)
• ‫TransitPreferences.TransitRoutingPreference (شمارشی)
• ‫TransitPreferences.TransitTravelMode (شمارشی)
• ‫TransitStop (پیام)
• ‫TransitVehicle (پیام)
• ‫TransitVehicle.TransitVehicleType (شمارشی)
• ‫Units (شمارشی)
• ‫VehicleEmissionType (شمارشی)
• ‫VehicleInfo (پیام)
• ‫VehicleInfo.HazardousGoodsType (شمارشی)
• ‫VehicleInfo.TrailerInfo (پیام)
• ‫Waypoint (پیام)

مسیرها

میانای برنامه‌سازی کاربردی «مسیرها».

ComputeRouteMatrix

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement) فهرستی از مبدأها و مقصدها را می‌گیرد و جاری‌سازی‌ای برمی‌گرداند که حاوی اطلاعات مسیر برای هر ترکیب مبدأ و مقصد است. توجه: این روش مستلزم آن است که یک پوشش فیلد پاسخ را در ورودی مشخص کنید. می‌توانید بااستفاده از پارامتر نشانی وب $fields یا fields، یا بااستفاده از سرایند HTTP/gRPC X-Goog-FieldMask پوشش فیلد پاسخ را ارائه دهید (پارامترها و سرایندهای نشانی وب دردسترس را ببینید). مقدار فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. این مستندات دقیق درباره نحوه ساختن مسیرهای فیلد را ببینید. برای مثال، در این روش: پوشش فیلد همه فیلدهای دردسترس (برای بازرسی دستی): X-Goog-FieldMask: * پوشش فیلد مدت زمان مسیر، فاصله‌ها، وضعیت عنصر، وضعیت، و شاخص‌های عنصر (نمونه‌ای از تنظیمات تولید): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration بسیار مهم است که status را در پوشش فیلدتان بگنجانید، درغیراین‌صورت همه پیام‌ها «تأیید» به‌نظر می‌رسند. ‫Google استفاده از ماسک فیلد پاسخ نویسه عام (*) را توصیه نمی‌کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می‌کند تا چرخه‌های محاسباتی را ذخیره کند و به ما امکان می‌دهد نتیجه را با تأخیر کمتری به شما برگردانیم. انتخاب فقط فیلدهایی که در کار تولید خود نیاز دارید عملکرد پایدار تأخیر را تضمین می‌کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسباتی بیشتری نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدهای سطح بالا را انتخاب کنید، ممکن است با افت عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه می‌کنیم به‌طور خودکار در پاسخ گنجانده می‌شود. انتخاب فقط فیلدهایی که به آن‌ها نیاز دارید منجر به اندازه پاسخ کوچک‌تر و درنتیجه توان عملیاتی شبکه بالاتر می‌شود.

ComputeRoutes

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse) مسیر اصلی را به‌همراه مسیرهای جایگزین اختیاری، با درنظر گرفتن مجموعه‌ای از ایستگاه‌های بین راهی و پایانی، برمی‌گرداند. توجه: این روش مستلزم آن است که یک پوشش فیلد پاسخ را در ورودی مشخص کنید. می‌توانید پوشش فیلد پاسخ را بااستفاده از پارامتر نشانی وب $fields یا fields، یا بااستفاده از سرایند HTTP/gRPC X-Goog-FieldMask ارائه دهید (پارامترهای نشانی وب و سرایندهای دردسترس را ببینید). مقدار فهرستی از مسیرهای فیلد است که با کاما از هم جدا شده‌اند. مستندات مفصلی درباره نحوه ساختن مسیرهای فیلد را ببینید. برای مثال، در این روش: پوشش فیلد همه فیلدهای دردسترس (برای بازرسی دستی): X-Goog-FieldMask: * پوشش فیلد مدت، فاصله، و چندخطی سطح «مسیر» (نمونه‌ای از تنظیم تولید): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline ‫Google استفاده از پوشش فیلد پاسخ نویسه عام (*) یا مشخص کردن پوشش فیلد در سطح بالا (routes) را توصیه نمی‌کند، زیرا: انتخاب فقط فیلدهایی که نیاز دارید به سرور ما کمک می‌کند تا چرخه‌های محاسباتی را ذخیره کند و به ما امکان می‌دهد نتیجه را با تأخیر کمتری به شما برگردانیم. انتخاب فقط فیلدهایی که در کار تولید خود نیاز دارید عملکرد پایدار تأخیر را تضمین می‌کند. ممکن است در آینده فیلدهای پاسخ بیشتری اضافه کنیم و این فیلدهای جدید ممکن است به زمان محاسباتی بیشتری نیاز داشته باشند. اگر همه فیلدها را انتخاب کنید، یا اگر همه فیلدهای سطح بالا را انتخاب کنید، ممکن است با افت عملکرد مواجه شوید زیرا هر فیلد جدیدی که اضافه می‌کنیم به‌طور خودکار در پاسخ گنجانده می‌شود. انتخاب فقط فیلدهایی که به آن‌ها نیاز دارید منجر به اندازه پاسخ کوچک‌تر و درنتیجه توان عملیاتی شبکه بالاتر می‌شود.

ComputeRouteMatrixRequest

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

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

ExtraComputation

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

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

ComputeRoutesRequest

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

فیلدها
origin	Waypoint الزامی. نقطه‌مسیر مبدأ.
destination	Waypoint الزامی. ایستگاه بین راهی مقصد.
intermediates[]	Waypoint اختیاری. مجموعه‌ای از نقاط بین مسیر (به‌جز نقاط پایانی)، برای توقف در آن‌ها یا عبور از کنار آن‌ها. حداکثر از ۲۵ ایستگاه بین راهی پشتیبانی می‌شود.
travel_mode	RouteTravelMode اختیاری. حالت حمل‌ونقل را مشخص می‌کند.
routing_preference	RoutingPreference اختیاری. نحوه محاسبه مسیر را مشخص می‌کند. کارساز تلاش می‌کند از اولویت مسیریابی انتخاب‌شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تأخیر بسیار طولانی شود، خطا برگردانده می‌شود. این گزینه را فقط زمانی می‌توانید مشخص کنید که travel_mode DRIVE یا TWO_WHEELER باشد، درغیراین‌صورت درخواست ناموفق خواهد بود.
polyline_quality	PolylineQuality اختیاری. اولویت شما را برای کیفیت چندخطی مشخص می‌کند.
polyline_encoding	PolylineEncoding اختیاری. کدبندی ترجیحی را برای چندخطی مشخص می‌کند.
departure_time	Timestamp اختیاری. زمان حرکت. اگر این مقدار را تنظیم نکنید، این مقدار به‌طور پیش‌فرض روی زمانی که درخواست را ارسال کرده‌اید تنظیم می‌شود. توجه: فقط زمانی می‌توانید departure_time را در گذشته مشخص کنید که RouteTravelMode روی TRANSIT تنظیم شده باشد. سفرهای حمل‌ونقل عمومی تا ۷ روز گذشته یا ۱۰۰ روز آینده دردسترس است.
arrival_time	Timestamp اختیاری. زمان رسیدن. توجه: وقتی درخواست‌ها RouteTravelMode دیگری به‌جز TRANSIT را مشخص می‌کنند، این فیلد نادیده گرفته می‌شود. می‌توانید departure_time یا arrival_time را مشخص کنید، اما نمی‌توانید هر دو را مشخص کنید. سفرهای حمل‌ونقل عمومی تا ۷ روز گذشته یا ۱۰۰ روز آینده دردسترس است.
compute_alternative_routes	bool اختیاری. مشخص می‌کند که آیا مسیرهای جایگزین علاوه‌بر مسیر محاسبه شود یا نه. برای درخواست‌هایی که ایستگاه‌های بین راهی دارند، مسیرهای جایگزین برگردانده نمی‌شود.
route_modifiers	RouteModifiers اختیاری. مجموعه‌ای از شرایطی که باید برآورده شوند و بر نحوه محاسبه مسیرها تأثیر می‌گذارند.
language_code	string اختیاری. کد زبان BCP-47، مانند «en-US» یا «sr-Latn». برای اطلاعات بیشتر، شناسه مکان Unicode را ببینید. برای فهرست زبان‌های پشتیبانی‌شده، پشتیبانی از زبان را ببینید. وقتی این مقدار را ارائه نمی‌دهید، زبان نمایش از مکان درخواست مسیر استنباط می‌شود.
region_code	string اختیاری. کد منطقه، که به‌عنوان مقدار دوحرفی ccTLD («دامنه سطح بالا») مشخص شده است. برای اطلاعات بیشتر، دامنه‌های سطح بالای کد کشور را ببینید.
units	Units اختیاری. واحدهای اندازه‌گیری را برای فیلدهای نمایش مشخص می‌کند. این فیلدها شامل فیلد instruction در NavigationInstruction می‌شود. واحدهای اندازه‌گیری استفاده‌شده برای مسیر، بخش، فاصله گام، و مدت زمان تحت تأثیر این مقدار قرار نمی‌گیرند. اگر این مقدار را ارائه ندهید، واحدهای نمایش از مکان اولین مبدأ استنباط می‌شود.
optimize_waypoint_order	bool اختیاری. اگر روی درست تنظیم شود، سرویس تلاش می‌کند با تغییر ترتیب ایستگاه‌های بین راه مشخص‌شده، هزینه کلی مسیر را به حداقل برساند. اگر هریک از ایستگاه‌های بین راهی via ایستگاه بین راهی باشد، درخواست ناموفق خواهد بود. از ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index برای پیدا کردن ترتیب جدید استفاده کنید. اگر ComputeRoutesResponse.routes.optimized_intermediate_waypoint_index در سرایند X-Goog-FieldMask درخواست نشود، درخواست ناموفق خواهد بود. اگر optimize_waypoint_order روی «نادرست» تنظیم شود، 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 تنظیم شده باشد.

ExtraComputation

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

شمارشی‌ها
EXTRA_COMPUTATION_UNSPECIFIED	استفاده‌نشده. درخواست‌های حاوی این مقدار ناموفق خواهد بود.
TOLLS	اطلاعات عوارض برای مسیر(ها).
FUEL_CONSUMPTION	مصرف سوخت تخمینی برای مسیر(ها).
TRAFFIC_ON_POLYLINE	چندخطی‌های آگاه از ترافیک برای مسیر(ها).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS	NavigationInstruction به‌عنوان رشته نوشتاری HTML قالب‌بندی‌شده ارائه می‌شود. این محتوا باید همان‌گونه که هست خوانده شود. این محتوا فقط برای نمایش است. آن را به‌صورت برنامه‌ریزی‌شده تجزیه نکنید.
FLYOVER_INFO_ON_POLYLINE	اطلاعات پل هوایی برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.flyover_info مشخص شود. درحال‌حاضر، این داده‌ها فقط برای برخی‌از شهرهای هند تکمیل می‌شود. این ویژگی آزمایشی است و واحد نگهداری کالا/هزینه ممکن است تغییر کند.
NARROW_ROAD_INFO_ON_POLYLINE	اطلاعات جاده باریک برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.narrow_road_info مشخص شود. درحال‌حاضر، این داده‌ها فقط برای برخی‌از شهرهای هند تکمیل می‌شود. این ویژگی آزمایشی است و واحد نگهداری کالا/هزینه ممکن است تغییر کند.
TUNNEL_INFO_ON_POLYLINE	اطلاعات تونل برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.tunnel_info مشخص شود.
BRIDGE_INFO_ON_POLYLINE	اطلاعات پل برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.bridge_info مشخص شود.
SKYWAY_INFO_ON_POLYLINE	اطلاعات پل هوایی برای مسیر(ها). برای برگرداندن این اطلاعات، باید فیلدماسک routes.polyline_details.skyway_info مشخص شود.

ReferenceRoute

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

شمارشی‌ها
REFERENCE_ROUTE_UNSPECIFIED	استفاده‌نشده. درخواست‌های حاوی این مقدار ناموفق است.
FUEL_EFFICIENT	مسیر با بهره‌وری سوخت.
SHORTER_DISTANCE	مسیر با فاصله سفر کوتاه‌تر. این قابلیتی آزمایشی است. برای DRIVE درخواست، این ویژگی مسافت کوتاه‌تر را بر راحتی رانندگی اولویت می‌دهد. برای مثال، ممکن است جاده‌های محلی را به‌جای بزرگراه‌ها ترجیح دهد، از جاده‌های خاکی استفاده کند، از میان پارکینگ‌ها عبور کند، و غیره. این ویژگی هیچ مانوری را که Google Maps می‌داند غیرقانونی است برنمی‌گرداند. برای درخواست‌های BICYCLE و TWO_WHEELER، این ویژگی مسیرهایی مشابه مسیرهایی که وقتی requested_reference_routes را مشخص نمی‌کنید برمی‌گرداند. این ویژگی با هیچ‌یک از حالت‌های سفر دیگر، ازطریق ایستگاه‌های بین راهی، یا optimize_waypoint_order سازگار نیست؛ چنین درخواست‌هایی ناموفق خواهد بود. بااین‌حال، می‌توانید آن را با هر routing_preference استفاده کنید.

ComputeRoutesResponse

پیام پاسخ ComputeRoutes.

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

FallbackInfo

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

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

FallbackReason

دلایل استفاده از پاسخ جایگزین.

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

FallbackRoutingMode

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

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

GeocodedWaypoint

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

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

GeocodingResults

حاوی GeocodedWaypoints برای مبدأ، مقصد، و ایستگاه‌های بین راهی است. فقط برای ایستگاه‌های بین راهی نشانی درج می‌شود.

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

LocalizedTime

شرح بومی‌سازی‌شده زمان.

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

مکان

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

فیلدها
lat_lng	LatLng مختصات جغرافیایی ایستگاه بین راهی.
heading	Int32Value جهت قطب‌نمای مرتبط با جهت جریان ترافیک. این مقدار سمت جاده را برای سوار و پیاده کردن مشخص می‌کند. مقادیر جهت می‌تواند از ۰ تا ۳۶۰ باشد، که در آن ۰ جهت شمال، ۹۰ جهت شرق، و غیره را مشخص می‌کند. فقط برای DRIVE و TWO_WHEELER RouteTravelMode می‌توانید از این فیلد استفاده کنید.

مانور

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

شمارشی‌ها
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	برای نشان دادن تغییر نام خیابان استفاده می‌شود.
DESTINATION	برای نشان دادن رسیدن به مقصد استفاده می‌شود.

NavigationInstruction

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

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

چندخطی

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

فیلدها
فیلد اتحادیه polyline_type. نوع چندخطی را دربرمی‌گیرد. به‌طور پیش‌فرض روی encoded_polyline تنظیم می‌شود. ‫polyline_type فقط می‌تواند یکی از موارد زیر باشد:
encoded_polyline	string کدبندی رشته‌ای چندخطی بااستفاده از الگوریتم کدبندی چندخطی
geo_json_linestring	Struct چندخطی را بااستفاده از قالب GeoJSON LineString مشخص می‌کند.

PolylineDetails

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

فیلدها
tunnel_info[]	TunnelInfo جزئیات تونل درطول چندخطی. اگر درخواست اصلاح‌کننده مسیر avoid_tunnels را مشخص کند و مسیر حاصل نتواند از آن اجتناب کند، یا اگر TUNNEL_INFO_ON_POLYLINE در extra_computations مشخص شده باشد و مسیر شامل تونل باشد، این فیلد تکمیل می‌شود.
restriction_info[]	RestrictionInfo جزئیات محدودیت درطول چندخطی. این فیلد فقط درصورتی تکمیل می‌شود که درخواستی اصلاح‌کننده مسیر vehicle_info را مشخص کند و مسیر حاصل حاوی محدودیت قابل‌اعمال باشد. درغیراین‌صورت، از این فیلد استفاده نمی‌شود.
flyover_info[]	FlyoverInfo جزئیات پرواز نمای نزدیک درطول چندخطی.
narrow_road_info[]	NarrowRoadInfo جزئیات جاده باریک درطول چندخطی.
bridge_info[]	BridgeInfo جزئیات پل درطول چندخطی.
skyway_info[]	SkywayInfo جزئیات پل هوایی درطول چندخطی.

BridgeInfo

اطلاعات مربوط به پل‌های طول چندخطی را دربرمی‌گیرد.

فیلدها
bridge_presence	RoadFeatureState نشان می‌دهد که آیا پلی برای بخش معینی از چندخط وجود دارد یا نه.
polyline_point_index	PolylinePointIndex مکان اطلاعات مربوط به پل درطول چندخطی.

FlyoverInfo

اطلاعات مربوط به پروازهای عبوری درطول چندخطی را دربرمی‌گیرد.

فیلدها
flyover_presence	RoadFeatureState فقط برونداد. نشان می‌دهد که آیا برای بخش معینی از چندخط پرواز نمایشی وجود دارد یا نه.
polyline_point_index	PolylinePointIndex مکان اطلاعات مربوط به پرواز بر فراز در امتداد چندخطی.

NarrowRoadInfo

اطلاعات مربوط به جاده‌های باریک درطول چندخطی را دربرمی‌گیرد.

فیلدها
narrow_road_presence	RoadFeatureState فقط برونداد. نشان می‌دهد که آیا جاده باریکی برای بخش معینی از چندخط وجود دارد یا خیر.
polyline_point_index	PolylinePointIndex مکان اطلاعات مربوط به جاده باریک درطول چندخطی.

PolylinePointIndex

شاخص‌های شروع و پایان را برای جزئیات چندخطی دربرمی‌گیرد. برای مواردی که داده‌ها مربوط به یک نقطه واحد است، start_index و end_index برابر خواهند بود.

فیلدها
start_index	int32 نمایه شروع این جزئیات در چندخطی.
end_index	int32 نمایه پایانی این جزئیات در چندخطی.

RestrictionInfo

اطلاعات مربوط به محدودیت‌های مختلف درطول چندخطی را دربرمی‌گیرد.

فیلدها
restriction_presence	RoadFeatureState فقط برونداد. نشان می‌دهد که آیا برای بخش معینی از چندخطی محدودیت وجود دارد یا خیر.
polyline_point_index	PolylinePointIndex مکان اطلاعات مربوط به محدودیت درطول چندخطی.
فیلد اتحادیه restriction. انواع محدودیت‌هایی را که می‌توانند برای یک بخش معین از چندخطی اعمال شوند دربرمی‌گیرد. ‫restriction فقط می‌تواند یکی از موارد زیر باشد:
restricted_height_mm	int64 حد ارتفاع، برحسب میلی‌متر. این فیلد زمانی تکمیل می‌شود که ارتفاع محدودشده مانع عبور شود یا منجر به فاصله کم برای خودرو مشخص‌شده شود.
restricted_weight_kg	int64 محدودیت وزن، به کیلوگرم. وقتی محدودیت وزن مانع عبور می‌شود یا به وزن خودرو مشخص‌شده نزدیک است، این فیلد تکمیل می‌شود.
hazardous_goods	bool وقتی حمل کالاهای خطرناک محدود می‌شود، این فیلد روی درست تنظیم می‌شود.
trucks_prohibited	bool وقتی کامیون‌ها ممنوع باشند، این فیلد روی درست تنظیم می‌شود.

RoadFeatureState

وضعیت‌های عوارض جاده‌ای را در امتداد یک بخش از چندخطی دربرمی‌گیرد.

شمارشی‌ها
ROAD_FEATURE_STATE_UNSPECIFIED	وضعیت عارضه جاده محاسبه نشد (مقدار پیش‌فرض).
EXISTS	عنصر جاده وجود دارد.
DOES_NOT_EXIST	ویژگی جاده وجود ندارد.

SkywayInfo

اطلاعات مربوط به پل‌های هوایی درطول چندخطی را دربرمی‌گیرد.

فیلدها
skyway_presence	RoadFeatureState نشان می‌دهد که آیا برای بخش معینی از چندخطی، پل هوایی وجود دارد یا خیر.
polyline_point_index	PolylinePointIndex مکان اطلاعات مربوط به پل هوایی درطول چندخطی.

TunnelInfo

اطلاعات مربوط به تونل‌ها را درطول چندخطی خلاصه می‌کند.

فیلدها
tunnel_presence	RoadFeatureState نشان می‌دهد که آیا برای بخش معینی از چندخطی تونل وجود دارد یا نه.
polyline_point_index	PolylinePointIndex مکان اطلاعات مربوط به تونل در امتداد چندخطی.

PolylineEncoding

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

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

PolylineQuality

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

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

مسیر

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

فیلدها
route_labels[]	RouteLabel برچسب‌های Route که برای شناسایی ویژگی‌های خاص مسیر برای مقایسه با دیگران مفید هستند.
legs[]	RouteLeg مجموعه‌ای از مسیرها (بخش‌های مسیر بین ایستگاه‌ها) که مسیر را تشکیل می‌دهند. هر مسیر مربوط به سفر بین دو via Waypoints است. برای مثال، مسیری که هیچ ایستگاه بین راهی نداشته باشد فقط یک بخش دارد. مسیر دارای یک ایستگاه بین راهی غیر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 را روی درست تنظیم کنید، این فیلد حاوی ترتیب بهینه‌سازی‌شده ایستگاه‌های بین راهی است. درغیراین‌صورت، این فیلد خالی است. برای مثال، اگر ورودی شما «مبدأ: لس‌آنجلس؛ ایستگاه‌های بین راهی: دالاس، بنگور، فینیکس؛ مقصد: نیویورک» باشد و ترتیب بهینه ایستگاه‌های بین راهی فینیکس، دالاس، بنگور باشد، این فیلد حاوی مقادیر [۲، ۰، ۱] خواهد بود. نمایه با ۰ برای اولین ایستگاه بین راهی ارائه‌شده در ورودی شروع می‌شود.
localized_values	RouteLocalizedValues نمایش‌های نوشتاری از ویژگی‌های Route.
route_token	string یک کد مبهم که می‌تواند به کیت توسعه نرم‌افزار پیمایش ارسال شود تا مسیر را درطول پیمایش بازسازی کند و درصورت تغییر مسیر، هدف اصلی را هنگام ایجاد مسیر حفظ کند. این نشان را به‌عنوان یک لکه مات درنظر بگیرید. مقدار آن را در درخواست‌ها مقایسه نکنید زیرا مقدار آن ممکن است تغییر کند حتی اگر سرویس دقیقاً همان مسیر را برگرداند. توجه: Route.route_token فقط برای درخواست‌هایی دردسترس است که ComputeRoutesRequest.routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده‌اند. ‫Route.route_token برای درخواست‌هایی که ایستگاه‌های بین راهی «ازطریق» دارند پشتیبانی نمی‌شود.
polyline_details	PolylineDetails حاوی اطلاعاتی درباره جزئیات درطول چندخطی است.

RouteLocalizedValues

نمایش نوشتاری برخی‌از دارایی‌ها.

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

RouteLabel

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

شمارشی‌ها
ROUTE_LABEL_UNSPECIFIED	پیش‌فرض - استفاده نمی‌شود.
DEFAULT_ROUTE	مسیر «بهترین» پیش‌فرض برای محاسبات مسیر برگردانده شد.
DEFAULT_ROUTE_ALTERNATE	جایگزینی برای مسیر «بهترین» پیش‌فرض. وقتی compute_alternative_routes مشخص شود، مسیرهایی مثل این برگردانده خواهد شد.
FUEL_EFFICIENT	مسیر با بهره‌وری سوخت. مسیرهایی که با این مقدار برچسب‌گذاری شده‌اند به‌عنوان مسیرهای بهینه‌شده برای پارامترهای «اکو» مثل مصرف سوخت تعیین می‌شوند.
SHORTER_DISTANCE	مسیر با فاصله سفر کوتاه‌تر. این قابلیتی آزمایشی است.

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. این فیلد فقط برای مسیرهای «حمل‌ونقل عمومی» پر می‌شود.

RouteLegLocalizedValues

نمایش نوشتاری برخی‌از دارایی‌ها.

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

StepsOverview

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

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

MultiModalSegment

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

فیلدها
navigation_instruction	NavigationInstruction 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 زمان موردانتظار را به‌عنوان مدت بین خروج از یک ایستگاه در این زمان مشخص می‌کند. برای مثال، با مقدار ثانیه سرخط ۶۰۰، اگر به اتوبوس نرسیدید، باید ۱۰ دقیقه منتظر بمانید.
transit_line	TransitLine اطلاعات مربوط به خط حمل‌ونقل عمومی که در این مرحله استفاده شده است.
stop_count	int32 تعداد توقف‌ها از ایستگاه مبدأ تا ایستگاه مقصد. این تعداد شامل ایستگاه رسیدن می‌شود، اما ایستگاه حرکت را دربرنمی‌گیرد. برای مثال، اگر مسیر شما از «ایستگاه A» شروع شود، از «ایستگاه B» و «ایستگاه C» عبور کند، و به «ایستگاه D» برسد، stop_count مقدار ۳ را برمی‌گرداند.
trip_short_text	string نوشتاری که در زمان‌بندی‌ها و تابلوهای راهنما نشان داده می‌شود تا سفر با حمل‌ونقل عمومی را به مسافران معرفی کند. نوشتار باید سفر را در روز خدمات به‌طور منحصربه‌فردی شناسایی کند. برای مثال، «۵۳۸» trip_short_text قطار Amtrak است که در روزهای هفته ساعت ۱۵:۱۰ از سن‌خوزه، کالیفرنیا، به مقصد ساکرامنتو، کالیفرنیا، حرکت می‌کند.

TransitDetailsLocalizedValues

شرح‌های بومی‌سازی‌شده مقادیر برای RouteTransitDetails.

فیلدها
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 توجه: این فیلد درحال‌حاضر تکمیل نشده است.

RouteLegTravelAdvisory

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

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

RouteMatrixDestination

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

فیلدها
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 نمایه مبتنی بر صفر مقصد در درخواست.

LocalizedValues

نمایش نوشتاری برخی‌از دارایی‌ها.

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

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

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

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

RouteModifiers

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

فیلدها
avoid_tolls	bool وقتی روی «درست» تنظیم شود، درصورت امکان از جاده‌های عوارضی اجتناب می‌کند و مسیرهایی را که جاده عوارضی ندارند ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER RouteTravelMode اعمال می‌شود.
avoid_highways	bool وقتی روی درست تنظیم شود، درصورت امکان از بزرگراه‌ها اجتناب می‌کند و مسیرهایی را که بزرگراه ندارند ترجیح می‌دهد. فقط برای DRIVE و TWO_WHEELER RouteTravelMode اعمال می‌شود.
avoid_ferries	bool وقتی روی «درست» تنظیم شود، درصورت امکان از کشتی اجتناب می‌کند و به مسیرهایی که کشتی ندارد اولویت می‌دهد. فقط برای DRIVE وTWO_WHEELER RouteTravelMode اعمال می‌شود.
avoid_indoor	bool وقتی روی درست تنظیم شود، درصورت امکان از ناوبری در فضای بسته اجتناب می‌کند و مسیرهایی را که ناوبری در فضای بسته ندارند ترجیح می‌دهد. فقط برای WALK RouteTravelMode اعمال می‌شود.
vehicle_info	VehicleInfo اطلاعات خودرو را مشخص می‌کند.
toll_passes[]	TollPass اطلاعات مربوط به مجوزهای عوارض را دربرمی‌گیرد. اگر مجوزهای عوارض ارائه شود، API تلاش می‌کند قیمت مجوز را برگرداند. اگر مجوزهای عوارض ارائه نشود، API مجوز عوارض را به‌عنوان ناشناخته درنظر می‌گیرد و سعی می‌کند قیمت نقدی را برگرداند. فقط برای DRIVE و TWO_WHEELER RouteTravelMode اعمال می‌شود.
avoid_tunnels	bool اختیاری. وقتی روی درست تنظیم شود، درصورت امکان از تونل‌ها اجتناب می‌کند و به مسیرهایی که تونل ندارند اولویت می‌دهد. فقط برای DRIVE و TWO_WHEELER RouteTravelMode اعمال می‌شود. ‫RoutingPreference باید روی TRAFFIC_AWARE_OPTIMAL تنظیم شود. این فیلد در ComputeRouteMatrix پشتیبانی نمی‌شود.

RouteTravelAdvisory

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

فیلدها
toll_info	TollInfo حاوی اطلاعاتی درباره عوارض در مسیر است. این فیلد فقط درصورتی تکمیل می‌شود که انتظار رود در مسیر عوارضی وجود داشته باشد و TOLLS در ComputeRoutesRequest.extra_computations درخواست گنجانده شده باشد. اگر این فیلد تنظیم شده باشد، اما فیلد فرعی estimatedPrice تکمیل نشده باشد، یعنی مسیر دارای عوارض است، اما قیمت تخمینی آن مشخص نیست. اگر toll_info تنظیم نشده باشد، در این مسیر هیچ عوارضی پیش‌بینی نمی‌شود.
speed_reading_intervals[]	SpeedReadingInterval فاصله‌های خواندن سریع که نشان‌دهنده تراکم ترافیک است. این فیلد فقط برای درخواست‌هایی تکمیل می‌شود که درخواست دارای مقدار TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL ComputeRoutesRequest.routing_preference باشد و TRAFFIC_ON_POLYLINE در ComputeRoutesRequest.extra_computations گنجانده شده باشد. فاصله‌ها کل چندضلعی مسیر را بدون هم‌پوشانی پوشش می‌دهد. نقطه شروع یک بازه مشخص با نقطه پایان بازه قبلی یکسان است. مثال: polyline: A ---- B ---- C ---- D ---- E ---- F ---- G speed_reading_intervals: [A,C), [C,D), [D,G).
fuel_consumption_microliters	int64 مصرف سوخت پیش‌بینی‌شده به میکرولیتر. این فیلد فقط زمانی تکمیل می‌شود که FUEL_CONSUMPTION در ComputeRoutesRequest.extra_computations درخواست اضافه شده باشد.
route_restrictions_partially_ignored	bool مسیر برگشتی ممکن است محدودیت‌هایی داشته باشد که برای حالت سفر یا اصلاح‌کننده‌های مسیر درخواستی مناسب نباشد.
transit_fare	Money درصورت وجود، شامل کل هزینه سفر یا بلیت در این مسیر است. این دارایی فقط برای درخواست‌های TRANSIT و فقط برای مسیرهایی که اطلاعات نرخ برای همه مراحل حمل‌ونقل عمومی دردسترس است برگردانده می‌شود.

RouteTravelMode

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

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

RoutingPreference

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

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

SpeedReadingInterval

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

فیلدها
start_polyline_point_index	int32 نمایه شروع این فاصله در چندضلعی.
end_polyline_point_index	int32 نمایه پایانی این فاصله در چندخطی.
فیلد اتحادیه speed_type. نوع سرعت در این بازه. ‫speed_type فقط می‌تواند یکی از موارد زیر باشد:
speed	Speed سرعت ترافیک در این بازه.

سرعت

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

شمارشی‌ها
SPEED_UNSPECIFIED	مقدار پیش‌فرض. از این مقدار استفاده نمی‌شود.
NORMAL	سرعت عادی، بدون تأخیر ترافیکی.
SLOW	کندی شناسایی شد، ترافیک متوسط.
TRAFFIC_JAM	تأخیرهای ترافیکی.

TollInfo

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

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

TollPass

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

شمارشی‌ها
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	اندونزی. کارت الکترونیکی ارائه‌شده توسط چند بانک که برای پرداخت عوارض استفاده می‌شود. کارمزد همه کارت‌های الکترونیکی ازطریق بانک‌ها یکسان است، بنابراین فقط به یک مقدار شمارشی نیاز است. برای نمونه - Bank Mandiri 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	سیستم بی‌سیم الکترونیکی ETC ژاپن برای جمع‌آوری عوارض. https://www.go-etc.jp/
JP_ETC2	Japan 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	آلاسکا، ایالات متحده امریکا.
US_CA_FASTRAK	کالیفرنیا، ایالات متحده امریکا.
US_CA_FASTRAK_CAV_STICKER	نشان می‌دهد که راننده علاوه بر برچسب «خودروی پاک» (CAV) صادرشده از DMV، گذر FasTrak نیز دارد. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL	کلرادو، ایالات متحده امریکا.
US_CO_GO_PASS	کلرادو، ایالات متحده امریکا.
US_DE_EZPASSDE	DE، ایالات متحده امریکا.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS	فلوریدا، ایالات متحده امریکا.
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD	فلوریدا، ایالات متحده امریکا.
US_FL_EPASS	فلوریدا، ایالات متحده امریکا.
US_FL_GIBA_TOLL_PASS	فلوریدا، ایالات متحده امریکا.
US_FL_LEEWAY	فلوریدا، ایالات متحده امریکا.
US_FL_SUNPASS	فلوریدا، ایالات متحده امریکا.
US_FL_SUNPASS_PRO	فلوریدا، ایالات متحده امریکا.
US_IL_EZPASSIL	ایلینوی، ایالات متحده امریکا.
US_IL_IPASS	ایلینوی، ایالات متحده امریکا.
US_IN_EZPASSIN	IN، ایالات متحده امریکا.
US_KS_BESTPASS_HORIZON	کانزاس، ایالات متحده امریکا.
US_KS_KTAG	کانزاس، ایالات متحده امریکا.
US_KS_NATIONALPASS	کانزاس، ایالات متحده امریکا.
US_KS_PREPASS_ELITEPASS	کانزاس، ایالات متحده امریکا.
US_KY_RIVERLINK	‫KY، ایالات متحده امریکا.
US_LA_GEAUXPASS	لس‌آنجلس، ایالات متحده امریکا.
US_LA_TOLL_TAG	لس‌آنجلس، ایالات متحده امریکا.
US_MA_EZPASSMA	ماساچوست، ایالات متحده امریکا.
US_MD_EZPASSMD	MD، ایالات متحده امریکا.
US_ME_EZPASSME	مین، ایالات متحده امریکا.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD	‫MI، ایالات متحده امریکا.
US_MI_BCPASS	‫MI، ایالات متحده امریکا.
US_MI_BREAKAWAY	‫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	کارولینای شمالی، ایالات متحده امریکا.
US_NC_PEACH_PASS	کارولینای شمالی، ایالات متحده امریکا.
US_NC_QUICK_PASS	کارولینای شمالی، ایالات متحده امریکا.
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	پنسیلوانیا، ایالات متحده امریکا.
US_RI_EZPASSRI	رودآیلند، ایالات متحده امریکا.
US_SC_PALPASS	کارولینای جنوبی، ایالات متحده امریکا.
US_TX_AVI_TAG	تگزاس، ایالات متحده امریکا.
US_TX_BANCPASS	تگزاس، ایالات متحده امریکا.
US_TX_DEL_RIO_PASS	تگزاس، ایالات متحده امریکا.
US_TX_EFAST_PASS	تگزاس، ایالات متحده امریکا.
US_TX_EAGLE_PASS_EXPRESS_CARD	تگزاس، ایالات متحده امریکا.
US_TX_EPTOLL	تگزاس، ایالات متحده امریکا.
US_TX_EZ_CROSS	تگزاس، ایالات متحده امریکا.
US_TX_EZTAG	تگزاس، ایالات متحده امریکا.
US_TX_FUEGO_TAG	تگزاس، ایالات متحده امریکا.
US_TX_LAREDO_TRADE_TAG	تگزاس، ایالات متحده امریکا.
US_TX_PLUSPASS	تگزاس، ایالات متحده امریکا.
US_TX_TOLLTAG	تگزاس، ایالات متحده امریکا.
US_TX_TXTAG	تگزاس، ایالات متحده امریکا.
US_TX_XPRESS_CARD	تگزاس، ایالات متحده امریکا.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD	UT، ایالات متحده امریکا.
US_VA_EZPASSVA	ویرجینیا، ایالات متحده امریکا.
US_WA_BREEZEBY	واشینگتن، ایالات متحده امریکا.
US_WA_GOOD_TO_GO	واشینگتن، ایالات متحده امریکا.
US_WV_EZPASSWV	ویرجینیای غربی، ایالات متحده امریکا.
US_WV_MEMORIAL_BRIDGE_TICKETS	ویرجینیای غربی، ایالات متحده امریکا.
US_WV_MOV_PASS	ویرجینیای غربی، ایالات متحده امریکا
US_WV_NEWELL_TOLL_BRIDGE_TICKET	ویرجینیای غربی، ایالات متحده امریکا.

TrafficModel

این فیلد یکی از فرضیه‌های زیر را برای استفاده هنگام محاسبه زمان سفر در شرایط ترافیکی مشخص می‌کند که در شمارش‌های زیر نشان داده شده است. بسته به شمارش انتخابی، فیلد duration پاسخ TrafficModel متفاوت خواهد بود. این مقدار شامل زمان پیش‌بینی‌شده برای رسیدن به مقصد در ترافیک براساس میانگین‌های تاریخی است. ‫TrafficModel فقط برای درخواست‌هایی دردسترس است که RoutingPreference را روی TRAFFIC_AWARE_OPTIMAL و RouteTravelMode را روی DRIVE تنظیم کرده باشند.

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

TransitAgency

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

فیلدها
name	string نام این دفتر حمل‌ونقل عمومی.
phone_number	string شماره تلفن قالب‌بندی‌شده مختص زبان محلی کارگزاری حمل‌ونقل عمومی.
uri	string نشانی وب دفتر حمل‌ونقل عمومی.

TransitLine

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

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

TransitPreferences

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

فیلدها
allowed_travel_modes[]	TransitTravelMode مجموعه‌ای از حالت‌های سفر برای استفاده هنگام دریافت مسیر TRANSIT. به‌طور پیش‌فرض روی همه حالت‌های سفر پشتیبانی‌شده تنظیم می‌شود.
routing_preference	TransitRoutingPreference اولویت مسیریابی که درصورت مشخص شدن، بر مسیر TRANSIT برگشتی تأثیر می‌گذارد.

TransitRoutingPreference

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

شمارشی‌ها
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED	اولویت مشخص نشده است.
LESS_WALKING	نشان می‌دهد که مسیر محاسبه‌شده باید پیاده‌روی محدود را ترجیح دهد.
FEWER_TRANSFERS	نشان می‌دهد که مسیر محاسبه‌شده باید تعداد محدودی تعویض وسیله را ترجیح دهد.

TransitTravelMode

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

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

TransitStop

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

فیلدها
name	string نام ایستگاه حمل‌ونقل عمومی.
location	Location مکان توقف که با مختصات طول/عرض جغرافیایی بیان می‌شود.

TransitVehicle

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

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

TransitVehicleType

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

شمارشی‌ها
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	اتوبوس برقی.

واحدها

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

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

VehicleEmissionType

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

شمارشی‌ها
VEHICLE_EMISSION_TYPE_UNSPECIFIED	نوع انتشار مشخص نشده است. به GASOLINE پیش‌فرض می‌شود.
GASOLINE	خودرو بنزینی.
ELECTRIC	خودرو با نیروی برق.
HYBRID	خودرو با سوخت ترکیبی (مثل بنزین + برق).
DIESEL	خودرو با سوخت گازوئیل.

VehicleInfo

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

فیلدها
emission_type	VehicleEmissionType نوع انتشار کربن خودرو را توصیف می‌کند. فقط برای DRIVE RouteTravelMode اعمال می‌شود.
total_height_mm	int64 ارتفاع وسیله نقلیه، شامل ارتفاع هرگونه تریلر متصل. برای فعال شدن باید برای کامیون‌رانی یا یدک‌کشی تنظیم شود. وقتی RouteTravelMode روی DRIVE تنظیم شده باشد، این فیلد در ComputeRouteMatrix پشتیبانی نمی‌شود.
total_length_mm	int64 طول وسیله نقلیه، شامل طول هرگونه تریلر متصل. برای فعال شدن باید برای کامیون‌رانی یا یدک‌کشی تنظیم شود. وقتی RouteTravelMode روی DRIVE تنظیم شده باشد، این فیلد در ComputeRouteMatrix پشتیبانی نمی‌شود.
total_width_mm	int64 عرض وسیله نقلیه، شامل عرض هرگونه تریلر متصل. برای فعال شدن باید برای کامیون‌رانی یا یدک‌کشی تنظیم شود. وقتی RouteTravelMode روی DRIVE تنظیم شده باشد، این فیلد در ComputeRouteMatrix پشتیبانی نمی‌شود.
total_weight_kg	int64 وزن وسیله نقلیه، شامل وزن هرگونه تریلر متصل. وزن در این زمینه به وزن واقعی اشاره دارد، نه رده‌بندی وزن. برای فعال شدن باید برای کامیون‌رانی یا یدک‌کشی تنظیم شود. وقتی RouteTravelMode روی DRIVE تنظیم شده باشد، این فیلد در ComputeRouteMatrix پشتیبانی نمی‌شود.
trailer_info[]	TrailerInfo شامل یک ورودی برای هر پیش‌پرده است. اگر اطلاعات پیش‌پرده ارائه شده است، RoutingPreference باید روی TRAFFIC_AWARE_OPTIMAL تنظیم شود. وقتی RouteTravelMode روی DRIVE تنظیم شده باشد، این فیلد در ComputeRouteMatrix پشتیبانی نمی‌شود.
hazardous_goods_types[]	HazardousGoodsType فهرست مواد خطرناک حمل‌شده در خودرو، درصورت وجود.

HazardousGoodsType

انواع مختلف مواد خطرناک.

شمارشی‌ها
HAZARDOUS_GOODS_TYPE_UNSPECIFIED	نوع کالاهای خطرناک مشخص نشده است.
EXPLOSIVES	کالاهای منفجره.
GASES	گازها.
FLAMMABLE	کالاهای قابل اشتعال.
COMBUSTIBLE	کالاهای قابل اشتعال.
ORGANIC	کالاهای ارگانیک.
POISON	کالاهای سمی.
RADIOACTIVE	کالاهای رادیواکتیو.
CORROSIVE	کالاهای خورنده.
ASPIRATION_HAZARD	کالاهای خطرناک آسپیراسیون.
ENVIRONMENTAL_HAZARD	کالاهای خطرناک زیست‌محیطی.
OTHER	انواع دیگر کالاها.

TrailerInfo

اطلاعات مربوط به تریلرهای جداگانه متصل به خودرو. طول هر تریلر باید برای حمل‌ونقل کامیونی ارائه شود. مشخصه‌های دیگر اختیاری هستند. مشخصه‌های کل باید مشخصه‌های هر پیش‌پرده‌ای را دربر بگیرد. برای مثال، total_height_mm همیشه باید بزرگ‌تر یا مساوی با trailer_info.height_mm باشد.

فیلدها
height_mm	int64 ارتفاع یدک.
length_mm	int64 طول پیش‌پرده.
width_mm	int64 عرض یدک.
weight_kg	int64 وزن تریلر. وزن در این زمینه به وزن واقعی اشاره دارد، نه رده‌بندی وزن.

نقطه مسیر

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

فیلدها
via	bool این ایستگاه بین راهی را به‌جای نقطه توقف به‌عنوان نقطه عطف علامت‌گذاری می‌کند. برای هر ایستگاه بین راهی غیر از ایستگاه بین راهی در درخواست، برنامه پاسخ ورودی‌ای را به آرایه legs اضافه می‌کند تا جزئیات توقف‌های موقت در آن بخش از سفر را ارائه دهد. وقتی می‌خواهید مسیر بدون توقف از این نقطه بین راه عبور کند، این مقدار را روی «درست» تنظیم کنید. ایستگاه‌های بین راه باعث نمی‌شوند ورودی‌ای به آرایه legs اضافه شود، اما سفر را ازطریق ایستگاه بین راه هدایت می‌کنند. این مقدار را فقط می‌توانید در ایستگاه‌های بین راهی تنظیم کنید. اگر این فیلد را در ایستگاه‌های بین راهی پایانه تنظیم کنید، درخواست ناموفق خواهد بود. اگر ComputeRoutesRequest.optimize_waypoint_order روی درست تنظیم شده باشد، این فیلد نمی‌تواند روی درست تنظیم شود؛ درغیراین‌صورت، درخواست ناموفق خواهد بود.
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 «شناسه مکان» «نقطه موردعلاقه» مرتبط با ایستگاه بین راهی.
address	string نشانی قابل‌خواندن توسط انسان یا کد پلاس. برای جزئیات، به https://plus.codes مراجعه کنید.
navigation_point_token	string رمزی که NavigationPoint را شناسایی می‌کند و از روش SearchDestinations در Geocoding API به‌دست می‌آید.