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

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

نظرة عامة

للحصول على معلومات عن المسار الحالي، احصل على الموقع المناسب من مثيل 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);
}