קבלת מידע על המסלול

במדריך הזה מוסבר איך להגדיר את האפליקציה כך שתוכל לאחזר את זמני הנסיעה, המרחקים והקטעים במסלול הנוכחי.

סקירה כללית

כדי לקבל מידע על המסלול הנוכחי, מקבלים את הנכס המתאים מהמכונה 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, שממנו אפשר לקבל:

  • היעד של הקטע.
  • הקואורדינטה האחרונה בקטע.
  • הנתיב שמכיל את הקואורדינטות שמרכיבות את מקטע המסלול.

בדוגמה הבאה מוצג רישום ביומן של השם ושל קואורדינטות ה-lat/lng של הקטע הבא במסלול:

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);
}