یک مسیر را برنامه ریزی کنید

گاهی اوقات، ممکن است بخواهید مسیری را که برنامه شما برای رانندگان ارائه می دهد، برنامه ریزی کنید. استفاده از نشانه مسیر از Routes API (یا Routes Preferred API) می‌تواند به شما کمک کند تا دو چیز را برای مسیر برنامه‌ریزی‌شده خود مشخص کنید:

• چند خط برای مسیر

• اهداف مسیر شما

به عنوان مثال، در اینجا چند نمونه از اهداف مسیریابی که ممکن است داشته باشید آورده شده است:

• زمان تحویل را به حداقل برسانید : یک کسب و کار تحویل غذا ممکن است بخواهد زمان تحویل غذا را به حداقل برساند.

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

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

• هزینه های کمتر و بهبود ایمنی : یک کسب و کار اشتراک سوار ممکن است بخواهد مسیری را پیدا کند که هزینه کمتری برای سوارکاران داشته باشد و به دلایل ایمنی از مناطق خاصی اجتناب کند.

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

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

چرا از نشانه مسیر برای اهداف مسیر استفاده کنیم؟

با یک نشانه مسیر از Routes یا Routes Preferred API، کنترل بیشتری روی مسیر ارائه شده دارید:

• از قبل مسیری را برای Navigation SDK برنامه ریزی کنید تا در صورت امکان از آن استفاده کنید.

• بهترین مسیر را برای استفاده از Navigation SDK انتخاب کنید . اگر هنگام ایجاد مسیرها در Routes API، توکن های مسیر را درخواست کنید، برای هر مسیر تولید شده یک نشانه مسیر دریافت می کنید. سپس می‌توانید رمزی را برای مسیری که می‌خواهید هنگام ارسال آن به Navigation SDK استفاده کنید، انتخاب کنید.

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

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

نکته: نشانه مسیر برای یک مبدا و مقصد خاص و در یک زمان خاص است. شما باید یک درخواست Routes API جدید برای یک نشانه مسیر جدید ارسال کنید.

نحوه عملکرد نشانه های مسیر Routes API

می توانید از Routes API یا Routes Preferred API برای برنامه ریزی یک مسیر با استفاده از اهداف مسیر استفاده کنید. Routes API یک نشانه مسیر را برمی گرداند که می توانید آن را به Navigation SDK ارسال کنید تا نحوه مسیریابی وسیله نقلیه شما را راهنمایی کند.

وقتی از Routes API درخواست و استفاده می‌کنید، چه اتفاقی می‌افتد:

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

2. رمز مسیر را به Navigation SDK منتقل می کنید.

3. Navigation SDK مسیر را بازیابی می کند یا اگر مسیر به دلیل تغییر شرایط موجود نباشد، بهترین مسیر منطبق را بازیابی می کند.

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

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

چرا یک مسیر برنامه ریزی شده ممکن است دقیقا دنبال نشود

مسیر برنامه ریزی شده و اهداف مسیر خود را به عنوان دستورالعمل هایی که باید دنبال کنید در نظر بگیرید: آنها تجویزی نیستند. ممکن است به دلیل تفاوت در شرایط جاده، مکان شروع یا سایر پارامترهایی که از زمان ایجاد مسیر برنامه ریزی شده تغییر کرده است، بین مسیر برنامه ریزی شده خود و مسیر ارائه شده توسط ناوبری هدایت شده تفاوت مشاهده کنید. این تفاوت ممکن است منجر به عدم تطابق بین اهداف برنامه ریزی شده و واقعی شما برای مسافت و ETA، در میان سایر ویژگی های مهم سفر شود.

نکته: به عنوان بهترین روش، همیشه هر بار که مقصد را در Navigation SDK تنظیم می‌کنید، یک نشانه مسیر جدید درخواست کنید و برای جلوگیری از تأثیر بر کسب‌وکارتان، برای تغییراتی برنامه‌ریزی کنید.

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

همانطور که در مراحل زیر توضیح داده شده است، می توانید یک مسیر را با ایجاد یک نشانه مسیر و سپس ارسال آن به Navigation SDK برنامه ریزی کنید:

مرحله 1: با استفاده از Routes یا Routes Preferred API یک نشانه مسیر ایجاد کنید

1. یک نشانه مسیر را با یکی از روش های زیر درخواست کنید :

   • Routes API : computeRoutes . برای اطلاعات بیشتر درباره درخواست نشانه مسیر در Routes API، به محاسبه مسیر و درخواست نشانه مسیر مراجعه کنید.

   • Routes Preferred API : computeCustomRoutes . برای اطلاعات بیشتر درباره درخواست نشانه مسیر در Routes Preferred API، به برنامه ریزی مسیر مراجعه کنید.

