共用方式為

計算地圖上航點圖釘之間的路線 （預覽版）

[本主題是發行前版本文件，並可能在未來變更。]

畫布應用程式中的地圖控制項可以使用從 Excel 活頁簿中的資料表匯入的資料來新增航點標記。 控制項可以計算航點之間的路線、重新排序航點，以及重新計算路線，以改善旅行時間或距離。

這很重要

  • 這是預覽功能。
  • 預覽功能不供生產時使用，而且可能功能受限。 這些功能可在正式發行之前提供，讓客戶可以取得早期存取並提供意見反應。

您需要一個數據源，其中包含具有以下欄的具名數據表。 每個資料行都對應到地圖控件的高級屬性。 每一列都固定為地圖上的航點。

欄位名稱 對應於 為必填項目
名稱 （或標籤） RouteWaypointsLabels 可選
緯度 路線航點經度 選擇性 （如果未提供 [地址]，則為必要）
緯度 路線航點緯度 選擇性 （如果未提供 [地址]，則為必要）
Address 路由航點位址 選擇性 （如果未提供經度和緯度，則為必要）

備註

所有屬性在技術上都是可選的。 但是，必須至少提供一個地址或緯度/經度對才能繪製航點位置。

從 Excel 表格匯入航點標記

在此範例中，我們將從名為 TestData 的 Excel 表格匯入航點資料。

建立數據源

  1. 在 Excel 中建立包含下列資料的資料表。 將資料表命名為 TestData。

    名稱 緯度 緯度 Address
    工作 -122.156481 47.663448 1 Microsoft Way，雷德蒙德，華盛頓州 98052
    集合 -122.221037 47.57137
    游泳 -122.144133 47.600373
    網球 -122.137265 47.616115

    您的表格應該如下所示：

    範例 Excel 工作表，其中包含名為 TestData 的資料表，其中包含在地圖上放置航點針腳所需的資訊。

  2. 將活頁簿儲存至商務用 OneDrive，然後關閉檔案。

將資料來源綁定至地圖控制項

  1. 建立畫布應用程式。 請確定它符合 地理空間先決條件。

  2. 插入地圖控制項。

  3. 在控制項的 [屬性 ] 索引標籤上，選取 [路由航點 （項目）] 方塊，然後輸入 excel。

    螢幕擷取畫面，顯示如何搜尋航點資料來源以連線到 Power Apps Studio 中的地圖控制項。

  4. 選取 [從 Excel 匯入]。

  5. 流覽至商務用 OneDrive，然後選取您稍早儲存的 Excel 活頁簿。

  6. 選取資料表 TestData，然後選取 [連線]。

    表格選取面板的螢幕擷取畫面。

  7. 在 Advanced 索引標籤上，尋找 RouteWaypointsLabels、 RouteWaypointsLatitudes、 RouteWaypointsLongitudes 和 RouteWaypointsAddresses ，然後在表格中輸入對應欄的名稱。 （在此範例中，請在 RouteWaypointsLabels 中輸入 Name，在 RouteWaypointsLatitudes 中輸入 Latitude，依此類推。將欄名稱括在引號中。

    備註

    地址可與緯度和經度互換。 如果提供緯度和經度，則不會使用地址。 如果提供地址，則不需要緯度和經度。 使用地址時可以顯示的航點數量有限制，因此請盡可能使用緯度和經度。

圖釘會出現在地圖上資料表中座標或地址描述的位置。 如果表格包含標籤，則會標示引腳。 這些圖釘會按照航點位置在資料表中出現的順序編號。

地圖的螢幕擷取畫面，其中釘選和標記的航點顯示在地圖屬性旁。

計算航點之間的路線

選取地圖控制項後，開啟 [屬性] 索引標籤，然後開啟 [啟用路由]。

控制項會計算釘選航點之間的路線。

一張地圖的螢幕截圖，顯示標記的航點之間的路線。

備註

依預設，地圖控制項會重新排序中間航點，以減少行進時間或行進距離。 第一個和最後一個航點會被視為出發地和目的地，且無法重新排序。 若要將航點保留在資料來源中指定的順序，請開啟控制項的 [維護航點順序] 屬性。

屬性

使用屬性更改路線的計算方式。

房產 Description 類型 Tab
啟用路由 計算航點之間的路線。 布林值 屬性;進階： UseRouting
維護航點秩序 判斷計算路線是否依資料來源中提供的順序維護航點。 布林值 屬性;進階： RouteMaintainOrder
優化路線 判斷計算路線是否針對距離、時間進行最佳化，或未最佳化。 下拉式清單 屬性;進階： 路線優化
路線出行模式 決定是針對汽車還是卡車計算路線，這可能需要避開具有特定高度或重量限制的橋樑。 下拉式清單 屬性;進階： RouteTravelMode
顯示路線標記 確定是否要在路線航點上顯示圖釘。 布林值 屬性;進階： ShowRoutePins

輸出屬性

某些性質只有在計算路線變更時才可用。 這些 輸出屬性 會放置在 RouteDirection 物件中。 OnRouteDirectionChange 事件是在其他控制項中使用輸出或自訂應用程式體驗的建議方式。

房產 Description 類型 Tab
OnRoute 方向變更 包含變更路由時執行的程式碼。 Event 進階
路線方向 描述路由輸出：
  • LengthInMeters：整條路線的長度（以公尺為單位）
  • TravelTimeInSeconds：整個路線的預期旅行時間（以秒為單位）
  • RouteGeoJSON：以 GeoJSON 格式描述路由的字串
  • RouteLegs：描述路由每個分支的資料表：
    • 索引：代表路線中路段順序的數字
    • LengthInMeters：腿的長度（以米為單位）
    • TravelTimeInSeconds：路段的預期行程時間（以秒為單位）
    • StartLabel：路段起點的標籤
    • StartLatitude：腿起點的緯度
    • StartLongitude：腿起點的經度
    • 起點位址：行程段的起點地址
    • EndLabel：分段終點的標籤
    • EndLatitude：路段終點的緯度
    • EndLongitude：分段終點的經度
    • EndAddress：支線終點的位址
  • OrderedWaypoints - 在排序導航點後描述每個航點的資料表：
    • 索引：表示航點在路線中順序的數字
    • 標籤：航點的標籤
    • 緯度：航點的緯度
    • 經度：航點的經度
    • 地址：航點的地址
 物體 不適用（僅限輸出屬性）

另請參閱

互動式地圖控制

  • Last updated on