Package google.maps.routes.v1

فهرست مطالب

Routes Preferred

Routes Preferred API.

ComputeCustomRoutes

rpc ComputeCustomRoutes( ComputeCustomRoutesRequest ) returns ( ComputeCustomRoutesResponse )

با توجه به مجموعه ای از ایستگاه های پایانه و میانی و یک هدف مسیر، بهترین مسیر را برای هدف مسیر محاسبه می کند. همچنین سریع ترین مسیر و کوتاه ترین مسیر را به عنوان مسیرهای مرجع برمی گرداند.

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

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

  • ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): X-Goog-FieldMask: *
  • ماسک میدانی از فواصل مسیر، مدت زمان، نشانه و اطلاعات عوارض: X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google از استفاده از ماسک فیلد پاسخ ( * ) یا مشخص کردن ماسک فیلد در سطح بالا ( routes ) جلوگیری می کند، زیرا:

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

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ComputeRouteMatrix

rpc ComputeRouteMatrix( ComputeRouteMatrixRequest ) returns ( RouteMatrixElement )

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

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

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

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

بسیار مهم است که status در ماسک فیلد خود وارد کنید زیرا در غیر این صورت همه پیام‌ها درست به نظر می‌رسند. گوگل استفاده از ماسک فیلد پاسخ ( * ) را منع می کند، زیرا:

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

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ComputeRoutes

rpc ComputeRoutes( ComputeRoutesRequest ) returns ( ComputeRoutesResponse )

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

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

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

  • ماسک فیلد تمام فیلدهای موجود (برای بازرسی دستی): X-Goog-FieldMask: *
  • ماسک فیلد مدت، فاصله و چند خط سطح مسیر (نمونه ای از راه اندازی تولید): X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google از استفاده از ماسک فیلد پاسخ ( * ) یا مشخص کردن ماسک فیلد در سطح بالا ( routes ) جلوگیری می کند، زیرا:

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

به محدوده OAuth زیر نیاز دارد:

  • https://www.googleapis.com/auth/maps-platform.routespreferred

برای اطلاعات بیشتر، به نمای کلی OAuth 2.0 مراجعه کنید.

ComputeCustomRoutesRequest

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

زمینه های
origin

Waypoint

ضروری. نقطه راه مبدأ

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

polyline_quality

PolylineQuality

اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند.

polyline_encoding

PolylineEncoding

اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند.

departure_time

Timestamp

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

route_modifiers

RouteModifiers

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

route_objective

RouteObjective

ضروری. یک هدف مسیر برای بهینه سازی.

language_code

string

اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.

units

Units

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

ComputeCustomRoutesResponse

پیام پاسخ ComputeCustomRoutes.

زمینه های
routes[]

CustomRoute

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

fastest_route

CustomRoute

سریعترین مسیر مرجع.

shortest_route

CustomRoute

کوتاه ترین مسیر مرجع

fallback_info

FallbackInfo

اطلاعات بازگشتی برای مسیرهای سفارشی.

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

اطلاعات بازگشتی را برای ComputeCustomRoutes در خود محفوظ می‌دارد. ComputeCustomRoutes دو نوع بازگشتی را انجام می دهد:

  1. اگر نتواند مسیر را با استفاده از routing_preference درخواست شده توسط مشتری محاسبه کند، به حالت مسیریابی دیگر باز می گردد. در این مورد fallback_routing_mode و routing_mode_fallback_reason برای ارتباط حالت مسیریابی بازگشتی استفاده شده و همچنین دلیل بازگشت مجدد استفاده می‌شوند.

  2. اگر نتواند یک "بهترین" مسیر را برای هدف مسیر مشخص شده توسط مشتری محاسبه کند، ممکن است به هدف دیگری بازگردد. fallback_route_objective برای برقراری ارتباط با هدف مسیر بازگشتی استفاده می شود.

زمینه های
routing_mode

FallbackRoutingMode

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

routing_mode_reason

FallbackReason

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

route_objective

FallbackRouteObjective

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

FallbackRouteObjective

RouteObjective برای پاسخ استفاده می شود.

Enums
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED هدف مسیر بازگشتی مشخص نشده است.
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA اگر مشتری RateCard را درخواست کند و include_tolls را روی true تنظیم کند و Google داده‌های قیمت عوارض مسیر را نداشته باشد، API بدون در نظر گرفتن قیمت عوارض به RateCard برمی‌گردد.

