Package google.maps.routing.v2

شاخص

مسیرها

Routes API.

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 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 ارائه شده است. این محتوا باید همانطور که هست خوانده شود. این محتوا فقط برای نمایش است. به صورت برنامه نویسی آن را تجزیه نکنید.
FLYOVER_INFO_ON_POLYLINE اطلاعات پرواز برای مسیر(های) برای بازگرداندن این اطلاعات، فیلد ماسک routes.polyline_details.flyover_info باید مشخص شود. این داده ها در حال حاضر فقط برای متروهای خاصی در هند پر می شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند.
NARROW_ROAD_INFO_ON_POLYLINE اطلاعات جاده باریک برای مسیر(ها). برای بازگرداندن این اطلاعات، فیلد ماسک routes.polyline_details.narrow_road_info باید مشخص شود. این داده ها در حال حاضر فقط برای متروهای خاصی در هند پر می شود. این ویژگی آزمایشی است و SKU/هزینه ممکن است تغییر کند.

ReferenceRoute

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

Enums
REFERENCE_ROUTE_UNSPECIFIED استفاده نشده است. درخواست های حاوی این مقدار با شکست مواجه می شوند.
FUEL_EFFICIENT مسیر مصرف سوخت
SHORTER_DISTANCE

مسیری با مسافت سفر کمتر. این یک ویژگی آزمایشی است.

برای درخواست‌های DRIVE ، این ویژگی مسافت کوتاه‌تر را به راحتی رانندگی اولویت می‌دهد. برای مثال، ممکن است جاده‌های محلی را به جای بزرگراه‌ها ترجیح دهد، از جاده‌های خاکی استفاده کند، پارکینگ‌ها را قطع کند، و غیره.

برای درخواست‌های BICYCLE و TWO_WHEELER ، این ویژگی مسیرهایی مشابه مسیرهایی را برمی‌گرداند که وقتی requested_reference_routes مشخص نکرده‌اید، باز می‌گردد.

این ویژگی با هیچ حالت سفر دیگری، از طریق ایستگاه های بین راهی، یا optimize_waypoint_order سازگار نیست. چنین درخواست هایی با شکست مواجه خواهند شد. با این حال، می توانید از آن با هر routing_preference استفاده کنید.

ComputeRoutesResponse

ComputeRoute پیام پاسخ.

فیلدها
routes[]

Route

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

fallback_ info

FallbackInfo

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

geocoding_ results

GeocodingResults

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

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

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

فیلدها
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

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

LocalizedTime

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

فیلدها
time

LocalizedText

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

time_ zone

string

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

مکان

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

فیلدها
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

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

فیلدها
flyover_ info[]

FlyoverInfo

جزئیات پرواز در امتداد چند خط.

narrow_ road_ info[]

NarrowRoadInfo

جزئیات جاده باریک در امتداد چند خط.

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

شاخص انتهایی این جزئیات در چند خط.

RoadFeatureState

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

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

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

polyline_ details

PolylineDetails

حاوی اطلاعاتی درباره جزئیات در امتداد چند خط است.

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

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

راهنمای ناوبری برای بخش چند وجهی.

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

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

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

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

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

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

localized_ values

LocalizedValues

بازنمایی متن از خواص RouteMatrixElement .

origin_ index

int32

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

destination_ index

int32

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

مقادیر موضعی

بازنمایی متن از خصوصیات خاص.

فیلدها
distance

LocalizedText

فاصله سفر به شکل متن نشان داده شده است.

duration

LocalizedText

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

static_ duration

LocalizedText

مدت زمان ارائه شده در فرم متن بدون توجه به شرایط ترافیکی.

transit_ fare

LocalizedText

کرایه ترانزیت به شکل متن نشان داده شده است.

مسیریابی

وضعیت مسیر بازگشت.

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

روترمیکسورژین

یک منشأ واحد برای computeTemateMatrixRixRixRixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. نقطه راه اصلی

route_ modifiers

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 اعمال می شود.

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

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

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

عوارض

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

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 IL، ایالات متحده آمریکا
US_IL_IPASS IL، ایالات متحده آمریکا
US_IN_EZPASSIN در ، ایالات متحده
US_KS_BESTPASS_HORIZON KS ، ایالات متحده.
US_KS_KTAG KS ، ایالات متحده.
US_KS_NATIONALPASS KS ، ایالات متحده.
US_KS_PREPASS_ELITEPASS KS ، ایالات متحده.
US_LA_GEAUXPASS لس آنجلس، ایالات متحده آمریکا
US_LA_TOLL_TAG لس آنجلس، ایالات متحده آمریکا
US_MA_EZPASSMA کارشناسی ارشد ، ایالات متحده
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 نیوجرسی، ایالات متحده آمریکا
US_NJ_EZPASSNJ نیوجرسی، ایالات متحده آمریکا
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 آژانس ترانزیت.

خط حمل و نقل

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

فیلدها
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 مراجعه کنید.

،

شاخص

مسیرها

مسیرها API.

کامپیوتر اداری

rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )

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

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

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

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

بسیار مهم است که شما status در ماسک فیلد خود قرار دهید زیرا در غیر این صورت همه پیام ها خوب به نظر می رسند. Google از استفاده از ماسک زمینه پاسخ Wildcard ( * ) خودداری می کند ، زیرا:

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

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 از استفاده از ماسک زمینه پاسخ Wildcard ( * ) یا مشخص کردن ماسک میدانی در سطح بالا ( routes ) دلسرد می شود ، زیرا:

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

combandoutematematrixrequest

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

فیلدها
origins[]

RouteMatrixOrigin

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

  • مجموع تعداد منشاء + تعداد مقصد های مشخص شده به عنوان place_id یا address نباید بیشتر از 50 باشد.
  • محصول تعداد مبدا × تعداد مقصد نباید در هر صورت بیش از 625 باشد.
  • اگر Routing_Preference روی TRAFFIC_AWARE_OPTIMAL تنظیم شود ، محصول تعداد مبدا × تعداد مقصد نباید بیشتر از 100 باشد.
  • در صورت تنظیم TRANSIT Travel_mode ، محصول تعداد مبدا × تعداد مقصد نباید بیش از 100 باشد.
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". برای اطلاعات بیشتر ، به شناسه محلی Unicode مراجعه کنید. پشتیبانی از زبان را برای لیست زبانهای پشتیبانی شده مشاهده کنید. وقتی این مقدار را ارائه نمی دهید ، زبان نمایش از محل اولین منشاء استنباط می شود.

region_ code

string

اختیاری. کد منطقه ، به عنوان یک مقدار CCTLD ("دامنه سطح بالا") مقدار دو شخصیت مشخص شده است. برای اطلاعات بیشتر به دامنه های سطح بالای کد کشور مراجعه کنید.

units

Units

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

extra_ computations[]

ExtraComputation

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

traffic_ model

TrafficModel

اختیاری. فرضیات استفاده شده در هنگام محاسبه زمان در ترافیک را مشخص می کند. این تنظیم بر مقدار برگشتی در زمینه مدت زمان در RouteMatrixElement که حاوی زمان پیش بینی شده در ترافیک بر اساس میانگین های تاریخی است ، تأثیر می گذارد. RoutingPreference به TRAFFIC_AWARE_OPTIMAL و RouteTravelMode برای DRIVE . در صورت درخواست ترافیک به بهترین وجه به BEST_GUESS و TrafficModel مشخص نشده است.

transit_ preferences

TransitPreferences

اختیاری. ترجیحاتی را که در مسیر بازگشت برای مسیرهای TRANSIT تأثیر می گذارد ، مشخص می کند. توجه: هنگامی که RouteTravelMode روی TRANSIT تنظیم شده است ، فقط می توانید یک transit_preferences مشخص کنید.

خارج

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

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

رایانه شخصی

پیام های رایانه ای درخواست می کند.

فیلدها
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 مشخص کنید. سفرهای ترانزیت در گذشته یا 100 روز در آینده تا 7 روز در دسترس است.

arrival_ time

Timestamp

اختیاری. زمان ورود توجه: فقط در صورت تنظیم RouteTravelMode در TRANSIT قابل تنظیم است. شما می توانید departure_time یا arrival_time را مشخص کنید ، اما هر دو نیست. سفرهای ترانزیت در گذشته یا 100 روز در آینده تا 7 روز در دسترس است.

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 استفاده کنید. اگر 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 DRIVE TRAFFIC_AWARE_OPTIMAL و RouteTravelMode تنظیم کرده اند در دسترس است. در صورت درخواست ترافیک به بهترین وجه به BEST_GUESS و TrafficModel مشخص نشده است.

transit_ preferences

TransitPreferences

اختیاری. ترجیحاتی را که در مسیر بازگشت برای مسیرهای TRANSIT تأثیر می گذارد ، مشخص می کند. توجه: هنگامی که RouteTravelMode روی TRANSIT تنظیم شده است ، فقط می توانید یک transit_preferences مشخص کنید.

خارج

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

Enums
EXTRA_COMPUTATION_UNSPECIFIED استفاده نشده است. درخواست های حاوی این مقدار شکست خواهد خورد.
TOLLS اطلاعات عوارض برای مسیر (ها).
FUEL_CONSUMPTION تخمین مصرف سوخت برای مسیر (ها).
TRAFFIC_ON_POLYLINE Polylines آگاهی از ترافیک برای مسیر (ها).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions به عنوان یک رشته متن HTML فرمت شده ارائه شده است. این محتوا به معنای خوانده شده است. این محتوا فقط برای نمایش است. آن را به صورت برنامه ای تجزیه نکنید.
FLYOVER_INFO_ON_POLYLINE اطلاعات پرواز برای مسیر (ها). برای بازگشت این اطلاعات باید routes.polyline_details.flyover_info FieldMask مشخص شود. این داده ها فقط در حال حاضر برای متروهای خاص در هند جمع می شوند. این ویژگی آزمایشی است و Sku/Charge در معرض تغییر است.
NARROW_ROAD_INFO_ON_POLYLINE اطلاعات جاده ای باریک برای مسیر (ها). routes.polyline_details.narrow_road_info fieldmask باید برای بازگشت این اطلاعات مشخص شود. این داده ها فقط در حال حاضر برای متروهای خاص در هند جمع می شوند. این ویژگی آزمایشی است و Sku/Charge در معرض تغییر است.

ارجاع

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

Enums
REFERENCE_ROUTE_UNSPECIFIED استفاده نشده است. درخواست های حاوی این مقدار شکست می خورند.
FUEL_EFFICIENT مسیر کارآمد سوخت.
SHORTER_DISTANCE

مسیر با فاصله سفر کوتاه تر. این یک ویژگی آزمایشی است.

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

برای درخواست های BICYCLE و TWO_WHEELER ، این ویژگی مسیرهایی را شبیه به بازده های برگشتی در هنگام مشخص کردن requested_reference_routes باز می گرداند.

این ویژگی با سایر حالت های مسافرتی ، از طریق نقاط راه میانی ، یا optimize_waypoint_order سازگار نیست. چنین درخواست هایی با شکست روبرو می شوند. با این حال ، شما می توانید از آن با هر نوع routing_preference استفاده کنید.

بازپرداخت رایانه

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

فیلدها
routes[]

Route

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

fallback_ info

FallbackInfo

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

geocoding_ results

GeocodingResults

حاوی اطلاعات پاسخ GeoCoding برای نقاط راه مشخص شده به عنوان آدرس است.

خط دبستان

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

فیلدها
routing_ mode

FallbackRoutingMode

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

reason

FallbackReason

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

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

Reasons for using fallback response.

Enums
FALLBACK_REASON_UNSPECIFIED No fallback reason specified.
SERVER_ERROR A server error happened while calculating routes with your preferred routing mode, but we were able to return a result calculated by an alternative mode.
LATENCY_EXCEEDED We were not able to finish the calculation with your preferred routing mode on time, but we were able to return a result calculated by an alternative mode.

FallbackRoutingMode

Actual routing mode used for returned fallback response.

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED استفاده نشده است.
FALLBACK_TRAFFIC_UNAWARE Indicates the TRAFFIC_UNAWARE RoutingPreference was used to compute the response.
FALLBACK_TRAFFIC_AWARE Indicates the TRAFFIC_AWARE RoutingPreference was used to compute the response.

GeocodedWaypoint

Details about the locations used as waypoints. Only populated for address waypoints. Includes details about the geocoding results for the purposes of determining what the address was geocoded to.

فیلدها
geocoder_ status

Status

Indicates the status code resulting from the geocoding operation.

type[]

string

The type(s) of the result, in the form of zero or more type tags. Supported types: Address types and address component types .

partial_ match

bool

Indicates that the geocoder did not return an exact match for the original request, though it was able to match part of the requested address. You may wish to examine the original request for misspellings and/or an incomplete address.

place_ id

string

The place ID for this result.

intermediate_ waypoint_ request_ index

int32

The index of the corresponding intermediate waypoint in the request. Only populated if the corresponding waypoint is an intermediate waypoint.

GeocodingResults

Contains GeocodedWaypoints for origin, destination and intermediate waypoints. Only populated for address waypoints.

فیلدها
origin

GeocodedWaypoint

Origin geocoded waypoint.

destination

GeocodedWaypoint

Destination geocoded waypoint.

intermediates[]

GeocodedWaypoint

A list of intermediate geocoded waypoints each containing an index field that corresponds to the zero-based position of the waypoint in the order they were specified in the request.

LocalizedTime

Localized description of time.

فیلدها
time

LocalizedText

The time specified as a string in a given time zone.

time_ zone

string

Contains the time zone. The value is the name of the time zone as defined in the IANA Time Zone Database , eg "America/New_York".

مکان

Encapsulates a location (a geographic point, and an optional heading).

فیلدها
lat_ lng

LatLng

The waypoint's geographic coordinates.

heading

Int32Value

The compass heading associated with the direction of the flow of traffic. This value specifies the side of the road for pickup and drop-off. Heading values can be from 0 to 360, where 0 specifies a heading of due North, 90 specifies a heading of due East, and so on. You can use this field only for DRIVE and TWO_WHEELER RouteTravelMode .

مانور

A set of values that specify the navigation action to take for the current step (for example, turn left, merge, or straight).

Enums
MANEUVER_UNSPECIFIED استفاده نشده است.
TURN_SLIGHT_LEFT Turn slightly to the left.
TURN_SHARP_LEFT Turn sharply to the left.
UTURN_LEFT Make a left u-turn.
TURN_LEFT به چپ بپیچید.
TURN_SLIGHT_RIGHT Turn slightly to the right.
TURN_SHARP_RIGHT Turn sharply to the right.
UTURN_RIGHT Make a right u-turn.
TURN_RIGHT به راست بپیچید.
STRAIGHT Go straight.
RAMP_LEFT Take the left ramp.
RAMP_RIGHT Take the right ramp.
MERGE Merge into traffic.
FORK_LEFT Take the left fork.
FORK_RIGHT Take the right fork.
FERRY Take the ferry.
FERRY_TRAIN Take the train leading onto the ferry.
ROUNDABOUT_LEFT Turn left at the roundabout.
ROUNDABOUT_RIGHT Turn right at the roundabout.
DEPART Initial maneuver.
NAME_CHANGE Used to indicate a street name change.

Encapsulates navigation instructions for a RouteLegStep .

فیلدها
maneuver

Maneuver

Encapsulates the navigation instructions for the current step (for example, turn left, merge, or straight). This field determines which icon to display.

instructions

string

Instructions for navigating this step.

پلی لاین

Encapsulates an encoded polyline.

فیلدها
Union field polyline_type . Encapsulates the type of polyline. Defaults to encoded_polyline. polyline_type can be only one of the following:
encoded_ polyline

string

The string encoding of the polyline using the polyline encoding algorithm

geo_ json_ linestring

Struct

Specifies a polyline using the GeoJSON LineString format .

PolylineDetails

Details corresponding to a given index or contiguous segment of a polyline. Given a polyline with points P_0, P_1, ... , P_N (zero-based index), the PolylineDetails defines an interval and associated metadata.

فیلدها
flyover_ info[]

FlyoverInfo

Flyover details along the polyline.

narrow_ road_ info[]

NarrowRoadInfo

Narrow road details along the polyline.

FlyoverInfo

Encapsulates information about flyovers along the polyline.

فیلدها
flyover_ presence

RoadFeatureState

فقط خروجی Denotes whether a flyover exists for a given stretch of the polyline.

