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

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

סקירה כללית

כדי לקבל מידע על המסלול הנוכחי, צריך לקבל את המאפיין המתאים ממופע 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);
}