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

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

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

ComputeRouteMatrixRequest

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

زمینه های
origins[]

RouteMatrixOrigin

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

  • مجموع تعداد مبدا + تعداد مقصدهای مشخص شده به عنوان place_id یا address نباید بیشتر از 50 باشد.
  • حاصل ضرب تعداد مبدا × تعداد مقصد در هر صورت نباید بیشتر از 625 باشد.
  • اگر routing_preference روی TRAFFIC_AWARE_OPTIMAL تنظیم شده باشد، حاصل ضرب تعداد مبدا × تعداد مقصد نباید بیشتر از 100 باشد.
  • حاصل ضرب تعداد مبدا × تعداد مقصدها نباید بیشتر از 100 باشد اگر travel_mode روی TRANSIT تنظیم شده باشد.
destinations[]

RouteMatrixDestination

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

departure_time

Timestamp

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

arrival_time

Timestamp

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

language_code

string

اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل مبدا اول استنباط می شود.

region_code

string

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

units

Units

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

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

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

transit_preferences

TransitPreferences

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

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

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

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

ComputeRoutesRequest

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

زمینه های
origin

Waypoint

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

destination

Waypoint

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

intermediates[]

Waypoint

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

travel_mode

RouteTravelMode

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

routing_preference

RoutingPreference

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

polyline_quality

PolylineQuality

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

polyline_encoding

PolylineEncoding

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

departure_time

Timestamp

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

arrival_time

Timestamp

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

compute_alternative_routes

bool

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

route_modifiers

RouteModifiers

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

language_code

string

اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به شناسه محلی یونیکد مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود.

region_code

string

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

units

Units

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

optimize_waypoint_order

bool

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

requested_reference_routes[]

ReferenceRoute

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

extra_computations[]

ExtraComputation

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

traffic_model

TrafficModel

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

transit_preferences

TransitPreferences

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

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

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

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

ReferenceRoute

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

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

ComputeRoutesResponse

ComputeRoute پیام پاسخ.

زمینه های
routes[]

Route

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

fallback_info

FallbackInfo

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

geocoding_results

GeocodingResults

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

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

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

زمینه های
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 یک چند خط را مشخص می کند.

PolylineEncoding

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

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

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

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

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

مسیر

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

زمینه های
route_labels[]

RouteLabel

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

legs[]

RouteLeg

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

distance_meters

int32

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

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

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

description

string

شرح مسیر.

warnings[]

string

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

viewport

Viewport

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

travel_advisory

RouteTravelAdvisory

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

optimized_intermediate_waypoint_index[]

int32

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

localized_values

RouteLocalizedValues

نمایش متنی ویژگی های Route .

route_token

string

یک توکن مسیر ایمن و با کد base64 که می‌تواند به Navigation SDK ارسال شود، که به Navigation SDK اجازه می‌دهد مسیر را در حین پیمایش بازسازی کند و در صورت تغییر مسیر، هنگام ایجاد مسیر با تماس، به هدف اصلی احترام بگذارد. ComputeRoutes. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند. برای خواندن یا جهش در نظر گرفته نشده است. توجه: Route.route_token فقط برای درخواست‌هایی در دسترس است که ComputeRoutesRequest.routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کرده‌اند. Route.route_token برای درخواست هایی که دارای ایستگاه های بین راه هستند پشتیبانی نمی شود.

RouteLocalizedValues

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

زمینه های
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

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

RouteLabel

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

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

RouteLeg

شامل یک بخش بین ایستگاه های غیر via .

زمینه های
distance_meters

int32

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

duration

Duration

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

static_duration

Duration

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

polyline

Polyline

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

start_location

Location

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

end_location

Location

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

steps[]

RouteLegStep

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

travel_advisory

RouteLegTravelAdvisory

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

localized_values

RouteLegLocalizedValues

نمایش متنی ویژگی های RouteLeg .

steps_overview

StepsOverview

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

RouteLegLocalizedValues

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

زمینه های
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

StepsOverview

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

زمینه های
multi_modal_segments[]

MultiModalSegment

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

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

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

localized_values

LocalizedValues

نمایش متنی خصوصیات RouteMatrixElement .

origin_index

int32

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

destination_index

int32

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

Localized Values

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

زمینه های
distance

LocalizedText

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

duration

LocalizedText

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

static_duration

LocalizedText

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

transit_fare

LocalizedText

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

RouteMatrixElementCondition

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

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

RouteMatrixOrigin

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

زمینه های
waypoint

Waypoint

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

route_modifiers

RouteModifiers

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

RouteModifiers

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

زمینه های
avoid_tolls

bool

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

avoid_highways

