共用方式為

互動式地圖控制

輕鬆將互動式地圖新增至您的畫布應用程式。 從包含地址或緯度和經度配對的資料來源繪製標記。 當您縮小視圖時，標記可能會自動分組，將資料群組進行聚合。 在行動裝置和網路體驗中，地圖可以顯示使用者目前的位置，並計算前往使用者目的地的路線。 地圖可以在道路和衛星視圖之間切換。

平板電腦應用程式的螢幕擷取畫面，其中地圖控制項正在 Microsoft Power Apps Studio 中建置中。

互動式地圖功能

先決條件

您必須先滿足一些先 決條件 ，才能在畫布應用程式中使用地圖。 請參閱 隱私權與安全性表格 ，以取得不同地圖功能如何使用資料的詳細資訊。

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

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

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

新增圖釘、路線和圖形

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

例如，如果您有名為 Locations 的資料表集合，其中包含 Name、 Longitude 和 Latitude 資料行：

名稱 緯度 緯度
第四杯咖啡（樣品） -98.29277 26.2774
Litware， Inc. （範例） -96.85572 32.55253
Adventure Works （範例） -96.99952 32.72058

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

  1. 將 Items 屬性設定為 Locations

  2. 將 ItemLabels 屬性設定為 “Name”

  3. 將 ItemLongitude 屬性設定為 “Longitude”

  4. 將 ItemLatitude 屬性設定為 “Latitude”

    這很重要

    相關資料行名稱必須在相關屬性中加上引號。 資料來源不應有引號。

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

備註

  • 每個地圖控制項最多可以顯示 5000 個來自緯度或經度的圖釘，以及 50 個來自地址的圖釘。 地址的引腳限制較低，因為地圖需要將這些地址地理編碼為緯度或經度才能顯示它們。 建議您盡可能不要使用地址。 您可以 將地理編碼的地址儲存回資料來源。
  • 當同時為單一標記提供緯度或經度及地址時，地圖工具會優先使用緯度或經度，以避免對地址進行地理編碼。
  • 地圖控制項中可繪製的圖形數目上限限制為 500。

屬性

使用屬性變更地圖的行為和外觀。 某些屬性僅在「進階」標籤頁上可用。

手機應用程式的螢幕擷取畫面，其中地圖控制項顯示在 Microsoft Power Apps Studio 的屬性索引標籤旁邊。

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

  1. 樣式屬性
  2. 行為屬性
  3. Pin屬性
  4. 路由屬性
  5. 形狀屬性
  6. 輸出屬性

樣式屬性

房產 Description 類型 Tab
衛星視圖 顯示衛星視圖的地圖。 關閉此屬性以在道路檢視中顯示地圖。 布林值 屬性;進階： SatelliteView
地圖樣式 設定地圖樣式。 選項：道路、夜晚、道路暈渲、衛星、衛星道路標籤、高對比度亮、高對比度暗、灰度亮、灰度暗。 Enum 屬性
透明度 決定地圖的透明度，從 0 （不透明） 到 100 （透明）。 整數 屬性;進階： 透明度
可見性 顯示或隱藏地圖。 布林值 屬性;進階： 可見
Position 將地圖的左上角放在 x 和 y 中指定的螢幕座標處。 浮點數 屬性;進階： X、 Y
Size 使用 Width 和 Height 中提供的像素值來決定地圖的大小。 整數 屬性;進階： 寬度、 高度
邊界半徑 決定地圖邊界的轉角半徑。 浮點數 屬性;進階： 邊界半徑
Border 決定地圖邊框的樣式、寬度和顏色。 不適用 屬性;進階： BorderStyle、 BorderThickness、 BorderColor
顯示模式 判斷控制項是否允許使用者輸入 （編輯）、只顯示資料 （檢視） 或停用 （停用）。 Enum 進階

行為屬性