ComputeRouteMatrixRequest

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

زمینه های
origins[]

RouteMatrixOrigin

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

  • تعداد عناصر (منشا × مقصد) در هر صورت نباید بیشتر از 625 باشد.
  • اگر routing_preference روی TRAFFIC_AWARE_OPTIMAL تنظیم شده باشد، تعداد عناصر (منشا × مقصد) نباید بیشتر از 100 باشد.
  • تعداد نقاط راه (مبداء + مقصد) مشخص شده به عنوان place_id نباید بیشتر از 50 باشد.
destinations[]

RouteMatrixDestination

ضروری. آرایه ای از مقاصد، که ستون های ماتریس پاسخ را تعیین می کند.

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

departure_time

Timestamp

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

ComputeRoutesRequest

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

زمینه های
origin

Waypoint

ضروری. نقطه راه مبدأ

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

polyline_quality

PolylineQuality

اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند.

polyline_encoding

PolylineEncoding

اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند.

departure_time

Timestamp

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

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

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

language_code

string

اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.

units

Units

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

optimize_waypoint_order

bool

اگر optimizeWaypointOrder روی true تنظیم شده باشد، تلاش می‌شود تا ایستگاه‌های میانی مشخص شده را مجدداً ترتیب دهیم تا هزینه کلی مسیر به حداقل برسد. اگر هر یک از ایستگاه های بین راهی از طریق ایستگاه بین راه باشد، درخواست با شکست مواجه می شود. از ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index برای پیدا کردن سفارش جدید استفاده کنید. اگر routes.optimized_intermediate_waypoint_index در هدر X-Goog-FieldMask درخواست نشود، درخواست با شکست مواجه می شود. اگر optimizeWaypointOrder روی false تنظیم شده باشد، ComputeRoutesResponse.optimized_intermediate_waypoint_index خالی است.

ComputeRoutesResponse

ComputeRoute پیام پاسخ.

زمینه های
routes[]

Route

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

fallback_info

FallbackInfo

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

مسیر سفارشی

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

زمینه های
route

Route

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

token

string

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

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

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

زمینه های
routing_mode

FallbackRoutingMode

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

reason

FallbackReason

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

FallbackReason

دلایل استفاده از پاسخ بازگشتی

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

حالت FallbackRouting

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

Enums
FALLBACK_ROUTING_MODE_UNSPECIFIED استفاده نشده.
FALLBACK_TRAFFIC_UNAWARE نشان می دهد که حالت مسیریابی "TRAFFIC_UNAWARE" برای محاسبه پاسخ استفاده شده است.
FALLBACK_TRAFFIC_AWARE نشان می دهد که حالت مسیریابی "TRAFFIC_AWARE" برای محاسبه پاسخ استفاده شده است.

محل

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

زمینه های
lat_lng

LatLng

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

heading

Int32Value

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

مانور

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

Enums
MANEUVER_UNSPECIFIED استفاده نشده.
TURN_SLIGHT_LEFT کمی به سمت چپ بپیچید.
TURN_SHARP_LEFT به شدت به سمت چپ بپیچید.
UTURN_LEFT یک چرخش به چپ انجام دهید.
TURN_LEFT به سمت چپ برو، به سمت چپ برگرد.
TURN_SLIGHT_RIGHT کمی به سمت راست بپیچید.
TURN_SHARP_RIGHT به شدت به سمت راست بپیچید.
UTURN_RIGHT یک دور به راست بپیچید.
TURN_RIGHT بپیچ به راست.
STRAIGHT مستقیم برو.
RAMP_LEFT از سطح شیب دار سمت چپ بروید.
RAMP_RIGHT از رمپ سمت راست بروید.
MERGE ادغام در ترافیک
FORK_LEFT چنگال چپ را بردارید.
FORK_RIGHT چنگال مناسب را بردارید.
FERRY سوار کشتی شوید.
FERRY_TRAIN سوار قطار منتهی به کشتی شوید.
ROUNDABOUT_LEFT در دوربرگردان به چپ بپیچید.
ROUNDABOUT_RIGHT در دوربرگردان به راست بپیچید.
زمینه های
maneuver

Maneuver

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

instructions

string

دستورالعمل پیمایش در این مرحله

پلی لاین

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

