Freigeben über


Interaktives Kartensteuerelement

Fügen Sie Ihren Canvas-Apps ganz einfach eine interaktive Karte hinzu. Zeichnen von Markierungen aus einer Datenquelle, die Adressen oder Breiten- und Längengradpaare enthält. Wenn Sie verkleinern, werden die Markierungen optional gruppiert, um Datengruppen zu verdichten. Auf mobilen Geräten und Weboberflächen kann eine Karte die aktuelle Position des Benutzers anzeigen und eine Route zum Ziel des Benutzers berechnen. Karten können zwischen Straßen- und Satellitenansichten gewechselt werden.

Screenshot einer Tablet-App, in der ein Kartensteuerelement in Microsoft Power Apps Studio erstellt wird.

Interaktive Kartenfeatures

Voraussetzungen

Sie müssen einige Voraussetzungen erfüllen, bevor Sie Karten in Ihren Canvas-Apps verwenden können. Weitere Informationen dazu, wie unterschiedliche Kartenfeatures Daten verwenden, finden Sie in der Datenschutz- und Sicherheitstabelle .

Hinzufügen einer Karte zu einem App-Bildschirm

Wenn Ihre App zur Bearbeitung in Power Apps Studio geöffnet ist:

  1. Wählen Sie die Registerkarte "Einfügen " aus, und erweitern Sie "Medien".
  2. Wählen Sie "Karte" aus, um eine Karte auf dem App-Bildschirm zu platzieren, oder ziehen Sie das Steuerelement auf den Bildschirm, um es genauer zu positionieren.

Hinzufügen von Pins, Routen und Formen

Stecknadeln, Routen und Formen sind Dataset-Eigenschaften, die sowohl eine Datenquelle, bei der es sich um eine Tabelle aus einer Sammlung oder einem Konnektor handelt, als auch die relevanten Spalten identifizieren müssen. Die Datenquelle wird in der Items-Eigenschaft festgelegt (Items für Stecknadeln, RouteWaypoints_Items für Routen, Shape_Items für Shapes) und die relevanten Spalten werden in den zugehörigen Eigenschaften festgelegt (z. B. ItemLatitudes, ItemLongitudes usw. für Stecknadeln). Der Abschnitt "Eigenschaften" enthält zusätzliche Informationen zu diesen Datensätzen und deren zugehörige Eigenschaften.

Wenn Sie beispielsweise eine Tabellenauflistung namens "Locations " mit den Spalten "Name", "Längengrad" und "Breitengrad " hatten:

Name Longitude Latitude
"Fourth Coffee" (Beispiel) -98.29277 26.2774
Litware, Inc. (Beispiel) -96.85572 32.55253
Adventure Works (Beispiel) -96.99952 32.72058

So zeigen Sie diese als beschriftete Pins auf der Karte an:

  1. Festlegen der Items-Eigenschaft auf "Locations"

  2. Festlegen der ItemLabels-Eigenschaft auf "Name"

  3. Festlegen der ItemLongitude-Eigenschaft auf "Längengrad"

  4. Festlegen der ItemLatitude-Eigenschaft auf "Latitude"

    Von Bedeutung

    Die relevanten Spaltennamen müssen sich in Anführungszeichen in den zugehörigen Eigenschaften befinden. Die Datenquelle sollte keine Anführungszeichen enthalten.

Sie können sehen, wie Sie Pins aus einem Excel-Blatt anzeigen oder eine App erstellen , die das Adresseingabesteuerelement verwendet, um Pins im Kartensteuerelement als zusätzliche Beispiele aufzufüllen.