房產 Description 類型 Tab
顯示資訊卡 當使用者選取映射位置（按一下時）或指向該位置（暫留時）時，顯示映射位置的相關資訊。 如果為 無，則不會顯示任何資訊。 Enum 屬性;進階： 資訊卡
使用預設位置 在預設位置初始化地圖。 布林值 屬性;進階： DefaultLocation
預設緯度 設定地圖顯示的緯度座標（如果啟用 了使用預設位置 ）。 浮點數 屬性;進階： 預設緯度
預設經度 設定地圖顯示的經度座標（如果啟用 了使用預設位置 ）。 浮點數 屬性;進階： 預設經度
預設縮放等級 如果啟用了使用 預設位置 ，則設定縮放等級，範圍為 0 到 22。 整數 屬性;進階： DefaultZoomLevel
顯示目前位置 顯示使用者目前的位置。 布林值 屬性;進階： 目前位置
目前位置緯度 如果已啟用顯示目前位置，則設定地圖顯示的目前位置圖釘的緯度座標。 若要將釘選放在使用者目前的位置，請將此屬性設定為 Location.Latitude。 浮點數 屬性;進階： CurrentLocationLatitude
目前位置經度 若啟用 顯示目前位置，則可設定地圖上顯示的目前位置釘標的經度座標。 若要將釘選放在使用者目前的位置，請將此屬性設定為 Location.Longitude。 浮點數 屬性;進階： CurrentLocationLongitude
縮放控制 顯示縮放控制項。 布林值 屬性;進階： Zoom
指南針控制 顯示指南針控制項。 布林值 屬性;高級： 指南針
俯仰控制 顯示俯仰（傾斜）控制功能。 布林值 屬性;進階： 音高
TabIndex 指定使用者使用 Tab 鍵瀏覽應用程式時選取地圖的順序。 整數 屬性;進階： 索引標籤索引
工具提示 決定使用者將滑鼠停留在視覺效果上時要顯示的文字。 繩子 進階
內容語言 決定地圖的顯示語言 （如果它與應用程式中使用的語言不同）。 繩子 進階
OnLoad 包含在地圖載入時執行的程式碼。 Event 進階
OnMapClick 涵蓋在使用者選擇地圖時執行的程式碼。 按一下點的緯度和經度位於 ClickedLocation 輸出屬性中。 Event 進階
OnChange 包含變更地圖任何層面時執行的程式碼。 Event 進階
OnSelect 包含使用者在地圖上選取某些內容時執行的程式碼。 Event 進階

Pin 屬性

房產 Description 類型 Tab
地點（項目） 以表格的形式識別 資料來源 （項目），從中取得要在地圖上顯示的位置。 該資料表列出要顯示為圖釘的經度和緯度組或實體地址。 建議使用緯度或經度，因為地址需要進行地理編碼，因此引腳限制更嚴格。 資料表可以是集合，也可以是來自 Excel Online 等資料來源。 每一資料列都必須有標籤、經度和緯度項目，或是實體地址，以及可選擇的圖釘顏色和圖示。 不適用 屬性;進階： 物品
項目標籤 識別項目中包含圖釘標籤的資料行。 ColumnName 進階
ItemsLatitudes 識別項目中包含圖釘緯度位置的資料行。 ColumnName 進階
項目經度 識別項目中包含圖釘經度位置的資料行。 ColumnName 進階
項目位址 識別項目中包含表示圖釘位置之地址的資料行。 可在地址上顯示的圖釘數量有限。 建議將您的地址地理編碼為緯度、經度對，並盡量使用它們來顯示圖釘。 ColumnName 進階
項目顏色 識別項目中包含圖釘顏色的資料行。 ColumnName 進階
項目圖示 確定 項目 中包含引腳圖示的欄位。 ColumnName 進階
叢集圖釘 將附近的地圖圖釘分組顯示，而非逐一顯示。 布林值 屬性;進階： 叢集
Pin color 決定地圖上顯示的預設圖釘色彩。 若已設定，ItemsColors 屬性會覆蓋此色彩 顏色選擇器 屬性;進階： PinColor
OnItemsChange 包含當地圖上的圖釘變更時執行的程式碼。 Event 進階

Route 屬性

