互動式地圖控制項

輕鬆地將互動式地圖新增至您的畫布應用程式。 從包含位址或緯度和經度對的資料來源繪製標記。 縮小時，標記會選擇性地叢集以壓縮資料群組。 根據行動裝置和網路體驗，地圖可以顯示使用者的目前位置，並計算使用者目的地的路徑。 地圖可以在道路和衛星檢視之間切換。

互動式地圖功能

• 使用資料來源插入圖釘
• 顯示地圖圖釘的相關資訊
• 顯示導航點之間的路線
• 繪製並插入圖形

先決條件

您必須先符合幾項先決條件，才能在畫布應用程式中使用地圖。 有關不同地圖功能如何使用資料的更多詳細資訊，請參閱隱私權和安全性表單。

將地圖新增至應用程式畫面

在 Power Apps Studio 中開啟應用程式以進行編輯時：

1. 選取插入索引標籤，然後展開媒體。
2. 選取地圖將地圖放置在應用程式畫面中，或將控制項拖曳到畫面以更精確地定位。

新增圖釘、路徑和圖形

圖釘、路徑及圖形都是資料集屬性，它們需要標識資料來源 (來自集合或連接器的資料表) 和相關資料行。 資料來源在 Items 屬性中設定 (Items 用於圖釘，RouteWaypoints_Items 用於路線，Shape_Items 用於圖形)，相關資料行在相關屬性中設定 (例如 ItemLatitudes、ItemLongitudes 等用於圖釘)。 屬性區段包含有關這些資料集及其相關屬性的其他資訊。

例如，如果您有一個名為位置的資料表集合，其中包含名稱、經度和緯度資料行：

名稱	經度	緯度
Fourth Coffee (範例)	-98.29277	26.2774
Litware, Inc. (範例)	-96.85572	32.55253
Adventure Works (範例)	-96.99952	32.72058

要將這些顯示為地圖上的標記圖釘：

1. 將 Items 屬性設為「位置」

2. 將 ItemLabels 屬性設定為「名稱」

3. 將 ItemLongitude 屬性設定為「經度」

4. 將 ItemLatitude 屬性設定為「緯度」

   重要

   相關資料行名稱必須在相關屬性中用引號括起來。 資料來源不應該包含引號。

作為附加範例，您可以了解如何使用地址輸入控制項在 map 控制項上填入圖釘的顯示 Excel 工作表中的圖釘或組建應用程式。

注意

每個地圖控制項最多可以顯示 5000 個來自緯度或經度的圖釘，以及 50 個來自地址的圖釘。 地址的圖釘限制較低，因為地圖需要將這些地址地理編碼為緯度或經度以顯示它們。 建議盡量不要使用地址。 您可以將地理編碼地址儲存回資料來源。

當單一圖釘同時指定緯度或經度和地址時，地圖控制項將優先使用緯度或經度，以避免對地址進行地理編碼。

內容

使用屬性變更地圖的行為和外觀。 有些屬性只能在進階索引標籤上使用。

地圖控制項有六種不同類型的屬性：

1. Styling 屬性
2. Behavioral 屬性
3. Pin 屬性
4. Route 屬性
5. Shape 屬性
6. Output 屬性

Styling 屬性

屬性	描述	類型	索引標籤
衛星檢視	在衛星檢視中顯示地圖。 關閉此屬性以在道路檢視中顯示地圖。	布林值	屬性; 進階：SatelliteView
地圖樣式	設定地圖樣式。 選項：道路、夜晚、道路暈渲、衛星、衛星道路標籤、高對比度亮、高對比度暗、灰度亮、灰度暗。	列舉	屬性
透明度	決定地圖的透明度，從 0 (不透明) 到 100 (透明)。	整數	屬性; 進階：Transparency
Visible	顯示或隱藏地圖。	布林值	屬性; 進階：Visible
Position	將地圖的左上角放置在 x 與 y 中指定的畫面座標處。	浮點數	屬性; 進階：X，Y
Size	使用 Width 和 Height 中提供的像素值來決定地圖的大小。	整數	屬性; 進階：Width、Height
框線半徑	確定地圖框線的圓角半徑。	浮點數	屬性; 進階：BorderRadius
Border	確定地圖框線的樣式、寬度和顏色。	不適用	屬性; 進階：BorderStyle、BorderThickness、BorderColor
DisplayMode	確定控制項是允許使用者輸入 (編輯)、只顯示資料 (檢視) 還是停用 (已停用)。	列舉	進階

Behavioral 屬性

