Freigeben über

Berechnung von Routen zwischen Wegpunkt-Pins auf einer Karte (Vorschau)

[Dieses Thema ist eine Vorabdokumentation und kann geändert werden.]

Das Kartensteuerelement in einer Canvas-App kann mithilfe von Daten Wegpunkt-Pins hinzufügen, die aus einer Tabelle in einer Excel-Arbeitsmappe importiert wurden. Das Steuerelement kann Routen zwischen Wegpunkten berechnen, Wegpunkte neu anordnen und eine Route neu berechnen, um die Fahrzeit oder entfernung zu verbessern.

Von Bedeutung

  • Dies ist eine Vorschaufunktion.
  • Previewfunktionen sind nicht für den Produktionseinsatz gedacht und können eine eingeschränkte Funktionalität aufweisen. Diese Funktionen sind vor einer offiziellen Veröffentlichung verfügbar, damit Kunden frühzeitig zugreifen und Feedback geben können.

Sie benötigen eine Datenquelle, die eine benannte Tabelle mit den folgenden Spalten enthält. Jede Spalte entspricht einer erweiterten Eigenschaft des „Zuordnung“-Steuerelements. Jede Zeile wird als Wegpunkt auf der Karte angeheftet.

Spaltenname Entspricht Erforderlich
Name (oder Bezeichnung) RouteWaypointsLabels Wahlfrei
Longitude WegpunktkoordinatenLängengrade Optional (erforderlich, wenn adresse nicht angegeben wird)
Latitude RouteWaypointsLatitudes Optional (erforderlich, wenn adresse nicht angegeben wird)
Adresse RoutenWegpunkteAdressen Optional (erforderlich, wenn Längengrad und Breitengrad nicht angegeben werden)

Hinweis

Alle Eigenschaften sind technisch optional. Mindestens eine Adresse oder ein Breiten-/Längengrad-Paar muss jedoch angegeben werden, damit der Wegpunktstandort gezeichnet werden kann.

Importieren von Wegpunkt-Pins aus einer Excel-Tabelle

In diesem Beispiel importieren wir Waypoint-Daten aus einer Excel-Tabelle mit dem Namen "TestData".

Erstellen einer Datenquelle

  1. Erstellen Sie eine Tabelle in Excel mit den folgenden Daten. Benennen Sie die Tabelle TestData.

    Name Longitude Latitude Adresse
    Arbeit -122.156481 47.663448 1 Microsoft Way, Redmond, WA 98052
    Treffpunkt -122.221037 47.57137
    Schwimmen -122.144133 47.600373
    Tennis -122.137265 47.616115

    Ihre Tabelle sollte etwa wie folgt aussehen:

    Ein Excel-Beispielarbeitsblatt mit einer Tabelle mit dem Namen

  2. Speichern Sie die Arbeitsmappe auf Ihrem OneDrive for Business, und schließen Sie die Datei.

Binden der Datenquelle an ein Kartensteuerelement

  1. Erstellen Sie eine Canvas-App. Stellen Sie sicher, dass sie die geospatialen Voraussetzungen erfüllt.

  2. Fügen Sie ein Kartensteuerelement ein.

  3. Wählen Sie auf der Registerkarte "Eigenschaften " des Steuerelements das Feld "Route waypoints(Items)" aus, und geben Sie Excel ein.

    Ein Screenshot, der zeigt, wie Sie nach einer Waypoint-Datenquelle suchen, um eine Verbindung mit einem Kartensteuerelement in Power Apps Studio herzustellen.

  4. Wählen Sie "Aus Excel importieren" aus.

  5. Navigieren Sie zu Ihrem OneDrive for Business, und wählen Sie die Zuvor gespeicherte Excel-Arbeitsmappe aus.

  6. Wählen Sie die Tabelle "TestData" und dann "Verbinden" aus.

    Screenshot des Tabellenauswahlbereichs.

  7. Suchen Sie auf der Registerkarte "Erweitert " nach "RouteWaypointsLabels", "RouteWaypointsLatitudes", "RouteWaypointsLongitudes" und "RouteWaypointsAddresses ", und geben Sie den Namen der entsprechenden Spalte in der Tabelle ein. (Geben Sie in diesem Beispiel "Name " in "RouteWaypointsLabels", "Latitude " in "RouteWaypointsLatitudes" usw. ein.) Schließen Sie den Spaltennamen in Anführungszeichen ein.

    Hinweis

    Die Adresse ist austauschbar mit Breiten- und Längengrad. Wenn Breitengrad und Längengrad angegeben werden, wird die Adresse nicht verwendet. Wenn die Adresse angegeben wird, werden Breiten- und Längengrad nicht benötigt. Es gibt ein Limit für die Anzahl von Wegpunkten, die bei Verwendung der Adresse angezeigt werden können, damit Breitengrad und Längengrad nach Möglichkeit verwendet werden können.