polyline_ point_ index

PolylinePointIndex

The location of flyover related information along the polyline.

NarrowRoadInfo

Encapsulates information about narrow roads along the polyline.

فیلدها
narrow_ road_ presence

RoadFeatureState

فقط خروجی Denotes whether a narrow road exists for a given stretch of the polyline.

polyline_ point_ index

PolylinePointIndex

The location of narrow road related information along the polyline.

PolylinePointIndex

Encapsulates the start and end indexes for a polyline detail. For instances where the data corresponds to a single point, start_index and end_index will be equal.

فیلدها
start_ index

int32

The start index of this detail in the polyline.

end_ index

int32

The end index of this detail in the polyline.

RoadFeatureState

Encapsulates the states of road features along a stretch of polyline.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED The road feature's state was not computed (default value).
EXISTS The road feature exists.
DOES_NOT_EXIST The road feature does not exist.

PolylineEncoding

Specifies the preferred type of polyline to be returned.

Enums
POLYLINE_ENCODING_UNSPECIFIED No polyline type preference specified. Defaults to ENCODED_POLYLINE .
ENCODED_POLYLINE Specifies a polyline encoded using the polyline encoding algorithm .
GEO_JSON_LINESTRING Specifies a polyline using the GeoJSON LineString format

PolylineQuality

A set of values that specify the quality of the polyline.

Enums
POLYLINE_QUALITY_UNSPECIFIED No polyline quality preference specified. Defaults to OVERVIEW .
HIGH_QUALITY Specifies a high-quality polyline - which is composed using more points than OVERVIEW , at the cost of increased response size. Use this value when you need more precision.
OVERVIEW Specifies an overview polyline - which is composed using a small number of points. Use this value when displaying an overview of the route. Using this option has a lower request latency compared to using the HIGH_QUALITY option.

مسیر

Contains a route, which consists of a series of connected road segments that join beginning, ending, and intermediate waypoints.

فیلدها
route_ labels[]

RouteLabel

Labels for the Route that are useful to identify specific properties of the route to compare against others.

legs[]

RouteLeg

A collection of legs (path segments between waypoints) that make up the route. Each leg corresponds to the trip between two non- via Waypoints . For example, a route with no intermediate waypoints has only one leg. A route that includes one non- via intermediate waypoint has two legs. A route that includes one via intermediate waypoint has one leg. The order of the legs matches the order of waypoints from origin to intermediates to destination .

distance_ meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of travel through the route without taking traffic conditions into consideration.

polyline

Polyline

The overall route polyline. This polyline is the combined polyline of all legs .

description

string

A description of the route.

warnings[]

string

An array of warnings to show when displaying the route.

viewport

Viewport

The viewport bounding box of the polyline.

travel_ advisory

RouteTravelAdvisory

Additional information about the route.

optimized_ intermediate_ waypoint_ index[]

int32

If you set optimize_waypoint_order to true, this field contains the optimized ordering of intermediate waypoints. Otherwise, this field is empty. For example, if you give an input of Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York; and the optimized intermediate waypoint order is Phoenix, Dallas, Bangor, then this field contains the values [2, 0, 1]. The index starts with 0 for the first intermediate waypoint provided in the input.

localized_ values

RouteLocalizedValues

Text representations of properties of the Route .

route_ token

string

An opaque token that can be passed to Navigation SDK to reconstruct the route during navigation, and, in the event of rerouting, honor the original intention when the route was created. Treat this token as an opaque blob. Don't compare its value across requests as its value may change even if the service returns the exact same route.

NOTE: Route.route_token is only available for requests that have set ComputeRoutesRequest.routing_preference to TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL . Route.route_token is not supported for requests that have Via waypoints.

polyline_ details

PolylineDetails

Contains information about details along the polyline.

RouteLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration, represented in text form and localized to the region of the query. Takes traffic conditions into consideration. Note: If you did not request traffic information, this value is the same value as static_duration .

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

transit_ fare

LocalizedText

Transit fare represented in text form.

RouteLabel

Labels for the Route that are useful to identify specific properties of the route to compare against others.

Enums
ROUTE_LABEL_UNSPECIFIED Default - not used.
DEFAULT_ROUTE The default "best" route returned for the route computation.
DEFAULT_ROUTE_ALTERNATE An alternative to the default "best" route. Routes like this will be returned when compute_alternative_routes is specified.
FUEL_EFFICIENT Fuel efficient route. Routes labeled with this value are determined to be optimized for Eco parameters such as fuel consumption.
SHORTER_DISTANCE Shorter travel distance route. این یک ویژگی آزمایشی است.

RouteLeg

Contains a segment between non- via waypoints.

فیلدها
distance_ meters

int32

The travel distance of the route leg, in meters.

duration

Duration

The length of time needed to navigate the leg. If the route_preference is set to TRAFFIC_UNAWARE , then this value is the same as static_duration . If the route_preference is either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of travel through the leg, calculated without taking traffic conditions into consideration.

polyline

Polyline

The overall polyline for this leg that includes each step 's polyline.

start_ location

Location

The start location of this leg. This location might be different from the provided origin . For example, when the provided origin is not near a road, this is a point on the road.

end_ location

Location

The end location of this leg. This location might be different from the provided destination . For example, when the provided destination is not near a road, this is a point on the road.

steps[]

RouteLegStep

An array of steps denoting segments within this leg. Each step represents one navigation instruction.

travel_ advisory

RouteLegTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions, on a route leg.

localized_ values

RouteLegLocalizedValues

Text representations of properties of the RouteLeg .

steps_ overview

StepsOverview

Overview information about the steps in this RouteLeg . This field is only populated for TRANSIT routes.

RouteLegLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration, represented in text form and localized to the region of the query. Takes traffic conditions into consideration. Note: If you did not request traffic information, this value is the same value as static_duration.

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

StepsOverview

Provides overview information about a list of RouteLegStep s.

فیلدها
multi_ modal_ segments[]

MultiModalSegment

Summarized information about different multi-modal segments of the RouteLeg.steps . This field is not populated if the RouteLeg does not contain any multi-modal segments in the steps.

MultiModalSegment

Provides summarized information about different multi-modal segments of the RouteLeg.steps . A multi-modal segment is defined as one or more contiguous RouteLegStep that have the same RouteTravelMode . This field is not populated if the RouteLeg does not contain any multi-modal segments in the steps.

فیلدها
navigation_ instruction

NavigationInstruction

NavigationInstruction for the multi-modal segment.

travel_ mode

RouteTravelMode

The travel mode of the multi-modal segment.

step_ start_ index

int32

The corresponding RouteLegStep index that is the start of a multi-modal segment.

step_ end_ index

int32

The corresponding RouteLegStep index that is the end of a multi-modal segment.

RouteLegStep

Contains a segment of a RouteLeg . A step corresponds to a single navigation instruction. Route legs are made up of steps.

فیلدها
distance_ meters

int32

The travel distance of this step, in meters. In some circumstances, this field might not have a value.

static_ duration

Duration

The duration of travel through this step without taking traffic conditions into consideration. In some circumstances, this field might not have a value.

polyline

Polyline

The polyline associated with this step.

start_ location

Location

The start location of this step.

end_ location

Location

The end location of this step.

navigation_ instruction

NavigationInstruction

Navigation instructions.

travel_ advisory

RouteLegStepTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions, on a leg step.

localized_ values

RouteLegStepLocalizedValues

Text representations of properties of the RouteLegStep .

transit_ details

RouteLegStepTransitDetails

Details pertaining to this step if the travel mode is TRANSIT .

travel_ mode

RouteTravelMode

The travel mode used for this step.

RouteLegStepLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

RouteLegStepTransitDetails

Additional information for the RouteLegStep related to TRANSIT routes.

فیلدها
stop_ details

TransitStopDetails

Information about the arrival and departure stops for the step.

localized_ values

TransitDetailsLocalizedValues

Text representations of properties of the RouteLegStepTransitDetails .

headsign

string

Specifies the direction in which to travel on this line as marked on the vehicle or at the departure stop. The direction is often the terminus station.

headway

Duration

Specifies the expected time as a duration between departures from the same stop at this time. For example, with a headway seconds value of 600, you would expect a ten minute wait if you should miss your bus.

transit_ line

TransitLine

Information about the transit line used in this step.

stop_ count

int32

The number of stops from the departure to the arrival stop. This count includes the arrival stop, but excludes the departure stop. For example, if your route leaves from Stop A, passes through stops B and C, and arrives at stop D,

stop_count

برمی گرداند 3.

trip_ short_ text

string

The text that appears in schedules and sign boards to identify a transit trip to passengers. The text should uniquely identify a trip within a service day. For example, "538" is the trip_short_text of the Amtrak train that leaves San Jose, CA at 15:10 on weekdays to Sacramento, CA.

TransitDetailsLocalizedValues

Localized descriptions of values for RouteTransitDetails .

فیلدها
arrival_ time

LocalizedTime

Time in its formatted text representation with a corresponding time zone.

departure_ time

LocalizedTime

Time in its formatted text representation with a corresponding time zone.

TransitStopDetails

Details about the transit stops for the RouteLegStep .

فیلدها
arrival_ stop

TransitStop

Information about the arrival stop for the step.

arrival_ time

Timestamp

The estimated time of arrival for the step.

departure_ stop

TransitStop

Information about the departure stop for the step.

departure_ time

Timestamp

The estimated time of departure for the step.

RouteLegStepTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions on a leg step.

فیلدها
speed_ reading_ intervals[]

SpeedReadingInterval

NOTE: This field is not currently populated.

RouteLegTravelAdvisory

Contains the additional information that the user should be informed about on a leg step, such as possible traffic zone restrictions.

فیلدها
toll_ info

TollInfo

Contains information about tolls on the specific RouteLeg . This field is only populated if we expect there are tolls on the RouteLeg . If this field is set but the estimated_price subfield is not populated, we expect that road contains tolls but we do not know an estimated price. If this field does not exist, then there is no toll on the RouteLeg .

speed_ reading_ intervals[]

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the RouteLeg without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

مثال:

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

RouteMatrixDestination

A single destination for ComputeRouteMatrixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. Destination waypoint

RouteMatrixElement

Contains route information computed for an origin/destination pair in the ComputeRouteMatrix API. This proto can be streamed to the client.

فیلدها
status

Status

Error status code for this element.

condition

RouteMatrixElementCondition

Indicates whether the route was found or not. Independent of status.

distance_ meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of traveling through the route without taking traffic conditions into consideration.

travel_ advisory

RouteTravelAdvisory

Additional information about the route. For example: restriction information and toll information

fallback_ info

FallbackInfo

In some cases when the server is not able to compute the route with the given preferences for this particular origin/destination pair, it may fall back to using a different mode of computation. When fallback mode is used, this field contains detailed information about the fallback response. Otherwise this field is unset.

localized_ values

LocalizedValues

Text representations of properties of the RouteMatrixElement .

origin_ index

int32

Zero-based index of the origin in the request.

destination_ index

int32

Zero-based index of the destination in the request.

LocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration represented in text form taking traffic conditions into consideration. Note: If traffic information was not requested, this value is the same value as static_duration.

static_ duration

LocalizedText

Duration represented in text form without taking traffic conditions into consideration.

transit_ fare

LocalizedText

Transit fare represented in text form.

RouteMatrixElementCondition

The condition of the route being returned.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Only used when the status of the element is not OK.
ROUTE_EXISTS A route was found, and the corresponding information was filled out for the element.
ROUTE_NOT_FOUND No route could be found. Fields containing route information, such as distance_meters or duration , will not be filled out in the element.

RouteMatrixOrigin

A single origin for ComputeRouteMatrixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. Origin waypoint

route_ modifiers

RouteModifiers

اختیاری. Modifiers for every route that takes this as the origin

RouteModifiers

Encapsulates a set of optional conditions to satisfy when calculating the routes.

فیلدها
avoid_ tolls

bool

When set to true, avoids toll roads where reasonable, giving preference to routes not containing toll roads. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ highways

bool

When set to true, avoids highways where reasonable, giving preference to routes not containing highways. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ ferries

bool

When set to true, avoids ferries where reasonable, giving preference to routes not containing ferries. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ indoor

bool

When set to true, avoids navigating indoors where reasonable, giving preference to routes not containing indoor navigation. Applies only to the WALK RouteTravelMode .

vehicle_ info

VehicleInfo

Specifies the vehicle information.

toll_ passes[]

TollPass

Encapsulates information about toll passes. If toll passes are provided, the API tries to return the pass price. If toll passes are not provided, the API treats the toll pass as unknown and tries to return the cash price. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

RouteTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions.

فیلدها
toll_ info

TollInfo

Contains information about tolls on the route. This field is only populated if tolls are expected on the route. If this field is set, but the estimatedPrice subfield is not populated, then the route contains tolls, but the estimated price is unknown. If this field is not set, then there are no tolls expected on the route.

speed_ reading_ intervals[]

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

مثال:

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

int64

The predicted fuel consumption in microliters.

route_ restrictions_ partially_ ignored

bool

Returned route may have restrictions that are not suitable for requested travel mode or route modifiers.

transit_ fare

Money

If present, contains the total fare or ticket costs on this route This property is only returned for TRANSIT requests and only for routes where fare information is available for all transit steps.

RouteTravelMode

A set of values used to specify the mode of travel. NOTE: WALK , BICYCLE , and TWO_WHEELER routes are in beta and might sometimes be missing clear sidewalks, pedestrian paths, or bicycling paths. You must display this warning to the user for all walking, bicycling, and two-wheel routes that you display in your app.

Enums
TRAVEL_MODE_UNSPECIFIED No travel mode specified. Defaults to DRIVE .
DRIVE Travel by passenger car.
BICYCLE Travel by bicycle.
WALK Travel by walking.
TWO_WHEELER Two-wheeled, motorized vehicle. For example, motorcycle. Note that this differs from the BICYCLE travel mode which covers human-powered mode.
TRANSIT Travel by public transit routes, where available.

RoutingPreference

A set of values that specify factors to take into consideration when calculating the route.

Enums
ROUTING_PREFERENCE_UNSPECIFIED No routing preference specified. Default to TRAFFIC_UNAWARE .
TRAFFIC_UNAWARE Computes routes without taking live traffic conditions into consideration. Suitable when traffic conditions don't matter or are not applicable. Using this value produces the lowest latency. Note: For RouteTravelMode DRIVE and TWO_WHEELER , the route and duration chosen are based on road network and average time-independent traffic conditions, not current road conditions. Consequently, routes may include roads that are temporarily closed. Results for a given request may vary over time due to changes in the road network, updated average traffic conditions, and the distributed nature of the service. Results may also vary between nearly-equivalent routes at any time or frequency.
TRAFFIC_AWARE Calculates routes taking live traffic conditions into consideration. In contrast to TRAFFIC_AWARE_OPTIMAL , some optimizations are applied to significantly reduce latency.
TRAFFIC_AWARE_OPTIMAL Calculates the routes taking live traffic conditions into consideration, without applying most performance optimizations. Using this value produces the highest latency.

SpeedReadingInterval

Traffic density indicator on a contiguous segment of a polyline or path. Given a path with points P_0, P_1, ... , P_N (zero-based index), the SpeedReadingInterval defines an interval and describes its traffic using the following categories.

فیلدها
start_ polyline_ point_ index

int32

The starting index of this interval in the polyline.

end_ polyline_ point_ index

int32

The ending index of this interval in the polyline.

Union field speed_type .

speed_type can be only one of the following:

speed

Speed

Traffic speed in this interval.

سرعت

The classification of polyline speed based on traffic data.

Enums
SPEED_UNSPECIFIED مقدار پیش فرض This value is unused.
NORMAL Normal speed, no slowdown is detected.
SLOW Slowdown detected, but no traffic jam formed.
TRAFFIC_JAM Traffic jam detected.

TollInfo

Encapsulates toll information on a Route or on a RouteLeg .

فیلدها
estimated_ price[]

Money

The monetary amount of tolls for the corresponding Route or RouteLeg . This list contains a money amount for each currency that is expected to be charged by the toll stations. Typically this list will contain only one item for routes with tolls in one currency. For international trips, this list may contain multiple items to reflect tolls in different currencies.

TollPass

List of toll passes around the world that we support.