زمینه های
فیلد اتحادیه polyline_type . نوع پلی لاین را کپسوله می کند. پیش‌فرض encoded_polyline است. polyline_type می تواند تنها یکی از موارد زیر باشد:
encoded_polyline

string

رمزگذاری رشته چند خط با استفاده از الگوریتم کدگذاری چند خطی

geo_json_linestring

Struct

با استفاده از قالب GeoJSON LineString یک چند خط را مشخص می کند

PolylineEncoding

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

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

کیفیت پلی لاین

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

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

مسیر

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

زمینه های
legs[]

RouteLeg

مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو نقطه راه غیر از via است. به عنوان مثال، مسیری که هیچ ایستگاه بین راهی ندارد، تنها یک پا دارد. مسیری که شامل یک ایستگاه بین راهی غیر از via است، دو پا دارد. مسیری که شامل یک مسیر via ایستگاه بین راهی است، یک پا دارد. ترتیب پاها با ترتیب نقاط راه از origin تا intermediates تا destination مطابقت دارد.

distance_meters

int32

مسافت طی مسیر، بر حسب متر.

duration

Duration

مدت زمان لازم برای پیمایش مسیر. اگر routing_preference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار همان static_duration است. اگر routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می‌شود.

static_duration

Duration

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

polyline

Polyline

چند خط کلی مسیر. این چند خط، چند خط ترکیبی همه legs خواهد بود.

description

string

شرح مسیر.

warnings[]

string

مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر.

viewport

Viewport

کادر محدودکننده نما در چند خط.

travel_advisory

RouteTravelAdvisory

اطلاعات تکمیلی در مورد مسیر.

optimized_intermediate_waypoint_index[]

int32

اگر ComputeRoutesRequest.optimize_waypoint_order روی true تنظیم شده باشد، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. برای مثال، فرض کنید ورودی Origin: LA باشد. واسطه ها: دالاس، بانگور، فینیکس؛ مقصد: نیویورک؛ و ترتیب میانی بهینه سازی شده عبارت است از: فونیکس، دالاس، بنگور. سپس این فیلد حاوی مقادیر [2، 0، 1] است. شاخص برای اولین نقطه میانی با 0 شروع می شود.

RouteLeg

قسمتی را بین نقاط راه غیر از via کپسوله می کند.

زمینه های
distance_meters

int32

مسافت طی مسیر، بر حسب متر.

duration

Duration

مدت زمان لازم برای حرکت در پا. اگر route_preference روی TRAFFIC_UNAWARE تنظیم شود، این مقدار همان static_duration است. اگر route_preference یا TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL باشد، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می شود.

static_duration

Duration

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

polyline

Polyline

چند خط کلی برای این پا. این شامل چند خط هر step می شود.

start_location

Location

محل شروع این پا. این ممکن است با origin ارائه شده متفاوت باشد. به عنوان مثال، زمانی که origin ارائه شده نزدیک جاده نباشد، این نقطه ای از جاده است.

end_location

Location

محل انتهایی این پا. این ممکن است با destination ارائه شده متفاوت باشد. به عنوان مثال، زمانی که destination ارائه شده نزدیک جاده ای نباشد، این نقطه ای در جاده است.

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

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

RouteLegStep

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

زمینه های
distance_meters

int32

مسافت طی این مرحله، بر حسب متر است. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد.

static_duration

Duration

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

polyline

Polyline

چند خط مرتبط با این مرحله.

start_location

Location

محل شروع این مرحله.

end_location

Location

محل پایان این مرحله.

navigation_instruction

NavigationInstruction

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

travel_advisory

RouteLegStepTravelAdvisory

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

RouteLegStepTravelAdvisory

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

زمینه های
speed_reading_intervals[]

SpeedReadingInterval

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

مثال:

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

RouteLegTravelAdvisory

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

زمینه های
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

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

مثال:

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

RouteMatrixDestination

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

زمینه های
waypoint

Waypoint

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

RouteMatrixElement

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

زمینه های
origin_index

int32

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

destination_index

int32

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

status

Status

کد وضعیت خطا برای این عنصر.

condition

RouteMatrixElementCondition

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

distance_meters

int32

مسافت طی مسیر، بر حسب متر.

duration

Duration

مدت زمان لازم برای پیمایش مسیر. اگر routing_preference را روی TRAFFIC_UNAWARE تنظیم کنید، این مقدار همان static_duration است. اگر routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید، این مقدار با در نظر گرفتن شرایط ترافیک محاسبه می‌شود.

