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

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

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

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

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