Enums
TOLL_PASS_UNSPECIFIED استفاده نشده است. If this value is used, then the request fails.
AU_ETOLL_TAG Sydney toll pass. See additional details at https://www.myetoll.com.au .
AU_EWAY_TAG Sydney toll pass. See additional details at https://www.tollpay.com.au .
AU_LINKT Australia-wide toll pass. See additional details at https://www.linkt.com.au/ .
AR_TELEPASE Argentina toll pass. See additional details at https://telepase.com.ar
BR_AUTO_EXPRESO Brazil toll pass. See additional details at https://www.autoexpreso.com
BR_CONECTCAR Brazil toll pass. See additional details at https://conectcar.com .
BR_MOVE_MAIS Brazil toll pass. See additional details at https://movemais.com .
BR_PASSA_RAPIDO Brazil toll pass. See additional details at https://pasorapido.gob.do/
BR_SEM_PARAR Brazil toll pass. See additional details at https://www.semparar.com.br .
BR_TAGGY Brazil toll pass. See additional details at https://taggy.com.br .
BR_VELOE Brazil toll pass. See additional details at https://veloe.com.br/site/onde-usar .
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Canada to United States border crossing.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Canada to United States border crossing.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada to Michigan, United States border crossing.
CA_US_CONNEXION Ontario, Canada to Michigan, United States border crossing.
CA_US_NEXUS_CARD Canada to United States border crossing.
ID_E_TOLL اندونزی. E-card provided by multiple banks used to pay for tolls. All e-cards via banks are charged the same so only one enum value is needed. Eg - 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 India, HP state plate exemption.
JP_ETC Japan ETC. Electronic wireless system to collect tolls. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. New version of ETC with further discount and bidirectional communication between devices on vehicles and antennas on the road. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mexico toll pass. https://iave.capufe.gob.mx/#/
MX_PASE Mexico https://www.pase.com.mx
MX_QUICKPASS Mexico 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 Mexico toll pass company. One of many operating in Mexico City. See additional details at https://www.televia.com.mx .
MX_TELEVIA Mexico toll pass company. One of many operating in Mexico City. https://www.televia.com.mx
MX_VIAPASS Mexico toll pass. See additional details at https://www.viapass.com.mx/viapass/web_home.aspx .
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK کالیفرنیا، ایالات متحده آمریکا
US_CA_FASTRAK_CAV_STICKER Indicates driver has any FasTrak pass in addition to the DMV issued Clean Air Vehicle (CAV) sticker. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL، ایالات متحده آمریکا
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL، ایالات متحده آمریکا
US_FL_EPASS FL، ایالات متحده آمریکا
US_FL_GIBA_TOLL_PASS FL، ایالات متحده آمریکا
US_FL_LEEWAY FL، ایالات متحده آمریکا
US_FL_SUNPASS FL، ایالات متحده آمریکا
US_FL_SUNPASS_PRO FL، ایالات متحده آمریکا
US_IL_EZPASSIL IL، ایالات متحده آمریکا
US_IL_IPASS IL، ایالات متحده آمریکا
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS لس آنجلس، ایالات متحده آمریکا
US_LA_TOLL_TAG لس آنجلس، ایالات متحده آمریکا
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Deprecated as this pass type no longer exists.

US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS نیوجرسی، ایالات متحده آمریکا
US_NJ_EZPASSNJ نیوجرسی، ایالات متحده آمریکا
US_NY_EXPRESSPASS نیویورک، ایالات متحده آمریکا
US_NY_EZPASSNY نیویورک، ایالات متحده آمریکا
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the response, which contains the predicted time in traffic based on historical averages.

Enums
TRAFFIC_MODEL_UNSPECIFIED استفاده نشده If specified, will default to BEST_GUESS .
BEST_GUESS Indicates that the returned duration should be the best estimate of travel time given what is known about both historical traffic conditions and live traffic. Live traffic becomes more important the closer the departure_time is to now.
PESSIMISTIC Indicates that the returned duration should be longer than the actual travel time on most days, though occasional days with particularly bad traffic conditions may exceed this value.
OPTIMISTIC Indicates that the returned duration should be shorter than the actual travel time on most days, though occasional days with particularly good traffic conditions may be faster than this value.

TransitAgency

A transit agency that operates a transit line.

فیلدها
name

string

The name of this transit agency.

phone_ number

string

The transit agency's locale-specific formatted phone number.

uri

string

The transit agency's URI.

TransitLine

Contains information about the transit line used in this step.

فیلدها
agencies[]

TransitAgency

The transit agency (or agencies) that operates this transit line.

name

string

The full name of this transit line, For example, "8 Avenue Local".

uri

string

the URI for this transit line as provided by the transit agency.

color

string

The color commonly used in signage for this line. Represented in hexadecimal.

icon_ uri

string

The URI for the icon associated with this line.

name_ short

string

The short name of this transit line. This name will normally be a line number, such as "M7" or "355".

text_ color

string

The color commonly used in text on signage for this line. Represented in hexadecimal.

vehicle

TransitVehicle

The type of vehicle that operates on this transit line.

TransitPreferences

Preferences for TRANSIT based routes that influence the route that is returned.

فیلدها
allowed_ travel_ modes[]

TransitTravelMode

A set of travel modes to use when getting a TRANSIT route. Defaults to all supported modes of travel.

routing_ preference

TransitRoutingPreference

A routing preference that, when specified, influences the TRANSIT route returned.

TransitRoutingPreference

Specifies routing preferences for transit routes.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED No preference specified.
LESS_WALKING Indicates that the calculated route should prefer limited amounts of walking.
FEWER_TRANSFERS Indicates that the calculated route should prefer a limited number of transfers.

TransitTravelMode

A set of values used to specify the mode of transit.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED No transit travel mode specified.
BUS Travel by bus.
SUBWAY Travel by subway.
TRAIN Travel by train.
LIGHT_RAIL Travel by light rail or tram.
RAIL Travel by rail. This is equivalent to a combination of SUBWAY , TRAIN , and LIGHT_RAIL .

TransitStop

Information about a transit stop.

فیلدها
name

string

The name of the transit stop.

location

Location

The location of the stop expressed in latitude/longitude coordinates.

TransitVehicle

Information about a vehicle used in transit routes.

فیلدها
name

LocalizedText

The name of this vehicle, capitalized.

type

TransitVehicleType

The type of vehicle used.

icon_ uri

string

The URI for an icon associated with this vehicle type.

local_ icon_ uri

string

The URI for the icon associated with this vehicle type, based on the local transport signage.

TransitVehicleType

The type of vehicles for transit routes.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED استفاده نشده
BUS اتوبوس
CABLE_CAR A vehicle that operates on a cable, usually on the ground. Aerial cable cars may be of the type GONDOLA_LIFT .
COMMUTER_TRAIN Commuter rail.
FERRY فری
FUNICULAR A vehicle that is pulled up a steep incline by a cable. A Funicular typically consists of two cars, with each car acting as a counterweight for the other.
GONDOLA_LIFT An aerial cable car.
HEAVY_RAIL ریل سنگین
HIGH_SPEED_TRAIN قطار پر سرعت.
INTERCITY_BUS Intercity bus.
LONG_DISTANCE_TRAIN Long distance train.
METRO_RAIL Light rail transit.
MONORAIL مونوریل.
OTHER All other vehicles.
RAIL راه آهن.
SHARE_TAXI Share taxi is a kind of bus with the ability to drop off and pick up passengers anywhere on its route.
SUBWAY Underground light rail.
TRAM Above ground light rail.
TROLLEYBUS Trolleybus.

واحدها

A set of values that specify the unit of measure used in the display.

Enums
UNITS_UNSPECIFIED Units of measure not specified. Defaults to the unit of measure inferred from the request.
METRIC Metric units of measure.
IMPERIAL Imperial (English) units of measure.

VehicleEmissionType

A set of values describing the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED No emission type specified. Default to GASOLINE .
GASOLINE Gasoline/petrol fueled vehicle.
ELECTRIC Electricity powered vehicle.
HYBRID Hybrid fuel (such as gasoline + electric) vehicle.
DIESEL Diesel fueled vehicle.

VehicleInfo

Contains the vehicle information, such as the vehicle emission type.

فیلدها
emission_ type

VehicleEmissionType

Describes the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

نقطه راه

Encapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.

فیلدها
via

bool

Marks this waypoint as a milestone rather a stopping point. For each non-via waypoint in the request, the response appends an entry to the legs array to provide the details for stopovers on that leg of the trip. Set this value to true when you want the route to pass through this waypoint without stopping over. Via waypoints don't cause an entry to be added to the legs array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. If ComputeRoutesRequest.optimize_waypoint_order is set to true then this field cannot be set to true; otherwise, the request fails.

vehicle_ stopover

bool

Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pickup or drop-off. When you set this value, the calculated route won't include non- via waypoints on roads that are unsuitable for pickup and drop-off. This option works only for DRIVE and TWO_WHEELER travel modes, and when the location_type is Location .

side_ of_ road

bool

Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option works only for DRIVE and TWO_WHEELER RouteTravelMode .

Union field location_type . Different ways to represent a location. location_type can be only one of the following:
location

Location

A point specified using geographic coordinates, including an optional heading.

place_ id

string

The POI Place ID associated with the waypoint.

address

string

Human readable address or a plus code. See https://plus.codes for details.

،

شاخص

مسیرها

The Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )

Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination.

NOTE: This method requires that you specify a response field mask in the input. You can provide the response field mask by using the URL parameter $fields or fields , or by using the HTTP/gRPC header X-Goog-FieldMask (see the available URL parameters and headers ). The value is a comma separated list of field paths. See this detailed documentation about how to construct the field paths .

For example, in this method:

  • Field mask of all available fields (for manual inspection): X-Goog-FieldMask: *
  • Field mask of route durations, distances, element status, condition, and element indices (an example production setup): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

It is critical that you include status in your field mask as otherwise all messages will appear to be OK. Google discourages the use of the wildcard ( * ) response field mask, because:

  • Selecting only the fields that you need helps our server save computation cycles, allowing us to return the result to you with a lower latency.
  • Selecting only the fields that you need in your production job ensures stable latency performance. We might add more response fields in the future, and those new fields might require extra computation time. If you select all fields, or if you select all fields at the top level, then you might experience performance degradation because any new field we add will be automatically included in the response.
  • Selecting only the fields that you need results in a smaller response size, and thus higher network throughput.
ComputeRoutes

rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )

Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints.

NOTE: This method requires that you specify a response field mask in the input. You can provide the response field mask by using URL parameter $fields or fields , or by using an HTTP/gRPC header X-Goog-FieldMask (see the available URL parameters and headers ). The value is a comma separated list of field paths. See detailed documentation about how to construct the field paths .

For example, in this method:

  • Field mask of all available fields (for manual inspection): X-Goog-FieldMask: *
  • Field mask of Route-level duration, distance, and polyline (an example production setup): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google discourage the use of the wildcard ( * ) response field mask, or specifying the field mask at the top level ( routes ), because:

  • Selecting only the fields that you need helps our server save computation cycles, allowing us to return the result to you with a lower latency.
  • Selecting only the fields that you need in your production job ensures stable latency performance. We might add more response fields in the future, and those new fields might require extra computation time. If you select all fields, or if you select all fields at the top level, then you might experience performance degradation because any new field we add will be automatically included in the response.
  • Selecting only the fields that you need results in a smaller response size, and thus higher network throughput.

ComputeRouteMatrixRequest

ComputeRouteMatrix request message

فیلدها
origins[]

RouteMatrixOrigin

مورد نیاز. Array of origins, which determines the rows of the response matrix. Several size restrictions apply to the cardinality of origins and destinations:

  • The sum of the number of origins + the number of destinations specified as either place_id or address must be no greater than 50.
  • The product of number of origins × number of destinations must be no greater than 625 in any case.
  • The product of the number of origins × number of destinations must be no greater than 100 if routing_preference is set to TRAFFIC_AWARE_OPTIMAL .
  • The product of the number of origins × number of destinations must be no greater than 100 if travel_mode is set to TRANSIT .
destinations[]

RouteMatrixDestination

مورد نیاز. Array of destinations, which determines the columns of the response matrix.

travel_ mode

RouteTravelMode

اختیاری. Specifies the mode of transportation.

routing_ preference

RoutingPreference

اختیاری. Specifies how to compute the route. The server attempts to use the selected routing preference to compute the route. If the routing preference results in an error or an extra long latency, an error is returned. You can specify this option only when the travel_mode is DRIVE or TWO_WHEELER , otherwise the request fails.

departure_ time

Timestamp

اختیاری. The departure time. If you don't set this value, then this value defaults to the time that you made the request. NOTE: You can only specify a departure_time in the past when RouteTravelMode is set to TRANSIT .

arrival_ time

Timestamp

اختیاری. The arrival time. NOTE: Can only be set when RouteTravelMode is set to TRANSIT . You can specify either departure_time or arrival_time , but not both.

language_ code

string

اختیاری. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see Unicode Locale Identifier . See Language Support for the list of supported languages. When you don't provide this value, the display language is inferred from the location of the first origin.

region_ code

string

اختیاری. The region code, specified as a ccTLD ("top-level domain") two-character value. For more information see Country code top-level domains .

units

Units

اختیاری. Specifies the units of measure for the display fields.

extra_ computations[]

ExtraComputation

اختیاری. A list of extra computations which may be used to complete the request. Note: These extra computations may return extra fields on the response. These extra fields must also be specified in the field mask to be returned in the response.

traffic_ model

TrafficModel

اختیاری. Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the RouteMatrixElement which contains the predicted time in traffic based on historical averages. RoutingPreference to TRAFFIC_AWARE_OPTIMAL and RouteTravelMode to DRIVE . Defaults to BEST_GUESS if traffic is requested and TrafficModel is not specified.

transit_ preferences

TransitPreferences

اختیاری. Specifies preferences that influence the route returned for TRANSIT routes. NOTE: You can only specify a transit_preferences when RouteTravelMode is set to TRANSIT .

ExtraComputation

Extra computations to perform while completing the request.

Enums
EXTRA_COMPUTATION_UNSPECIFIED استفاده نشده است. Requests containing this value will fail.
TOLLS Toll information for the matrix element(s).

ComputeRoutesRequest

ComputeRoutes request message.

فیلدها
origin

Waypoint

مورد نیاز. Origin waypoint.

destination

Waypoint

مورد نیاز. Destination waypoint.

intermediates[]

Waypoint

اختیاری. A set of waypoints along the route (excluding terminal points), for either stopping at or passing by. Up to 25 intermediate waypoints are supported.

travel_ mode

RouteTravelMode

اختیاری. Specifies the mode of transportation.

routing_ preference

RoutingPreference

اختیاری. Specifies how to compute the route. The server attempts to use the selected routing preference to compute the route. If the routing preference results in an error or an extra long latency, then an error is returned. You can specify this option only when the travel_mode is DRIVE or TWO_WHEELER , otherwise the request fails.

polyline_ quality

PolylineQuality

اختیاری. Specifies your preference for the quality of the polyline.

polyline_ encoding

PolylineEncoding

اختیاری. Specifies the preferred encoding for the polyline.

departure_ time

Timestamp

اختیاری. The departure time. If you don't set this value, then this value defaults to the time that you made the request. NOTE: You can only specify a departure_time in the past when RouteTravelMode is set to TRANSIT . Transit trips are available for up to 7 days in the past or 100 days in the future.

arrival_ time

Timestamp

اختیاری. The arrival time. NOTE: Can only be set when RouteTravelMode is set to TRANSIT . You can specify either departure_time or arrival_time , but not both. Transit trips are available for up to 7 days in the past or 100 days in the future.

compute_ alternative_ routes

bool

اختیاری. Specifies whether to calculate alternate routes in addition to the route. No alternative routes are returned for requests that have intermediate waypoints.

route_ modifiers

RouteModifiers

اختیاری. A set of conditions to satisfy that affect the way routes are calculated.

language_ code

string

اختیاری. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see Unicode Locale Identifier . See Language Support for the list of supported languages. When you don't provide this value, the display language is inferred from the location of the route request.

region_ code

string

اختیاری. The region code, specified as a ccTLD ("top-level domain") two-character value. For more information see Country code top-level domains .

units

Units

اختیاری. Specifies the units of measure for the display fields. These fields include the instruction field in NavigationInstruction . The units of measure used for the route, leg, step distance, and duration are not affected by this value. If you don't provide this value, then the display units are inferred from the location of the first origin.

optimize_ waypoint_ order

bool