房產 Description 類型 Tab
啟用路由 決定使用者是否可以要求前往指定位置的路線。 布林值 屬性;進階： UseRouting
航線航點（項目） 以表格形式顯示資料來源 （RouteWaypoints_Items） 中提供的路線航點。 資料表可以是集合，也可以是來自 Excel Online 等資料來源。 如果為 無，則不會顯示任何航點。 Enum 屬性; 進階：RouteWaypoints_Items
RouteWaypointsLabels 識別 RouteWaypoints_Items 中包含航點標籤的欄。 ColumnName 進階
路線航點緯度 識別 RouteWaypoints_Items 中包含航點緯度位置的欄。 ColumnName 進階
路線航點經度 識別 RouteWaypoints_Items 中包含航點經度位置的欄。 ColumnName 進階
路由航點位址 識別 RouteWaypoints_Items 中包含代表航點位置的地址的資料行。 ColumnName 進階
維護航點秩序 判斷計算的路線是否依提供的順序保持航點。 布林值 屬性;進階： RouteMaintainOrder
優化路線 判斷計算路線是否針對距離、時間進行最佳化，或未最佳化。 Enum 屬性;進階： 路線優化
路線出行模式 決定是針對汽車還是卡車計算路線，這可能需要避開具有特定高度或重量限制的橋樑。 Enum 屬性;進階： RouteTravelMode
OnRoute 方向變更 包含當應用程式偵測到使用者在計算路線上改變方向時執行的程式碼。 Event 進階

形狀屬性

房產 Description 類型 Tab
顯示形狀 以 Shapes_Items顯示形狀。 布林值 屬性;進階： ShowShapes
Shapes_Items 以表格的形式識別資料來源 （Shapes_Items），從中取得要在地圖上顯示的圖形。 資料表可以是集合，也可以是來自 Excel Online 等資料來源。 每一行必須有一個形狀（GeoJSON 物件）的項目，以及可選的標籤和顏色。 TableName 進階
ShapeGeoJSON項目 使用字串來識別 Shapes_Items 中的資料行，這些字串代表圖形的 GeoJSON 物件，在圖形集合或單一圖形 GeoJSON 格式中。 ColumnName 進階
形狀標籤 識別 Shapes_Items 中包含圖形標籤的欄。 ColumnName 進階
形狀顏色 識別Shapes_Items中包含圖形顏色的資料行。 ColumnName 進階
顯示圖形標籤 顯示形狀標籤 （如果提供）。 布林值 屬性;進階： ShowShapeLabels
啟用圖形繪圖 在地圖上顯示繪圖工具。 布林值 屬性;進階： ShapeDrawing
啟用形狀刪除和標籤編輯 決定使用者是否可以刪除圖形並編輯其標籤。 布林值 屬性;進階設定： 形狀編輯刪除
OnShape創建完畢 包含使用者將圖形新增至地圖時執行的程式碼。 Event 進階
OnShape已選取 包含使用者在地圖上選取圖形時執行的程式碼。 Event 進階
OnShape已被編輯 包含使用者修改地圖上的圖形時執行的程式碼。 Event 進階
OnShape已刪除 包含使用者刪除地圖上的圖形時執行的程式碼。 Event 進階

Output 屬性

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

房產 Description 類型
中心位置 擷取地圖的中心點。 不適用
點擊位置 擷取使用者選取的最後一個位置，不論是 .緯度 或 .經度。 錄製
Selected 擷取選取的圖釘。 錄製
SelectedItems 擷取所選叢集的一個或多個所選圖釘。 Table
地理編碼的項目 擷取圖釘的地理編碼位置。 Table
路徑航點_已選擇 對應於在RouteWaypoints_Items中所選形狀的記錄。 錄製
路徑航點_選擇項目 對應於 RouteWaypoints_Items中所選重疊形狀的記錄。 Table
已選擇圖形 對應於已選形狀在 Shapes_Items 中的記錄。 錄製
Shapes_SelectedItems 對應於 Shapes_Items中所選重疊形狀的記錄。 Table
選取的形狀 擷取 .周長 和 . 所選形狀的面積。 錄製
已刪除圖形 擷取上次刪除的圖形的 .周長 及 .面積。 錄製
GeoJSON 以功能集合 GeoJSON 格式擷取圖形清單。 繩子

其他地理空間控制項

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

已知的限制

  • 需要互聯網連接

另請參閱

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

  • Last updated on