إدارة نقاط الطريق

يوضّح هذا المستند كيفية إدارة الإعدادات المفضّلة للنقاط على المسار في تطبيقك باستخدام ميزتَين:

  • الإعدادات المفضّلة لتوجيه المسار على جانب الطريق
  • محطة توقف

ضبط الإعدادات المفضّلة للتوجيه حسب جانب الطريق

بشكل تلقائي، تعثر حزمة تطوير البرامج (SDK) للتنقّل على نظام التشغيل iOS على أسرع مسار إلى نقطة على المسار، ولكن هذا لا يضمن وصول المستخدم إلى الجانب المطلوب من الطريق، على سبيل المثال، جانب الطريق الذي ينتظر فيه عميل سائق مركبة مشتركة. تتيح لك ميزة تفضيل التوجيه حسب جانب الطريق التأكّد من وصول المركبة إلى الجانب الصحيح من الطريق.

آلية العمل

يمكنك ضبط الإعدادات المفضّلة للوصول إلى جانب معيّن من الطريق عند إنشاء نقطة على المسار لتلك المحطة. يمكنك تحديد الإعدادات المفضّلة بإحدى طريقتين.

أفضّل الجانب نفسه من الطريق

يمكنك تقديم الإحداثيات الجغرافية للنقطة على المسار، ثم ضبط علامة preferSameSideOfRoad تشير إلى أنّك تفضّل الوصول إلى جانب الطريق نفسه الذي تقع فيه النقطة على المسار، أي إلى أقرب رصيف.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                   preferSameSideOfRoad:(BOOL)preferSameSideOfRoad;

ضبط وجهة الوصول

يمكنك تقديم الإحداثيات الجغرافية للنقطة على المسار، ثم تقديم اتجاه الوصول preferredSegmentHeading الذي يتطابق مع اتجاه حركة المرور على الجانب نفسه من الطريق كالوجهة.

(nullable instancetype)initWithLocation:(CLLocationCoordinate2D)location
                                  title:(NSString *)title
                preferredSegmentHeading:(int32_t)preferredSegmentHeading;

تختار حزمة تطوير البرامج (SDK) للتنقّل الجزء من الطريق الأقرب إلى نقطة على المسار، والذي يتضمّن اتجاه مسار يتوافق (ضمن +/- 55 درجة) مع جانب الطريق الذي تقع عليه نقطة على المسار.

ضبط الإعدادات المفضّلة لمحطات التوقف

في بعض الأماكن، لا يمكن للمستخدمين التوقف بأمان (على سبيل المثال، المناطق المرتفعة والعبّارات والمواقع تحت الأرض والمناطق الأخرى التي يصعب الوصول إليها). تعمل ميزة التوقّف على نقل نقطة المسار إلى مكان قريب إذا كان موقعها الجغرافي غير مناسب لتوقّف المستخدم. عند ضبط vehicleStopover على YES، يتم نقل النقطة على المسار تلقائيًا عند احتساب المسار، في حال توفّر موقع جغرافي بديل.

آلية العمل

يمكنك ضبط الإعدادات المفضّلة للتوقّف عند إنشاء نقطة على المسار لهذا التوقّف. لإجراء ذلك، اضبط الإعدادات المفضّلة للتوقف في GMSNavigationMutableWaypoint كما هو موضّح في المثال التالي:

Swift

let location = CLLocationCoordinate2D(latitude: 47.67, longitude: -122.20)
let waypoint = GMSNavigationMutableWaypoint(location: location, title: "waypoint from location")!
waypoint.vehicleStopover = true
mapView.navigator?.setDestinations([waypoint], routingOptions: routingOptions, callback: {...})

Objective-C

CLLocationCoordinate2D location = CLLocationCoordinate2DMake(47.67, -122.20);
GMSNavigationMutableWaypoint *waypoint =
    [[GMSNavigationMutableWaypoint alloc] initWithLocation:location
                                                     title:@"waypoint from location"];
waypoint.vehicleStopover = YES;
[_mapView.navigator setDestinations:@[waypoint1]
                     routingOptions:routingOptions
                           callback:^(GMSRouteStatus routeStatus){...}];