اختیاری. If set to true, the service attempts to minimize the overall cost of the route by re-ordering the specified intermediate waypoints. The request fails if any of the intermediate waypoints is a via waypoint. Use ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index to find the new ordering. If ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index is not requested in the X-Goog-FieldMask header, the request fails. If optimize_waypoint_order is set to false, ComputeRoutesResponse.optimized_intermediate_waypoint_index will be empty.

requested_ reference_ routes[]

ReferenceRoute

اختیاری. Specifies what reference routes to calculate as part of the request in addition to the default route. A reference route is a route with a different route calculation objective than the default route. For example a FUEL_EFFICIENT reference route calculation takes into account various parameters that would generate an optimal fuel efficient route. When using this feature, look for route_labels on the resulting routes.

extra_ computations[]

ExtraComputation

اختیاری. A list of extra computations which may be used to complete the request. Note: These extra computations may return extra fields on the response. These extra fields must also be specified in the field mask to be returned in the response.

traffic_ model

TrafficModel

اختیاری. Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the Route and RouteLeg which contains the predicted time in traffic based on historical averages. TrafficModel is only available for requests that have set RoutingPreference to TRAFFIC_AWARE_OPTIMAL and RouteTravelMode to DRIVE . Defaults to BEST_GUESS if traffic is requested and TrafficModel is not specified.

transit_ preferences

TransitPreferences

اختیاری. Specifies preferences that influence the route returned for TRANSIT routes. NOTE: You can only specify a transit_preferences when RouteTravelMode is set to TRANSIT .

ExtraComputation

Extra computations to perform while completing the request.

Enums
EXTRA_COMPUTATION_UNSPECIFIED استفاده نشده است. Requests containing this value will fail.
TOLLS Toll information for the route(s).
FUEL_CONSUMPTION Estimated fuel consumption for the route(s).
TRAFFIC_ON_POLYLINE Traffic aware polylines for the route(s).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions presented as a formatted HTML text string. This content is meant to be read as-is. This content is for display only. Do not programmatically parse it.
FLYOVER_INFO_ON_POLYLINE Flyover information for the route(s). The routes.polyline_details.flyover_info fieldmask must be specified to return this information. This data will only currently be populated for certain metros in India. This feature is experimental, and the SKU/charge is subject to change.
NARROW_ROAD_INFO_ON_POLYLINE Narrow road information for the route(s). The routes.polyline_details.narrow_road_info fieldmask must be specified to return this information. This data will only currently be populated for certain metros in India. This feature is experimental, and the SKU/charge is subject to change.

ReferenceRoute

A supported reference route on the ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED استفاده نشده است. Requests containing this value fail.
FUEL_EFFICIENT Fuel efficient route.
SHORTER_DISTANCE

Route with shorter travel distance. این یک ویژگی آزمایشی است.

For DRIVE requests, this feature prioritizes shorter distance over driving comfort. For example, it may prefer local roads instead of highways, take dirt roads, cut through parking lots, etc. This feature does not return any maneuvers that Google Maps knows to be illegal.

For BICYCLE and TWO_WHEELER requests, this feature returns routes similar to those returned when you don't specify requested_reference_routes .

This feature is not compatible with any other travel modes, via intermediate waypoints, or optimize_waypoint_order ; such requests will fail. However, you can use it with any routing_preference .

ComputeRoutesResponse

ComputeRoutes the response message.

فیلدها
routes[]

Route

Contains an array of computed routes (up to three) when you specify compute_alternatives_routes , and contains just one route when you don't. When this array contains multiple entries, the first one is the most recommended route. If the array is empty, then it means no route could be found.

fallback_ info

FallbackInfo

In some cases when the server is not able to compute the route results with all of the input preferences, it may fallback to using a different way of computation. When fallback mode is used, this field contains detailed info about the fallback response. Otherwise this field is unset.

geocoding_ results

GeocodingResults

Contains geocoding response info for waypoints specified as addresses.

FallbackInfo

Information related to how and why a fallback result was used. If this field is set, then it means the server used a different routing mode from your preferred mode as fallback.

فیلدها
routing_ mode

FallbackRoutingMode

Routing mode used for the response. If fallback was triggered, the mode may be different from routing preference set in the original client request.

reason

FallbackReason

The reason why fallback response was used instead of the original response. This field is only populated when the fallback mode is triggered and the fallback response is returned.

FallbackReason

Reasons for using fallback response.

Enums
FALLBACK_REASON_UNSPECIFIED No fallback reason specified.
SERVER_ERROR A server error happened while calculating routes with your preferred routing mode, but we were able to return a result calculated by an alternative mode.
LATENCY_EXCEEDED We were not able to finish the calculation with your preferred routing mode on time, but we were able to return a result calculated by an alternative mode.

FallbackRoutingMode

Actual routing mode used for returned fallback response.

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED استفاده نشده است.
FALLBACK_TRAFFIC_UNAWARE Indicates the TRAFFIC_UNAWARE RoutingPreference was used to compute the response.
FALLBACK_TRAFFIC_AWARE Indicates the TRAFFIC_AWARE RoutingPreference was used to compute the response.

GeocodedWaypoint

Details about the locations used as waypoints. Only populated for address waypoints. Includes details about the geocoding results for the purposes of determining what the address was geocoded to.

فیلدها
geocoder_ status

Status

Indicates the status code resulting from the geocoding operation.

type[]

string

The type(s) of the result, in the form of zero or more type tags. Supported types: Address types and address component types .

partial_ match

bool

Indicates that the geocoder did not return an exact match for the original request, though it was able to match part of the requested address. You may wish to examine the original request for misspellings and/or an incomplete address.

place_ id

string

The place ID for this result.

intermediate_ waypoint_ request_ index

int32

The index of the corresponding intermediate waypoint in the request. Only populated if the corresponding waypoint is an intermediate waypoint.

GeocodingResults

Contains GeocodedWaypoints for origin, destination and intermediate waypoints. Only populated for address waypoints.

فیلدها
origin

GeocodedWaypoint

Origin geocoded waypoint.

destination

GeocodedWaypoint

Destination geocoded waypoint.

intermediates[]

GeocodedWaypoint

A list of intermediate geocoded waypoints each containing an index field that corresponds to the zero-based position of the waypoint in the order they were specified in the request.

LocalizedTime

Localized description of time.

فیلدها
time

LocalizedText

The time specified as a string in a given time zone.

time_ zone

string

Contains the time zone. The value is the name of the time zone as defined in the IANA Time Zone Database , eg "America/New_York".

مکان

Encapsulates a location (a geographic point, and an optional heading).

فیلدها
lat_ lng

LatLng

The waypoint's geographic coordinates.

heading

Int32Value

The compass heading associated with the direction of the flow of traffic. This value specifies the side of the road for pickup and drop-off. Heading values can be from 0 to 360, where 0 specifies a heading of due North, 90 specifies a heading of due East, and so on. You can use this field only for DRIVE and TWO_WHEELER RouteTravelMode .

مانور

A set of values that specify the navigation action to take for the current step (for example, turn left, merge, or straight).

Enums
MANEUVER_UNSPECIFIED استفاده نشده است.
TURN_SLIGHT_LEFT Turn slightly to the left.
TURN_SHARP_LEFT Turn sharply to the left.
UTURN_LEFT Make a left u-turn.
TURN_LEFT به چپ بپیچید.
TURN_SLIGHT_RIGHT Turn slightly to the right.
TURN_SHARP_RIGHT Turn sharply to the right.
UTURN_RIGHT Make a right u-turn.
TURN_RIGHT به راست بپیچید.
STRAIGHT Go straight.
RAMP_LEFT Take the left ramp.
RAMP_RIGHT Take the right ramp.
MERGE Merge into traffic.
FORK_LEFT Take the left fork.
FORK_RIGHT Take the right fork.
FERRY Take the ferry.
FERRY_TRAIN Take the train leading onto the ferry.
ROUNDABOUT_LEFT Turn left at the roundabout.
ROUNDABOUT_RIGHT Turn right at the roundabout.
DEPART Initial maneuver.
NAME_CHANGE Used to indicate a street name change.

Encapsulates navigation instructions for a RouteLegStep .

فیلدها
maneuver

Maneuver

Encapsulates the navigation instructions for the current step (for example, turn left, merge, or straight). This field determines which icon to display.

instructions

string

Instructions for navigating this step.

پلی لاین

Encapsulates an encoded polyline.

فیلدها
Union field polyline_type . Encapsulates the type of polyline. Defaults to encoded_polyline. polyline_type can be only one of the following:
encoded_ polyline

string

The string encoding of the polyline using the polyline encoding algorithm

geo_ json_ linestring

Struct

Specifies a polyline using the GeoJSON LineString format .

PolylineDetails

Details corresponding to a given index or contiguous segment of a polyline. Given a polyline with points P_0, P_1, ... , P_N (zero-based index), the PolylineDetails defines an interval and associated metadata.

فیلدها
flyover_ info[]

FlyoverInfo

Flyover details along the polyline.

narrow_ road_ info[]

NarrowRoadInfo

Narrow road details along the polyline.

FlyoverInfo

Encapsulates information about flyovers along the polyline.

فیلدها
flyover_ presence

RoadFeatureState

فقط خروجی Denotes whether a flyover exists for a given stretch of the polyline.

polyline_ point_ index

PolylinePointIndex

The location of flyover related information along the polyline.

NarrowRoadInfo

Encapsulates information about narrow roads along the polyline.

فیلدها
narrow_ road_ presence

RoadFeatureState

فقط خروجی Denotes whether a narrow road exists for a given stretch of the polyline.

polyline_ point_ index

PolylinePointIndex

The location of narrow road related information along the polyline.

PolylinePointIndex

Encapsulates the start and end indexes for a polyline detail. For instances where the data corresponds to a single point, start_index and end_index will be equal.

فیلدها
start_ index

int32

The start index of this detail in the polyline.

end_ index

int32

The end index of this detail in the polyline.

RoadFeatureState

Encapsulates the states of road features along a stretch of polyline.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED The road feature's state was not computed (default value).
EXISTS The road feature exists.
DOES_NOT_EXIST The road feature does not exist.

PolylineEncoding

Specifies the preferred type of polyline to be returned.

Enums
POLYLINE_ENCODING_UNSPECIFIED No polyline type preference specified. Defaults to ENCODED_POLYLINE .
ENCODED_POLYLINE Specifies a polyline encoded using the polyline encoding algorithm .
GEO_JSON_LINESTRING Specifies a polyline using the GeoJSON LineString format

PolylineQuality

A set of values that specify the quality of the polyline.

Enums
POLYLINE_QUALITY_UNSPECIFIED No polyline quality preference specified. Defaults to OVERVIEW .
HIGH_QUALITY Specifies a high-quality polyline - which is composed using more points than OVERVIEW , at the cost of increased response size. Use this value when you need more precision.
OVERVIEW Specifies an overview polyline - which is composed using a small number of points. Use this value when displaying an overview of the route. Using this option has a lower request latency compared to using the HIGH_QUALITY option.

مسیر

Contains a route, which consists of a series of connected road segments that join beginning, ending, and intermediate waypoints.

فیلدها
route_ labels[]

RouteLabel

Labels for the Route that are useful to identify specific properties of the route to compare against others.

legs[]

RouteLeg

A collection of legs (path segments between waypoints) that make up the route. Each leg corresponds to the trip between two non- via Waypoints . For example, a route with no intermediate waypoints has only one leg. A route that includes one non- via intermediate waypoint has two legs. A route that includes one via intermediate waypoint has one leg. The order of the legs matches the order of waypoints from origin to intermediates to destination .

distance_ meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of travel through the route without taking traffic conditions into consideration.

polyline

Polyline

The overall route polyline. This polyline is the combined polyline of all legs .

description

string

A description of the route.

warnings[]

string

An array of warnings to show when displaying the route.

viewport

Viewport

The viewport bounding box of the polyline.

travel_ advisory

RouteTravelAdvisory

Additional information about the route.

optimized_ intermediate_ waypoint_ index[]

int32

If you set optimize_waypoint_order to true, this field contains the optimized ordering of intermediate waypoints. Otherwise, this field is empty. For example, if you give an input of Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York; and the optimized intermediate waypoint order is Phoenix, Dallas, Bangor, then this field contains the values [2, 0, 1]. The index starts with 0 for the first intermediate waypoint provided in the input.

localized_ values

RouteLocalizedValues

Text representations of properties of the Route .

route_ token

string

An opaque token that can be passed to Navigation SDK to reconstruct the route during navigation, and, in the event of rerouting, honor the original intention when the route was created. Treat this token as an opaque blob. Don't compare its value across requests as its value may change even if the service returns the exact same route.

NOTE: Route.route_token is only available for requests that have set ComputeRoutesRequest.routing_preference to TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL . Route.route_token is not supported for requests that have Via waypoints.

polyline_ details

PolylineDetails

Contains information about details along the polyline.

RouteLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration, represented in text form and localized to the region of the query. Takes traffic conditions into consideration. Note: If you did not request traffic information, this value is the same value as static_duration .

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

transit_ fare

LocalizedText

Transit fare represented in text form.

RouteLabel

Labels for the Route that are useful to identify specific properties of the route to compare against others.

Enums
ROUTE_LABEL_UNSPECIFIED Default - not used.
DEFAULT_ROUTE The default "best" route returned for the route computation.
DEFAULT_ROUTE_ALTERNATE An alternative to the default "best" route. Routes like this will be returned when compute_alternative_routes is specified.
FUEL_EFFICIENT Fuel efficient route. Routes labeled with this value are determined to be optimized for Eco parameters such as fuel consumption.
SHORTER_DISTANCE Shorter travel distance route. این یک ویژگی آزمایشی است.

RouteLeg

Contains a segment between non- via waypoints.

فیلدها
distance_ meters

int32

The travel distance of the route leg, in meters.

duration

Duration

The length of time needed to navigate the leg. If the route_preference is set to TRAFFIC_UNAWARE , then this value is the same as static_duration . If the route_preference is either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of travel through the leg, calculated without taking traffic conditions into consideration.

polyline

Polyline

The overall polyline for this leg that includes each step 's polyline.

start_ location

Location

The start location of this leg. This location might be different from the provided origin . For example, when the provided origin is not near a road, this is a point on the road.

end_ location

Location

The end location of this leg. This location might be different from the provided destination . For example, when the provided destination is not near a road, this is a point on the road.

steps[]

RouteLegStep

An array of steps denoting segments within this leg. Each step represents one navigation instruction.

travel_ advisory

RouteLegTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions, on a route leg.

localized_ values

RouteLegLocalizedValues

Text representations of properties of the RouteLeg .

steps_ overview

StepsOverview

Overview information about the steps in this RouteLeg . This field is only populated for TRANSIT routes.

RouteLegLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration, represented in text form and localized to the region of the query. Takes traffic conditions into consideration. Note: If you did not request traffic information, this value is the same value as static_duration.

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

StepsOverview

Provides overview information about a list of RouteLegStep s.

فیلدها
multi_ modal_ segments[]

MultiModalSegment

Summarized information about different multi-modal segments of the RouteLeg.steps . This field is not populated if the RouteLeg does not contain any multi-modal segments in the steps.

MultiModalSegment

Provides summarized information about different multi-modal segments of the RouteLeg.steps . A multi-modal segment is defined as one or more contiguous RouteLegStep that have the same RouteTravelMode . This field is not populated if the RouteLeg does not contain any multi-modal segments in the steps.

فیلدها
navigation_ instruction

NavigationInstruction

NavigationInstruction for the multi-modal segment.

travel_ mode

RouteTravelMode

The travel mode of the multi-modal segment.

step_ start_ index

int32

The corresponding RouteLegStep index that is the start of a multi-modal segment.

step_ end_ index

int32

The corresponding RouteLegStep index that is the end of a multi-modal segment.

RouteLegStep

Contains a segment of a RouteLeg . A step corresponds to a single navigation instruction. Route legs are made up of steps.

فیلدها
distance_ meters

int32

The travel distance of this step, in meters. In some circumstances, this field might not have a value.

static_ duration

Duration

The duration of travel through this step without taking traffic conditions into consideration. In some circumstances, this field might not have a value.

polyline

Polyline

The polyline associated with this step.

start_ location

Location

The start location of this step.

end_ location

Location

The end location of this step.

navigation_ instruction

NavigationInstruction

Navigation instructions.