Hinweis

  • Jedes Kartensteuerelement kann bis zu 5000 Pins von Breiten- oder Längengrad und 50 Pins von Adressen anzeigen. Das Pin-Limit ist für Adressen geringer, da die Karte diese Adressen in Breiten- oder Längengrad geocodieren muss, um sie anzuzeigen. Es wird empfohlen, nach Möglichkeit keine Adressen zu verwenden. Sie können geocodierte Adressen wieder in Ihrer Datenquelle speichern.
  • Wenn sowohl Breiten- als auch Längengrad und eine Adresse für einen einzelnen Pin angegeben werden, priorisiert das Kartensteuerelement die Verwendung des Breiten- oder Längengrads, um die Geocodierung der Adresse zu vermeiden.
  • Die maximale Anzahl von Shapes, die in einem Kartensteuerelement gezeichnet werden können, ist auf 500 beschränkt.

Eigenschaften

Ändern sie das Verhalten und die Darstellung einer Karte mithilfe von Eigenschaften. Einige Eigenschaften sind nur auf der Registerkarte "Erweitert " verfügbar.

Screenshot einer Smartphone-App, in der neben der Registerkarte

Das Kartensteuerelement verfügt über sechs verschiedene Eigenschaftentypen:

  1. Stileigenschaften
  2. Verhaltenseigenschaften
  3. Pin-Eigenschaften
  4. Routeneigenschaften
  5. Shape-Eigenschaften
  6. Ausgabeeigenschaften

Stileigenschaften

Eigentum Description Typ Registerkarte
Satellitenansicht Zeigt die Karte in der Satellitenansicht an. Lassen Sie diese Eigenschaft deaktiviert, um die Karte in der Straßenansicht anzuzeigen. Boolean Eigenschaften; Erweitert: SatelliteView
Kartenformat Legt den Kartenstil fest. Optionen: Straße, Nacht, Straße mit schattiertem Relief, Satellit, Satelliten-Straßenbezeichnung, Hoher Kontrast hell, Hoher Kontrast dunkel, Graustufen hell, Graustufen dunkel. Enumeration Eigenschaften
Transparenz Bestimmt die Transparenz der Karte von 0 (undurchsichtig) bis 100 (transparent). Integer Eigenschaften; Erweitert: Transparenz
Sichtbar Blendet die Karte ein oder aus. Boolean Eigenschaften; Erweitert: Sichtbar
Position Platziert die obere linke Ecke der Karte an den bildschirmkoordinaten, die in x und y angegeben sind. Gleitkommazahl Eigenschaften; Erweitert: X, Y
Size Bestimmt die Größe der Karte mithilfe der Pixelwerte, die in Breite und Höhe angegeben sind. Integer Eigenschaften; Erweitert: Breite, Höhe
Rahmenradius Bestimmt den Eckenradius des Kartenrahmens. Gleitkommazahl Eigenschaften; Erweitert: BorderRadius
Border Bestimmt den Stil, die Breite und die Farbe des Kartenrahmens. Nicht anwendbar Eigenschaften; Erweitert: BorderStyle, BorderThickness, BorderColor
DisplayMode Bestimmt, ob das Steuerelement Benutzereingaben (Bearbeiten) zulässt, nur Daten (Ansicht) anzeigt oder deaktiviert ist (deaktiviert). Enumeration Advanced

Verhaltenseigenschaften