bool

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

avoid_ferries

bool

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

avoid_indoor

bool

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

vehicle_info

VehicleInfo

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

toll_passes[]

TollPass

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

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

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

زمینه های
toll_info

TollInfo

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

speed_reading_intervals[]

SpeedReadingInterval

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

مثال:

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

int64

پیش بینی مصرف سوخت در میکرولیترها.

route_restrictions_partially_ignored

bool

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

transit_fare

Money

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

روش

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

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

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

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

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

سرعت خواندن

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

زمینه های
start_polyline_point_index

int32

شاخص شروع این بازه در پلی خط.

end_polyline_point_index

int32

شاخص پایان این بازه در پلی خط.

Union Field speed_type .

speed_type فقط می تواند یکی از موارد زیر باشد:

speed

Speed

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

سرعت

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

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

کول

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

زمینه های
estimated_price[]

Money

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

عوارض

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

Enums
TOLL_PASS_UNSPECIFIED استفاده نشده. اگر از این مقدار استفاده شود ، درخواست از بین می رود.
AU_ETOLL_TAG عوارض سیدنی. جزئیات اضافی را در https://www.myetoll.com.au مشاهده کنید.
AU_EWAY_TAG عوارض سیدنی. جزئیات اضافی را در https://www.tollpay.com.au مشاهده کنید.
AU_LINKT عوارض گسترده استرالیا. جزئیات اضافی را در https://www.linkt.com.au/ مشاهده کنید.
AR_TELEPASE عوارض آرژانتین. جزئیات اضافی را در https://telepase.com.ar مشاهده کنید
BR_AUTO_EXPRESO عوارض برزیل. جزئیات اضافی را در https://www.autoexpreso.com مشاهده کنید
BR_CONECTCAR عوارض برزیل. جزئیات اضافی را در https://conectcar.com مشاهده کنید.
BR_MOVE_MAIS عوارض برزیل. جزئیات اضافی را در https://movemais.com مشاهده کنید.
BR_PASSA_RAPIDO عوارض برزیل. جزئیات اضافی را در https://pasorapido.gob.do/ مشاهده کنید
BR_SEM_PARAR عوارض برزیل. جزئیات اضافی را در https://www.semparar.com.br مشاهده کنید.
BR_TAGGY عوارض برزیل. جزئیات اضافی را در https://taggy.com.br مشاهده کنید.
BR_VELOE عوارض برزیل. جزئیات اضافی را در https://veloe.com.br/site/onde-usar مشاهده کنید.
CA_US_AKWASASNE_SEAWAY_CORPORATE_CARD گذرگاه مرزی کانادا به ایالات متحده.
CA_US_AKWASASNE_SEAWAY_TRANSIT_CARD گذرگاه مرزی کانادا به ایالات متحده.
CA_US_BLUE_WATER_EDGE_PASS انتاریو ، کانادا به میشیگان ، گذرگاه مرزی ایالات متحده.
CA_US_CONNEXION انتاریو ، کانادا به میشیگان ، گذرگاه مرزی ایالات متحده.
CA_US_NEXUS_CARD گذرگاه مرزی کانادا به ایالات متحده.
ID_E_TOLL اندونزی. کارت الکترونیکی تهیه شده توسط چندین بانک که قبلاً هزینه های عوارض را پرداخت می کردند. تمام کارتهای الکترونیکی از طریق بانک ها یکسان هستند ، بنابراین فقط یک ارزش enum لازم است. به عنوان مثال - Mandiri Bank https://www.bankmandiri.co.id/e-money - bca https://www.bca.co.id/flazz - bni https://www.bni.co.id/id-id- شناسه/eBanking/tapcash
IN_FASTAG هند.
IN_LOCAL_HP_PLATE_EXEMPT هند ، معافیت صفحه دولتی HP.
JP_ETC ژاپن و غیره سیستم بی سیم الکترونیکی برای جمع آوری عوارض. https://www.go-etc.jp/
JP_ETC2 ژاپن etc2.0. نسخه جدید و غیره با تخفیف بیشتر و ارتباطات دو طرفه بین دستگاه های موجود در وسایل نقلیه و آنتن در جاده. https://www.go-etc.jp/etc2/index.html
MX_IAVE عوارض مکزیک. https://iave.capufe.gob.mx/#/
MX_PASE مکزیک https://www.pase.com.mx
MX_QUICKPASS مکزیک https://operadoravial.com/quick-pass/
MX_SISTEMA_TELEPEAJE_CHIHUAHUA http://appsh.chihuahua.gob.mx/transparencia/؟doc=/ingresos/telepeajeformato4.pdf
MX_TAG_IAVE مکزیک
MX_TAG_TELEVIA شرکت عوارض مکزیک. یکی از بسیاری از فعالیت های مکزیکو سیتی. جزئیات اضافی را در https://www.televia.com.mx مشاهده کنید.
MX_TELEVIA شرکت عوارض مکزیک. یکی از بسیاری از فعالیت های مکزیکو سیتی. https://www.televia.com.mx
MX_VIAPASS عوارض مکزیک. جزئیات اضافی را در https://www.viapass.com.mx/viapass/web_home.aspx مشاهده کنید.
US_AL_FREEDOM_PASS آل ، ایالات متحده
US_AK_ANTON_ANDERSON_TUNNEL_BOOK_OF_10_TICKETS AK ، ایالات متحده
US_CA_FASTRAK کالیفرنیا ، ایالات متحده
US_CA_FASTRAK_CAV_STICKER نشان می دهد که راننده علاوه بر برچسب DMV صادر شده با هوای تمیز (CAV) دارای هر پاس Fastrak است. https://www.bayareafastrak.org/en/guide/doineedflex.shtml
US_CO_EXPRESSTOLL شرکت ، ایالات متحده
US_CO_GO_PASS شرکت ، ایالات متحده
US_DE_EZPASSDE د ، ایالات متحده
US_FL_BOB_SIKES_TOLL_BRIDGE_PASS FL ، ایالات متحده
US_FL_DUNES_COMMUNITY_DEVELOPMENT_DISTRICT_EXPRESSCARD FL ، ایالات متحده
US_FL_EPASS FL ، ایالات متحده
US_FL_GIBA_TOLL_PASS FL ، ایالات متحده
US_FL_LEEWAY FL ، ایالات متحده
US_FL_SUNPASS FL ، ایالات متحده
US_FL_SUNPASS_PRO FL ، ایالات متحده
US_IL_EZPASSIL ایل ، ایالات متحده
US_IL_IPASS ایل ، ایالات متحده
US_IN_EZPASSIN در آمریکا.
US_KS_BESTPASS_HORIZON KS ، ایالات متحده.
US_KS_KTAG KS ، ایالات متحده.
US_KS_NATIONALPASS KS ، ایالات متحده.
US_KS_PREPASS_ELITEPASS KS ، ایالات متحده.
US_LA_GEAUXPASS LA ، ایالات متحده
US_LA_TOLL_TAG LA ، ایالات متحده
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 NJ ، ایالات متحده.
US_NJ_EZPASSNJ NJ ، ایالات متحده.
US_NY_EXPRESSPASS نیویورک ، ایالات متحده.
US_NY_EZPASSNY نیویورک ، ایالات متحده.
US_OH_EZPASSOH اوه ، ایالات متحده
US_PA_EZPASSPA PA ، ایالات متحده
US_RI_EZPASSRI ری ، ایالات متحده
US_SC_PALPASS SC ، ایالات متحده.
US_TX_AVI_TAG TX ، ایالات متحده.
US_TX_BANCPASS TX ، ایالات متحده.
US_TX_DEL_RIO_PASS TX ، ایالات متحده.
US_TX_EFAST_PASS TX ، ایالات متحده.
US_TX_EAGLE_PASS_EXPRESS_CARD TX ، ایالات متحده.
US_TX_EPTOLL TX ، ایالات متحده.
US_TX_EZ_CROSS TX ، ایالات متحده.
US_TX_EZTAG TX ، ایالات متحده.
US_TX_FUEGO_TAG TX ، ایالات متحده.
US_TX_LAREDO_TRADE_TAG TX ، ایالات متحده.
US_TX_PLUSPASS TX ، ایالات متحده.
US_TX_TOLLTAG TX ، ایالات متحده.
US_TX_TXTAG TX ، ایالات متحده.
US_TX_XPRESS_CARD TX ، ایالات متحده.
US_UT_ADAMS_AVE_PARKWAY_EXPRESSCARD UT ، ایالات متحده
US_VA_EZPASSVA VA ، ایالات متحده
US_WA_BREEZEBY WA ، ایالات متحده
US_WA_GOOD_TO_GO WA ، ایالات متحده
US_WV_EZPASSWV WV ، ایالات متحده.
US_WV_MEMORIAL_BRIDGE_TICKETS WV ، ایالات متحده.
US_WV_MOV_PASS WV ، ایالات متحده
US_WV_NEWELL_TOLL_BRIDGE_TICKET WV ، ایالات متحده.

حالت ترافیک

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

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

ترانسیت

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

زمینه های
name

string

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

phone_number

string

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

uri

string

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

خط حمل و نقل

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

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