travel_ advisory

RouteLegStepTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions, on a leg step.

localized_ values

RouteLegStepLocalizedValues

Text representations of properties of the RouteLegStep .

transit_ details

RouteLegStepTransitDetails

Details pertaining to this step if the travel mode is TRANSIT .

travel_ mode

RouteTravelMode

The travel mode used for this step.

RouteLegStepLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

RouteLegStepTransitDetails

Additional information for the RouteLegStep related to TRANSIT routes.

فیلدها
stop_ details

TransitStopDetails

Information about the arrival and departure stops for the step.

localized_ values

TransitDetailsLocalizedValues

Text representations of properties of the RouteLegStepTransitDetails .

headsign

string

Specifies the direction in which to travel on this line as marked on the vehicle or at the departure stop. The direction is often the terminus station.

headway

Duration

Specifies the expected time as a duration between departures from the same stop at this time. For example, with a headway seconds value of 600, you would expect a ten minute wait if you should miss your bus.

transit_ line

TransitLine

Information about the transit line used in this step.

stop_ count

int32

The number of stops from the departure to the arrival stop. This count includes the arrival stop, but excludes the departure stop. For example, if your route leaves from Stop A, passes through stops B and C, and arrives at stop D,

stop_count

برمی گرداند 3.

trip_ short_ text

string

The text that appears in schedules and sign boards to identify a transit trip to passengers. The text should uniquely identify a trip within a service day. For example, "538" is the trip_short_text of the Amtrak train that leaves San Jose, CA at 15:10 on weekdays to Sacramento, CA.

TransitDetailsLocalizedValues

Localized descriptions of values for RouteTransitDetails .

فیلدها
arrival_ time

LocalizedTime

Time in its formatted text representation with a corresponding time zone.

departure_ time

LocalizedTime

Time in its formatted text representation with a corresponding time zone.

TransitStopDetails

Details about the transit stops for the RouteLegStep .

فیلدها
arrival_ stop

TransitStop

Information about the arrival stop for the step.

arrival_ time

Timestamp

The estimated time of arrival for the step.

departure_ stop

TransitStop

Information about the departure stop for the step.

departure_ time

Timestamp

The estimated time of departure for the step.

RouteLegStepTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions on a leg step.

فیلدها
speed_ reading_ intervals[]

SpeedReadingInterval

NOTE: This field is not currently populated.

RouteLegTravelAdvisory

Contains the additional information that the user should be informed about on a leg step, such as possible traffic zone restrictions.

فیلدها
toll_ info

TollInfo

Contains information about tolls on the specific RouteLeg . This field is only populated if we expect there are tolls on the RouteLeg . If this field is set but the estimated_price subfield is not populated, we expect that road contains tolls but we do not know an estimated price. If this field does not exist, then there is no toll on the RouteLeg .

speed_ reading_ intervals[]

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the RouteLeg without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

مثال:

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

RouteMatrixDestination

A single destination for ComputeRouteMatrixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. Destination waypoint

RouteMatrixElement

Contains route information computed for an origin/destination pair in the ComputeRouteMatrix API. This proto can be streamed to the client.

فیلدها
status

Status

Error status code for this element.

condition

RouteMatrixElementCondition

Indicates whether the route was found or not. Independent of status.

distance_ meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of traveling through the route without taking traffic conditions into consideration.

travel_ advisory

RouteTravelAdvisory

Additional information about the route. For example: restriction information and toll information

fallback_ info

FallbackInfo

In some cases when the server is not able to compute the route with the given preferences for this particular origin/destination pair, it may fall back to using a different mode of computation. When fallback mode is used, this field contains detailed information about the fallback response. Otherwise this field is unset.

localized_ values

LocalizedValues

Text representations of properties of the RouteMatrixElement .

origin_ index

int32

Zero-based index of the origin in the request.

destination_ index

int32

Zero-based index of the destination in the request.

LocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration represented in text form taking traffic conditions into consideration. Note: If traffic information was not requested, this value is the same value as static_duration.

static_ duration

LocalizedText

Duration represented in text form without taking traffic conditions into consideration.

transit_ fare

LocalizedText

Transit fare represented in text form.

RouteMatrixElementCondition

The condition of the route being returned.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Only used when the status of the element is not OK.
ROUTE_EXISTS A route was found, and the corresponding information was filled out for the element.
ROUTE_NOT_FOUND No route could be found. Fields containing route information, such as distance_meters or duration , will not be filled out in the element.

RouteMatrixOrigin

A single origin for ComputeRouteMatrixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. Origin waypoint

route_ modifiers

RouteModifiers

اختیاری. Modifiers for every route that takes this as the origin

RouteModifiers

Encapsulates a set of optional conditions to satisfy when calculating the routes.

فیلدها
avoid_ tolls

bool

When set to true, avoids toll roads where reasonable, giving preference to routes not containing toll roads. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ highways

bool

When set to true, avoids highways where reasonable, giving preference to routes not containing highways. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ ferries

bool

When set to true, avoids ferries where reasonable, giving preference to routes not containing ferries. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ indoor

bool

When set to true, avoids navigating indoors where reasonable, giving preference to routes not containing indoor navigation. Applies only to the WALK RouteTravelMode .

vehicle_ info

VehicleInfo

Specifies the vehicle information.

toll_ passes[]

TollPass

Encapsulates information about toll passes. If toll passes are provided, the API tries to return the pass price. If toll passes are not provided, the API treats the toll pass as unknown and tries to return the cash price. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

RouteTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions.

فیلدها
toll_ info

TollInfo

Contains information about tolls on the route. This field is only populated if tolls are expected on the route. If this field is set, but the estimatedPrice subfield is not populated, then the route contains tolls, but the estimated price is unknown. If this field is not set, then there are no tolls expected on the route.

speed_ reading_ intervals[]

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

مثال:

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

int64

The predicted fuel consumption in microliters.

route_ restrictions_ partially_ ignored

bool

Returned route may have restrictions that are not suitable for requested travel mode or route modifiers.

transit_ fare

Money

If present, contains the total fare or ticket costs on this route This property is only returned for TRANSIT requests and only for routes where fare information is available for all transit steps.

RouteTravelMode

A set of values used to specify the mode of travel. NOTE: WALK , BICYCLE , and TWO_WHEELER routes are in beta and might sometimes be missing clear sidewalks, pedestrian paths, or bicycling paths. You must display this warning to the user for all walking, bicycling, and two-wheel routes that you display in your app.

Enums
TRAVEL_MODE_UNSPECIFIED No travel mode specified. Defaults to DRIVE .
DRIVE Travel by passenger car.
BICYCLE Travel by bicycle.
WALK Travel by walking.
TWO_WHEELER Two-wheeled, motorized vehicle. For example, motorcycle. Note that this differs from the BICYCLE travel mode which covers human-powered mode.
TRANSIT Travel by public transit routes, where available.

RoutingPreference

A set of values that specify factors to take into consideration when calculating the route.

Enums
ROUTING_PREFERENCE_UNSPECIFIED No routing preference specified. Default to TRAFFIC_UNAWARE .
TRAFFIC_UNAWARE Computes routes without taking live traffic conditions into consideration. Suitable when traffic conditions don't matter or are not applicable. Using this value produces the lowest latency. Note: For RouteTravelMode DRIVE and TWO_WHEELER , the route and duration chosen are based on road network and average time-independent traffic conditions, not current road conditions. Consequently, routes may include roads that are temporarily closed. Results for a given request may vary over time due to changes in the road network, updated average traffic conditions, and the distributed nature of the service. Results may also vary between nearly-equivalent routes at any time or frequency.
TRAFFIC_AWARE Calculates routes taking live traffic conditions into consideration. In contrast to TRAFFIC_AWARE_OPTIMAL , some optimizations are applied to significantly reduce latency.
TRAFFIC_AWARE_OPTIMAL Calculates the routes taking live traffic conditions into consideration, without applying most performance optimizations. Using this value produces the highest latency.

SpeedReadingInterval

Traffic density indicator on a contiguous segment of a polyline or path. Given a path with points P_0, P_1, ... , P_N (zero-based index), the SpeedReadingInterval defines an interval and describes its traffic using the following categories.

فیلدها
start_ polyline_ point_ index

int32

The starting index of this interval in the polyline.

end_ polyline_ point_ index

int32

The ending index of this interval in the polyline.

Union field speed_type .

speed_type can be only one of the following:

speed

Speed

Traffic speed in this interval.

سرعت

The classification of polyline speed based on traffic data.

Enums
SPEED_UNSPECIFIED مقدار پیش فرض This value is unused.
NORMAL Normal speed, no slowdown is detected.
SLOW Slowdown detected, but no traffic jam formed.
TRAFFIC_JAM Traffic jam detected.

TollInfo

Encapsulates toll information on a Route or on a RouteLeg .

فیلدها
estimated_ price[]

Money

The monetary amount of tolls for the corresponding Route or RouteLeg . This list contains a money amount for each currency that is expected to be charged by the toll stations. Typically this list will contain only one item for routes with tolls in one currency. For international trips, this list may contain multiple items to reflect tolls in different currencies.

TollPass

List of toll passes around the world that we support.

Enums
TOLL_PASS_UNSPECIFIED استفاده نشده است. If this value is used, then the request fails.
AU_ETOLL_TAG Sydney toll pass. See additional details at https://www.myetoll.com.au .
AU_EWAY_TAG Sydney toll pass. See additional details at https://www.tollpay.com.au .
AU_LINKT Australia-wide toll pass. See additional details at https://www.linkt.com.au/ .
AR_TELEPASE Argentina toll pass. See additional details at https://telepase.com.ar
BR_AUTO_EXPRESO Brazil toll pass. See additional details at https://www.autoexpreso.com
BR_CONECTCAR Brazil toll pass. See additional details at https://conectcar.com .
BR_MOVE_MAIS Brazil toll pass. See additional details at https://movemais.com .
BR_PASSA_RAPIDO Brazil toll pass. See additional details at https://pasorapido.gob.do/
BR_SEM_PARAR Brazil toll pass. See additional details at https://www.semparar.com.br .
BR_TAGGY Brazil toll pass. See additional details at https://taggy.com.br .
BR_VELOE Brazil toll pass. See additional details at https://veloe.com.br/site/onde-usar .
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Canada to United States border crossing.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Canada to United States border crossing.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada to Michigan, United States border crossing.
CA_US_CONNEXION Ontario, Canada to Michigan, United States border crossing.
CA_US_NEXUS_CARD Canada to United States border crossing.
ID_E_TOLL اندونزی. E-card provided by multiple banks used to pay for tolls. All e-cards via banks are charged the same so only one enum value is needed. Eg - 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 India, HP state plate exemption.
JP_ETC Japan ETC. Electronic wireless system to collect tolls. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. New version of ETC with further discount and bidirectional communication between devices on vehicles and antennas on the road. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mexico toll pass. https://iave.capufe.gob.mx/#/
MX_PASE Mexico https://www.pase.com.mx
MX_QUICKPASS Mexico 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 Mexico toll pass company. One of many operating in Mexico City. See additional details at https://www.televia.com.mx .
MX_TELEVIA Mexico toll pass company. One of many operating in Mexico City. https://www.televia.com.mx
MX_VIAPASS Mexico toll pass. See additional details at https://www.viapass.com.mx/viapass/web_home.aspx .
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK کالیفرنیا، ایالات متحده آمریکا
US_CA_FASTRAK_CAV_STICKER Indicates driver has any FasTrak pass in addition to the DMV issued Clean Air Vehicle (CAV) sticker. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL، ایالات متحده آمریکا
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL، ایالات متحده آمریکا
US_FL_EPASS FL، ایالات متحده آمریکا
US_FL_GIBA_TOLL_PASS FL، ایالات متحده آمریکا
US_FL_LEEWAY FL، ایالات متحده آمریکا
US_FL_SUNPASS FL، ایالات متحده آمریکا
US_FL_SUNPASS_PRO FL، ایالات متحده آمریکا
US_IL_EZPASSIL IL، ایالات متحده آمریکا
US_IL_IPASS IL، ایالات متحده آمریکا
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS لس آنجلس، ایالات متحده آمریکا
US_LA_TOLL_TAG لس آنجلس، ایالات متحده آمریکا
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Deprecated as this pass type no longer exists.

US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS نیوجرسی، ایالات متحده آمریکا
US_NJ_EZPASSNJ نیوجرسی، ایالات متحده آمریکا
US_NY_EXPRESSPASS نیویورک، ایالات متحده آمریکا
US_NY_EZPASSNY نیویورک، ایالات متحده آمریکا
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the response, which contains the predicted time in traffic based on historical averages.

Enums
TRAFFIC_MODEL_UNSPECIFIED استفاده نشده If specified, will default to BEST_GUESS .
BEST_GUESS Indicates that the returned duration should be the best estimate of travel time given what is known about both historical traffic conditions and live traffic. Live traffic becomes more important the closer the departure_time is to now.
PESSIMISTIC Indicates that the returned duration should be longer than the actual travel time on most days, though occasional days with particularly bad traffic conditions may exceed this value.
OPTIMISTIC Indicates that the returned duration should be shorter than the actual travel time on most days, though occasional days with particularly good traffic conditions may be faster than this value.

TransitAgency

A transit agency that operates a transit line.

فیلدها
name

string

The name of this transit agency.

phone_ number

string

The transit agency's locale-specific formatted phone number.

uri

string

The transit agency's URI.

TransitLine

Contains information about the transit line used in this step.

فیلدها
agencies[]

TransitAgency

The transit agency (or agencies) that operates this transit line.

name

string

The full name of this transit line, For example, "8 Avenue Local".

uri

string

the URI for this transit line as provided by the transit agency.

color

string

The color commonly used in signage for this line. Represented in hexadecimal.

icon_ uri

string

The URI for the icon associated with this line.

name_ short

string

The short name of this transit line. This name will normally be a line number, such as "M7" or "355".

text_ color

string

The color commonly used in text on signage for this line. Represented in hexadecimal.

vehicle

TransitVehicle

The type of vehicle that operates on this transit line.

TransitPreferences

Preferences for TRANSIT based routes that influence the route that is returned.

فیلدها
allowed_ travel_ modes[]

TransitTravelMode

A set of travel modes to use when getting a TRANSIT route. Defaults to all supported modes of travel.

routing_ preference

TransitRoutingPreference

A routing preference that, when specified, influences the TRANSIT route returned.

TransitRoutingPreference

Specifies routing preferences for transit routes.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED No preference specified.
LESS_WALKING Indicates that the calculated route should prefer limited amounts of walking.
FEWER_TRANSFERS Indicates that the calculated route should prefer a limited number of transfers.

TransitTravelMode

A set of values used to specify the mode of transit.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED No transit travel mode specified.
BUS Travel by bus.
SUBWAY Travel by subway.
TRAIN Travel by train.
LIGHT_RAIL Travel by light rail or tram.
RAIL Travel by rail. This is equivalent to a combination of SUBWAY , TRAIN , and LIGHT_RAIL .

TransitStop

Information about a transit stop.

فیلدها
name

string

The name of the transit stop.

location

Location

The location of the stop expressed in latitude/longitude coordinates.

TransitVehicle

Information about a vehicle used in transit routes.

فیلدها
name

LocalizedText

The name of this vehicle, capitalized.

type

TransitVehicleType

The type of vehicle used.

icon_ uri

string

The URI for an icon associated with this vehicle type.

local_ icon_ uri

string

The URI for the icon associated with this vehicle type, based on the local transport signage.

TransitVehicleType

The type of vehicles for transit routes.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED استفاده نشده
BUS اتوبوس
CABLE_CAR A vehicle that operates on a cable, usually on the ground. Aerial cable cars may be of the type GONDOLA_LIFT .
COMMUTER_TRAIN Commuter rail.
FERRY فری
FUNICULAR A vehicle that is pulled up a steep incline by a cable. A Funicular typically consists of two cars, with each car acting as a counterweight for the other.
GONDOLA_LIFT An aerial cable car.
HEAVY_RAIL ریل سنگین
HIGH_SPEED_TRAIN قطار پر سرعت.
INTERCITY_BUS Intercity bus.
LONG_DISTANCE_TRAIN Long distance train.
METRO_RAIL Light rail transit.
MONORAIL مونوریل.
OTHER All other vehicles.
RAIL راه آهن.
SHARE_TAXI Share taxi is a kind of bus with the ability to drop off and pick up passengers anywhere on its route.
SUBWAY Underground light rail.
TRAM Above ground light rail.
TROLLEYBUS Trolleybus.