Eigentum Description Typ Registerkarte
Infokarten anzeigen Zeigt Informationen über einen kartierten Ort an, wenn der Benutzer ihn aussucht (bei Klick) oder wenn der Benutzer darauf zeigt (bei Hover). Wenn keine, werden keine Informationen angezeigt. Enumeration Eigenschaften; Erweitert: InfoCards
Standardspeicherort verwenden Initialisiert die Karte an einem Standardstandort. Boolean Eigenschaften; Erweitert: Standardstandort
Standardbreite Legt die Breitenkoordinate fest, die auf der Karte angezeigt wird, wenn die Standardposition verwenden aktiviert ist. Gleitkommazahl Eigenschaften; Erweitert: DefaultLatitude
Standardlängengrad Legt die Längengradkoordinate fest, die auf der Karte angezeigt wird, wenn die Standardposition verwenden aktiviert ist. Gleitkommazahl Eigenschaften; Erweitert: DefaultLongitude
Standardzoomfaktor Legt den Zoomfaktor fest, wenn Standardposition verwenden aktiviert ist, von 0 bis 22. Integer Eigenschaften; Erweitert: DefaultZoomLevel
Aktuelle Position anzeigen Zeigt die aktuelle Position des Benutzers an. Boolean Eigenschaften; Erweitert: CurrentLocation
Breitengrad der aktuellen Position Legt die Breitenkoordinate des aktuellen Ortungspins fest, die die Karte anzeigt, wenn Aktuelle Position anzeigen aktiviert ist. Wenn Sie den Pin an der aktuellen Position des Benutzers platzieren möchten, legen Sie diese Eigenschaft auf "Location.Latitude" fest. Gleitkommazahl Eigenschaften; Erweitert: CurrentLocationLatitude
Aktueller Längengrad des Standorts Legt die Längengradkoordinate des aktuellen Standort-Stecknadeln fest, den die Karte anzeigt, wenn Show current location aktiviert ist. Wenn Sie den Pin an der aktuellen Position des Benutzers platzieren möchten, legen Sie diese Eigenschaft auf "Location.Longitude" fest. Gleitkommazahl Eigenschaften; Erweitert: CurrentLocationLongitude
Zoom-Steuerelement Zeigt das Zoomsteuerelement an. Boolean Eigenschaften; Erweitert: Zoom
Kompasssteuerung Zeigt die Kompasssteuerung an. Boolean Eigenschaften; Erweitert: Kompass
Pitchregelung Zeigt die Neigungssteuerung an. Boolean Eigenschaften; Erweitert: Pitch
TabIndex Gibt die Reihenfolge an, in der die Karte ausgewählt wird, wenn der Benutzer mithilfe der TAB-TASTE in der App navigiert. Integer Eigenschaften; Erweitert: Tab index
QuickInfo Bestimmt den Anzuzeigenden Text, wenn der Benutzer auf ein visuelles Element zeigt. String Advanced
ContentLanguage Bestimmt die Anzeigesprache der Karte, wenn sie sich von der in der App verwendeten Sprache unterscheidet. String Advanced
OnLoad Enthält Code, der ausgeführt wird, wenn die Karte geladen wird. Event Advanced
OnMapClick Enthält Code, der ausgeführt wird, wenn der Benutzer die Karte auswählt. Der Breiten- und Längengrad des geklickten Punkts befindet sich in der ClickedLocation-Ausgabeeigenschaft . Event Advanced
OnChange Enthält Code, der ausgeführt wird, wenn ein beliebiger Aspekt der Karte geändert wird. Event Advanced
OnSelect Enthält Code, der ausgeführt wird, wenn der Benutzer etwas auf der Karte auswählt. Event Advanced

Pin-Eigenschaften

