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

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

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

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

تجد حزمة تطوير البرامج (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){...}];