واحدها

A set of values that specify the unit of measure used in the display.

Enums
UNITS_UNSPECIFIED Units of measure not specified. Defaults to the unit of measure inferred from the request.
METRIC Metric units of measure.
IMPERIAL Imperial (English) units of measure.

VehicleEmissionType

A set of values describing the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED No emission type specified. Default to GASOLINE .
GASOLINE Gasoline/petrol fueled vehicle.
ELECTRIC Electricity powered vehicle.
HYBRID Hybrid fuel (such as gasoline + electric) vehicle.
DIESEL Diesel fueled vehicle.

VehicleInfo

Contains the vehicle information, such as the vehicle emission type.

فیلدها
emission_ type

VehicleEmissionType

Describes the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

نقطه راه

Encapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.

فیلدها
via

bool

Marks this waypoint as a milestone rather a stopping point. For each non-via waypoint in the request, the response appends an entry to the legs array to provide the details for stopovers on that leg of the trip. Set this value to true when you want the route to pass through this waypoint without stopping over. Via waypoints don't cause an entry to be added to the legs array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. If ComputeRoutesRequest.optimize_waypoint_order is set to true then this field cannot be set to true; otherwise, the request fails.

vehicle_ stopover

bool

Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pickup or drop-off. When you set this value, the calculated route won't include non- via waypoints on roads that are unsuitable for pickup and drop-off. This option works only for DRIVE and TWO_WHEELER travel modes, and when the location_type is Location .

side_ of_ road

bool

Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option works only for DRIVE and TWO_WHEELER RouteTravelMode .

Union field location_type . Different ways to represent a location. location_type can be only one of the following:
location

Location

A point specified using geographic coordinates, including an optional heading.

place_ id

string

The POI Place ID associated with the waypoint.

address

string

Human readable address or a plus code. See https://plus.codes for details.

،

شاخص

مسیرها

The Routes API.

ComputeRouteMatrix

rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )

Takes in a list of origins and destinations and returns a stream containing route information for each combination of origin and destination.

NOTE: This method requires that you specify a response field mask in the input. You can provide the response field mask by using the URL parameter $fields or fields , or by using the HTTP/gRPC header X-Goog-FieldMask (see the available URL parameters and headers ). The value is a comma separated list of field paths. See this detailed documentation about how to construct the field paths .

For example, in this method:

  • Field mask of all available fields (for manual inspection): X-Goog-FieldMask: *
  • Field mask of route durations, distances, element status, condition, and element indices (an example production setup): X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

It is critical that you include status in your field mask as otherwise all messages will appear to be OK. Google discourages the use of the wildcard ( * ) response field mask, because:

  • Selecting only the fields that you need helps our server save computation cycles, allowing us to return the result to you with a lower latency.
  • Selecting only the fields that you need in your production job ensures stable latency performance. We might add more response fields in the future, and those new fields might require extra computation time. If you select all fields, or if you select all fields at the top level, then you might experience performance degradation because any new field we add will be automatically included in the response.
  • Selecting only the fields that you need results in a smaller response size, and thus higher network throughput.
ComputeRoutes

rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )

Returns the primary route along with optional alternate routes, given a set of terminal and intermediate waypoints.

NOTE: This method requires that you specify a response field mask in the input. You can provide the response field mask by using URL parameter $fields or fields , or by using an HTTP/gRPC header X-Goog-FieldMask (see the available URL parameters and headers ). The value is a comma separated list of field paths. See detailed documentation about how to construct the field paths .

For example, in this method:

  • Field mask of all available fields (for manual inspection): X-Goog-FieldMask: *
  • Field mask of Route-level duration, distance, and polyline (an example production setup): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google discourage the use of the wildcard ( * ) response field mask, or specifying the field mask at the top level ( routes ), because:

  • Selecting only the fields that you need helps our server save computation cycles, allowing us to return the result to you with a lower latency.
  • Selecting only the fields that you need in your production job ensures stable latency performance. We might add more response fields in the future, and those new fields might require extra computation time. If you select all fields, or if you select all fields at the top level, then you might experience performance degradation because any new field we add will be automatically included in the response.
  • Selecting only the fields that you need results in a smaller response size, and thus higher network throughput.

ComputeRouteMatrixRequest

ComputeRouteMatrix request message

فیلدها
origins[]

RouteMatrixOrigin

مورد نیاز. Array of origins, which determines the rows of the response matrix. Several size restrictions apply to the cardinality of origins and destinations:

  • The sum of the number of origins + the number of destinations specified as either place_id or address must be no greater than 50.
  • The product of number of origins × number of destinations must be no greater than 625 in any case.
  • The product of the number of origins × number of destinations must be no greater than 100 if routing_preference is set to TRAFFIC_AWARE_OPTIMAL .
  • The product of the number of origins × number of destinations must be no greater than 100 if travel_mode is set to TRANSIT .
destinations[]

RouteMatrixDestination

مورد نیاز. Array of destinations, which determines the columns of the response matrix.

travel_ mode

RouteTravelMode

اختیاری. Specifies the mode of transportation.

routing_ preference

RoutingPreference

اختیاری. Specifies how to compute the route. The server attempts to use the selected routing preference to compute the route. If the routing preference results in an error or an extra long latency, an error is returned. You can specify this option only when the travel_mode is DRIVE or TWO_WHEELER , otherwise the request fails.

departure_ time

Timestamp

اختیاری. The departure time. If you don't set this value, then this value defaults to the time that you made the request. NOTE: You can only specify a departure_time in the past when RouteTravelMode is set to TRANSIT .

arrival_ time

Timestamp

اختیاری. The arrival time. NOTE: Can only be set when RouteTravelMode is set to TRANSIT . You can specify either departure_time or arrival_time , but not both.

language_ code

string

اختیاری. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see Unicode Locale Identifier . See Language Support for the list of supported languages. When you don't provide this value, the display language is inferred from the location of the first origin.

region_ code

string

اختیاری. The region code, specified as a ccTLD ("top-level domain") two-character value. For more information see Country code top-level domains .

units

Units

اختیاری. Specifies the units of measure for the display fields.

extra_ computations[]

ExtraComputation

اختیاری. A list of extra computations which may be used to complete the request. Note: These extra computations may return extra fields on the response. These extra fields must also be specified in the field mask to be returned in the response.

traffic_ model

TrafficModel

اختیاری. Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the RouteMatrixElement which contains the predicted time in traffic based on historical averages. RoutingPreference to TRAFFIC_AWARE_OPTIMAL and RouteTravelMode to DRIVE . Defaults to BEST_GUESS if traffic is requested and TrafficModel is not specified.

transit_ preferences

TransitPreferences

اختیاری. Specifies preferences that influence the route returned for TRANSIT routes. NOTE: You can only specify a transit_preferences when RouteTravelMode is set to TRANSIT .

ExtraComputation

Extra computations to perform while completing the request.

Enums
EXTRA_COMPUTATION_UNSPECIFIED استفاده نشده است. Requests containing this value will fail.
TOLLS Toll information for the matrix element(s).

ComputeRoutesRequest

ComputeRoutes request message.

فیلدها
origin

Waypoint

مورد نیاز. Origin waypoint.

destination

Waypoint

مورد نیاز. Destination waypoint.

intermediates[]

Waypoint

اختیاری. A set of waypoints along the route (excluding terminal points), for either stopping at or passing by. Up to 25 intermediate waypoints are supported.

travel_ mode

RouteTravelMode

اختیاری. Specifies the mode of transportation.

routing_ preference

RoutingPreference

اختیاری. Specifies how to compute the route. The server attempts to use the selected routing preference to compute the route. If the routing preference results in an error or an extra long latency, then an error is returned. You can specify this option only when the travel_mode is DRIVE or TWO_WHEELER , otherwise the request fails.

polyline_ quality

PolylineQuality

اختیاری. Specifies your preference for the quality of the polyline.

polyline_ encoding

PolylineEncoding

اختیاری. Specifies the preferred encoding for the polyline.

departure_ time

Timestamp

اختیاری. The departure time. If you don't set this value, then this value defaults to the time that you made the request. NOTE: You can only specify a departure_time in the past when RouteTravelMode is set to TRANSIT . Transit trips are available for up to 7 days in the past or 100 days in the future.

arrival_ time

Timestamp

اختیاری. The arrival time. NOTE: Can only be set when RouteTravelMode is set to TRANSIT . You can specify either departure_time or arrival_time , but not both. Transit trips are available for up to 7 days in the past or 100 days in the future.

compute_ alternative_ routes

bool

اختیاری. Specifies whether to calculate alternate routes in addition to the route. No alternative routes are returned for requests that have intermediate waypoints.

route_ modifiers

RouteModifiers

اختیاری. A set of conditions to satisfy that affect the way routes are calculated.

language_ code

string

اختیاری. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see Unicode Locale Identifier . See Language Support for the list of supported languages. When you don't provide this value, the display language is inferred from the location of the route request.

region_ code

string

اختیاری. The region code, specified as a ccTLD ("top-level domain") two-character value. For more information see Country code top-level domains .

units

Units

اختیاری. Specifies the units of measure for the display fields. These fields include the instruction field in NavigationInstruction . The units of measure used for the route, leg, step distance, and duration are not affected by this value. If you don't provide this value, then the display units are inferred from the location of the first origin.

optimize_ waypoint_ order

bool

اختیاری. If set to true, the service attempts to minimize the overall cost of the route by re-ordering the specified intermediate waypoints. The request fails if any of the intermediate waypoints is a via waypoint. Use ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index to find the new ordering. If ComputeRoutesResponseroutes.optimized_intermediate_waypoint_index is not requested in the X-Goog-FieldMask header, the request fails. If optimize_waypoint_order is set to false, ComputeRoutesResponse.optimized_intermediate_waypoint_index will be empty.

requested_ reference_ routes[]

ReferenceRoute

اختیاری. Specifies what reference routes to calculate as part of the request in addition to the default route. A reference route is a route with a different route calculation objective than the default route. For example a FUEL_EFFICIENT reference route calculation takes into account various parameters that would generate an optimal fuel efficient route. When using this feature, look for route_labels on the resulting routes.

extra_ computations[]

ExtraComputation

اختیاری. A list of extra computations which may be used to complete the request. Note: These extra computations may return extra fields on the response. These extra fields must also be specified in the field mask to be returned in the response.

traffic_ model

TrafficModel

اختیاری. Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the Route and RouteLeg which contains the predicted time in traffic based on historical averages. TrafficModel is only available for requests that have set RoutingPreference to TRAFFIC_AWARE_OPTIMAL and RouteTravelMode to DRIVE . Defaults to BEST_GUESS if traffic is requested and TrafficModel is not specified.

transit_ preferences

TransitPreferences

اختیاری. Specifies preferences that influence the route returned for TRANSIT routes. NOTE: You can only specify a transit_preferences when RouteTravelMode is set to TRANSIT .

ExtraComputation

Extra computations to perform while completing the request.

Enums
EXTRA_COMPUTATION_UNSPECIFIED استفاده نشده است. Requests containing this value will fail.
TOLLS Toll information for the route(s).
FUEL_CONSUMPTION Estimated fuel consumption for the route(s).
TRAFFIC_ON_POLYLINE Traffic aware polylines for the route(s).
HTML_FORMATTED_NAVIGATION_INSTRUCTIONS NavigationInstructions presented as a formatted HTML text string. This content is meant to be read as-is. This content is for display only. Do not programmatically parse it.
FLYOVER_INFO_ON_POLYLINE Flyover information for the route(s). The routes.polyline_details.flyover_info fieldmask must be specified to return this information. This data will only currently be populated for certain metros in India. This feature is experimental, and the SKU/charge is subject to change.
NARROW_ROAD_INFO_ON_POLYLINE Narrow road information for the route(s). The routes.polyline_details.narrow_road_info fieldmask must be specified to return this information. This data will only currently be populated for certain metros in India. This feature is experimental, and the SKU/charge is subject to change.

ReferenceRoute

A supported reference route on the ComputeRoutesRequest.

Enums
REFERENCE_ROUTE_UNSPECIFIED استفاده نشده است. Requests containing this value fail.
FUEL_EFFICIENT Fuel efficient route.
SHORTER_DISTANCE

Route with shorter travel distance. این یک ویژگی آزمایشی است.

For DRIVE requests, this feature prioritizes shorter distance over driving comfort. For example, it may prefer local roads instead of highways, take dirt roads, cut through parking lots, etc. This feature does not return any maneuvers that Google Maps knows to be illegal.

For BICYCLE and TWO_WHEELER requests, this feature returns routes similar to those returned when you don't specify requested_reference_routes .

This feature is not compatible with any other travel modes, via intermediate waypoints, or optimize_waypoint_order ; such requests will fail. However, you can use it with any routing_preference .

ComputeRoutesResponse

ComputeRoutes the response message.

فیلدها
routes[]

Route

Contains an array of computed routes (up to three) when you specify compute_alternatives_routes , and contains just one route when you don't. When this array contains multiple entries, the first one is the most recommended route. If the array is empty, then it means no route could be found.

fallback_ info

FallbackInfo

In some cases when the server is not able to compute the route results with all of the input preferences, it may fallback to using a different way of computation. When fallback mode is used, this field contains detailed info about the fallback response. Otherwise this field is unset.

geocoding_ results

GeocodingResults

Contains geocoding response info for waypoints specified as addresses.

FallbackInfo

Information related to how and why a fallback result was used. If this field is set, then it means the server used a different routing mode from your preferred mode as fallback.

فیلدها
routing_ mode

FallbackRoutingMode

Routing mode used for the response. If fallback was triggered, the mode may be different from routing preference set in the original client request.

reason

FallbackReason

The reason why fallback response was used instead of the original response. This field is only populated when the fallback mode is triggered and the fallback response is returned.

FallbackReason

Reasons for using fallback response.

Enums
FALLBACK_REASON_UNSPECIFIED No fallback reason specified.
SERVER_ERROR A server error happened while calculating routes with your preferred routing mode, but we were able to return a result calculated by an alternative mode.
LATENCY_EXCEEDED We were not able to finish the calculation with your preferred routing mode on time, but we were able to return a result calculated by an alternative mode.

FallbackRoutingMode

Actual routing mode used for returned fallback response.

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED استفاده نشده است.
FALLBACK_TRAFFIC_UNAWARE Indicates the TRAFFIC_UNAWARE RoutingPreference was used to compute the response.
FALLBACK_TRAFFIC_AWARE Indicates the TRAFFIC_AWARE RoutingPreference was used to compute the response.

GeocodedWaypoint

Details about the locations used as waypoints. Only populated for address waypoints. Includes details about the geocoding results for the purposes of determining what the address was geocoded to.

فیلدها
geocoder_ status

Status

Indicates the status code resulting from the geocoding operation.

type[]

string

The type(s) of the result, in the form of zero or more type tags. Supported types: Address types and address component types .

partial_ match

bool

Indicates that the geocoder did not return an exact match for the original request, though it was able to match part of the requested address. You may wish to examine the original request for misspellings and/or an incomplete address.

place_ id

string

The place ID for this result.

intermediate_ waypoint_ request_ index

int32

The index of the corresponding intermediate waypoint in the request. Only populated if the corresponding waypoint is an intermediate waypoint.

GeocodingResults

Contains GeocodedWaypoints for origin, destination and intermediate waypoints. Only populated for address waypoints.

فیلدها
origin

GeocodedWaypoint

Origin geocoded waypoint.

destination

GeocodedWaypoint

Destination geocoded waypoint.

intermediates[]

GeocodedWaypoint

A list of intermediate geocoded waypoints each containing an index field that corresponds to the zero-based position of the waypoint in the order they were specified in the request.

LocalizedTime

Localized description of time.

فیلدها
time

LocalizedText

The time specified as a string in a given time zone.

time_ zone

string

Contains the time zone. The value is the name of the time zone as defined in the IANA Time Zone Database , eg "America/New_York".

مکان

Encapsulates a location (a geographic point, and an optional heading).

فیلدها
lat_ lng

LatLng

The waypoint's geographic coordinates.

heading

Int32Value

The compass heading associated with the direction of the flow of traffic. This value specifies the side of the road for pickup and drop-off. Heading values can be from 0 to 360, where 0 specifies a heading of due North, 90 specifies a heading of due East, and so on. You can use this field only for DRIVE and TWO_WHEELER RouteTravelMode .

