ウェイポイントピンを挿入し、それらの間のルートを描画する (プレビュー)
[このトピックはプレリリース ドキュメントであり、変更されることがあります。]
ウェイポイントのデータセットを含むテーブルを、マップ コントロールに読み込むことができます。 このコントロールは、各ウェイポイントのピンを地図上に配置し、ウェイポイント間のルートを描くことができます。
このコントロールには、移動時間や移動距離を改善するために、ウェイポイントを並べ替えたり、ルートを再配置するオプションがあります。
重要
- これはプレビュー機能です。
- プレビュー機能は運用環境での使用を想定しておらず、機能が制限されている可能性があります。 これらの機能を公式リリースの前に使用できるようにすることで、顧客が一足先にアクセスし、そこからフィードバックを得ることができます。
前提条件
Excel ブックからウェイポイント データを追加する
データ ソースには、以下の列を持つ名前付きのテーブルが必要です。これらの列は、コントロールの 詳細設定 ペインで、関連するプロパティにマッピングされる必要があります。
| 列の説明 | プロパティへのマップ | 必須 |
|---|---|---|
| ウェイポイントで使用するラベル | RouteWaypointsLabels | 任意出席者 |
| ウェイポイントの経度 | RouteWaypointsLongitudes | 任意出席者 |
| ウェイポイントの緯度 | RouteWaypointsLatitudes | 任意出席者 |
| ウェイポイントのアドレス | RouteWaypointsAddresses | 任意出席者 |
注意
すべてのプロパティはオプションですが、ウェイポイントの位置を見つけるためには、以下の条件のいずれかが満たされている必要があります:
- ウェイポイントのアドレスは必須です。
- ウェイポイントの緯度と経度は必須です。
まず、以下のサンプルのようなテーブルに必要な列を備えた Excel ワークブックを使用します。
次のサンプル データをコピーして、この機能をテストできます:
| 名称 | 経度 | 緯度 |
|---|---|---|
| 作業 | -122.156481 | 47.663448 |
| ミーティング | -122.221037 | 47.57137 |
| 水泳 | -122.144133 | 47.600373 |
| テニス | -122.137265 | 47.616115 |
Excel のワークブック作成後は、以下の手順でこのワークブックからウェイポイント データを追加します。
テーブルをコピーして新しいデータ ソースに貼り付けます。 この例では、Excel ブックを使用しています。
いずれかのセルを選択してから、リボンの ホーム タブで、テーブルとしてフォーマット を選択し、任意のスタイルを選択してから、OK を選択します。
![Excel の [テーブルとしてフォーマット] オプションを強調したスクリーンショット](media/geospatial/convert-table.png)
テーブルを選択して、リボンの テーブル デザイン タブに移動します。
テーブル名 配下のテーブルに名前を入力します。 例: TestData。
ブックを保存します。
Power Apps で新規アプリを開くか作成し、マップ コントロールを挿入します。
プロパティ ペインで、ルート ウェイポイント (Items) フィールドを選択し、excel を検索して Excel からインポート を選択します。
Excel ワークブックを検索し、開く を選択します。
情報を含むテーブルを選択し、TestData、次に 接続 を選択します。
プロパティ ペインに移動して 詳細設定 タブを選択します。
次のようにプロパティを設定します。
プロパティ 価値 RouteWaypointsLabels 名称 RouteWaypointsLatitudes 緯度 RouteWaypointsLongitudes 経度 RouteWaypointsAddresses 住所
ノート: オプションです。データセットにアドレスフィールドがある場合に使用します。 緯度と経度が設定されていない行では、緯度・経度の代わりにアドレスを使用することができます。注意
アドレスは、緯度・経度と互換性があります。 緯度と経度が指定されている場合、アドレスは使用されません。 アドレスのみの場合は、緯度と経度は必要ありません。
マップ コントロールでは、テーブルの各行がピンとして表示され、Excel のテーブルで定義された 名前 がラベルとして付けられ、与えられたデータセットと同じ順序で番号が付けられます。
ウェイポイント間にルートを描く
マップ上のウェイポイント間のルートを描画したり、ルートの計算方法をカスタマイズしたりするには、以下の構成を行う必要があります:
マップが選択されている状態で、プロパティ ペインを開きます。
ルーティングの有効化 を オン に切り替えます。
このコントロールは、マップ上のウェイポイント間にルートを描画します。
注意
既定では、このコントロールは、移動時間や移動距離を減らすために、中間のウェイポイントを並べ替えます。 最初と最後のウェイポイントは出発地と目的地と見なされるため、並べ替えることはできません。 ウェイポイントの順番を固定するには、ウェイポイントの順序を維持する を オン に切り替えます。
プロパティ
次のプロパティは、ルートの計算方法を構成できます:
| プロパティ | 内容 | タイプ | 場所 |
|---|---|---|---|
| ルーティングを有効にする | ウェイポイント間のルート描画の有無 | Boolean | プロパティ (詳細設定 では UseRouting) |
| ウェイポイント順序を管理する | true の場合、このコントロールは、最適なルート 設定に基づいて、ルートを最適化するウェイポイントを並べ替えます。 false の場合、このコントロールはデータセット内のウェイポイントの順序を維持し、最適なルート の設定は描画されたルートにのみ影響を与えます。 | Boolean | プロパティ (詳細設定 では RouteMaintainOrder) |
| ルートの最適化 | ルートを最適化して移動時間を短縮するか、移動距離を短縮します。 | リスト (なし、距離、時間) | プロパティ (詳細設定 では RouteOptimization) |
| ルート トラベル モード | ルートを車で移動するか、トラックで移動するか。 | リスト (車、トラック) | プロパティ (詳細設定 では RouteTravelMode) |
出力プロパティ
ルートが変更されると、このコントロールはさまざまなプロパティを出力します。 これらのプロパティはすべて、RouteDirection オブジェクトに配置されています。 OnRouteDirectionChange イベントは、出力を他のコントロールで使用したり、エクスペリエンスをカスタマイズしたりする際に推奨される方法です。
| Property | Description | タイプ | 場所 |
|---|---|---|---|
| OnRouteDirectionChange | ルートが変更されたときのアプリの応答方法です | イベント | 上級 |
| RouteDirection | すべてのルーティング出力を説明するオブジェクト:
|
オブジェクト | 該当なし (出力プロパティのみ) |
関連情報
フィードバック
フィードバックの送信と表示