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

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

نظرة عامة

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