مانور

A set of values that specify the navigation action to take for the current step (for example, turn left, merge, or straight).

Enums
MANEUVER_UNSPECIFIED استفاده نشده است.
TURN_SLIGHT_LEFT Turn slightly to the left.
TURN_SHARP_LEFT Turn sharply to the left.
UTURN_LEFT Make a left u-turn.
TURN_LEFT به چپ بپیچید.
TURN_SLIGHT_RIGHT Turn slightly to the right.
TURN_SHARP_RIGHT Turn sharply to the right.
UTURN_RIGHT Make a right u-turn.
TURN_RIGHT به راست بپیچید.
STRAIGHT Go straight.
RAMP_LEFT Take the left ramp.
RAMP_RIGHT Take the right ramp.
MERGE Merge into traffic.
FORK_LEFT Take the left fork.
FORK_RIGHT Take the right fork.
FERRY Take the ferry.
FERRY_TRAIN Take the train leading onto the ferry.
ROUNDABOUT_LEFT Turn left at the roundabout.
ROUNDABOUT_RIGHT Turn right at the roundabout.
DEPART Initial maneuver.
NAME_CHANGE Used to indicate a street name change.

Encapsulates navigation instructions for a RouteLegStep .

فیلدها
maneuver

Maneuver

Encapsulates the navigation instructions for the current step (for example, turn left, merge, or straight). This field determines which icon to display.

instructions

string

Instructions for navigating this step.

پلی لاین

Encapsulates an encoded polyline.

فیلدها
Union field polyline_type . Encapsulates the type of polyline. Defaults to encoded_polyline. polyline_type can be only one of the following:
encoded_ polyline

string

The string encoding of the polyline using the polyline encoding algorithm

geo_ json_ linestring

Struct

Specifies a polyline using the GeoJSON LineString format .

PolylineDetails

Details corresponding to a given index or contiguous segment of a polyline. Given a polyline with points P_0, P_1, ... , P_N (zero-based index), the PolylineDetails defines an interval and associated metadata.

فیلدها
flyover_ info[]

FlyoverInfo

Flyover details along the polyline.

narrow_ road_ info[]

NarrowRoadInfo

Narrow road details along the polyline.

FlyoverInfo

Encapsulates information about flyovers along the polyline.

فیلدها
flyover_ presence

RoadFeatureState

فقط خروجی Denotes whether a flyover exists for a given stretch of the polyline.

polyline_ point_ index

PolylinePointIndex

The location of flyover related information along the polyline.

NarrowRoadInfo

Encapsulates information about narrow roads along the polyline.

فیلدها
narrow_ road_ presence

RoadFeatureState

فقط خروجی Denotes whether a narrow road exists for a given stretch of the polyline.

polyline_ point_ index

PolylinePointIndex

The location of narrow road related information along the polyline.

PolylinePointIndex

Encapsulates the start and end indexes for a polyline detail. For instances where the data corresponds to a single point, start_index and end_index will be equal.

فیلدها
start_ index

int32

The start index of this detail in the polyline.

end_ index

int32

The end index of this detail in the polyline.

RoadFeatureState

Encapsulates the states of road features along a stretch of polyline.

Enums
ROAD_FEATURE_STATE_UNSPECIFIED The road feature's state was not computed (default value).
EXISTS The road feature exists.
DOES_NOT_EXIST The road feature does not exist.

PolylineEncoding

Specifies the preferred type of polyline to be returned.

Enums
POLYLINE_ENCODING_UNSPECIFIED No polyline type preference specified. Defaults to ENCODED_POLYLINE .
ENCODED_POLYLINE Specifies a polyline encoded using the polyline encoding algorithm .
GEO_JSON_LINESTRING Specifies a polyline using the GeoJSON LineString format

PolylineQuality

A set of values that specify the quality of the polyline.

Enums
POLYLINE_QUALITY_UNSPECIFIED No polyline quality preference specified. Defaults to OVERVIEW .
HIGH_QUALITY Specifies a high-quality polyline - which is composed using more points than OVERVIEW , at the cost of increased response size. Use this value when you need more precision.
OVERVIEW Specifies an overview polyline - which is composed using a small number of points. Use this value when displaying an overview of the route. Using this option has a lower request latency compared to using the HIGH_QUALITY option.

مسیر

Contains a route, which consists of a series of connected road segments that join beginning, ending, and intermediate waypoints.

فیلدها
route_ labels[]

RouteLabel

Labels for the Route that are useful to identify specific properties of the route to compare against others.

legs[]

RouteLeg

A collection of legs (path segments between waypoints) that make up the route. Each leg corresponds to the trip between two non- via Waypoints . For example, a route with no intermediate waypoints has only one leg. A route that includes one non- via intermediate waypoint has two legs. A route that includes one via intermediate waypoint has one leg. The order of the legs matches the order of waypoints from origin to intermediates to destination .

distance_ meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of travel through the route without taking traffic conditions into consideration.

polyline

Polyline

The overall route polyline. This polyline is the combined polyline of all legs .

description

string

A description of the route.

warnings[]

string

An array of warnings to show when displaying the route.

viewport

Viewport

The viewport bounding box of the polyline.

travel_ advisory

RouteTravelAdvisory

Additional information about the route.

optimized_ intermediate_ waypoint_ index[]

int32

If you set optimize_waypoint_order to true, this field contains the optimized ordering of intermediate waypoints. Otherwise, this field is empty. For example, if you give an input of Origin: LA; Intermediate waypoints: Dallas, Bangor, Phoenix; Destination: New York; and the optimized intermediate waypoint order is Phoenix, Dallas, Bangor, then this field contains the values [2, 0, 1]. The index starts with 0 for the first intermediate waypoint provided in the input.

localized_ values

RouteLocalizedValues

Text representations of properties of the Route .

route_ token

string

An opaque token that can be passed to Navigation SDK to reconstruct the route during navigation, and, in the event of rerouting, honor the original intention when the route was created. Treat this token as an opaque blob. Don't compare its value across requests as its value may change even if the service returns the exact same route.

NOTE: Route.route_token is only available for requests that have set ComputeRoutesRequest.routing_preference to TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL . Route.route_token is not supported for requests that have Via waypoints.

polyline_ details

PolylineDetails

Contains information about details along the polyline.

RouteLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration, represented in text form and localized to the region of the query. Takes traffic conditions into consideration. Note: If you did not request traffic information, this value is the same value as static_duration .

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

transit_ fare

LocalizedText

Transit fare represented in text form.

RouteLabel

Labels for the Route that are useful to identify specific properties of the route to compare against others.

Enums
ROUTE_LABEL_UNSPECIFIED Default - not used.
DEFAULT_ROUTE The default "best" route returned for the route computation.
DEFAULT_ROUTE_ALTERNATE An alternative to the default "best" route. Routes like this will be returned when compute_alternative_routes is specified.
FUEL_EFFICIENT Fuel efficient route. Routes labeled with this value are determined to be optimized for Eco parameters such as fuel consumption.
SHORTER_DISTANCE Shorter travel distance route. این یک ویژگی آزمایشی است.

RouteLeg

Contains a segment between non- via waypoints.

فیلدها
distance_ meters

int32

The travel distance of the route leg, in meters.

duration

Duration

The length of time needed to navigate the leg. If the route_preference is set to TRAFFIC_UNAWARE , then this value is the same as static_duration . If the route_preference is either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of travel through the leg, calculated without taking traffic conditions into consideration.

polyline

Polyline

The overall polyline for this leg that includes each step 's polyline.

start_ location

Location

The start location of this leg. This location might be different from the provided origin . For example, when the provided origin is not near a road, this is a point on the road.

end_ location

Location

The end location of this leg. This location might be different from the provided destination . For example, when the provided destination is not near a road, this is a point on the road.

steps[]

RouteLegStep

An array of steps denoting segments within this leg. Each step represents one navigation instruction.

travel_ advisory

RouteLegTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions, on a route leg.

localized_ values

RouteLegLocalizedValues

Text representations of properties of the RouteLeg .

steps_ overview

StepsOverview

Overview information about the steps in this RouteLeg . This field is only populated for TRANSIT routes.

RouteLegLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration, represented in text form and localized to the region of the query. Takes traffic conditions into consideration. Note: If you did not request traffic information, this value is the same value as static_duration.

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

StepsOverview

Provides overview information about a list of RouteLegStep s.

فیلدها
multi_ modal_ segments[]

MultiModalSegment

Summarized information about different multi-modal segments of the RouteLeg.steps . This field is not populated if the RouteLeg does not contain any multi-modal segments in the steps.

MultiModalSegment

Provides summarized information about different multi-modal segments of the RouteLeg.steps . A multi-modal segment is defined as one or more contiguous RouteLegStep that have the same RouteTravelMode . This field is not populated if the RouteLeg does not contain any multi-modal segments in the steps.

فیلدها
navigation_ instruction

NavigationInstruction

NavigationInstruction for the multi-modal segment.

travel_ mode

RouteTravelMode

The travel mode of the multi-modal segment.

step_ start_ index

int32

The corresponding RouteLegStep index that is the start of a multi-modal segment.

step_ end_ index

int32

The corresponding RouteLegStep index that is the end of a multi-modal segment.

RouteLegStep

Contains a segment of a RouteLeg . A step corresponds to a single navigation instruction. Route legs are made up of steps.

فیلدها
distance_ meters

int32

The travel distance of this step, in meters. In some circumstances, this field might not have a value.

static_ duration

Duration

The duration of travel through this step without taking traffic conditions into consideration. In some circumstances, this field might not have a value.

polyline

Polyline

The polyline associated with this step.

start_ location

Location

The start location of this step.

end_ location

Location

The end location of this step.

navigation_ instruction

NavigationInstruction

Navigation instructions.

travel_ advisory

RouteLegStepTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions, on a leg step.

localized_ values

RouteLegStepLocalizedValues

Text representations of properties of the RouteLegStep .

transit_ details

RouteLegStepTransitDetails

Details pertaining to this step if the travel mode is TRANSIT .

travel_ mode

RouteTravelMode

The travel mode used for this step.

RouteLegStepLocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

static_ duration

LocalizedText

Duration without taking traffic conditions into consideration, represented in text form.

RouteLegStepTransitDetails

Additional information for the RouteLegStep related to TRANSIT routes.

فیلدها
stop_ details

TransitStopDetails

Information about the arrival and departure stops for the step.

localized_ values

TransitDetailsLocalizedValues

Text representations of properties of the RouteLegStepTransitDetails .

headsign

string

Specifies the direction in which to travel on this line as marked on the vehicle or at the departure stop. The direction is often the terminus station.

headway

Duration

Specifies the expected time as a duration between departures from the same stop at this time. For example, with a headway seconds value of 600, you would expect a ten minute wait if you should miss your bus.

transit_ line

TransitLine

Information about the transit line used in this step.

stop_ count

int32

The number of stops from the departure to the arrival stop. This count includes the arrival stop, but excludes the departure stop. For example, if your route leaves from Stop A, passes through stops B and C, and arrives at stop D,

stop_count

برمی گرداند 3.

trip_ short_ text

string

The text that appears in schedules and sign boards to identify a transit trip to passengers. The text should uniquely identify a trip within a service day. For example, "538" is the trip_short_text of the Amtrak train that leaves San Jose, CA at 15:10 on weekdays to Sacramento, CA.

TransitDetailsLocalizedValues

Localized descriptions of values for RouteTransitDetails .

فیلدها
arrival_ time

LocalizedTime

Time in its formatted text representation with a corresponding time zone.

departure_ time

LocalizedTime

Time in its formatted text representation with a corresponding time zone.

TransitStopDetails

Details about the transit stops for the RouteLegStep .

فیلدها
arrival_ stop

TransitStop

Information about the arrival stop for the step.

arrival_ time

Timestamp

The estimated time of arrival for the step.

departure_ stop

TransitStop

Information about the departure stop for the step.

departure_ time

Timestamp

The estimated time of departure for the step.

RouteLegStepTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions on a leg step.

فیلدها
speed_ reading_ intervals[]

SpeedReadingInterval

NOTE: This field is not currently populated.

RouteLegTravelAdvisory

Contains the additional information that the user should be informed about on a leg step, such as possible traffic zone restrictions.

فیلدها
toll_ info

TollInfo

Contains information about tolls on the specific RouteLeg . This field is only populated if we expect there are tolls on the RouteLeg . If this field is set but the estimated_price subfield is not populated, we expect that road contains tolls but we do not know an estimated price. If this field does not exist, then there is no toll on the RouteLeg .

speed_ reading_ intervals[]

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the RouteLeg without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

مثال:

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

RouteMatrixDestination

A single destination for ComputeRouteMatrixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. Destination waypoint

RouteMatrixElement

Contains route information computed for an origin/destination pair in the ComputeRouteMatrix API. This proto can be streamed to the client.

فیلدها
status

Status

Error status code for this element.

condition

RouteMatrixElementCondition

Indicates whether the route was found or not. Independent of status.

distance_ meters

int32

The travel distance of the route, in meters.

duration

Duration

The length of time needed to navigate the route. If you set the routing_preference to TRAFFIC_UNAWARE , then this value is the same as static_duration . If you set the routing_preference to either TRAFFIC_AWARE or TRAFFIC_AWARE_OPTIMAL , then this value is calculated taking traffic conditions into account.

static_ duration

Duration

The duration of traveling through the route without taking traffic conditions into consideration.

travel_ advisory

RouteTravelAdvisory

Additional information about the route. For example: restriction information and toll information

fallback_ info

FallbackInfo

In some cases when the server is not able to compute the route with the given preferences for this particular origin/destination pair, it may fall back to using a different mode of computation. When fallback mode is used, this field contains detailed information about the fallback response. Otherwise this field is unset.

localized_ values

LocalizedValues

Text representations of properties of the RouteMatrixElement .

origin_ index

int32

Zero-based index of the origin in the request.

destination_ index

int32

Zero-based index of the destination in the request.

LocalizedValues

Text representations of certain properties.

فیلدها
distance

LocalizedText

Travel distance represented in text form.

duration

LocalizedText

Duration represented in text form taking traffic conditions into consideration. Note: If traffic information was not requested, this value is the same value as static_duration.

static_ duration

LocalizedText

Duration represented in text form without taking traffic conditions into consideration.

transit_ fare

LocalizedText

Transit fare represented in text form.

RouteMatrixElementCondition

The condition of the route being returned.

Enums
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED Only used when the status of the element is not OK.
ROUTE_EXISTS A route was found, and the corresponding information was filled out for the element.
ROUTE_NOT_FOUND No route could be found. Fields containing route information, such as distance_meters or duration , will not be filled out in the element.

RouteMatrixOrigin

A single origin for ComputeRouteMatrixRequest

فیلدها
waypoint

Waypoint

مورد نیاز. Origin waypoint

route_ modifiers

RouteModifiers

اختیاری. Modifiers for every route that takes this as the origin

RouteModifiers

Encapsulates a set of optional conditions to satisfy when calculating the routes.

فیلدها
avoid_ tolls

bool

When set to true, avoids toll roads where reasonable, giving preference to routes not containing toll roads. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ highways

bool

When set to true, avoids highways where reasonable, giving preference to routes not containing highways. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ ferries

bool

When set to true, avoids ferries where reasonable, giving preference to routes not containing ferries. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

avoid_ indoor

bool

When set to true, avoids navigating indoors where reasonable, giving preference to routes not containing indoor navigation. Applies only to the WALK RouteTravelMode .

vehicle_ info

VehicleInfo

Specifies the vehicle information.

toll_ passes[]

TollPass

Encapsulates information about toll passes. If toll passes are provided, the API tries to return the pass price. If toll passes are not provided, the API treats the toll pass as unknown and tries to return the cash price. Applies only to the DRIVE and TWO_WHEELER RouteTravelMode .

RouteTravelAdvisory

Contains the additional information that the user should be informed about, such as possible traffic zone restrictions.

فیلدها
toll_ info

TollInfo

Contains information about tolls on the route. This field is only populated if tolls are expected on the route. If this field is set, but the estimatedPrice subfield is not populated, then the route contains tolls, but the estimated price is unknown. If this field is not set, then there are no tolls expected on the route.

speed_ reading_ intervals[]

SpeedReadingInterval