屬性	描述	類型	索引標籤
顯示資訊卡	當使用者選取它 (按一下) 或指向它 (暫留) 時，顯示有關對應位置的資訊。 如果無，則不會顯示任何資訊。	列舉	屬性; 進階：InfoCards
使用預設位置	會在預設位置初始化地圖。	布林值	屬性; 進階：DefaultLocation
Default latitude	設定啟用使用預設位置時，地圖所顯示的緯度座標。	浮點數	屬性; 進階：DefaultLatitude
Default longitude	如果已啟用使用預設位置，則設定地圖顯示的經度座標。	浮點數	屬性; 進階：DefaultLongitude
Default zoom level	若已啟用使用預設位置，則設定縮放等級 (從 0 到 22)。	整數	屬性; 進階：DefaultZoomLevel
Show current location	顯示使用者目前的位置。	布林值	屬性; 進階：CurrentLocation
目前位置的緯度	如果已啟用顯示目前位置，則設定地圖顯示的目前位置圖釘的緯度座標。 若要將圖釘放置在使用者目前的位置，請將此屬性設定為 Location.Latitude。	浮點數	屬性; 進階：CurrentLocationLatitude
目前位置經度	如果已啟用顯示目前位置，則設定地圖顯示的目前位置圖釘的經度座標。 若要將圖釘放置在使用者目前的位置，請將此屬性設定為 Location.Longitude。	浮點數	屬性; 進階：CurrentLocationLongitude
Zoom 控制項	顯示 zoom 控制項。	布林值	屬性; 進階：Zoom
Compass control	顯示 compass 控制項。	布林值	屬性; 進階：Compass
Pitch control	顯示 pitch (tilt) 控制項。	布林值	屬性; 進階：Pitch
TabIndex	指定使用者使用 Tab 索引鍵瀏覽應用程式時，選取地圖的順序。	Integer	屬性; 進階：Tab index
Tooltip	確定當使用者將滑鼠游標懸停在視覺效果上時要顯示的文字。	字串	進階
ContentLanguage	確定地圖的顯示語言 (如果其與應用程式中使用的語言不同)。	字串	進階
OnLoad	包含載入地圖時執行的程式碼。	事件	進階
OnMapClick	包含在使用者選取地圖時執行的程式碼。 已點擊點的緯度和經度位於 ClickedLocation 輸出屬性中。	事件	進階
OnChange	包含當地圖上發生任何變更時執行的程式碼。	事件	進階
OnSelect	包含在使用者在地圖上選取某些內容時執行的程式碼。	事件	進階

Pin 屬性

屬性	描述	類型	索引標籤
Locations(Items)	以資料表的格式標識資料來源 (項目)，從中取得要在地圖上顯示的位置。 該資料表列出要顯示為圖釘的經度和緯度組或實體地址。 建議使用緯度或經度，因為地址需要地理編碼，因此具有更嚴格的釘選限制。 此資料表可以是集合，或來自 Excel Online 等資料來源。 每一資料列都必須有標籤、經度和緯度項目，或是實體地址，以及可選擇的圖釘顏色和圖示。	不適用	屬性; 進階：Items
ItemsLabels	識別項目中包含圖釘標籤的資料行。	ColumnName	進階
ItemsLatitudes	識別項目中包含圖釘緯度位置的資料行。	ColumnName	進階
ItemsLongitudes	識別項目中包含圖釘經度位置的資料行。	ColumnName	進階
ItemsAddresses	識別項目中包含表示圖釘位置之地址的資料行。 可在地址上顯示的圖釘數量有限。 建議將您的地址地理編碼為緯度、經度對，並盡量使用它們來顯示圖釘。	ColumnName	進階
ItemsColors	識別項目中包含圖釘顏色的資料行。	ColumnName	進階
ItemsIcons	識別項目中包含圖釘圖示的資料行。	ColumnName	進階
叢集圖釘	將附近的地圖圖釘分組，而不是個別顯示。	布林值	屬性; 進階：Clustering
圖釘色彩	決定地圖上顯示的預設圖釘色彩。 如果設定，此色彩將由 ItemsColors 屬性覆蓋	顏色選擇器	屬性; 進階：PinColor
OnItemsChange	包含當地圖上的圖釘變更時執行的程式碼。	事件	進階

Route 屬性