Eigentum Description Typ Registerkarte
Standorte(Artikel) Identifiziert eine Datenquelle (Elemente) in Form einer Tabelle, aus der Speicherorte abgerufen werden sollen, die auf der Karte angezeigt werden sollen. In der Tabelle sind Längen- und Breitengrade oder physische Adressen aufgeführt, die als Pins angezeigt werden sollen. Die Verwendung von Breiten- oder Längengrad wird empfohlen, da Adressen geocodiert werden müssen und daher ein restriktiveres Pinlimit aufweisen. Die Tabelle kann eine Sammlung oder aus einer Datenquelle wie Excel Online sein. Jede Zeile muss einen Eintrag für Beschriftung, Längengrad und Breitengrad oder eine physische Adresse sowie optional die Pinfarbe und das Symbol enthalten. Nicht anwendbar Eigenschaften; Erweitert: Elemente
Elementbeschriftungen Identifiziert die Spalte in "Items ", die die Beschriftungen für die Pins enthält. ColumnName Advanced
ItemsLatitudes Identifiziert die Spalte in "Items ", die die Breitenposition der Pins enthält. ColumnName Advanced
ItemsLongitudes Identifiziert die Spalte in "Items ", die die Längengradposition der Pins enthält. ColumnName Advanced
ItemsAddresses Identifiziert die Spalte in "Items ", die Adressen enthält, die die Position der Pins darstellen. Es gibt ein Limit für die Anzahl der Pins, die von Adressen angezeigt werden können. Wir empfehlen, Ihre Adressen nach Breitengrad, Längengradpaaren zu geocodieren und diese nach Möglichkeit zum Anzeigen von Pins zu verwenden. ColumnName Advanced
Artikel-Farben Identifiziert die Spalte in "Items ", die die Farben der Pins enthält. ColumnName Advanced
ItemsIcons Identifiziert die Spalte in "Elemente ", die die Symbole der Pins enthält. ColumnName Advanced
Clusterstecknadeln Gruppiert nahe gelegene Kartennadeln, anstatt sie einzeln anzuzeigen. Boolean Eigenschaften; Erweitert: Clustering
Stecknadel color Bestimmt die Standardfarbe von Pins, die auf der Karte angezeigt werden. Diese Farbe wird durch die ItemsColors-Eigenschaft überschrieben, wenn diese festgelegt ist Farbauswahl Eigenschaften; Erweitert: PinColor
OnItemsChange Enthält Code, der ausgeführt wird, wenn Pins auf der Karte geändert werden. Event Advanced

Routeneigenschaften

Eigentum Description Typ Registerkarte
Routing aktivieren Stellt fest, ob der Benutzer nach dem Weg zu einem angegebenen Ort fragen kann. Boolean Eigenschaften; Erweitert: UseRouting
Route-Wegpunkte (Einträge) Zeigt Routenwegpunkte an, wie in einer Datenquelle (RouteWaypoints_Items) in Form einer Tabelle angegeben. Die Tabelle kann eine Sammlung oder aus einer Datenquelle wie Excel Online sein. Wenn keine, werden keine Wegpunkte angezeigt. Enumeration Eigenschaften; Erweitert: RouteWaypoints_Items
RouteWaypointsLabels Identifiziert die Spalte in RouteWaypoints_Items , die die Beschriftungen für die Wegpunkte enthält. ColumnName Advanced
RouteWaypointsLatitudes Identifiziert die Spalte in RouteWaypoints_Items , die die Breitenposition der Wegpunkte enthält. ColumnName Advanced
WegpunktkoordinatenLängengrade Identifiziert die Spalte in RouteWaypoints_Items , die die Längengradposition der Wegpunkte enthält. ColumnName Advanced
RoutenWegpunkteAdressen Identifiziert die Spalte in RouteWaypoints_Items , die Adressen enthält, die den Speicherort von Wegpunkten darstellen. ColumnName Advanced
Wegpunktreihenfolge beibehalten Bestimmt, ob eine berechnete Route Wegpunkte in der angegebenen Reihenfolge verwaltet. Boolean Eigenschaften; Erweitert: RouteMaintainOrder
Optimieren der Route Bestimmt, ob eine berechnete Route für Entfernung oder Zeit optimiert ist oder überhaupt nicht optimiert wird. Enumeration 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. Enumeration Eigenschaften; Erweitert: RouteTravelMode
OnRouteDirectionChange Enthält Code, der ausgeführt wird, wenn die App erkennt, dass der Benutzer während einer berechneten Route die Richtung geändert hat. Event Advanced

Shape-Eigenschaften

