Obtenir des informations sur l'itinéraire

Suivez ce guide pour configurer votre application afin de récupérer les durées, les distances et les étapes de l'itinéraire actuel.

Présentation

Pour obtenir des informations sur l'itinéraire actuel, récupérez la propriété appropriée à partir de l'instance navigator :

Voir le code

Obtenir la durée jusqu'à la prochaine destination

Pour obtenir la durée jusqu'à la prochaine destination, appelez timeToNextDestination(). Cette méthode renvoie une valeur NSTimeInterval. L'exemple suivant montre comment enregistrer la durée jusqu'à la prochaine destination :

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

Obtenir la distance jusqu'à la prochaine destination

Pour obtenir la distance jusqu'à la prochaine destination, appelez distanceToNextDestination(). Cette méthode renvoie une valeur CLLocationDistance. Les unités sont spécifiées en mètres.

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

Obtenir les conditions de circulation jusqu'à la prochaine destination

Pour obtenir une valeur indiquant le flux de trafic jusqu'à la prochaine destination, appelez delayCategoryToNextDestination. Ce paramètre renvoie GMSNavigationDelayCategory. L'exemple suivant montre comment évaluer le résultat et enregistrer un message de trafic :

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

Obtenir des informations sur l'étape actuelle

Pour obtenir des informations sur l'étape actuelle de l'itinéraire, appelez currentRouteLeg. Cette méthode renvoie une instance GMSRouteLeg, à partir de laquelle vous pouvez obtenir les informations suivantes :

  • La destination de l'étape.
  • La coordonnée finale de l'étape.
  • Le chemin contenant les coordonnées qui composent l'étape de l'itinéraire.

L'exemple suivant montre comment enregistrer le titre et les coordonnées de latitude/longitude de l'étape suivante de l'itinéraire :

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

Obtenir le chemin parcouru le plus récemment

Pour obtenir le chemin parcouru le plus récemment, appelez traveledPath. Cette méthode renvoie une GMSPath instance qui a été simplifiée pour supprimer les points redondants (par exemple en transformant des points colinéaires consécutifs en un seul segment de ligne). Ce chemin est vide jusqu'à ce que le guidage commence. L'exemple suivant montre comment obtenir le chemin parcouru le plus récemment :

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