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

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

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

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

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

آلية العمل

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

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

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

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

ملاحظة مهمة: في بعض الحالات، عندما يتم محاذاة نقطة على المسار مع جانب أقرب طريق، قد لا يكون هذا الطريق هو الطريق الصحيح. على سبيل المثال، قد تكون هذه المنطقة عبارة عن طريق يقع بالقرب من عميل ينتظر سيارة أجرة مشتركة. يمكنك منع حدوث ذلك باستخدام preferredSegmentHeading بدلاً من 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){...}];