static_duration

Duration

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

travel_advisory

RouteTravelAdvisory

اطلاعات تکمیلی در مورد مسیر. به عنوان مثال: اطلاعات محدودیت و اطلاعات عوارض

fallback_info

FallbackInfo

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

RouteMatrixElementCondition

وضعیت مسیر در حال برگشت.

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

RouteMatrixOrigin

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

زمینه های
waypoint

Waypoint

ضروری. نقطه راه مبدأ

route_modifiers

RouteModifiers

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

RouteModifiers

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

زمینه های
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

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

vehicle_info

VehicleInfo

اطلاعات خودرو را مشخص می کند.

toll_passes[]

TollPass

اطلاعات مربوط به مجوزهای دریافت عوارض را در خود گنجانده است. اگر مجوزهای عوارضی ارائه شود، API سعی می‌کند قیمت گذر را برگرداند. اگر مجوزهای دریافت عوارض ارائه نشود، API کارت عوارضی را ناشناخته تلقی می کند و سعی می کند قیمت نقدی را برگرداند. فقط برای حالت‌های سفر DRIVE و TWO_WHEELER اعمال می‌شود.

RouteObjective

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

زمینه های
rate_card

RateCard

هدف RateCard

کارت امتیاز

هدف مسیر RateCard را در بر می گیرد.

زمینه های
cost_per_minute

MonetaryCost

اختیاری. هزینه هر دقیقه

cost_per_km

MonetaryCost

اختیاری. هزینه هر کیلومتر

include_tolls

bool

اختیاری. اینکه آیا هزینه عوارض در هزینه کلی لحاظ شود.

هزینه پولی

هزینه استفاده شده در کارت نرخ را در بر می گیرد.

زمینه های
value

double

ضروری. ارزش هزینه به ارز محلی استنتاج شده از درخواست.

RouteTravelAdvisory

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

زمینه های
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

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

مثال:

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

RouteTravelMode

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

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

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

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

RoutingPreference

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

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

SpeedReading Interval

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

زمینه های
start_polyline_point_index

int32

شاخص شروع این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.

end_polyline_point_index

int32

شاخص پایانی این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد.

speed

Speed

سرعت ترافیک در این بازه.

سرعت

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

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

TollInfo

اطلاعات عوارض را در Route یا RouteLeg در خود گنجانده است.

زمینه های
estimated_price[]

Money

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

TollPass

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

