الحصول على معلومات المسار

اتّبِع هذا الدليل لإعداد تطبيقك لاسترداد الأوقات والمسافات وأجزاء المسار الحالي.

نظرة عامة

للحصول على معلومات حول المسار الحالي، يمكنك الحصول على السمة المناسبة من مثيل navigator:

الاطّلاع على الرمز

جارٍ الحصول على الوقت اللازم للوصول إلى الوجهة التالية

لمعرفة الوقت المتبقي للوصول إلى الوجهة التالية، يُرجى الاتصال بالرقم timeToNextDestination(). يؤدي ذلك إلى عرض قيمة NSTimeInterval. يوضح المثال التالي تسجيل الوقت إلى الوجهة التالية:

Swift

if let navigator = mapView.navigator {
  let time = navigator.timeToNextDestination
  let minutes = floor(time/60)
  let seconds = round(time - minutes * 60)
  NSLog("Time to next destination: %.0f:%.0f", minutes, seconds)
}

Objective-C

NSTimeInterval time = _mapView.navigator.timeToNextDestination;
int minutes = floor(time/60);
int seconds = round(time - minutes * 60);
NSLog(@"%@", [NSString stringWithFormat:@"Time to next destination: %i:%i.", minutes, seconds]);

جارٍ الحصول على المسافة إلى الوجهة التالية

لمعرفة المسافة إلى الوجهة التالية، يمكنك استدعاء distanceToNextDestination(). يؤدي ذلك إلى عرض قيمة CLLocationDistance. يتم تحديد الوحدات بالمتر.

Swift

if let navigator = mapView.navigator {
  let distance = navigator.distanceToNextDestination
  let miles = distance * 0.00062137
  NSLog("Distance to next destination: %.2f miles.", miles)
}

Objective-C

CLLocationDistance distance = _mapView.navigator.distanceToNextDestination;
double miles = distance * 0.00062137;
NSLog(@"%@", [NSString stringWithFormat:@"Distance to next destination: %.2f.", miles]);

جارٍ الحصول على أحوال حركة المرور إلى الوجهة التالية

للحصول على قيمة تشير إلى تدفق الزيارات إلى الوجهة التالية، يمكنك استدعاء delayCategoryToNextDestination. تعرض هذه المَعلمة GMSNavigationDelayCategory. يوضّح المثال التالي تقييم النتيجة وتسجيل رسالة عن عدد الزيارات:

Swift

if let navigator = mapView.navigator {
  // insert sample for evaluating traffic value
  let delay = navigator.delayCategoryToNextDestination
  let traffic = "unavailable"
  switch delay {
    case .noData:
      traffic = "unavailable"
    case .heavy:
      traffic = "heavy"
    case .medium:
      traffic = "moderate"
    case .light:
      traffic = "light"
    default:
      traffic = "unavailable"
  }
  print("Traffic is \(traffic).")
}

Objective-C

GMSNavigationDelayCategory delay = mapView.navigator.delayCategoryToNextDestination;
NSString *traffic = @"";

switch (delayCategory) {
    case GMSNavigationDelayCategoryNoData:
      traffic = @"No Data";
      break;
    case GMSNavigationDelayCategoryHeavy:
      traffic = @"Heavy";
      break;
    case GMSNavigationDelayCategoryMedium:
      traffic = @"Medium";
      break;
    case GMSNavigationDelayCategoryLight:
      traffic = @"Light";
      break;
    default:
      NSLog(@"Invalid delay category: %zd", delayCategory);
 }

NSLog(@"%@", [NSString stringWithFormat:@"Traffic is %@.", traffic]);

الحصول على معلومات حول المرحلة الحالية

للحصول على معلومات عن الجزء الحالي من المسار، استخدِم currentRouteLeg. يؤدي ذلك إلى عرض مثيل GMSRouteLeg، يمكنك من خلاله الحصول على ما يلي:

  • وجهة المرحلة
  • الإحداثيات النهائية في المرحلة
  • المسار الذي يحتوي على الإحداثيات التي تشكّل جزء المسار

يوضّح المثال التالي تسجيل العنوان وإحداثيات خط العرض/خط الطول للمرحلة التالية من المسار:

Swift

if let navigator = mapView.navigator {
  let currentLeg = navigator.currentRouteLeg
  let nextDestination = currentLeg?.destinationWaypoint?.title
  let lat = currentLeg?.destinationCoordinate.latitude.description
  let lng = currentLeg?.destinationCoordinate.longitude.description
  NSLog(nextDestination! + ", " + lat! + "/" + lng!)
}

Objective-C

GMSRouteLeg *currentSegment = _mapView.navigator.currentRouteLeg;
NSString *nextDestination = currentSegment.destinationWaypoint.title;
CLLocationDegrees lat = currentSegment.destinationCoordinate.latitude;
CLLocationDegrees lng = currentSegment.destinationCoordinate.longitude;
NSLog(@"%@", [NSString stringWithFormat:@"%@, %f/%f", nextDestination, lat, lng]);

الحصول على آخر مسار تم التنقّل فيه

للحصول على أحدث مسار تم التنقّل فيه، يمكنك استدعاء traveledPath. يؤدي ذلك إلى عرض مثيل GMSPath تم تبسيطه لإزالة النقاط المكرّرة (على سبيل المثال، تحويل النقاط المتتالية على خط مستقيم واحد إلى مقطع خطي واحد). يكون هذا المسار فارغًا إلى أن تبدأ الإرشادات. يوضح المثال التالي الحصول على أحدث مسار تم السفر إليه:

Swift

if let navigator = mapView.navigator {
  let latestPath = navigator.traveledPath
  if latestPath.count() > 0 {
    let begin: CLLocationCoordinate2D = latestPath.coordinate(at: 0)
    let current: CLLocationCoordinate2D = latestPath.coordinate(at: latestPath.count() - 1)
    print("Path from (\(begin.latitude),\(begin.longitude)) to (\(current.latitude),\(current.longitude))")
  }
}

Objective-C

GMSPath *latestPath = mapView.navigator.traveledPath;
if (latestPath.count > 0) {
  CLLocationCoordinate2D begin = [latestPath coordinateAtIndex:0];
  CLLocationCoordinate2D current = [latestPath coordinateAtIndex:latestPath.count - 1];
  NSLog(@"Path from %f/%f to %f/%f",
        begin.latitude,
        begin.longitude,
        current.latitude,
        current.longitude);
}