Speed reading intervals detailing traffic density. Applicable in case of TRAFFIC_AWARE and TRAFFIC_AWARE_OPTIMAL routing preferences. The intervals cover the entire polyline of the route without overlap. The start point of a specified interval is the same as the end point of the preceding interval.

مثال:

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

int64

The predicted fuel consumption in microliters.

route_ restrictions_ partially_ ignored

bool

Returned route may have restrictions that are not suitable for requested travel mode or route modifiers.

transit_ fare

Money

If present, contains the total fare or ticket costs on this route This property is only returned for TRANSIT requests and only for routes where fare information is available for all transit steps.

RouteTravelMode

A set of values used to specify the mode of travel. NOTE: WALK , BICYCLE , and TWO_WHEELER routes are in beta and might sometimes be missing clear sidewalks, pedestrian paths, or bicycling paths. You must display this warning to the user for all walking, bicycling, and two-wheel routes that you display in your app.

Enums
TRAVEL_MODE_UNSPECIFIED No travel mode specified. Defaults to DRIVE .
DRIVE Travel by passenger car.
BICYCLE Travel by bicycle.
WALK Travel by walking.
TWO_WHEELER Two-wheeled, motorized vehicle. For example, motorcycle. Note that this differs from the BICYCLE travel mode which covers human-powered mode.
TRANSIT Travel by public transit routes, where available.

RoutingPreference

A set of values that specify factors to take into consideration when calculating the route.

Enums
ROUTING_PREFERENCE_UNSPECIFIED No routing preference specified. Default to TRAFFIC_UNAWARE .
TRAFFIC_UNAWARE Computes routes without taking live traffic conditions into consideration. Suitable when traffic conditions don't matter or are not applicable. Using this value produces the lowest latency. Note: For RouteTravelMode DRIVE and TWO_WHEELER , the route and duration chosen are based on road network and average time-independent traffic conditions, not current road conditions. Consequently, routes may include roads that are temporarily closed. Results for a given request may vary over time due to changes in the road network, updated average traffic conditions, and the distributed nature of the service. Results may also vary between nearly-equivalent routes at any time or frequency.
TRAFFIC_AWARE Calculates routes taking live traffic conditions into consideration. In contrast to TRAFFIC_AWARE_OPTIMAL , some optimizations are applied to significantly reduce latency.
TRAFFIC_AWARE_OPTIMAL Calculates the routes taking live traffic conditions into consideration, without applying most performance optimizations. Using this value produces the highest latency.

SpeedReadingInterval

Traffic density indicator on a contiguous segment of a polyline or path. Given a path with points P_0, P_1, ... , P_N (zero-based index), the SpeedReadingInterval defines an interval and describes its traffic using the following categories.

فیلدها
start_ polyline_ point_ index

int32

The starting index of this interval in the polyline.

end_ polyline_ point_ index

int32

The ending index of this interval in the polyline.

Union field speed_type .

speed_type can be only one of the following:

speed

Speed

Traffic speed in this interval.

سرعت

The classification of polyline speed based on traffic data.

Enums
SPEED_UNSPECIFIED مقدار پیش فرض This value is unused.
NORMAL Normal speed, no slowdown is detected.
SLOW Slowdown detected, but no traffic jam formed.
TRAFFIC_JAM Traffic jam detected.

TollInfo

Encapsulates toll information on a Route or on a RouteLeg .

فیلدها
estimated_ price[]

Money

The monetary amount of tolls for the corresponding Route or RouteLeg . This list contains a money amount for each currency that is expected to be charged by the toll stations. Typically this list will contain only one item for routes with tolls in one currency. For international trips, this list may contain multiple items to reflect tolls in different currencies.

TollPass

List of toll passes around the world that we support.

Enums
TOLL_PASS_UNSPECIFIED استفاده نشده است. If this value is used, then the request fails.
AU_ETOLL_TAG Sydney toll pass. See additional details at https://www.myetoll.com.au .
AU_EWAY_TAG Sydney toll pass. See additional details at https://www.tollpay.com.au .
AU_LINKT Australia-wide toll pass. See additional details at https://www.linkt.com.au/ .
AR_TELEPASE Argentina toll pass. See additional details at https://telepase.com.ar
BR_AUTO_EXPRESO Brazil toll pass. See additional details at https://www.autoexpreso.com
BR_CONECTCAR Brazil toll pass. See additional details at https://conectcar.com .
BR_MOVE_MAIS Brazil toll pass. See additional details at https://movemais.com .
BR_PASSA_RAPIDO Brazil toll pass. See additional details at https://pasorapido.gob.do/
BR_SEM_PARAR Brazil toll pass. See additional details at https://www.semparar.com.br .
BR_TAGGY Brazil toll pass. See additional details at https://taggy.com.br .
BR_VELOE Brazil toll pass. See additional details at https://veloe.com.br/site/onde-usar .
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD Canada to United States border crossing.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD Canada to United States border crossing.
CA_US_BLUE_WATER_EDGE_PASS Ontario, Canada to Michigan, United States border crossing.
CA_US_CONNEXION Ontario, Canada to Michigan, United States border crossing.
CA_US_NEXUS_CARD Canada to United States border crossing.
ID_E_TOLL اندونزی. E-card provided by multiple banks used to pay for tolls. All e-cards via banks are charged the same so only one enum value is needed. Eg - 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 India, HP state plate exemption.
JP_ETC Japan ETC. Electronic wireless system to collect tolls. https://www.go-etc.jp/
JP_ETC2 Japan ETC2.0. New version of ETC with further discount and bidirectional communication between devices on vehicles and antennas on the road. https://www.go-etc.jp/etc2/index.html
MX_IAVE Mexico toll pass. https://iave.capufe.gob.mx/#/
MX_PASE Mexico https://www.pase.com.mx
MX_QUICKPASS Mexico 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 Mexico toll pass company. One of many operating in Mexico City. See additional details at https://www.televia.com.mx .
MX_TELEVIA Mexico toll pass company. One of many operating in Mexico City. https://www.televia.com.mx
MX_VIAPASS Mexico toll pass. See additional details at https://www.viapass.com.mx/viapass/web_home.aspx .
US_AL_FREEDOM_PASS AL, USA.
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK, USA.
US_CA_FASTRAK کالیفرنیا، ایالات متحده آمریکا
US_CA_FASTRAK_CAV_STICKER Indicates driver has any FasTrak pass in addition to the DMV issued Clean Air Vehicle (CAV) sticker. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO, USA.
US_CO_GO_PASS CO, USA.
US_DE_EZPASSDE DE, USA.
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL، ایالات متحده آمریکا
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL، ایالات متحده آمریکا
US_FL_EPASS FL، ایالات متحده آمریکا
US_FL_GIBA_TOLL_PASS FL، ایالات متحده آمریکا
US_FL_LEEWAY FL، ایالات متحده آمریکا
US_FL_SUNPASS FL، ایالات متحده آمریکا
US_FL_SUNPASS_PRO FL، ایالات متحده آمریکا
US_IL_EZPASSIL IL، ایالات متحده آمریکا
US_IL_IPASS IL، ایالات متحده آمریکا
US_IN_EZPASSIN IN, USA.
US_KS_BESTPASS_HORIZON KS, USA.
US_KS_KTAG KS, USA.
US_KS_NATIONALPASS KS, USA.
US_KS_PREPASS_ELITEPASS KS, USA.
US_LA_GEAUXPASS لس آنجلس، ایالات متحده آمریکا
US_LA_TOLL_TAG لس آنجلس، ایالات متحده آمریکا
US_MA_EZPASSMA MA, USA.
US_MD_EZPASSMD MD, USA.
US_ME_EZPASSME ME, USA.
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI, USA.
US_MI_BCPASS MI, USA.
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI, USA.
US_MI_IQ_PROX_CARD

MI, USA. Deprecated as this pass type no longer exists.

US_MI_IQ_TAG MI, USA.
US_MI_MACKINAC_BRIDGE_MAC_PASS MI, USA.
US_MI_NEXPRESS_TOLL MI, USA.
US_MN_EZPASSMN MN, USA.
US_NC_EZPASSNC NC, USA.
US_NC_PEACH_PASS NC, USA.
US_NC_QUICK_PASS NC, USA.
US_NH_EZPASSNH NH, USA.
US_NJ_DOWNBEACH_EXPRESS_PASS نیوجرسی، ایالات متحده آمریکا
US_NJ_EZPASSNJ نیوجرسی، ایالات متحده آمریکا
US_NY_EXPRESSPASS نیویورک، ایالات متحده آمریکا
US_NY_EZPASSNY نیویورک، ایالات متحده آمریکا
US_OH_EZPASSOH OH, USA.
US_PA_EZPASSPA PA, USA.
US_RI_EZPASSRI RI, USA.
US_SC_PALPASS SC, USA.
US_TX_AVI_TAG TX, USA.
US_TX_BANCPASS TX, USA.
US_TX_DEL_RIO_PASS TX, USA.
US_TX_EFAST_PASS TX, USA.
US_TX_EAGLE_PASS_EXPRESS_CARD TX, USA.
US_TX_EPTOLL TX, USA.
US_TX_EZ_CROSS TX, USA.
US_TX_EZTAG TX, USA.
US_TX_FUEGO_TAG TX, USA.
US_TX_LAREDO_TRADE_TAG TX, USA.
US_TX_PLUSPASS TX, USA.
US_TX_TOLLTAG TX, USA.
US_TX_TXTAG TX, USA.
US_TX_XPRESS_CARD TX, USA.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT, USA.
US_VA_EZPASSVA VA, USA.
US_WA_BREEZEBY WA, USA.
US_WA_GOOD_TO_GO WA, USA.
US_WV_EZPASSWV WV, USA.
US_WV_MEMORIAL_BRIDGE_TICKETS WV, USA.
US_WV_MOV_PASS WV, USA
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV, USA.

TrafficModel

Specifies the assumptions to use when calculating time in traffic. This setting affects the value returned in the duration field in the response, which contains the predicted time in traffic based on historical averages.

Enums
TRAFFIC_MODEL_UNSPECIFIED استفاده نشده If specified, will default to BEST_GUESS .
BEST_GUESS Indicates that the returned duration should be the best estimate of travel time given what is known about both historical traffic conditions and live traffic. Live traffic becomes more important the closer the departure_time is to now.
PESSIMISTIC Indicates that the returned duration should be longer than the actual travel time on most days, though occasional days with particularly bad traffic conditions may exceed this value.
OPTIMISTIC Indicates that the returned duration should be shorter than the actual travel time on most days, though occasional days with particularly good traffic conditions may be faster than this value.

TransitAgency

A transit agency that operates a transit line.

فیلدها
name

string

The name of this transit agency.

phone_ number

string

The transit agency's locale-specific formatted phone number.

uri

string

The transit agency's URI.

TransitLine

Contains information about the transit line used in this step.

فیلدها
agencies[]

TransitAgency

The transit agency (or agencies) that operates this transit line.

name

string

The full name of this transit line, For example, "8 Avenue Local".

uri

string

the URI for this transit line as provided by the transit agency.

color

string

The color commonly used in signage for this line. Represented in hexadecimal.

icon_ uri

string

The URI for the icon associated with this line.

name_ short

string

The short name of this transit line. This name will normally be a line number, such as "M7" or "355".

text_ color

string

The color commonly used in text on signage for this line. Represented in hexadecimal.

vehicle

TransitVehicle

The type of vehicle that operates on this transit line.

TransitPreferences

Preferences for TRANSIT based routes that influence the route that is returned.

فیلدها
allowed_ travel_ modes[]

TransitTravelMode

A set of travel modes to use when getting a TRANSIT route. Defaults to all supported modes of travel.

routing_ preference

TransitRoutingPreference

A routing preference that, when specified, influences the TRANSIT route returned.

TransitRoutingPreference

Specifies routing preferences for transit routes.

Enums
TRANSIT_ROUTING_PREFERENCE_UNSPECIFIED No preference specified.
LESS_WALKING Indicates that the calculated route should prefer limited amounts of walking.
FEWER_TRANSFERS Indicates that the calculated route should prefer a limited number of transfers.

TransitTravelMode

A set of values used to specify the mode of transit.

Enums
TRANSIT_TRAVEL_MODE_UNSPECIFIED No transit travel mode specified.
BUS Travel by bus.
SUBWAY Travel by subway.
TRAIN Travel by train.
LIGHT_RAIL Travel by light rail or tram.
RAIL Travel by rail. This is equivalent to a combination of SUBWAY , TRAIN , and LIGHT_RAIL .

TransitStop

Information about a transit stop.

فیلدها
name

string

The name of the transit stop.

location

Location

The location of the stop expressed in latitude/longitude coordinates.

TransitVehicle

Information about a vehicle used in transit routes.

فیلدها
name

LocalizedText

The name of this vehicle, capitalized.

type

TransitVehicleType

The type of vehicle used.

icon_ uri

string

The URI for an icon associated with this vehicle type.

local_ icon_ uri

string

The URI for the icon associated with this vehicle type, based on the local transport signage.

TransitVehicleType

The type of vehicles for transit routes.

Enums
TRANSIT_VEHICLE_TYPE_UNSPECIFIED استفاده نشده
BUS اتوبوس
CABLE_CAR A vehicle that operates on a cable, usually on the ground. Aerial cable cars may be of the type GONDOLA_LIFT .
COMMUTER_TRAIN Commuter rail.
FERRY فری
FUNICULAR A vehicle that is pulled up a steep incline by a cable. A Funicular typically consists of two cars, with each car acting as a counterweight for the other.
GONDOLA_LIFT An aerial cable car.
HEAVY_RAIL ریل سنگین
HIGH_SPEED_TRAIN قطار پر سرعت.
INTERCITY_BUS Intercity bus.
LONG_DISTANCE_TRAIN Long distance train.
METRO_RAIL Light rail transit.
MONORAIL مونوریل.
OTHER All other vehicles.
RAIL راه آهن.
SHARE_TAXI Share taxi is a kind of bus with the ability to drop off and pick up passengers anywhere on its route.
SUBWAY Underground light rail.
TRAM Above ground light rail.
TROLLEYBUS Trolleybus.

واحدها

A set of values that specify the unit of measure used in the display.

Enums
UNITS_UNSPECIFIED Units of measure not specified. Defaults to the unit of measure inferred from the request.
METRIC Metric units of measure.
IMPERIAL Imperial (English) units of measure.

VehicleEmissionType

A set of values describing the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

Enums
VEHICLE_EMISSION_TYPE_UNSPECIFIED No emission type specified. Default to GASOLINE .
GASOLINE Gasoline/petrol fueled vehicle.
ELECTRIC Electricity powered vehicle.
HYBRID Hybrid fuel (such as gasoline + electric) vehicle.
DIESEL Diesel fueled vehicle.

VehicleInfo

Contains the vehicle information, such as the vehicle emission type.

فیلدها
emission_ type

VehicleEmissionType

Describes the vehicle's emission type. Applies only to the DRIVE RouteTravelMode .

نقطه راه

Encapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.

فیلدها
via

bool

Marks this waypoint as a milestone rather a stopping point. For each non-via waypoint in the request, the response appends an entry to the legs array to provide the details for stopovers on that leg of the trip. Set this value to true when you want the route to pass through this waypoint without stopping over. Via waypoints don't cause an entry to be added to the legs array, but they do route the journey through the waypoint. You can only set this value on waypoints that are intermediates. The request fails if you set this field on terminal waypoints. If ComputeRoutesRequest.optimize_waypoint_order is set to true then this field cannot be set to true; otherwise, the request fails.

vehicle_ stopover

bool

Indicates that the waypoint is meant for vehicles to stop at, where the intention is to either pickup or drop-off. When you set this value, the calculated route won't include non- via waypoints on roads that are unsuitable for pickup and drop-off. This option works only for DRIVE and TWO_WHEELER travel modes, and when the location_type is Location .

side_ of_ road

bool

Indicates that the location of this waypoint is meant to have a preference for the vehicle to stop at a particular side of road. When you set this value, the route will pass through the location so that the vehicle can stop at the side of road that the location is biased towards from the center of the road. This option works only for DRIVE and TWO_WHEELER RouteTravelMode .

Union field location_type . Different ways to represent a location. location_type can be only one of the following:
location

Location

A point specified using geographic coordinates, including an optional heading.

place_ id

string

The POI Place ID associated with the waypoint.

address

string

Human readable address or a plus code. See https://plus.codes for details.