Enums
TOLL_PASS_UNSPECIFIED استفاده نشده. اگر از این مقدار استفاده شود، درخواست با شکست مواجه می شود.
AU_ETOLL_TAG یکی از بسیاری از ارائه دهندگان کارت عوارضی سیدنی. https://www.myetoll.com.au
AU_EWAY_TAG یکی از بسیاری از ارائه دهندگان کارت عوارضی سیدنی. https://www.tollpay.com.au/
AU_LINKT کارت عوارضی در سراسر استرالیا جزئیات بیشتر را در https://www.linkt.com.au/ ببینید.
AR_TELEPASE کارت عوارضی آرژانتین جزئیات بیشتر را در https://telepase.com.ar ببینید
BR_AUTO_EXPRESO کارت عوارض برزیل جزئیات بیشتر را در https://www.autoexpreso.com ببینید
BR_CONECTCAR کارت عوارض برزیل جزئیات بیشتر را در https://conectcar.com ببینید.
BR_MOVE_MAIS کارت عوارض برزیل جزئیات بیشتر را در https://movemais.com ببینید.
BR_PASSA_RAPIDO کارت عوارض برزیل جزئیات بیشتر را در https://pasorapido.gob.do/ ببینید
BR_SEM_PARAR کارت عوارض برزیل جزئیات بیشتر را در https://www.semparar.com.br ببینید.
BR_TAGGY کارت عوارض برزیل جزئیات بیشتر را در https://taggy.com.br ببینید.
BR_VELOE کارت عوارض برزیل جزئیات بیشتر را در https://veloe.com.br/site/onde-usar ببینید.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD گذرگاه مرزی کانادا به ایالات متحده
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD گذرگاه مرزی کانادا به ایالات متحده
CA_US_BLUE_WATER_EDGE_PASS انتاریو، کانادا به میشیگان، گذرگاه مرزی ایالات متحده.
CA_US_CONNEXION انتاریو، کانادا به میشیگان، گذرگاه مرزی ایالات متحده.
CA_US_NEXUS_CARD گذرگاه مرزی کانادا به ایالات متحده
ID_E_TOLL اندونزی. کارت الکترونیکی ارائه شده توسط چندین بانک که برای پرداخت عوارض استفاده می شود. همه کارت‌های الکترونیکی از طریق بانک‌ها یکسان شارژ می‌شوند، بنابراین فقط یک مقدار enum مورد نیاز است. به عنوان مثال بانک ماندری https://www.bankmandiri.co.id/e-money BCA https://www.bca.co.id/flazz BNI https://www.bni.co.id/id-id/ebanking /tapcash
IN_FASTAG هندوستان
IN_LOCAL_HP_PLATE_EXEMPT هند، معافیت پلاک دولتی HP.
MX_TAG_IAVE کارت عوارض مکزیک
MX_TAG_TELEVIA شرکت گذر عوارض مکزیک یکی از بسیاری که در مکزیکوسیتی فعالیت می کند. جزئیات بیشتر را در https://www.televia.com.mx ببینید.
MX_VIAPASS کارت عوارض مکزیک جزئیات بیشتر را در https://www.viapass.com.mx/viapass/web_home.aspx ببینید.
US_AL_FREEDOM_PASS AL، ایالات متحده آمریکا
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK، ایالات متحده آمریکا
US_CA_FASTRAK کالیفرنیا، ایالات متحده آمریکا
US_CA_FASTRAK_CAV_STICKER نشان می دهد که راننده علاوه بر برچسب خودروی هوای پاک (CAV) صادر شده توسط DMV، دارای مجوز FasTrak است. https://www.bayareafastrak.org/en/guide/doINeedFlex.shtml
US_CO_EXPRESSTOLL CO، ایالات متحده آمریکا
US_CO_GO_PASS CO، ایالات متحده آمریکا
US_DE_EZPASSDE DE، ایالات متحده آمریکا
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL، ایالات متحده آمریکا
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL، ایالات متحده آمریکا
US_FL_EPASS FL، ایالات متحده آمریکا
US_FL_GIBA_TOLL_PASS FL، ایالات متحده آمریکا
US_FL_LEEWAY FL، ایالات متحده آمریکا
US_FL_SUNPASS FL، ایالات متحده آمریکا
US_FL_SUNPASS_PRO FL، ایالات متحده آمریکا
US_IL_EZPASSIL IL، ایالات متحده آمریکا
US_IL_IPASS IL، ایالات متحده آمریکا
US_IN_EZPASSIN در آمریکا.
US_KS_BESTPASS_HORIZON KS، ایالات متحده آمریکا
US_KS_KTAG KS، ایالات متحده آمریکا
US_KS_NATIONALPASS KS، ایالات متحده آمریکا
US_KS_PREPASS_ELITEPASS KS، ایالات متحده آمریکا
US_LA_GEAUXPASS لس آنجلس، ایالات متحده آمریکا
US_LA_TOLL_TAG لس آنجلس، ایالات متحده آمریکا
US_MA_EZPASSMA MA، ایالات متحده آمریکا
US_MD_EZPASSMD MD، ایالات متحده آمریکا
US_ME_EZPASSME من، ایالات متحده آمریکا
US_MI_AMBASSADOR_BRIDGE_PREMIER_COMMUTER_CARD MI، ایالات متحده آمریکا
US_MI_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG MI، ایالات متحده آمریکا
US_MI_IQ_PROX_CARD MI، ایالات متحده آمریکا
US_MI_MACKINAC_BRIDGE_MAC_PASS MI، ایالات متحده آمریکا
US_MI_NEXPRESS_TOLL MI، ایالات متحده آمریکا
US_MN_EZPASSMN MN، ایالات متحده آمریکا
US_NC_EZPASSNC NC، ایالات متحده آمریکا
US_NC_PEACH_PASS NC، ایالات متحده آمریکا
US_NC_QUICK_PASS NC، ایالات متحده آمریکا
US_NH_EZPASSNH NH، ایالات متحده آمریکا
US_NJ_DOWNBEACH_EXPRESS_PASS نیوجرسی، ایالات متحده آمریکا
US_NJ_EZPASSNJ نیوجرسی، ایالات متحده آمریکا
US_NY_EXPRESSPASS نیویورک، ایالات متحده آمریکا
US_NY_EZPASSNY نیویورک، ایالات متحده آمریکا
US_OH_EZPASSOH اوه، ایالات متحده آمریکا
US_PA_EZPASSPA PA، ایالات متحده آمریکا
US_RI_EZPASSRI RI، ایالات متحده آمریکا
US_SC_PALPASS SC، ایالات متحده آمریکا
US_TX_BANCPASS TX، ایالات متحده آمریکا
US_TX_DEL_RIO_PASS TX، ایالات متحده آمریکا
US_TX_EFAST_PASS TX، ایالات متحده آمریکا
US_TX_EAGLE_PASS_EXPRESS_CARD TX، ایالات متحده آمریکا
US_TX_EPTOLL TX، ایالات متحده آمریکا
US_TX_EZ_CROSS TX، ایالات متحده آمریکا
US_TX_EZTAG TX، ایالات متحده آمریکا
US_TX_LAREDO_TRADE_TAG TX، ایالات متحده آمریکا
US_TX_PLUSPASS TX، ایالات متحده آمریکا
US_TX_TOLLTAG TX، ایالات متحده آمریکا
US_TX_TXTAG TX، ایالات متحده آمریکا
US_TX_XPRESS_CARD TX، ایالات متحده آمریکا
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT، ایالات متحده آمریکا
US_VA_EZPASSVA VA، ایالات متحده آمریکا
US_WA_BREEZEBY WA، ایالات متحده آمریکا
US_WA_GOOD_TO_GO WA، ایالات متحده آمریکا
US_WV_EZPASSWV WV، ایالات متحده آمریکا
US_WV_MEMORIAL_BRIDGE_TICKETS WV، ایالات متحده آمریکا
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV، ایالات متحده آمریکا