Pins werden auf der Karte an den positionen angezeigt, die durch die Koordinaten oder Adressen in der Tabelle beschrieben werden. Wenn die Tabelle Beschriftungen enthält, werden die Pins beschriftet. Die Pins werden in der Reihenfolge nummeriert, in der die Wegpunktpositionen in der Tabelle angezeigt werden.

Screenshot einer Karte mit angehefteten und beschrifteten Wegpunkten neben den Eigenschaften der Karte.

Berechnen von Routen zwischen den Wegpunkten

Wenn das Kartensteuerelement ausgewählt ist, öffnen Sie die Registerkarte Eigenschaften und aktivieren Sie Routing aktivieren.

Das Steuerelement berechnet Routen zwischen den angehefteten Wegpunkten.

Screenshot einer Karte mit Routen zwischen angehefteten Wegpunkten.

Hinweis

Standardmäßig sortiert das Kartensteuerelement die Mittleren Wegpunkte neu, um die Reisezeit oder die Reisedistanz zu verringern. Die ersten und letzten Wegpunkte werden als Ursprung und Ziel betrachtet und können nicht neu angeordnet werden. Um die Wegpunkte in der Reihenfolge in der Datenquelle beizubehalten, aktivieren Sie die Eigenschaft "Wegpunkt-Reihenfolge verwalten" des Steuerelements.

Eigenschaften

Ändern Sie, wie eine Route mithilfe von Eigenschaften berechnet wird.

Eigentum Description Typ Registerkarte
Routing aktivieren Berechnet Routen zwischen Wegpunkten. Boolean Eigenschaften; Erweitert: UseRouting
Wegpunktreihenfolge beibehalten Bestimmt, ob eine berechnete Route Wegpunkte in der reihenfolge verwaltet, die in der Datenquelle angegeben ist. Boolean Eigenschaften; Erweitert: RouteMaintainOrder
Optimieren der Route Bestimmt, ob eine berechnete Route für Entfernung oder Zeit optimiert ist oder überhaupt nicht optimiert wird. Dropdownliste Eigenschaften; Erweitert: Routenoptimierung
Routenreisemodus Bestimmt, ob eine Route für ein Auto oder einen Lkw berechnet wird, was möglicherweise die Vermeidung von Brücken mit bestimmten Höhen- oder Gewichtseinschränkungen erfordert. Dropdownliste Eigenschaften; Erweitert: RouteTravelMode
Routennadeln anzeigen Legt fest, ob Stecknadeln über den Wegpunkten der Route angezeigt werden. Boolean Eigenschaften; Erweitert: RoutenmarkierungenAnzeigen

Ausgabeeigenschaften

Einige Eigenschaften sind nur verfügbar, wenn sich eine berechnete Route ändert. Diese Ausgabeeigenschaften werden im RouteDirection-Objekt platziert. Das OnRouteDirectionChange-Ereignis ist eine empfohlene Methode zum Verwenden der Ausgabe in anderen Steuerelementen oder zum Anpassen der App-Oberfläche.

Eigentum Description Typ Registerkarte
OnRouteDirectionChange Enthält Code, der ausgeführt wird, wenn die Route geändert wird. Event Advanced
RouteDirection Beschreibt die Routingausgaben:
  • LengthInMeters: Die Länge in Metern der gesamten Route
  • TravelTimeInSeconds: Die erwartete Fahrzeit in Sekunden der gesamten Route
  • RouteGeoJSON: Eine Zeichenfolge, die die Route im GeoJSON-Format beschreibt
  • RouteLegs: Eine Tabelle, die die einzelnen Streckenabschnitte beschreibt:
    • Index: Eine Zahl, die die Reihenfolge des Beins in der Route darstellt
    • LengthInMeters: Die Länge des Beins in Metern
    • TravelTimeInSeconds: Die erwartete Fahrzeit des Beins in Sekunden
    • StartLabel: Die Beschriftung des Anfangspunkts des Beins
    • StartLatitude: Der Breitengrad des Startpunkts der Etappe
    • StartLongitude: Der Längengrad des Startpunkts des Abschnitts
    • StartAddress: Die Adresse des Anfangspunkts des Beins
    • EndLabel: Die Beschriftung des Endpunkts des Abschnitts
    • EndLatitude: Der Breitengrad des Endpunkts der Strecke
    • EndLongitude: Der Längengrad des Endpunkts des Abschnitts
    • EndAddress: Die Adresse des Endpunkts des Abschnitts
  • OrderedWaypoints: Eine Tabelle, die jeden Wegpunkt beschreibt, nachdem die Wegpunkte sortiert wurden:
    • Index: Eine Zahl, die die Reihenfolge des Wegpunkts in der Route darstellt
    • Beschriftung: Die Beschriftung des Wegpunkts
    • Breitengrad: Der Breitengrad des Wegpunkts
    • Längengrad: Der Längengrad des Wegpunkts
    • Adresse: Die Adresse des Wegpunkts
 Object Nicht zutreffend (nur Ausgabeeigenschaft)

Siehe auch

Interaktives Kartensteuerelement

  • Last updated on