屬性	描述	類型	索引標籤
啟用路線	確定使用者是否可以要求前往指定位置的路線。	布林值	屬性; 進階：UseRouting
Route waypoints(Items)	以資料表的格式顯示資料來源 (RouteWaypoints_Items) 中提供的路線航點。 此資料表可以是集合，或來自 Excel Online 等資料來源。 如果無，則不會顯示任何航點。	列舉	屬性; 進階：RouteWaypoints_Items
RouteWaypointsLabels	識別 RouteWaypoints_Items 中包含航點標籤的資料行。	ColumnName	進階
RouteWaypointsLatitudes	識別RouteWaypoints_Items中包含航點緯度位置的資料行。	ColumnName	進階
RouteWaypointsLongitudes	識別RouteWaypoints_Items中包含航點經度位置的資料行。	ColumnName	進階
RouteWaypointsAddresses	識別RouteWaypoints_Items中包含表示航點位置之地址的資料行。	ColumnName	進階
Maintain waypoint order	確定計算的路線是否按照提供的順序維護航點。	布林值	屬性; 進階：RouteMaintainOrder
Optimize route	確定計算的路線是針對距離、時間最佳化還是未最佳化。	列舉	屬性; 進階：RouteOptimization
Route travel mode	確定是為汽車還是卡車計算路線，這可能需要避開具有特定高度或重量限制的橋樑。	列舉	屬性; 進階：RouteTravelMode
OnRouteDirectionChange	包含當應用程式偵測到使用者在計算路線上改變方向時執行的程式碼。	事件	進階

Shape 屬性

屬性	描述	類型	索引標籤
顯示圖形	顯示 Shapes_Items 中的圖形。	布林值	屬性; 進階：ShowShapes
Shapes_Items	以資料表的格式標識資料來源 (Shapes_Items)，從中取得要在地圖上顯示的圖形。 此資料表可以是集合，或來自 Excel Online 等資料來源。 每資料列必須有一個圖形項目 (GeoJSON 物件) 和 (選擇性) 標籤和顏色。	TableName	進階
ShapeGeoJSONObjects	用表示圖形的 GeoJSON 物件字串識別 Shapes_Items 中的資料行，採用圖形集合或單一圖形 GeoJSON 格式。	ColumnName	進階
ShapeLabels	識別Shapes_Items中包含圖形標籤的資料行。	ColumnName	進階
ShapeColors	識別Shapes_Items中包含圖形顏色的資料行。	ColumnName	進階
顯示圖形標籤	顯示圖形標籤 (如果有的話)。	布林值	屬性; 進階：ShowShapeLabels
Enable shape drawing	在地圖上顯示繪圖工具。	布林值	屬性; 進階：ShapeDrawing
Enable shape deleting and label editing	確定使用者是否可以刪除圖形並編輯其標籤。	布林值	屬性; 進階：ShapeEditingDeleting
OnShapeCreated	包含在使用者將圖形新增到地圖時執行的程式碼。	事件	進階
OnShapeSelected	包含在使用者在地圖上選取圖形時執行的程式碼。	事件	進階
OnShapeEdited	包含在使用者在地圖上修改圖形時執行的程式碼。	事件	進階
OnShapeDeleted	包含在使用者在地圖上刪除圖形時執行的程式碼。	事件	進階

Output 屬性

當使用者與地圖進行互動時，其他屬性會變得可用。 您可以在其他控制項中使用這些輸出屬性，也可以自訂應用程式體驗。

屬性	描述	類型
CenterLocation	擷取地圖的中心點。	不適用
ClickedLocation	擷取使用者選取的最後一個位置，.Latitude 或 .Longitude。	錄製
已選取	擷取選取的圖釘。	錄製
SelectedItems	擷取所選叢集的一個或多個所選圖釘。	資料表
GeocodedItems	擷取圖釘的地理編碼位置。	資料表
RouteWaypoints_Selected	對應 RouteWaypoints_Items 中所選圖形的記錄。	錄製
RouteWaypoints_SelectedItems	對應 RouteWaypoints_Items 中所選重疊圖形的記錄。	資料表
Shapes_Selected	對應 Shapes_Items 中所選圖形的記錄。	記錄
Shapes_SelectedItems	對應 Shapes_Items 中所選重疊圖形的記錄。	資料表
SelectedShape	擷取所選圖形的 .Perimeter 和 .Area。	記錄
DeletedShape	擷取最後刪除圖形的 .Perimeter 和 .Area。	記錄
GeoJSON	以功能集合 GeoJSON 格式捕擷取圖形清單。	字串

其他地理空間控制項

若要在輸入時查看動態地址建議，請使用**地址輸入** 控制項。

注意

是否能請您告知您偏好的慣用文件語言？ 請填寫問卷。 (請注意，本問卷為英文版)

完成問卷大約需要七分鐘。 本問卷將不會收集個人資料 (隱私權聲明)。

已知限制

• 需要網際網路連線

另請參閱

建立包含地址輸入和地圖控制項的應用程式