شاخص
-
RoutesPreferred(رابط) -
ComputeCustomRoutesRequest(پیام) -
ComputeCustomRoutesResponse(پیام) -
ComputeCustomRoutesResponse.FallbackInfo(پیام) -
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective(enum) -
ComputeRouteMatrixRequest(پیام) -
ComputeRoutesRequest(پیام) -
ComputeRoutesResponse(پیام) -
CustomRoute(پیام) -
FallbackInfo(پیام) -
FallbackReason(تعدادی) -
FallbackRoutingMode(enum) -
Location(پیام) -
Maneuver(enum) -
NavigationInstruction(پیام) -
Polyline(پیام) -
PolylineEncoding(enum) -
PolylineQuality(تعدادی) -
Route(پیام) -
RouteLeg(پیام) -
RouteLegStep(پیام) -
RouteLegStepTravelAdvisory(پیام) -
RouteLegTravelAdvisory(پیام) -
RouteMatrixDestination(پیام) -
RouteMatrixElement(پیام) -
RouteMatrixElementCondition(enum) -
RouteMatrixOrigin(پیام) -
RouteModifiers(پیام) -
RouteObjective(پیام) -
RouteObjective.RateCard(پیام) -
RouteObjective.RateCard.MonetaryCost(پیام) -
RouteTravelAdvisory(پیام) -
RouteTravelMode(enum) -
RoutingPreference(enum) -
SpeedReadingInterval(پیام) -
SpeedReadingInterval.Speed(enum) -
TollInfo(پیام) -
TollPass(تعدادی) -
Units(تعدادی) -
VehicleEmissionType(تعدادی) -
VehicleInfo(پیام) -
Waypoint(پیام)
Routes Preferred
Routes Preferred API.
| ComputeCustomRoutes |
|---|
با توجه به مجموعه ای از ایستگاه های پایانه و میانی و یک هدف مسیر، بهترین مسیر را برای هدف مسیر محاسبه می کند. همچنین سریع ترین مسیر و کوتاه ترین مسیر را به عنوان مسیرهای مرجع برمی گرداند. توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا برای مثال در این روش:
Google از استفاده از ماسک فیلد پاسخ (
|
| ComputeRouteMatrix |
|---|
فهرستی از مبدا و مقصد را می گیرد و جریانی حاوی اطلاعات مسیر را برای هر ترکیب مبدا و مقصد برمی گرداند. توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا برای مثال در این روش:
بسیار مهم است که
|
| مسیرهای کامپیوتری |
|---|
با توجه به مجموعه ای از ایستگاه های پایانه و میانی، مسیر اصلی را به همراه مسیرهای جایگزین اختیاری برمی گرداند. توجه: این روش مستلزم آن است که یک ماسک فیلد پاسخ را در ورودی مشخص کنید. می‌توانید ماسک فیلد پاسخ را با استفاده از پارامتر URL فیلدها یا برای مثال در این روش:
Google از استفاده از ماسک فیلد پاسخ (
|
ComputeCustomRoutesRequest
پیام درخواست ComputeCustomRoutes.
| فیلدها | |
|---|---|
origin | مورد نیاز. نقطه راه مبدأ |
destination | مورد نیاز. ایستگاه بین راهی مقصد |
intermediates[] | اختیاری. مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود. |
travel_mode | اختیاری. نحوه حمل و نقل را مشخص می کند. اکنون فقط DRIVE پشتیبانی می شود. |
routing_preference | اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. در آینده، ممکن است مکانیزم بازگشتی را برای استفاده از یک گزینه متفاوت در زمانی که گزینه ترجیحی نتیجه معتبری ارائه نمی دهد، اجرا کنیم. شما می توانید این گزینه را فقط زمانی مشخص کنید که |
polyline_quality | اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند. |
polyline_encoding | اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند. |
departure_time | اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً رخ داده است، درخواست با شکست مواجه می شود. |
route_modifiers | اختیاری. مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد. |
route_objective | مورد نیاز. یک هدف مسیر برای بهینه سازی. |
language_code | اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود. |
units | اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این شامل فیلد |
ComputeCustomRoutesResponse
پیام پاسخ ComputeCustomRoutes.
| فیلدها | |
|---|---|
routes[] | "بهترین" مسیرها برای هدف مسیر ورودی. |
fastest_route | سریعترین مسیر مرجع. |
shortest_route | کوتاه ترین مسیر مرجع |
fallback_info | اطلاعات بازگشتی برای مسیرهای سفارشی. |
اطلاعات برگشتی
اطلاعات بازگشتی را برای ComputeCustomRoutes در خود محفوظ می‌دارد. ComputeCustomRoutes دو نوع بازگشتی را انجام می دهد:
اگر نتواند مسیر را با استفاده از routing_preference درخواست شده توسط مشتری محاسبه کند، به حالت مسیریابی دیگر باز می گردد. در این مورد fallback_routing_mode و routing_mode_fallback_reason برای ارتباط حالت مسیریابی بازگشتی استفاده شده و همچنین دلیل بازگشت مجدد استفاده می‌شوند.
اگر نتواند یک "بهترین" مسیر را برای هدف مسیر مشخص شده توسط مشتری محاسبه کند، ممکن است به هدف دیگری بازگردد. fallback_route_objective برای برقراری ارتباط با هدف مسیر بازگشتی استفاده می شود.
| فیلدها | |
|---|---|
routing_mode | حالت مسیریابی برای پاسخ استفاده می شود. اگر بازگشت مجدد فعال شد، حالت ممکن است با اولویت مسیریابی تنظیم شده در درخواست مشتری اصلی متفاوت باشد. |
routing_mode_reason | دلیل استفاده از پاسخ بازگشتی به جای پاسخ اصلی. این فیلد تنها زمانی پر می شود که حالت بازگشتی فعال شود و پاسخ بازگشتی برگردانده شود. |
route_objective | هدف مسیر مورد استفاده برای پاسخ. اگر بازگشت مجدد راه اندازی شد، ممکن است هدف با هدف مسیر ارائه شده در درخواست مشتری اصلی متفاوت باشد. |
FallbackRouteObjective
RouteObjective برای پاسخ استفاده می شود.
| Enums | |
|---|---|
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED | هدف مسیر بازگشتی مشخص نشده است. |
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA | اگر مشتری RateCard را درخواست کند و include_tolls را روی true تنظیم کند و Google داده‌های قیمت عوارض مسیر را نداشته باشد، API بدون در نظر گرفتن قیمت عوارض به RateCard برمی‌گردد. |
ComputeRouteMatrixRequest
پیام درخواست ComputeRouteMatrix
| فیلدها | |
|---|---|
origins[] | مورد نیاز. آرایه مبدا، که ردیف های ماتریس پاسخ را تعیین می کند. چندین محدودیت اندازه برای اصلی بودن مبدا و مقصد اعمال می شود:
|
destinations[] | مورد نیاز. آرایه ای از مقاصد، که ستون های ماتریس پاسخ را تعیین می کند. |
travel_mode | اختیاری. نحوه حمل و نقل را مشخص می کند. |
routing_preference | اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. در آینده، ممکن است مکانیزم بازگشتی را برای استفاده از یک گزینه متفاوت در زمانی که گزینه ترجیحی نتیجه معتبری ارائه نمی دهد، اجرا کنیم. شما می توانید این گزینه را فقط زمانی مشخص کنید که |
departure_time | اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً اتفاق افتاده است، درخواست با شکست مواجه می شود. |
ComputeRoutesRequest
پیام درخواست ComputeRoutes.
| فیلدها | |
|---|---|
origin | مورد نیاز. نقطه راه مبدأ |
destination | مورد نیاز. ایستگاه بین راهی مقصد |
intermediates[] | اختیاری. مجموعه ای از ایستگاه های بین راهی در طول مسیر (به استثنای نقاط پایانه)، برای توقف یا عبور. حداکثر 25 ایستگاه بین راهی پشتیبانی می شود. |
travel_mode | اختیاری. نحوه حمل و نقل را مشخص می کند. |
routing_preference | اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی می کند از اولویت مسیریابی انتخاب شده برای محاسبه مسیر استفاده کند. اگر اولویت مسیریابی منجر به خطا یا تاخیر طولانی مدت شود، یک خطا برگردانده می شود. در آینده، ممکن است مکانیزم بازگشتی را برای استفاده از یک گزینه متفاوت در زمانی که گزینه ترجیحی نتیجه معتبری ارائه نمی دهد، اجرا کنیم. شما می توانید این گزینه را فقط زمانی مشخص کنید که |
polyline_quality | اختیاری. ترجیح شما را برای کیفیت پلی لاین مشخص می کند. |
polyline_encoding | اختیاری. رمزگذاری ترجیحی برای چند خط را مشخص می کند. |
departure_time | اختیاری. زمان حرکت اگر این مقدار را تنظیم نکنید، این مقدار به طور پیش‌فرض روی زمانی است که درخواست را انجام داده‌اید. اگر این مقدار را روی زمانی تنظیم کنید که قبلاً رخ داده است، درخواست با شکست مواجه می شود. |
compute_alternative_routes | تعیین می کند که آیا مسیرهای جایگزین علاوه بر مسیر محاسبه شود یا خیر. |
route_modifiers | اختیاری. مجموعه ای از شرایط برای برآورده شدن که بر نحوه محاسبه مسیرها تأثیر می گذارد. |
language_code | اختیاری. کد زبان BCP-47، مانند "en-US" یا "sr-Latn". برای اطلاعات بیشتر، به http://www.unicode.org/reports/tr35/#Unicode_locale_identifier مراجعه کنید. برای لیست زبان های پشتیبانی شده به پشتیبانی زبان مراجعه کنید. وقتی این مقدار را ارائه نمی کنید، زبان نمایش از محل درخواست مسیر استنباط می شود. |
units | اختیاری. واحدهای اندازه گیری فیلدهای نمایش را مشخص می کند. این شامل فیلد |
optimize_waypoint_order | اگر optimizeWaypointOrder روی true تنظیم شده باشد، تلاش می‌شود تا ایستگاه‌های میانی مشخص شده را مجدداً ترتیب دهیم تا هزینه کلی مسیر به حداقل برسد. اگر هر یک از ایستگاه های بین راهی از طریق ایستگاه بین راه باشد، درخواست با شکست مواجه می شود. از ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index برای پیدا کردن سفارش جدید استفاده کنید. اگر routes.optimized_intermediate_waypoint_index در هدر |
ComputeRoutesResponse
ComputeRoute پیام پاسخ.
| فیلدها | |
|---|---|
routes[] | حاوی آرایه‌ای از مسیرهای محاسبه‌شده (حداکثر سه) وقتی که compute_alternatives_routes را مشخص می‌کنید، و فقط یک مسیر را در خود جای داده است. هنگامی که این آرایه حاوی چندین ورودی باشد، اولین مسیر توصیه شده است. اگر آرایه خالی باشد، به این معنی است که هیچ مسیری پیدا نشد. |
fallback_info | در برخی موارد، زمانی که سرور قادر به محاسبه نتایج مسیر با تمام تنظیمات برگزیده ورودی نیست، ممکن است از روش دیگری برای محاسبه استفاده کند. هنگامی که از حالت بازگشتی استفاده می شود، این فیلد حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است. |
مسیر سفارشی
یک مسیر سفارشی محاسبه شده بر اساس هدف مسیر مشخص شده توسط مشتری را در بر می گیرد. CustomRoute حاوی یک مسیر و یک نشانه مسیر است که می‌تواند به NavSDK ارسال شود تا مسیر سفارشی را برای پیمایش نوبتی بازسازی کند.
| فیلدها | |
|---|---|
route | مسیر "بهترین" برای هدف مسیر ورودی در نظر گرفته شده است. |
token | توکن مسیر کدگذاری شده مبتنی بر وب base64 که می‌تواند به NavSDK ارسال شود، که به NavSDK اجازه می‌دهد مسیر را در طول ناوبری بازسازی کند و در صورت تغییر مسیر، هنگام فراخوانی RoutesPreferred ComputeCustomRoutes، هدف اصلی را رعایت کند. مشتریان باید با این توکن به عنوان یک لکه غیر شفاف برخورد کنند. |
اطلاعات برگشتی
اطلاعات مربوط به چگونگی و چرایی استفاده از یک نتیجه بازگشتی. اگر این فیلد تنظیم شده باشد، به این معنی است که سرور از یک حالت مسیریابی متفاوت از حالت دلخواه شما به عنوان بازگشت استفاده کرده است.
| فیلدها | |
|---|---|
routing_mode | حالت مسیریابی برای پاسخ استفاده می شود. اگر بازگشت مجدد فعال شد، حالت ممکن است با اولویت مسیریابی تنظیم شده در درخواست مشتری اصلی متفاوت باشد. |
reason | دلیل استفاده از پاسخ بازگشتی به جای پاسخ اصلی. این فیلد تنها زمانی پر می شود که حالت بازگشتی فعال شود و پاسخ بازگشتی برگردانده شود. |
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 | مختصات جغرافیایی نقطه راه. |
heading | عنوان قطب نما با جهت جریان ترافیک مرتبط است. این مقدار برای تعیین سمت جاده مورد استفاده برای حمل و نقل استفاده می شود. مقادیر سرفصل می تواند از 0 تا 360 باشد، که در آن 0 یک عنوان شمال را مشخص می کند، 90 عنوان یک عنوان شرق و غیره را مشخص می کند. شما می توانید از این فیلد فقط برای حالت های سفر |
مانور
مجموعه ای از مقادیر که عمل ناوبری را برای مرحله فعلی مشخص می کند (مثلاً گردش به چپ، ادغام، مستقیم و غیره).
| 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 | در دوربرگردان به راست بپیچید. |
پلی لاین
یک چند خط کدگذاری شده را در بر می گیرد.
| فیلدها | |
|---|---|
فیلد اتحادیه polyline_type . نوع پلی لاین را کپسوله می کند. پیش‌فرض encoded_polyline است. polyline_type می تواند تنها یکی از موارد زیر باشد: | |
encoded_polyline | رمزگذاری رشته چند خط با استفاده از الگوریتم کدگذاری چند خطی |
geo_json_linestring | با استفاده از قالب 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[] | مجموعه ای از پاها (بخش های مسیر بین ایستگاه های بین راه) که مسیر را تشکیل می دهند. هر پا مربوط به سفر بین دو نقطه راه غیر |
distance_meters | مسافت طی مسیر، بر حسب متر. |
duration | مدت زمان لازم برای پیمایش مسیر. اگر |
static_duration | مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی. |
polyline | چند خط کلی مسیر. این چند خط، چند خط ترکیبی همه |
description | شرح مسیر. |
warnings[] | مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر. |
viewport | کادر محدودکننده نما در چند خط. |
travel_advisory | اطلاعات تکمیلی در مورد مسیر. |
optimized_intermediate_waypoint_index[] | اگر ComputeRoutesRequest.optimize_waypoint_order روی true تنظیم شده باشد، این فیلد شامل ترتیب بهینه شده نقاط بین راهی است. در غیر این صورت این قسمت خالی است. برای مثال، فرض کنید ورودی Origin: LA باشد. واسطه ها: دالاس، بانگور، فینیکس؛ مقصد: نیویورک؛ و ترتیب میانی بهینه سازی شده عبارت است از: فونیکس، دالاس، بنگور. سپس این فیلد حاوی مقادیر [2، 0، 1] است. شاخص برای اولین نقطه میانی با 0 شروع می شود. |
RouteLeg
قسمتی را بین نقاط راه غیر via کپسوله می کند.
| فیلدها | |
|---|---|
distance_meters | مسافت طی مسیر، بر حسب متر. |
duration | مدت زمان لازم برای حرکت در پا. اگر |
static_duration | مدت زمان سفر از طریق پا، بدون در نظر گرفتن شرایط ترافیک محاسبه شده است. |
polyline | چند خط کلی برای این پا. این شامل چند خط هر |
start_location | محل شروع این پا. این ممکن است با |
end_location | محل انتهایی این پا. این ممکن است با |
steps[] | مجموعه‌ای از مراحل که بخش‌های درون این پا را نشان می‌دهد. هر مرحله نشان دهنده یک دستورالعمل ناوبری است. |
travel_advisory | اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی و غیره در یک مسیر را در بر می گیرد. |
RouteLegStep
قسمتی از RouteLeg را در بر می گیرد. یک مرحله مربوط به یک دستورالعمل ناوبری است. پایه های مسیر از پله ها تشکیل شده است.
| فیلدها | |
|---|---|
distance_meters | مسافت طی این مرحله، بر حسب متر است. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد. |
static_duration | مدت زمان سفر در این مرحله بدون در نظر گرفتن شرایط ترافیکی. در برخی شرایط، این فیلد ممکن است ارزشی نداشته باشد. |
polyline | چند خط مرتبط با این مرحله. |
start_location | محل شروع این مرحله. |
end_location | محل پایان این مرحله. |
navigation_instruction | دستورالعمل های ناوبری. |
travel_advisory | اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی در یک پله پا، در بر می گیرد. |
RouteLegStepTravelAdvisory
اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی در یک پله پا، در بر می گیرد.
| فیلدها | |
|---|---|
speed_reading_intervals[] | فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی مثال: |
RouteLegTravelAdvisory
اطلاعات اضافی را که کاربر باید در مورد آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی و غیره در یک مسیر را در بر می گیرد.
| فیلدها | |
|---|---|
toll_info | اطلاعات مربوط به عوارض در RouteLeg خاص را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم عوارضی در RouteLeg وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد تخمینی_قیمت پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد وجود نداشته باشد، در RouteLeg عوارضی وجود ندارد. |
speed_reading_intervals[] | فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی مثال: |
RouteMatrixDestination
یک مقصد واحد برای ComputeRouteMatrixRequest
| فیلدها | |
|---|---|
waypoint | مورد نیاز. ایستگاه بین راهی مقصد |
RouteMatrixElement
اطلاعات مسیر محاسبه شده برای یک جفت مبدا/مقصد را در ComputeRouteMatrix API محصور می کند. این پروتو را می توان برای مشتری پخش کرد.
| فیلدها | |
|---|---|
origin_index | شاخص مبتنی بر صفر مبدا در درخواست. |
destination_index | شاخص مبتنی بر صفر مقصد در درخواست. |
status | کد وضعیت خطا برای این عنصر. |
condition | نشان می دهد که آیا مسیر پیدا شده است یا خیر. مستقل از وضعیت |
distance_meters | مسافت طی مسیر، بر حسب متر. |
duration | مدت زمان لازم برای پیمایش مسیر. اگر |
static_duration | مدت زمان سفر در مسیر بدون در نظر گرفتن شرایط ترافیکی. |
travel_advisory | اطلاعات تکمیلی در مورد مسیر. به عنوان مثال: اطلاعات محدودیت و اطلاعات عوارض |
fallback_info | در برخی موارد که سرور قادر به محاسبه مسیر با ترجیحات داده شده برای این جفت مبدا/مقصد خاص نیست، ممکن است به استفاده از حالت دیگری از محاسبه بازگردد. هنگامی که از حالت بازگشتی استفاده می شود، این قسمت حاوی اطلاعات دقیق در مورد پاسخ بازگشتی است. در غیر این صورت این فیلد تنظیم نشده است. |
RouteMatrixElementCondition
وضعیت مسیر در حال برگشت.
| Enums | |
|---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED | فقط زمانی استفاده می شود که status عنصر خوب نباشد. |
ROUTE_EXISTS | یک مسیر پیدا شد و اطلاعات مربوطه برای عنصر پر شد. |
ROUTE_NOT_FOUND | هیچ مسیری پیدا نشد فیلدهای حاوی اطلاعات مسیر، مانند distance_meters یا duration ، در عنصر پر نمی‌شوند. |
RouteMatrixOrigin
یک مبدا واحد برای ComputeRouteMatrixRequest
| فیلدها | |
|---|---|
waypoint | مورد نیاز. نقطه راه مبدأ |
route_modifiers | اختیاری. اصلاح‌کننده‌ها برای هر مسیری که این را مبدأ می‌گیرد |
RouteModifiers
مجموعه ای از شرایط اختیاری را در بر می گیرد تا هنگام محاسبه مسیرها برآورده شوند.
| فیلدها | |
|---|---|
avoid_tolls | مشخص می کند که آیا در صورت معقول بودن از جاده های عوارضی اجتناب شود یا خیر. اولویت با مسیرهایی است که دارای عوارضی نیستند. فقط برای حالت‌های سفر |
avoid_highways | مشخص می کند که آیا در صورت لزوم از بزرگراه ها اجتناب شود یا خیر. اولویت با مسیرهای فاقد بزرگراه خواهد بود. فقط برای حالت‌های سفر |
avoid_ferries | مشخص می‌کند که آیا در صورت لزوم از کشتی‌ها اجتناب شود یا خیر. اولویت با مسیرهایی است که شامل سفر با کشتی نباشد. فقط برای حالت‌های سفر |
avoid_indoor | مشخص می کند که آیا از پیمایش در داخل خانه در صورت لزوم اجتناب شود. اولویت به مسیرهایی داده می شود که دارای ناوبری داخلی نیستند. فقط برای حالت سفر |
vehicle_info | اطلاعات خودرو را مشخص می کند. |
toll_passes[] | اطلاعات مربوط به مجوزهای دریافت عوارض را در خود گنجانده است. اگر مجوزهای عوارضی ارائه شود، API سعی می‌کند قیمت گذر را برگرداند. اگر مجوزهای دریافت عوارض ارائه نشود، API کارت عوارضی را ناشناخته تلقی می کند و سعی می کند قیمت نقدی را برگرداند. فقط برای حالت‌های سفر DRIVE و TWO_WHEELER اعمال می‌شود. |
RouteObjective
یک هدف برای بهینه سازی توسط ComputeCustomRoutes را در خود محفوظ می دارد.
| فیلدها | |
|---|---|
rate_card | هدف RateCard |
کارت امتیاز
هدف مسیر RateCard را در بر می گیرد.
| فیلدها | |
|---|---|
cost_per_minute | اختیاری. هزینه هر دقیقه |
cost_per_km | اختیاری. هزینه هر کیلومتر |
include_tolls | اختیاری. اینکه آیا هزینه عوارض در هزینه کلی لحاظ شود. |
هزینه پولی
هزینه استفاده شده در کارت نرخ را در بر می گیرد.
| فیلدها | |
|---|---|
value | مورد نیاز. ارزش هزینه به ارز محلی استنتاج شده از درخواست. |
RouteTravelAdvisory
اطلاعات اضافی را که کاربر باید از آنها مطلع شود، مانند محدودیت منطقه ترافیکی احتمالی و غیره را در بر می گیرد.
| فیلدها | |
|---|---|
toll_info | اطلاعات مربوط به عوارض در مسیر را در خود گنجانده است. این فیلد فقط در صورتی پر می شود که انتظار داشته باشیم در مسیر عوارضی وجود داشته باشد. اگر این فیلد تنظیم شده باشد اما زیرفیلد تخمینی_قیمت پر نشده باشد، انتظار داریم که جاده شامل عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این فیلد تنظیم نشده باشد، انتظار داریم عوارضی در مسیر وجود نداشته باشد. |
speed_reading_intervals[] | فواصل تندخوانی با جزئیات تراکم ترافیک. قابل اجرا در موارد ترجیحات مسیریابی مثال: |
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 | شاخص شروع این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد. |
end_polyline_point_index | شاخص پایانی این بازه در چند خط. در JSON، وقتی ایندکس 0 باشد، فیلد خالی به نظر می رسد. |
speed | سرعت ترافیک در این بازه. |
سرعت
طبقه بندی سرعت چند خط بر اساس داده های ترافیک.
| Enums | |
|---|---|
SPEED_UNSPECIFIED | مقدار پیش فرض این مقدار استفاده نشده است. |
NORMAL | سرعت معمولی، هیچ کاهش سرعت تشخیص داده نمی شود. |
SLOW | کاهش سرعت شناسایی شد، اما ترافیک ایجاد نشد. |
TRAFFIC_JAM | ترافیک شناسایی شد |
TollInfo
اطلاعات عوارض را در Route یا RouteLeg در خود گنجانده است.
| فیلدها | |
|---|---|
estimated_price[] | مقدار پولی عوارض برای مسیر یا 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_KY_RIVERLINK | کی ، ایالات متحده |
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_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 | 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_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 | واحدهای اندازه گیری امپریال (انگلیسی). |
وسیله نقلیه
مجموعه ای از مقادیر توصیف نوع انتشار وسیله نقلیه. فقط مربوط به حالت سفر درایو است.
| Enums | |
|---|---|
VEHICLE_EMISSION_TYPE_UNSPECIFIED | هیچ نوع انتشار مشخص نشده است. پیش فرض بنزین. |
GASOLINE | وسیله نقلیه بنزین/بنزین سوخت. |
ELECTRIC | وسیله نقلیه برق. |
HYBRID | سوخت ترکیبی (مانند بنزین + برقی). |
وسیله نقلیه
اطلاعات مربوط به وسیله نقلیه ، مانند پلاک آخرین کاراکتر را در بر می گیرد.
| فیلدها | |
|---|---|
emission_type | نوع انتشار وسیله نقلیه را توصیف می کند. فقط مربوط به حالت سفر درایو است. |
نقطه راه
یک نقطه راه را محاصره می کند. ایستگاه های راه شروع و پایان یک مسیر را نشان می دهند و شامل توقف های میانی در طول مسیر هستند.
| فیلدها | |
|---|---|
via | این نقطه را به عنوان یک نقطه عطف و نه یک نقطه توقف نشان می دهد. برای هر یک از ایستگاه های غیر VIA در درخواست ، پاسخ ورود به آرایه |
vehicle_stopover | نشان می دهد که ایستگاه راه برای متوقف کردن وسایل نقلیه در آن قرار دارد ، جایی که قصد وانت یا کشویی است. هنگامی که این مقدار را تعیین می کنید ، مسیر محاسبه شده شامل غیر |
side_of_road | نشان می دهد که مکان این نقطه راه به معنای اولویت برای متوقف کردن وسیله نقلیه در یک طرف خاص از جاده است. هنگامی که این مقدار را تعیین کردید ، مسیر از محل عبور می کند تا وسیله نقلیه بتواند در کنار جاده متوقف شود که مکان از مرکز جاده مغرضانه باشد. این گزینه فقط برای حالت های مسافرتی "Drive" و "Two_Wheeler" کار می کند ، و هنگامی که "socation_type" روی "مکان" تنظیم شده است. |
Union Field location_type . روش های مختلف برای نشان دادن یک مکان. location_type فقط می تواند یکی از موارد زیر باشد: | |
location | نکته ای که با استفاده از مختصات جغرافیایی ، از جمله عنوان اختیاری مشخص شده است. |
place_id | شناسه Poi Place در ارتباط با نقطه راه. |
شاخص
-
RoutesPreferred(رابط) -
ComputeCustomRoutesRequest(پیام) -
ComputeCustomRoutesResponse(پیام) -
ComputeCustomRoutesResponse.FallbackInfo(پیام) -
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective(enum) -
ComputeRouteMatrixRequest(پیام) -
ComputeRoutesRequest(پیام) -
ComputeRoutesResponse(پیام) -
CustomRoute(پیام) -
FallbackInfo(پیام) -
FallbackReason(enum) -
FallbackRoutingMode(enum) -
Location(پیام) -
Maneuver(enum) -
NavigationInstruction(پیام) -
Polyline(پیام) -
PolylineEncoding(enum) -
PolylineQuality(enum) -
Route(پیام) -
RouteLeg(پیام) -
RouteLegStep(پیام) -
RouteLegStepTravelAdvisory(پیام) -
RouteLegTravelAdvisory(پیام) -
RouteMatrixDestination(پیام) -
RouteMatrixElement(پیام) -
RouteMatrixElementCondition(enum) -
RouteMatrixOrigin(پیام) -
RouteModifiers(پیام) -
RouteObjective(پیام) -
RouteObjective.RateCard(پیام) -
RouteObjective.RateCard.MonetaryCost(پیام) -
RouteTravelAdvisory(پیام) -
RouteTravelMode(enum) -
RoutingPreference(enum) -
SpeedReadingInterval(پیام) -
SpeedReadingInterval.Speed(enum) -
TollInfo(پیام) -
TollPass(enum) -
Units(enum) -
VehicleEmissionType(enum) -
VehicleInfo(پیام) -
Waypoint(پیام)
مسیر
مسیرها API را ترجیح می دهند.
| ComputeCustomRoutes |
|---|
با توجه به مجموعه ای از ایستگاه های راه ترمینال و میانی و یک هدف مسیر ، بهترین مسیر را برای هدف مسیر محاسبه می کند. همچنین سریعترین مسیر و کوتاهترین مسیر را به عنوان مسیرهای مرجع برمی گرداند. توجه: این روش مستلزم آن است که ماسک زمینه پاسخ را در ورودی مشخص کنید. شما می توانید با استفاده از پارامتر URL به عنوان مثال ، در این روش:
Google از استفاده از ماسک زمینه پاسخ Wildcard (
|
| کامپیوتر اداری |
|---|
لیستی از ریشه ها و مقصد ها را می گیرد و جریانی را که حاوی اطلاعات مسیر برای هر ترکیبی از مبدا و مقصد است ، برمی گرداند. توجه: این روش مستلزم آن است که ماسک زمینه پاسخ را در ورودی مشخص کنید. شما می توانید با استفاده از پارامتر URL به عنوان مثال ، در این روش:
بسیار مهم است که شما
|
| کامپیوتر |
|---|
با توجه به مجموعه ای از ایستگاه های راه ترمینال و میانی ، مسیر اصلی را به همراه مسیرهای متناوب اختیاری برمی گرداند. توجه: این روش مستلزم آن است که ماسک زمینه پاسخ را در ورودی مشخص کنید. شما می توانید با استفاده از پارامتر URL به عنوان مثال ، در این روش:
Google از استفاده از ماسک زمینه پاسخ Wildcard (
|
computecustomroutesrequest
پیام درخواست computecustomroutes.
| فیلدها | |
|---|---|
origin | مورد نیاز. نقطه راه اصلی. |
destination | مورد نیاز. ایستگاه مقصد. |
intermediates[] | اختیاری. مجموعه ای از ایستگاه های راه در طول مسیر (به استثنای نقاط ترمینال) ، برای متوقف کردن یا عبور از آن. حداکثر 25 نقطه راه میانی پشتیبانی می شود. |
travel_mode | اختیاری. نحوه حمل و نقل را مشخص می کند. اکنون فقط درایو پشتیبانی می شود. |
routing_preference | اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی در استفاده از اولویت مسیریابی انتخاب شده برای محاسبه مسیر دارد. اگر ترجیح مسیریابی منجر به خطا یا تأخیر طولانی مدت شود ، خطایی بازگردانده می شود. در آینده ، ما ممکن است یک مکانیسم بازگشت برای استفاده از گزینه متفاوت را اجرا کنیم که گزینه ترجیحی نتیجه معتبری ارائه ندهد. شما می توانید این گزینه را فقط هنگامی که |
polyline_quality | اختیاری. ترجیح شما را برای کیفیت پلی خط مشخص می کند. |
polyline_encoding | اختیاری. رمزگذاری ترجیحی را برای پلی خط مشخص می کند. |
departure_time | اختیاری. زمان عزیمت اگر این مقدار را تنظیم نکردید ، این مقدار به زمانی که درخواست را انجام داده اید پیش فرض می شود. اگر این مقدار را به زمانی تنظیم کنید که قبلاً اتفاق افتاده است ، درخواست با موفقیت انجام نمی شود. |
route_modifiers | اختیاری. مجموعه ای از شرایط برای برآورده کردن بر نحوه محاسبه مسیرها. |
route_objective | مورد نیاز. هدف مسیر برای بهینه سازی. |
language_code | اختیاری. کد زبان BCP-47 ، مانند "en-us" یا "sr-latn". برای اطلاعات بیشتر ، به http://www.unicode.org/reports/tr35/#unicode_locale_identifier مراجعه کنید. پشتیبانی از زبان را برای لیست زبانهای پشتیبانی شده مشاهده کنید. وقتی این مقدار را ارائه نمی دهید ، زبان نمایش از محل درخواست مسیر استنباط می شود. |
units | اختیاری. واحدهای اندازه گیری را برای قسمتهای نمایشگر مشخص می کند. این شامل زمینه |
ComputeCustomRoutesResponse
پیام پاسخ computecustomroutes.
| فیلدها | |
|---|---|
routes[] | مسیرهای "بهترین" برای هدف مسیر ورودی. |
fastest_route | سریعترین مسیر مرجع. |
shortest_route | کوتاهترین مسیر مرجع. |
fallback_info | اطلاعات برگشتی برای مسیرهای سفارشی. |
خط دبستان
اطلاعات برگشتی را برای ComputeCustomRoutes محصور می کند. ComputeCustomRoutes دو نوع برگه را انجام می دهد:
اگر نتواند مسیر را با استفاده از Routing_Preference درخواست شده توسط مشتری محاسبه کند ، به حالت مسیریابی دیگری باز می گردد. در این حالت fallback_routing_mode و routing_mode_fallback_reason برای برقراری ارتباط حالت مسیریابی برگشتی مورد استفاده و همچنین دلیل بازگشت مجدد استفاده می شود.
اگر نتواند مسیر "بهترین" را برای هدف مسیر مشخص شده توسط مشتری محاسبه کند ، ممکن است به هدف دیگری بازگردد. fallback_route_objective برای برقراری ارتباط هدف مسیر بازگشت استفاده می شود.
| فیلدها | |
|---|---|
routing_mode | حالت مسیریابی مورد استفاده برای پاسخ. در صورت ایجاد برگشتی ، حالت ممکن است با ترجیح مسیریابی تنظیم شده در درخواست اصلی مشتری متفاوت باشد. |
routing_mode_reason | دلیل استفاده از پاسخ برگشت به جای پاسخ اصلی استفاده شد. این قسمت فقط زمانی جمع می شود که حالت Fallback ایجاد شود و پاسخ برگشتی بازگردد. |
route_objective | هدف مسیر مورد استفاده برای پاسخ. در صورت ایجاد برگشتی ، هدف ممکن است با هدف مسیر ارائه شده در درخواست اصلی مشتری متفاوت باشد. |
فال بازپرداخت
RouteObjective مورد استفاده برای پاسخ.
| Enums | |
|---|---|
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED | هدف اصلی مسیر نامشخص. |
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA | اگر مشتری درخواست کند Ratecard و مجموعه ها شامل True ، و Google داده های عوارض را برای این مسیر ندارد ، API بدون در نظر گرفتن قیمت عوارض به Ratecard باز می گردد. |
combandoutematematrixrequest
پیام درخواست computeratematrix
| فیلدها | |
|---|---|
origins[] | مورد نیاز. آرایه ای از ریشه ها ، که ردیف های ماتریس پاسخ را تعیین می کند. محدودیت های مختلف در مورد کاردینال بودن ریشه ها و مقصد ها اعمال می شود:
|
destinations[] | مورد نیاز. مجموعه مقصد ، که ستون های ماتریس پاسخ را تعیین می کند. |
travel_mode | اختیاری. نحوه حمل و نقل را مشخص می کند. |
routing_preference | اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی در استفاده از اولویت مسیریابی انتخاب شده برای محاسبه مسیر دارد. اگر ترجیح مسیریابی منجر به خطا یا تأخیر طولانی شود ، خطایی بازگردانده می شود. در آینده ، ما ممکن است یک مکانیسم بازگشت برای استفاده از گزینه متفاوت را اجرا کنیم که گزینه ترجیحی نتیجه معتبری ارائه ندهد. شما می توانید این گزینه را فقط هنگامی که |
departure_time | اختیاری. زمان عزیمت اگر این مقدار را تنظیم نکردید ، این پیش فرض به زمانی که درخواست کرده اید. اگر این مقدار را به زمانی تنظیم کنید که قبلاً رخ داده است ، درخواست با موفقیت انجام نمی شود. |
رایانه شخصی
پیام های رایانه ای درخواست می کند.
| فیلدها | |
|---|---|
origin | مورد نیاز. نقطه راه اصلی. |
destination | مورد نیاز. ایستگاه مقصد. |
intermediates[] | اختیاری. مجموعه ای از ایستگاه های راه در طول مسیر (به استثنای نقاط ترمینال) ، برای متوقف کردن یا عبور از آن. حداکثر 25 نقطه راه میانی پشتیبانی می شود. |
travel_mode | اختیاری. نحوه حمل و نقل را مشخص می کند. |
routing_preference | اختیاری. نحوه محاسبه مسیر را مشخص می کند. سرور سعی در استفاده از اولویت مسیریابی انتخاب شده برای محاسبه مسیر دارد. اگر ترجیح مسیریابی منجر به خطا یا تأخیر طولانی مدت شود ، خطایی بازگردانده می شود. در آینده ، ما ممکن است یک مکانیسم بازگشت برای استفاده از گزینه متفاوت را اجرا کنیم که گزینه ترجیحی نتیجه معتبری ارائه ندهد. شما می توانید این گزینه را فقط هنگامی که |
polyline_quality | اختیاری. ترجیح شما را برای کیفیت پلی خط مشخص می کند. |
polyline_encoding | اختیاری. رمزگذاری ترجیحی را برای پلی خط مشخص می کند. |
departure_time | اختیاری. زمان عزیمت اگر این مقدار را تنظیم نکردید ، این مقدار به زمانی که درخواست را انجام داده اید پیش فرض می شود. اگر این مقدار را به زمانی تنظیم کنید که قبلاً اتفاق افتاده است ، درخواست با موفقیت انجام نمی شود. |
compute_alternative_routes | مشخص می کند که آیا می توان مسیرهای متناوب را علاوه بر مسیر محاسبه کرد. |
route_modifiers | اختیاری. مجموعه ای از شرایط برای برآورده کردن بر نحوه محاسبه مسیرها. |
language_code | اختیاری. کد زبان BCP-47 ، مانند "en-us" یا "sr-latn". برای اطلاعات بیشتر ، به http://www.unicode.org/reports/tr35/#unicode_locale_identifier مراجعه کنید. پشتیبانی از زبان را برای لیست زبانهای پشتیبانی شده مشاهده کنید. وقتی این مقدار را ارائه نمی دهید ، زبان نمایش از محل درخواست مسیر استنباط می شود. |
units | اختیاری. واحدهای اندازه گیری را برای قسمتهای نمایشگر مشخص می کند. این شامل زمینه |
optimize_waypoint_order | اگر OptimizeWayPointOrder به درستی تنظیم شده باشد ، تلاش می شود مجدداً نقاط واسطه ای مشخص شده را به حداقل برساند تا هزینه کلی مسیر را به حداقل برساند. اگر هر یک از ایستگاه های راه میانی از طریق Waypoint باشد ، درخواست از بین می رود. برای یافتن سفارش جدید از computeroutesresponse.routes.optimized_intermediate_waypoint_index استفاده کنید. اگر Routes.Optimized_Intermediate_Waypoint_Index در عنوان |
بازپرداخت رایانه
رایانه پیام پاسخ را انجام می دهد.
| فیلدها | |
|---|---|
routes[] | در هنگام مشخص کردن compute_alternatives_routes ، دارای آرایه ای از مسیرهای محاسبه شده (حداکثر سه) است و در صورت عدم استفاده از آن فقط یک مسیر دارد. هنگامی که این آرایه حاوی چندین ورودی است ، اولین مسیر توصیه شده ترین مسیر است. اگر آرایه خالی باشد ، به این معنی است که هیچ مسیری پیدا نمی شود. |
fallback_info | در بعضی موارد که سرور قادر به محاسبه نتایج مسیر با تمام ترجیحات ورودی نیست ، ممکن است به استفاده از یک روش محاسبات متفاوت بازگردد. هنگامی که از حالت Fallback استفاده می شود ، این قسمت حاوی اطلاعات مفصلی در مورد پاسخ برگشتی است. در غیر این صورت این زمینه غیرقانونی است. |
سفارشی
مسیر سفارشی محاسبه شده بر اساس هدف مسیر مشخص شده توسط مشتری را محاصره می کند. CustomRoute شامل یک مسیر و یک مسیر مسیری است که می تواند برای بازسازی مسیر سفارشی برای نوبت با چرخش به NAVSDK منتقل شود.
| فیلدها | |
|---|---|
route | مسیر "بهترین" برای هدف مسیر ورودی است. |
token | Web-Safe Base64 نشانه مسیر رمزگذاری شده که می تواند به NAVSDK منتقل شود ، که به NAVSDK اجازه می دهد مسیر را در حین ناوبری بازسازی کند ، و در صورت استفاده مجدد از افتخار قصد اصلی را هنگامی که ComputeCustomRouts Routefredred نامیده می شود. مشتریان باید این نشانه را به عنوان حباب مات رفتار کنند. |
خط دبستان
اطلاعات مربوط به چگونگی و چرا از نتیجه برگشتی استفاده شده است. اگر این قسمت تنظیم شده باشد ، به این معنی است که سرور از حالت مسیریابی متفاوتی از حالت مورد نظر شما به عنوان Fallback استفاده کرده است.
| فیلدها | |
|---|---|
routing_mode | حالت مسیریابی مورد استفاده برای پاسخ. در صورت ایجاد برگشتی ، حالت ممکن است با ترجیح مسیریابی تنظیم شده در درخواست اصلی مشتری متفاوت باشد. |
reason | دلیل استفاده از پاسخ برگشت به جای پاسخ اصلی استفاده شد. این قسمت فقط زمانی جمع می شود که حالت Fallback ایجاد شود و پاسخ برگشتی بازگردد. |
فال بازپرداخت
دلایل استفاده از پاسخ برگشت.
| Enums | |
|---|---|
FALLBACK_REASON_UNSPECIFIED | هیچ دلیل فزاینده ای مشخص نشده است. |
SERVER_ERROR | خطای سرور هنگام محاسبه مسیرها با حالت مسیریابی مورد نظر شما اتفاق افتاد ، اما ما توانستیم نتیجه محاسبه شده توسط یک حالت جایگزین را برگردانیم. |
LATENCY_EXCEEDED | ما نتوانستیم محاسبه را با حالت مسیریابی مورد نظر شما به موقع به پایان برسانیم ، اما توانستیم نتیجه محاسبه شده توسط یک حالت جایگزین را برگردانیم. |
پیشگام
حالت مسیریابی واقعی که برای پاسخ برگشتی برگشتی استفاده می شود.
| Enums | |
|---|---|
FALLBACK_ROUTING_MODE_UNSPECIFIED | استفاده نشده است |
FALLBACK_TRAFFIC_UNAWARE | نشان می دهد که از حالت مسیریابی "Traffic_Unaware" برای محاسبه پاسخ استفاده شده است. |
FALLBACK_TRAFFIC_AWARE | نشان می دهد که از حالت مسیریابی "Traffic_Aware" برای محاسبه پاسخ استفاده شده است. |
مکان
یک مکان (یک نقطه جغرافیایی و عنوان اختیاری) را محاصره می کند.
| فیلدها | |
|---|---|
lat_lng | مختصات جغرافیایی Waypoint. |
heading | عنوان قطب نما همراه با جهت جریان ترافیک. این مقدار برای مشخص کردن سمت جاده برای استفاده برای وانت و کشویی استفاده می شود. مقادیر عنوان می تواند از 0 تا 360 باشد ، جایی که 0 عنوان به سمت شمال |
مانور
مجموعه ای از مقادیر که اقدام ناوبری را برای مرحله فعلی مشخص می کند (به عنوان مثال ، به سمت چپ ، ادغام ، مستقیم و غیره).
| Enums | |
|---|---|
MANEUVER_UNSPECIFIED | استفاده نشده است |
TURN_SLIGHT_LEFT | کمی به سمت چپ بپیچید. |
TURN_SHARP_LEFT | به شدت به سمت چپ بپیچید. |
UTURN_LEFT | یک چرخش U سمت چپ درست کنید. |
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 | به سمت راست در دور دور بپیچید. |
پلی لاین
یک پلی خط رمزگذاری شده را محصور می کند.
| فیلدها | |
|---|---|
Union Field polyline_type . نوع پلی خط را محصور می کند. پیش فرض به encoded_polyline. polyline_type فقط می تواند یکی از موارد زیر باشد: | |
encoded_polyline | رمزگذاری رشته پلی خط با استفاده از الگوریتم رمزگذاری پلی خط |
geo_json_linestring | با استفاده از قالب Geojson Linestring ، یک پلی خط را مشخص می کند |
پرکندرد
نوع ترجیحی پلی خط را که باید برگردانده شود مشخص می کند.
| 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[] | مجموعه ای از پاها (بخش های مسیر بین ایستگاه های راه) که مسیر را تشکیل می دهند. هر پا با سفر بین دو غیر |
distance_meters | فاصله سفر مسیر ، در متر. |
duration | مدت زمان لازم برای حرکت در مسیر. اگر |
static_duration | مدت زمان سفر از طریق مسیر بدون توجه به شرایط ترافیکی. |
polyline | پلی خط مسیر کلی. این پلی خط پلی خط ترکیبی از همه |
description | توضیحی از مسیر. |
warnings[] | مجموعه ای از هشدارها برای نشان دادن هنگام نمایش مسیر. |
viewport | جعبه محدودیت نمای Polyline. |
travel_advisory | اطلاعات اضافی در مورد مسیر. |
optimized_intermediate_waypoint_index[] | اگر ComputerOtesRequest.Optimize_Waypoint_order تنظیم شده باشد ، این قسمت حاوی ترتیب بهینه شده از ایستگاه های واسطه ای است. در غیر این صورت ، این قسمت خالی است. به عنوان مثال ، فرض کنید ورودی منشأ است: LA ؛ واسطه ها: دالاس ، بنگور ، ققنوس ؛ مقصد: نیویورک ؛ و ترتیب بهینه واسطه میانی بهینه شده است: ققنوس ، دالاس ، بنگور. سپس این قسمت حاوی مقادیر [2 ، 0 ، 1] است. شاخص با 0 برای اولین ایستگاه میانی شروع می شود. |
مسیر
بخشی بین غیر via ایستگاه های راه را محاصره می کند.
| فیلدها | |
|---|---|
distance_meters | فاصله سفر پای مسیر ، در متر. |
duration | مدت زمان لازم برای حرکت در پا. اگر |
static_duration | مدت زمان سفر از طریق پا ، بدون توجه به شرایط ترافیکی محاسبه می شود. |
polyline | پلی خط کلی برای این پا. این شامل این است که پلی خط هر |
start_location | محل شروع این پا. این ممکن است با |
end_location | محل پایان این پا. این ممکن است با |
steps[] | مجموعه ای از مراحل حاکی از بخش های موجود در این پا. هر مرحله یک دستورالعمل ناوبری را نشان می دهد. |
travel_advisory | اطلاعات اضافی را که باید از آن مطلع شود ، مانند محدودیت احتمالی منطقه ترافیک و غیره در یک مسیر مسیر ، محاصره می کند. |
مسیر
بخشی از یک RouteLeg را محاصره می کند. یک قدم با یک دستورالعمل ناوبری واحد مطابقت دارد. پاهای مسیر از مراحل تشکیل شده است.
| فیلدها | |
|---|---|
distance_meters | فاصله سفر این مرحله ، در متر. در برخی شرایط ، این زمینه ممکن است ارزشی نداشته باشد. |
static_duration | مدت زمان سفر در این مرحله بدون توجه به شرایط ترافیکی. در برخی شرایط ، این زمینه ممکن است ارزشی نداشته باشد. |
polyline | پلی خط مرتبط با این مرحله. |
start_location | محل شروع این مرحله. |
end_location | محل پایان این مرحله. |
navigation_instruction | دستورالعمل های ناوبری. |
travel_advisory | اطلاعات اضافی را که باید از آن مطلع شود ، مانند محدودیت احتمالی منطقه ترافیک در مرحله پا ، محاصره می کند. |
مسیریابی
اطلاعات اضافی را که باید از آن مطلع شود ، مانند محدودیت احتمالی منطقه ترافیک در مرحله پا ، محاصره می کند.
| فیلدها | |
|---|---|
speed_reading_intervals[] | فواصل خواندن سرعت در مورد تراکم ترافیک. در صورت استفاده از مثال: |
مربوط به مسیر
اطلاعات اضافی را که باید از آن مطلع شود ، مانند محدودیت احتمالی منطقه ترافیک و غیره در یک مسیر مسیر ، محاصره می کند.
| فیلدها | |
|---|---|
toll_info | اطلاعات مربوط به عوارض را در مسیر خاص قرار می دهد. این زمینه فقط در صورتی جمع می شود که انتظار داشته باشیم عوارضی در مسیر وجود داشته باشد. اگر این قسمت تنظیم شده باشد اما زیر مجموعه تخمین زده شده_پریس جمع نشده است ، ما انتظار داریم که جاده حاوی عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این زمینه وجود نداشته باشد ، هیچ عوارضی در مسیر وجود ندارد. |
speed_reading_intervals[] | فواصل خواندن سرعت در مورد تراکم ترافیک. در صورت استفاده از مثال: |
مسیریابی
یک مقصد واحد برای computeTemateMatrixRixRequest
| فیلدها | |
|---|---|
waypoint | مورد نیاز. نقطه راه مقصد |
مسیر یابی
اطلاعات مسیر محاسبه شده برای یک جفت مبدا/مقصد را در API Computeratematrix محاسبه می کند. این پروتئین را می توان به مشتری پخش کرد.
| فیلدها | |
|---|---|
origin_index | شاخص صفر مبتنی بر مبدا در درخواست. |
destination_index | شاخص صفر مبتنی بر مقصد در درخواست. |
status | کد وضعیت خطا برای این عنصر. |
condition | نشان می دهد که آیا مسیر پیدا شده است یا نه. مستقل از وضعیت. |
distance_meters | فاصله سفر مسیر ، در متر. |
duration | مدت زمان لازم برای حرکت در مسیر. اگر |
static_duration | مدت زمان سفر از طریق مسیر بدون توجه به شرایط ترافیکی. |
travel_advisory | اطلاعات اضافی در مورد مسیر. به عنوان مثال: اطلاعات محدودیت و اطلاعات عوارض |
fallback_info | در بعضی موارد که سرور قادر به محاسبه مسیر با ترجیحات داده شده برای این جفت خاص/مقصد نیست ، ممکن است با استفاده از یک حالت محاسبات متفاوت بازگردد. هنگامی که از حالت Fallback استفاده می شود ، این قسمت حاوی اطلاعات دقیق در مورد پاسخ برگشتی است. در غیر این صورت این زمینه غیرقانونی است. |
مسیریابی
وضعیت مسیر بازگشت.
| Enums | |
|---|---|
ROUTE_MATRIX_ELEMENT_CONDITION_UNSPECIFIED | فقط در شرایطی که status عنصر خوب نیست استفاده می شود. |
ROUTE_EXISTS | مسیری پیدا شد و اطلاعات مربوطه برای این عنصر پر شد. |
ROUTE_NOT_FOUND | هیچ مسیری یافت نمی شود. زمینه های حاوی اطلاعات مسیر ، مانند distance_meters یا duration ، در این عنصر پر نمی شوند. |
روترمیکسورژین
یک منشأ واحد برای computeTemateMatrixRixRixRixRequest
| فیلدها | |
|---|---|
waypoint | مورد نیاز. نقطه راه اصلی |
route_modifiers | اختیاری. اصلاح کننده برای هر مسیری که این موضوع را به عنوان مبدا طی می کند |
رویه سازان
مجموعه ای از شرایط اختیاری را برای برآورده کردن هنگام محاسبه مسیرها محاصره می کند.
| فیلدها | |
|---|---|
avoid_tolls | مشخص می کند که آیا باید از جاده های عوارض معقول خودداری کنید. اولویت به مسیرهایی که حاوی جاده های عوارض نیستند ، داده می شود. فقط مربوط به حالت های مسافرتی |
avoid_highways | مشخص می کند که آیا باید از بزرگراه هایی که منطقی است جلوگیری کنید. اولویت به مسیرهایی که حاوی بزرگراه ها نیستند ، داده می شود. فقط مربوط به حالت های مسافرتی |
avoid_ferries | مشخص می کند که آیا باید از کشتی های معقول جلوگیری کند. اولویت به مسیرهایی که شامل مسافرت با کشتی ها نباشد ، داده می شود. فقط مربوط به حالت های مسافرتی |
avoid_indoor | مشخص می کند که آیا باید از پیمایش در داخل خانه در جایی که منطقی باشد ، جلوگیری کند. اولویت به مسیرهایی که حاوی ناوبری داخلی نیستند داده می شود. فقط مربوط به حالت سفر |
vehicle_info | اطلاعات وسیله نقلیه را مشخص می کند. |
toll_passes[] | اطلاعات مربوط به گذرگاه های عوارض را محاصره می کند. در صورت ارائه عوارض ، API سعی می کند قیمت پاس را بازگرداند. در صورت عدم ارائه عوارض ، API با عبور عوارض به عنوان ناشناخته رفتار می کند و سعی می کند قیمت نقدی را برگرداند. فقط مربوط به حالت های مسافرتی Drive و Two_Wheeler است. |
مسیر
هدف را برای بهینه سازی توسط ComputeCustomRoutes محصور می کند.
| فیلدها | |
|---|---|
rate_card | هدف Ratecard. |
محاصره
یک هدف مسیر Ratecard را محاصره می کند.
| فیلدها | |
|---|---|
cost_per_minute | اختیاری. هزینه در هر دقیقه |
cost_per_km | اختیاری. در هر کیلومتر هزینه. |
include_tolls | اختیاری. آیا هزینه عوارض را در هزینه کلی شامل می شود. |
پول پولی
هزینه مورد استفاده در کارت نرخ را محصور می کند.
| فیلدها | |
|---|---|
value | مورد نیاز. ارزش هزینه در ارز محلی استنباط شده از درخواست. |
مربوط به مسیریابی
اطلاعات اضافی را که باید از آن مطلع شود ، مانند محدودیت ممکن در منطقه ترافیک و غیره ، محاصره می کند.
| فیلدها | |
|---|---|
toll_info | اطلاعات مربوط به عوارض موجود در مسیر را محاصره می کند. این زمینه فقط در صورتی جمع می شود که انتظار داشته باشیم عوارض در مسیر وجود داشته باشد. اگر این قسمت تنظیم شده باشد اما زیر مجموعه تخمین زده شده_پریس جمع نشده است ، ما انتظار داریم که جاده حاوی عوارض باشد اما قیمت تخمینی را نمی دانیم. اگر این قسمت تنظیم نشده باشد ، انتظار داریم که در این مسیر هیچ عوارضی وجود نداشته باشد. |
speed_reading_intervals[] | فواصل خواندن سرعت در مورد تراکم ترافیک. در صورت استفاده از مثال: |
روش
مجموعه ای از مقادیر استفاده شده برای مشخص کردن حالت سفر.
| Enums | |
|---|---|
TRAVEL_MODE_UNSPECIFIED | هیچ حالت سفر مشخص نشده است. پیش فرض برای DRIVE . |
DRIVE | سفر با ماشین مسافر. |
BICYCLE | با دوچرخه سفر کنید. |
WALK | سفر با راه رفتن |
TWO_WHEELER | وسیله نقلیه دو چرخ و موتوری. به عنوان مثال ، موتور سیکلت. توجه داشته باشید که این متفاوت از حالت سفر BICYCLE است که حالت قدرت انسان را در بر می گیرد. |
TAXI | سفر با تاکسی دارای مجوز ، که ممکن است به وسیله نقلیه در برخی مناطق به خطوط تاکسی تعیین شده سفر کند. حالت تاکسی یک ویژگی آزمایشی است. اگر مشتری از مسیر تاکسی در شهری درخواست کند که داده های خط تاکسی در دسترس نباشد ، یک مسیر درایو بازگردانده می شود. |
پیشروی مسیریابی
مجموعه ای از مقادیر که عوامل را در هنگام محاسبه مسیر مورد توجه قرار می دهد.
| Enums | |
|---|---|
ROUTING_PREFERENCE_UNSPECIFIED | هیچ اولویت مسیریابی مشخص نشده است. به طور پیش فرض به TRAFFIC_AWARE . |
TRAFFIC_UNAWARE | مسیرها را بدون توجه به شرایط ترافیکی محاسبه می کند. مناسب وقتی شرایط ترافیک مهم نیست. استفاده از این مقدار کمترین تأخیر را ایجاد می کند. |
TRAFFIC_AWARE | مسیرهایی را که شرایط ترافیکی را در نظر گرفته است محاسبه می کند. بر خلاف TRAFFIC_AWARE_OPTIMAL ، برخی از بهینه سازی ها برای کاهش قابل توجهی در تأخیر اعمال می شود. |
TRAFFIC_AWARE_OPTIMAL | بدون استفاده از بیشتر بهینه سازی عملکرد ، مسیرهایی را که شرایط ترافیکی را در نظر گرفته است محاسبه می کند. استفاده از این مقدار بالاترین تأخیر را ایجاد می کند. |
سرعت خواندن
نشانگر چگالی ترافیک در یک بخش متناوب از یک پلی خط یا مسیر. با توجه به مسیری با امتیاز P_0 ، P_1 ، ... ، P_N (شاخص مبتنی بر صفر) ، SpeedReadingInterval یک فاصله را تعریف می کند و ترافیک آن را با استفاده از دسته های زیر توصیف می کند.
| فیلدها | |
|---|---|
start_polyline_point_index | The starting index of this interval in the polyline. In JSON, when the index is 0, the field appears to be unpopulated. |
end_polyline_point_index | The ending index of this interval in the polyline. In JSON, when the index is 0, the field appears to be unpopulated. |
speed | Traffic speed in this interval. |
سرعت
The classification of polyline speed based on traffic data.
| Enums | |
|---|---|
SPEED_UNSPECIFIED | Default value. 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[] | 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 | Not used. If this value is used, then the request fails. |
AU_ETOLL_TAG | One of many Sydney toll pass providers. https://www.myetoll.com.au |
AU_EWAY_TAG | One of many Sydney toll pass providers. 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. |
MX_TAG_IAVE | Mexico toll pass. |
MX_TAG_TELEVIA | Mexico toll pass company. One of many operating in Mexico City. See additional details at 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 | CA, USA. |
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_KY_RIVERLINK | KY, USA. |
US_LA_GEAUXPASS | LA, USA. |
US_LA_TOLL_TAG | LA, USA. |
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_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG | MI, USA. |
US_MI_IQ_PROX_CARD | 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 | NJ, USA. |
US_NJ_EZPASSNJ | NJ, USA. |
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_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, 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_NEWELL_TOLL_BRIDGE_TICKET | WV, USA. |
واحدها
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 travel mode.
| 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. |
VehicleInfo
Encapsulates the vehicle information, such as the license plate last character.
| فیلدها | |
|---|---|
emission_type | Describes the vehicle's emission type. Applies only to the DRIVE travel mode. |
نقطه راه
Encapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.
| فیلدها | |
|---|---|
via | 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 |
vehicle_stopover | 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- |
side_of_road | 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' travel modes, and when the 'location_type' is set to 'location'. |
Union field location_type . Different ways to represent a location. location_type can be only one of the following: | |
location | A point specified using geographic coordinates, including an optional heading. |
place_id | The POI Place ID associated with the waypoint. |
شاخص
-
RoutesPreferred(interface) -
ComputeCustomRoutesRequest(message) -
ComputeCustomRoutesResponse(message) -
ComputeCustomRoutesResponse.FallbackInfo(message) -
ComputeCustomRoutesResponse.FallbackInfo.FallbackRouteObjective(enum) -
ComputeRouteMatrixRequest(message) -
ComputeRoutesRequest(message) -
ComputeRoutesResponse(message) -
CustomRoute(message) -
FallbackInfo(message) -
FallbackReason(enum) -
FallbackRoutingMode(enum) -
Location(message) -
Maneuver(enum) -
NavigationInstruction(message) -
Polyline(message) -
PolylineEncoding(enum) -
PolylineQuality(enum) -
Route(message) -
RouteLeg(message) -
RouteLegStep(message) -
RouteLegStepTravelAdvisory(message) -
RouteLegTravelAdvisory(message) -
RouteMatrixDestination(message) -
RouteMatrixElement(message) -
RouteMatrixElementCondition(enum) -
RouteMatrixOrigin(message) -
RouteModifiers(message) -
RouteObjective(message) -
RouteObjective.RateCard(message) -
RouteObjective.RateCard.MonetaryCost(message) -
RouteTravelAdvisory(message) -
RouteTravelMode(enum) -
RoutingPreference(enum) -
SpeedReadingInterval(message) -
SpeedReadingInterval.Speed(enum) -
TollInfo(message) -
TollPass(enum) -
Units(enum) -
VehicleEmissionType(enum) -
VehicleInfo(message) -
Waypoint(message)
RoutesPreferred
The Routes Preferred API.
| ComputeCustomRoutes |
|---|
Given a set of terminal and intermediate waypoints, and a route objective, computes the best route for the route objective. Also returns fastest route and shortest route as reference routes. 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 For example, in this method:
Google discourages the use of the wildcard (
|
| ComputeRouteMatrix |
|---|
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 For example, in this method:
It is critical that you include
|
| ComputeRoutes |
|---|
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 For example, in this method:
Google discourage the use of the wildcard (
|
ComputeCustomRoutesRequest
ComputeCustomRoutes request message.
| فیلدها | |
|---|---|
origin | مورد نیاز. Origin waypoint. |
destination | مورد نیاز. Destination waypoint. |
intermediates[] | اختیاری. 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 | اختیاری. Specifies the mode of transportation. Only DRIVE is supported now. |
routing_preference | اختیاری. 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. In the future, we might implement a fallback mechanism to use a different option when the preferred option does not give a valid result. You can specify this option only when the |
polyline_quality | اختیاری. Specifies your preference for the quality of the polyline. |
polyline_encoding | اختیاری. Specifies the preferred encoding for the polyline. |
departure_time | اختیاری. The departure time. If you don't set this value, then this value defaults to the time that you made the request. If you set this value to a time that has already occurred, then the request fails. |
route_modifiers | اختیاری. A set of conditions to satisfy that affect the way routes are calculated. |
route_objective | مورد نیاز. A route objective to optimize for. |
language_code | اختیاری. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#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. |
units | اختیاری. Specifies the units of measure for the display fields. This includes the |
ComputeCustomRoutesResponse
ComputeCustomRoutes response message.
| فیلدها | |
|---|---|
routes[] | The 'best' routes for the input route objective. |
fastest_route | The fastest reference route. |
shortest_route | The shortest reference route. |
fallback_info | Fallback info for custom routes. |
FallbackInfo
Encapsulates fallback info for ComputeCustomRoutes. ComputeCustomRoutes performs two types of fallbacks:
If it cannot compute the route using the routing_preference requested by the customer, it will fallback to another routing mode. In this case fallback_routing_mode and routing_mode_fallback_reason are used to communicate the fallback routing mode used, as well as the reason for fallback.
If it cannot compute a 'best' route for the route objective specified by the customer, it might fallback to another objective. fallback_route_objective is used to communicate the fallback route objective.
| فیلدها | |
|---|---|
routing_mode | Routing mode used for the response. If fallback was triggered, the mode may be different from routing preference set in the original client request. |
routing_mode_reason | 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. |
route_objective | The route objective used for the response. If fallback was triggered, the objective may be different from the route objective provided in the original client request. |
FallbackRouteObjective
RouteObjective used for the response.
| Enums | |
|---|---|
FALLBACK_ROUTE_OBJECTIVE_UNSPECIFIED | Fallback route objective unspecified. |
FALLBACK_RATECARD_WITHOUT_TOLL_PRICE_DATA | If customer requests RateCard and sets include_tolls to true, and Google does not have toll price data for the route, the API falls back to RateCard without considering toll price. |
ComputeRouteMatrixRequest
ComputeRouteMatrix request message
| فیلدها | |
|---|---|
origins[] | مورد نیاز. Array of origins, which determines the rows of the response matrix. Several size restrictions apply to the cardinality of origins and destinations:
|
destinations[] | مورد نیاز. Array of destinations, which determines the columns of the response matrix. |
travel_mode | اختیاری. Specifies the mode of transportation. |
routing_preference | اختیاری. 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. In the future, we might implement a fallback mechanism to use a different option when the preferred option does not give a valid result. You can specify this option only when the |
departure_time | اختیاری. The departure time. If you don't set this value, this defaults to the time that you made the request. If you set this value to a time that has already occurred, the request fails. |
ComputeRoutesRequest
ComputeRoutes request message.
| فیلدها | |
|---|---|
origin | مورد نیاز. Origin waypoint. |
destination | مورد نیاز. Destination waypoint. |
intermediates[] | اختیاری. 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 | اختیاری. Specifies the mode of transportation. |
routing_preference | اختیاری. 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. In the future, we might implement a fallback mechanism to use a different option when the preferred option does not give a valid result. You can specify this option only when the |
polyline_quality | اختیاری. Specifies your preference for the quality of the polyline. |
polyline_encoding | اختیاری. Specifies the preferred encoding for the polyline. |
departure_time | اختیاری. The departure time. If you don't set this value, then this value defaults to the time that you made the request. If you set this value to a time that has already occurred, then the request fails. |
compute_alternative_routes | Specifies whether to calculate alternate routes in addition to the route. |
route_modifiers | اختیاری. A set of conditions to satisfy that affect the way routes are calculated. |
language_code | اختیاری. The BCP-47 language code, such as "en-US" or "sr-Latn". For more information, see http://www.unicode.org/reports/tr35/#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. |
units | اختیاری. Specifies the units of measure for the display fields. This includes the |
optimize_waypoint_order | If optimizeWaypointOrder is set to true, an attempt is made to re-order the specified intermediate waypoints to minimize the overall cost of the route. If any of the intermediate waypoints is via waypoint the request fails. Use ComputeRoutesResponse.Routes.optimized_intermediate_waypoint_index to find the new ordering. If routes.optimized_intermediate_waypoint_index is not requested in the |
ComputeRoutesResponse
ComputeRoutes the response message.
| فیلدها | |
|---|---|
routes[] | 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 | 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. |
CustomRoute
Encapsulates a custom route computed based on the route objective specified by the customer. CustomRoute contains a route and a route token, which can be passed to NavSDK to reconstruct the custom route for turn by turn navigation.
| فیلدها | |
|---|---|
route | The route considered 'best' for the input route objective. |
token | Web-safe base64 encoded route token that can be passed to NavSDK, which allows NavSDK to reconstruct the route during navigation, and in the event of rerouting honor the original intention when RoutesPreferred ComputeCustomRoutes is called. Customers should treat this token as an opaque blob. |
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 | 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 | 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 | Not used. |
FALLBACK_TRAFFIC_UNAWARE | Indicates the "TRAFFIC_UNAWARE" routing mode was used to compute the response. |
FALLBACK_TRAFFIC_AWARE | Indicates the "TRAFFIC_AWARE" routing mode was used to compute the response. |
مکان
Encapsulates a location (a geographic point, and an optional heading).
| فیلدها | |
|---|---|
lat_lng | The waypoint's geographic coordinates. |
heading | The compass heading associated with the direction of the flow of traffic. This value is used to specify the side of the road to use 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, etc. You can use this field only for |
مانور
A set of values that specify the navigation action to take for the current step (eg, turn left, merge, straight, etc.).
| Enums | |
|---|---|
MANEUVER_UNSPECIFIED | Not used. |
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 | مستقیم برو |
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. |
پلی لاین
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 | The string encoding of the polyline using the polyline encoding algorithm |
geo_json_linestring | Specifies a polyline using the GeoJSON LineString format |
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. |
مسیر
Encapsulates a route, which consists of a series of connected road segments that join beginning, ending, and intermediate waypoints.
| فیلدها | |
|---|---|
legs[] | A collection of legs (path segments between waypoints) that make-up the route. Each leg corresponds to the trip between two non- |
distance_meters | The travel distance of the route, in meters. |
duration | The length of time needed to navigate the route. If you set the |
static_duration | The duration of traveling through the route without taking traffic conditions into consideration. |
polyline | The overall route polyline. This polyline will be the combined polyline of all |
description | A description of the route. |
warnings[] | An array of warnings to show when displaying the route. |
viewport | The viewport bounding box of the polyline. |
travel_advisory | Additional information about the route. |
optimized_intermediate_waypoint_index[] | If ComputeRoutesRequest.optimize_waypoint_order is set to true, this field contains the optimized ordering of intermediates waypoints. otherwise, this field is empty. For example, suppose the input is Origin: LA; Intermediates: 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. |
RouteLeg
Encapsulates a segment between non- via waypoints.
| فیلدها | |
|---|---|
distance_meters | The travel distance of the route leg, in meters. |
duration | The length of time needed to navigate the leg. If the |
static_duration | The duration of traveling through the leg, calculated without taking traffic conditions into consideration. |
polyline | The overall polyline for this leg. This includes that each |
start_location | The start location of this leg. This might be different from the provided |
end_location | The end location of this leg. This might be different from the provided |
steps[] | An array of steps denoting segments within this leg. Each step represents one navigation instruction. |
travel_advisory | Encapsulates the additional information that the user should be informed about, such as possible traffic zone restriction etc. on a route leg. |
RouteLegStep
Encapsulates a segment of a RouteLeg . A step corresponds to a single navigation instruction. Route legs are made up of steps.
| فیلدها | |
|---|---|
distance_meters | The travel distance of this step, in meters. In some circumstances, this field might not have a value. |
static_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 | The polyline associated with this step. |
start_location | The start location of this step. |
end_location | The end location of this step. |
navigation_instruction | Navigation instructions. |
travel_advisory | Encapsulates the additional information that the user should be informed about, such as possible traffic zone restriction on a leg step. |
RouteLegStepTravelAdvisory
Encapsulates the additional information that the user should be informed about, such as possible traffic zone restriction on a leg step.
| فیلدها | |
|---|---|
speed_reading_intervals[] | Speed reading intervals detailing traffic density. Applicable in case of مثال: |
RouteLegTravelAdvisory
Encapsulates the additional information that the user should be informed about, such as possible traffic zone restriction etc. on a route leg.
| فیلدها | |
|---|---|
toll_info | Encapsulates 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[] | Speed reading intervals detailing traffic density. Applicable in case of مثال: |
RouteMatrixDestination
A single destination for ComputeRouteMatrixRequest
| فیلدها | |
|---|---|
waypoint | مورد نیاز. Destination waypoint |
RouteMatrixElement
Encapsulates route information computed for an origin/destination pair in the ComputeRouteMatrix API. This proto can be streamed to the client.
| فیلدها | |
|---|---|
origin_index | Zero-based index of the origin in the request. |
destination_index | Zero-based index of the destination in the request. |
status | Error status code for this element. |
condition | Indicates whether the route was found or not. Independent of status. |
distance_meters | The travel distance of the route, in meters. |
duration | The length of time needed to navigate the route. If you set the |
static_duration | The duration of traveling through the route without taking traffic conditions into consideration. |
travel_advisory | Additional information about the route. For example: restriction information and toll information |
fallback_info | 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. |
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 | مورد نیاز. Origin waypoint |
route_modifiers | اختیاری. 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 | Specifies whether to avoid toll roads where reasonable. Preference will be given to routes not containing toll roads. Applies only to the |
avoid_highways | Specifies whether to avoid highways where reasonable. Preference will be given to routes not containing highways. Applies only to the |
avoid_ferries | Specifies whether to avoid ferries where reasonable. Preference will be given to routes not containing travel by ferries. Applies only to the |
avoid_indoor | Specifies whether to avoid navigating indoors where reasonable. Preference will be given to routes not containing indoor navigation. Applies only to the |
vehicle_info | Specifies the vehicle information. |
toll_passes[] | 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 travel modes. |
RouteObjective
Encapsulates an objective to optimize for by ComputeCustomRoutes.
| فیلدها | |
|---|---|
rate_card | The RateCard objective. |
RateCard
Encapsulates a RateCard route objective.
| فیلدها | |
|---|---|
cost_per_minute | اختیاری. Cost per minute. |
cost_per_km | اختیاری. Cost per kilometer. |
include_tolls | اختیاری. Whether to include toll cost in the overall cost. |
MonetaryCost
Encapsulates the cost used in the rate card.
| فیلدها | |
|---|---|
value | مورد نیاز. The cost value in local currency inferred from the request. |
RouteTravelAdvisory
Encapsulates the additional information that the user should be informed about, such as possible traffic zone restriction etc.
| فیلدها | |
|---|---|
toll_info | Encapsulates information about tolls on the Route. This field is only populated if we expect there are tolls on the Route. 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 is not set, then we expect there is no toll on the Route. |
speed_reading_intervals[] | Speed reading intervals detailing traffic density. Applicable in case of مثال: |
RouteTravelMode
A set of values used to specify the mode of travel.
| Enums | |
|---|---|
TRAVEL_MODE_UNSPECIFIED | No travel mode specified. Defaults to DRIVE . |
DRIVE | Travel by passenger car. |
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. |
TAXI | Travel by licensed taxi, which may allow the vehicle to travel on designated taxi lanes in some areas. TAXI mode is an experimental feature. If customer requests TAXI route in a city where taxi lane data is not available, a DRIVE route is returned. |
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_AWARE . |
TRAFFIC_UNAWARE | Computes routes without taking traffic conditions into consideration. Suitable when traffic conditions don't matter. Using this value produces the lowest latency. |
TRAFFIC_AWARE | Calculates routes taking 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 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 | The starting index of this interval in the polyline. In JSON, when the index is 0, the field appears to be unpopulated. |
end_polyline_point_index | The ending index of this interval in the polyline. In JSON, when the index is 0, the field appears to be unpopulated. |
speed | Traffic speed in this interval. |
سرعت
The classification of polyline speed based on traffic data.
| Enums | |
|---|---|
SPEED_UNSPECIFIED | Default value. 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[] | 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 | Not used. If this value is used, then the request fails. |
AU_ETOLL_TAG | One of many Sydney toll pass providers. https://www.myetoll.com.au |
AU_EWAY_TAG | One of many Sydney toll pass providers. 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. |
MX_TAG_IAVE | Mexico toll pass. |
MX_TAG_TELEVIA | Mexico toll pass company. One of many operating in Mexico City. See additional details at 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 | CA, USA. |
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_KY_RIVERLINK | KY, USA. |
US_LA_GEAUXPASS | LA, USA. |
US_LA_TOLL_TAG | LA, USA. |
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_GROSSE_ILE_TOLL_BRIDGE_PASS_TAG | MI, USA. |
US_MI_IQ_PROX_CARD | 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 | NJ, USA. |
US_NJ_EZPASSNJ | NJ, USA. |
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_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, 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_NEWELL_TOLL_BRIDGE_TICKET | WV, USA. |
واحدها
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 travel mode.
| 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. |
VehicleInfo
Encapsulates the vehicle information, such as the license plate last character.
| فیلدها | |
|---|---|
emission_type | Describes the vehicle's emission type. Applies only to the DRIVE travel mode. |
نقطه راه
Encapsulates a waypoint. Waypoints mark both the beginning and end of a route, and include intermediate stops along the route.
| فیلدها | |
|---|---|
via | 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 |
vehicle_stopover | 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- |
side_of_road | 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' travel modes, and when the 'location_type' is set to 'location'. |
Union field location_type . Different ways to represent a location. location_type can be only one of the following: | |
location | A point specified using geographic coordinates, including an optional heading. |
place_id | The POI Place ID associated with the waypoint. |