Routeninformationen abrufen

In dieser Anleitung erfahren Sie, wie Sie Ihre App so einrichten, dass sie Zeiten, Entfernungen und Routenabschnitte für die aktuelle Route abrufen kann.

Übersicht

Wenn Sie Informationen zur aktuellen Route abrufen möchten, rufen Sie die entsprechende Property aus der navigator-Instanz ab:

Code

Zeit bis zum nächsten Ziel abrufen

Rufen Sie timeToNextDestination() auf, um die Zeit bis zum nächsten Ziel abzurufen. Dadurch wird ein NSTimeInterval-Wert zurückgegeben. Im folgenden Beispiel wird die Zeit bis zum nächsten Ziel protokolliert:

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

Entfernung zum nächsten Ziel abrufen

Rufen Sie distanceToNextDestination() auf, um die Entfernung zum nächsten Ziel abzurufen. Dadurch wird ein CLLocationDistance-Wert zurückgegeben. Die Einheiten werden in Metern angegeben.

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

Verkehrsbedingungen bis zum nächsten Ziel abrufen

Rufen Sie delayCategoryToNextDestination auf, um einen Wert abzurufen, der den Verkehrsfluss bis zum nächsten Ziel angibt. Dieser Parameter gibt GMSNavigationDelayCategory zurück. Im folgenden Beispiel wird das Ergebnis ausgewertet und eine Verkehrsmeldung protokolliert:

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

Informationen zum aktuellen Routenabschnitt abrufen

Rufen Sie currentRouteLeg auf, um Informationen zum aktuellen Routenabschnitt abzurufen. Dadurch wird eine GMSRouteLeg-Instanz zurückgegeben, aus der Sie Folgendes abrufen können:

  • Das Ziel des Routenabschnitts.
  • Die letzte Koordinate im Routenabschnitt.
  • Der Pfad mit den Koordinaten, aus denen der Routenabschnitt besteht.

Im folgenden Beispiel werden der Titel und die Koordinaten (Breitengrad/Längengrad) für den nächsten Routenabschnitt protokolliert:

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

Zuletzt zurückgelegten Weg abrufen

Rufen Sie traveledPath auf, um den zuletzt zurückgelegten Weg abzurufen. Dadurch wird eine GMSPath -Instanz zurückgegeben, die vereinfacht wurde, um redundante Punkte zu entfernen (z. B. werden aufeinanderfolgende kollineare Punkte in ein einzelnes Liniensegment umgewandelt). Dieser Pfad ist leer, bis die Navigation gestartet wird. Im folgenden Beispiel wird der zuletzt zurückgelegte Weg abgerufen:

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