Eigentum Description Typ Registerkarte
Formen anzeigen Zeigt die Formen in Shapes_Items an. Boolean Eigenschaften; Fortgeschritten: Formen anzeigen
Formen_Objekte Identifiziert eine Datenquelle (Shapes_Items) in Form einer Tabelle, aus der Shapes abgerufen werden sollen, die auf der Karte angezeigt werden sollen. Die Tabelle kann eine Sammlung oder aus einer Datenquelle wie Excel Online sein. Jede Zeile muss einen Eintrag für die Form (GeoJSON-Objekt) und (optional) eine Beschriftung und Farbe aufweisen. TableName Advanced
ShapeGeoJSONObjects Identifiziert die Spalte in Shapes_Items mit Zeichenfolgen, die die GeoJSON-Objekte der Formen darstellen, im Format einer Formen-Sammlung oder eines einzelnen Formen-GeoJSON. ColumnName Advanced
ShapeLabels Identifiziert die Spalte in Shapes_Items , die die Beschriftungen für die Shapes enthält. ColumnName Advanced
ShapeColors Identifiziert die Spalte in Shapes_Items , die die Farben der Formen enthält. ColumnName Advanced
Anzeigen von Formbeschriftungen Zeigt die Formbeschriftungen an, sofern angegeben. Boolean Eigenschaften; Erweitert: ShowShapeLabels
Form-Zeichnung aktivieren Zeigt Zeichentools auf der Karte an. Boolean Eigenschaften; Erweitert: ShapeDrawing
Aktivieren der Löschung von Formen und Beschriftungsbearbeitung Bestimmt, ob der Benutzer Shapes löschen und seine Beschriftungen bearbeiten kann. Boolean Eigenschaften; Erweitert: ShapeEditingDeleting
OnShapeCreated Enthält Code, der ausgeführt wird, wenn der Benutzer der Karte ein Shape hinzufügt. Event Advanced
OnShapeSelected Enthält Code, der ausgeführt wird, wenn der Benutzer ein Shape auf der Karte auswählt. Event Advanced
OnShapeEdited Enthält Code, der ausgeführt wird, wenn der Benutzer ein Shape auf der Karte ändert. Event Advanced
OnShapeDeleted Enthält Code, der ausgeführt wird, wenn der Benutzer ein Shape auf der Karte löscht. Event Advanced

Ausgabeeigenschaften

Andere Eigenschaften werden verfügbar, wenn ein Benutzer mit einer Karte interagiert. Sie können diese Ausgabeeigenschaften in anderen Steuerelementen verwenden oder die App-Oberfläche anpassen.

Eigentum Description Typ
CenterLocation Erfasst den Mittelpunkt der Karte. Nicht zutreffend
GeklickterStandort Erfasst den letzten Speicherort, den der Benutzer ausgewählt hat. Breitengrad oder . Längengrad. Datensatz
Selected Erfasst den ausgewählten Pin. Datensatz
SelectedItems Erfasst die ausgewählten Pin oder Pins innerhalb des ausgewählten Clusters. Table
GeocodierteElemente Erfasst die geocodierten Standorte der Pins. Table
Routenwegpunkte_Ausgewählt Entspricht dem Datensatz des ausgewählten Formobjekts in RouteWaypoints_Items. Datensatz
RouteWaypoints_SelectedItems Entspricht den Aufzeichnungen der ausgewählten überlappenden Formen in RouteWaypoints_Items. Table
Formen_Ausgewählt Entspricht dem Datensatz der ausgewählten Form in Shapes_Items. Datensatz
Formen_AusgewählteElemente Entspricht den datensätzen der ausgewählten überlappenden Formen in Shapes_Items. Table
SelectedShape Erfasst den .Umfang und die .Fläche der ausgewählten Form. Datensatz
DeletedShape Erfasst die .Umfang und .Fläche des letzten gelöschten Shapes. Datensatz
GeoJSON Erfasst die Liste der Shapes im GeoJSON-Format einer Feature-Sammlung. String

Andere geospatiale Steuerelemente

Wenn Sie während der Eingabe dynamische Adressvorschläge anzeigen möchten, verwenden Sie das Adresseingabesteuerelement .

Bekannte Einschränkungen

  • Erfordert Internetverbindung

Siehe auch

Erstellen einer App mit Adresseingabe und Kartensteuerelementen