واحدها

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

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

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

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

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

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

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

زمینه های
emission_type

VehicleEmissionType

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

نقطه راه

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

زمینه های
via

bool

این نقطه را به عنوان یک نقطه عطف و نه یک نقطه توقف مشخص می کند. برای هر نقطه غیر از طریق درخواست، پاسخ یک ورودی به آرایه legs اضافه می کند تا جزئیات توقف در آن مرحله از سفر را ارائه کند. زمانی که می‌خواهید مسیر بدون توقف از این نقطه عبور کند، این مقدار را روی true تنظیم کنید. از طریق ایستگاه‌های بین راه باعث نمی‌شود که ورودی به آرایه legs اضافه شود، اما مسیر را از طریق ایستگاه بین‌المللی هدایت می‌کنند. شما فقط می توانید این مقدار را در نقاطی که متوسط ​​هستند تنظیم کنید. اگر این فیلد را در ایستگاه های پایانه تنظیم کنید، درخواست انجام نمی شود. اگر ComputeRoutesRequest.optimize_waypoint_order روی true تنظیم شده باشد، این فیلد را نمی توان روی true تنظیم کرد. در غیر این صورت، درخواست ناموفق است.

vehicle_stopover

bool

نشان می دهد که ایستگاه بین راه برای توقف وسایل نقلیه در نظر گرفته شده است، جایی که قصد سوار شدن یا رها کردن آن است. وقتی این مقدار را تنظیم می‌کنید، مسیر محاسبه‌شده شامل ایستگاه‌های via راهی در جاده‌هایی که برای حمل و نقل نامناسب هستند، نمی‌شود. این گزینه فقط برای حالت‌های سفر DRIVE و TWO_WHEELER و زمانی که location_type location باشد کار می‌کند.

side_of_road

bool

نشان می دهد که مکان این ایستگاه بین راهی برای توقف خودرو در سمت خاصی از جاده ترجیح داده می شود. هنگامی که این مقدار را تنظیم می کنید، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده ای که مکان از مرکز جاده به سمت آن سوگیری دارد، توقف کند. این گزینه فقط برای حالت‌های سفر «DRIVE» و «TWO_WHEELER» و زمانی که «location_type» روی «location» تنظیم شده باشد، کار می‌کند.

location_type فیلد اتحادیه روش های مختلف برای نشان دادن یک مکان location_type تنها می تواند یکی از موارد زیر باشد:
location

Location

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

place_id

string

شناسه مکان POI مرتبط با ایستگاه بین راه.