2. درخواست مسیر خود را برای برآورده کردن الزامات استفاده از نشانه مسیر تنظیم کنید :

   • travel_mode را روی DRIVING تنظیم کنید
   • routing_preference را روی TRAFFIC_AWARE یا TRAFFIC_AWARE_OPTIMAL تنظیم کنید
   • از طریق ایستگاه های بین راه استفاده نکنید

مرحله 2: رمز مسیر را به Navigation SDK منتقل کنید

1. ذخیره نشانه مسیر : در Navigation SDK، یک رشته برای ذخیره نشانه مسیر تنظیم کنید. مثلا:

   let routeToken = "route token returned by Routes API"

   نمونه ای از نشانه مسیر برگشتی:

   {
   // Other fields
   "routeToken": "CqMBCjoKCJQOor5DHcwiEhBon3XpHXFnVvDeWMwd9PpAGgz6wtnFDKIBrAHTARpCApUDSggAAAAACjcrP3gBEAQaTApKChgKDQoCCAERAAAAAACAZkAR3SQGgZUXdUASEggAEAMQBhATEBIYAkIEGgIIBSIYChZ2VEJiWlBPSkk1aU5wUVRzNTV5d0FRKAEiFQBcJuds-Efh-2QZhOMTtUCCxEVL_g",
   }
   

2. رمز مسیر را با استفاده از روش mapView.navigator setDestinations به Navigation SDK منتقل کنید و همان نقاط بین مقصدی را که هنگام ایجاد نشانه مسیر استفاده کردید مشخص کنید:

   mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

توجه: در صورت نیاز به سفر مجدد در همان مسیر، یک رمز مسیر جدید درخواست کنید.

متد Navigator.setDestinations وضعیت درخواست را برمی گرداند. اگر مسیری از مکان کاربر به مقصد مشخص شده پیدا شود، RouteStatus.OK را برمی‌گرداند.

برای اطلاعات بیشتر در مورد این روش، به Navigator.setDestinations مراجعه کنید.

مثال

مثال های کد زیر نحوه بازیابی یک مسیر برنامه ریزی شده را نشان می دهد.

سریع

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint1 = GMSNavigationWaypoint(location: location, title: "waypoint from location")!
let waypoint2 = GMSNavigationWaypoint(placeID: "samplePlaceID", title: "waypoint from Place ID")!

let routeToken = "route token returned by Routes API"
mapView.navigator?.setDestinations([waypoint1, waypoint2], routeToken: routeToken, callback: {...})

هدف-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationWaypoint *waypoint1 = [[GMSNavigationWaypoint alloc] initWithLocation:coordinate title:@"waypoint from location"];
GMSNavigationWaypoint *waypoint2 = [[GMSNavigationWaypoint alloc] initWithPlaceID:@"samplePlaceID"
                                                                            title:@"waypoint from Place ID"];
NSString *routeToken = @"route token returned by Routes API";

[mapView.navigator setDestinations:@[waypoint1, waypoint2]
                         routeToken:routeToken
                           callback:^(GMSRouteStatus routeStatus){...}];

نحوه تعامل نشانه‌های مسیر و Navigation SDK

در اینجا نحوه تعامل مسیر تولید شده توسط Navigation SDK و مسیر برنامه ریزی شده در نشانه مسیر آمده است:

• هر مقصدی که قبلاً تنظیم شده بود را لغو می کند .

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

• برای شرایط جاده و ترافیک تنظیم می شود . ببینید چرا یک مسیر برنامه ریزی شده ممکن است دقیقا دنبال نشود .

• گزینه های مرتبط با مسیریابی زیر را به عنوان غیر ضروری نادیده می گیرد :

  • avoidsHighways
  • avoidsTolls
  • avoidsFerries
  • licensePlateRestriction

• دنبال می کند :

  • گزینه‌های مرتبط با ایستگاه‌های راه ، مانند ترجیح کنار جاده.

  • اهداف مسیر اگر Navigation SDK باید مسیر برگشتی را تنظیم کند، از اهداف مسیری که هنگام درخواست نشانه مسیر مشخص کرده‌اید استفاده می‌کند. به همین دلیل، باید از همان گزینه های مربوط به ایستگاه بین راه استفاده کنید که در Routes API مشخص کرده اید.