Anzeigen von Routen und Wegbeschreibungen auf einer Karte

Artikel
07/13/2023

Hinweis

MapControl und Kartendienste erfordern einen Karten-Authentifizierungsschlüssel namens MapServiceToken. Weitere Informationen zum Abrufen und Festlegen eines Kartenauthentifizierungsschlüssels finden Sie unter Anfordern eines Kartenauthentifizierungsschlüssels.

Fordern Sie Routen und Wegbeschreibungen an, und zeigen Sie sie in Ihrer App an.

Hinweis

Wenn Sie mehr über die Verwendung von Karten in Ihrer App erfahren möchten, laden Sie das Kartenbeispiel Universelle Windows-Plattform (UWP) herunter. Wenn die Zuordnung kein Kernfeature Ihrer App ist, sollten Sie stattdessen die Windows-Karten-App starten. Sie können die URI-Schemas bingmaps:, ms-drive-to: und ms-walk-to: zum Starten der Windows-Karten-App für bestimmte Karten und für Wegbeschreibungen mit Sprachnavigation verwenden. Weitere Informationen finden Sie unter Starten der Windows-Karten-App.

Eine Einführung in die MapRouteFinder-Ergebnisse

Hier erfahren Sie, wie Klassen für Routen und Wegbeschreibungen zusammenhängen.

Die MapRouteFinder-Klasse verfügt über Methoden zum Abrufen von Routen und Wegbeschreibungen. Diese Methoden geben ein MapRouteFinderResult zurück.
Das MapRouteFinderResult enthält ein MapRoute-Objekt. Greifen Sie über die Route-Eigenschaft des MapRouteFinderResult auf dieses Objekt zu.
Die MapRoute enthält eine Sammlung von MapRouteLeg-Objekten. Greifen Sie über die Legs-Eigenschaft der MapRoute auf diese Sammlung zu.
Jeder MapRouteLeg enthält eine Sammlung von MapRouteManeuver-Objekten. Greifen Sie über die Maneuvers-Eigenschaft des MapRouteLeg auf diese Sammlung zu.

Rufen Sie eine Fahr- oder Wanderroute und Wegbeschreibungen ab, indem Sie die Methoden der MapRouteFinder-Klasse aufrufen. Beispiel : GetDrivingRouteAsync oder GetWalkingRouteAsync.

Wenn Sie eine Route anfordern, können Sie Folgendes angeben:

Sie können nur einen Startpunkt und einen Endpunkt oder eine Reihe von Wegpunkten zur Berechnung angeben.

Stop-Wegpunkte fügen zusätzliche Routenpunkte hinzu, die jeweils eine eigene Reiseroute haben. Verwenden Sie zum Angeben von Stoppwegpunkten eine der GetDrivingRouteFromWaypointsAsync-Überladungen .

Über Wegpunkt werden Zwischenstandorte zwischen Stoppwegpunkten definiert. Sie fügen keine Routenbeine hinzu. Sie sind lediglich Wegpunkte, durch die eine Route gehen muss. Um über Wegpunkte anzugeben, verwenden Sie eine der GetDrivingRouteFromEnhancedWaypointsAsync-Überladungen .
Sie können Optimierungen angeben (z. B. minimieren Sie die Entfernung).
Sie können Einschränkungen angeben (z. B.: Vermeiden von Autobahnen).

Anzeigen von Wegbeschreibungen

Das MapRouteFinderResult-Objekt enthält ein MapRoute-Objekt, auf das Sie über seine Route-Eigenschaft zugreifen können.

Die berechnete MapRoute hat Eigenschaften, die die Zeit zum Zurücklegen der Route, die Länge der Route und die Auflistung von MapRouteLeg-Objekten bereitstellen, die die Teilstrecken der Route enthalten. Jedes MapRouteLeg-Objekt enthält eine Auflistung von MapRouteManeuver-Objekten. Das MapRouteManeuver-Objekt enthält eine Wegbeschreibung, auf die Sie über seine InstructionText-Eigenschaft zugreifen können.

Wichtig

Sie müssen einen Kartenauthentifizierungsschlüssel angeben, bevor Sie Kartendienste verwenden können. Weitere Informationen finden Sie unter Anfordern eines Kartenauthentifizierungsschlüssels.

using System;
using Windows.UI.Xaml;
using Windows.UI.Xaml.Controls;
using Windows.Services.Maps;
using Windows.Devices.Geolocation;
...
private async void button_Click(object sender, RoutedEventArgs e)
{
   // Start at Microsoft in Redmond, Washington.
   BasicGeoposition startLocation = new BasicGeoposition() {Latitude=47.643,Longitude=-122.131};

   // End at the city of Seattle, Washington.
   BasicGeoposition endLocation = new BasicGeoposition() {Latitude = 47.604,Longitude= -122.329};

   // Get the route between the points.
   MapRouteFinderResult routeResult =
         await MapRouteFinder.GetDrivingRouteAsync(
         new Geopoint(startLocation),
         new Geopoint(endLocation),
         MapRouteOptimization.Time,
         MapRouteRestrictions.None);

   if (routeResult.Status == MapRouteFinderStatus.Success)
   {
      System.Text.StringBuilder routeInfo = new System.Text.StringBuilder();

      // Display summary info about the route.
      routeInfo.Append("Total estimated time (minutes) = ");
      routeInfo.Append(routeResult.Route.EstimatedDuration.TotalMinutes.ToString());
      routeInfo.Append("\nTotal length (kilometers) = ");
      routeInfo.Append((routeResult.Route.LengthInMeters / 1000).ToString());

      // Display the directions.
      routeInfo.Append("\n\nDIRECTIONS\n");

      foreach (MapRouteLeg leg in routeResult.Route.Legs)
      {
         foreach (MapRouteManeuver maneuver in leg.Maneuvers)
         {
            routeInfo.AppendLine(maneuver.InstructionText);
         }
      }

      // Load the text box.
      tbOutputText.Text = routeInfo.ToString();
   }
   else
   {
      tbOutputText.Text =
            "A problem occurred: " + routeResult.Status.ToString();
   }
}

Dieses Beispiel zeigt die folgenden Ergebnisse im tbOutputText-Textfeld an:

Total estimated time (minutes) = 18.4833333333333
Total length (kilometers) = 21.847

DIRECTIONS
Head north on 157th Ave NE.
Turn left onto 159th Ave NE.
Turn left onto NE 40th St.
Turn left onto WA-520 W.
Enter the freeway WA-520 from the right.
Keep left onto I-5 S/Portland.
Keep right and leave the freeway at exit 165A towards James St..
Turn right onto James St.
You have reached your destination.