Interactive map コントロール
インタラクティブなマップをキャンバス アプリに簡単に追加できます。 住所または緯度と経度のペアを含むデータ ソースからマーカーをプロットします。 ズームアウトすると、マーカーはオプションでクラスター化され、データのグループを凝縮します。 モバイル デバイスと Web エクスペリエンスでは、地図でユーザーの現在位置を示し、ユーザーの目的地までのルートを計算できます。 マップは、道路ビューと衛星ビューの間で切り替えることができます。
インタラクティブなマップ機能
前提条件
キャンバスアプリでマップを使用する前に、いくつかの 前提条件 を満たす必要があります。
アプリ画面へのマップを追加する
Power Apps Studio でアプリを 編集 用に開いた状態で:
- 挿入 タブを洗濯して、メディア を展開します。
- マップ を選択して、アプリ スクリーンにマップを配置するか、またはそのコントロールをスクリーンのより正確な場所にドラッグします。
プロパティ
プロパティを使用して、マップの動作と外観を変更します。 一部のプロパティは、詳細 タブでのみ使用できます。
![マップ コントロールが Microsoft Power Apps Studio の [プロパティ] タブの横に表示されている電話アプリのスクリーンショット。](media/augmented-geospatial/geospatial-controls.png)
| プロパティ | 説明 | タイプ | タブ |
|---|---|---|---|
| Locations(Items) | マップで表示する場所を取得するための Excel ブックのテーブル形式の データ ソース (Items) を指定します。 このテーブルには、ピンとして表示する経度と緯度のセット、または物理アドレスがリストされています。 各行には、ラベル、経度、緯度、または物理アドレス、およびオプションでピンの色とアイコンのエントリーが必要です。 | 該当なし | プロパティ; 詳細: Items |
| Transparency | マップの透過率を 0 (不透明) から 100 (透明) まで特定します。 | 整数 | プロパティ; 詳細: Transparency |
| Visible | マップを表示または非表示にします。 | ブール値 | プロパティ; 詳細: Visible |
| Position | x と y で指定した画面座標に、マップの左上隅を配置します。 | 浮動小数点数 | プロパティ; 詳細: X、Y |
| Size | 幅 と 高さ で指定されたピクセル値を使用して、マップのサイズを指定します。 | 整数 | プロパティ; 詳細: 幅、高さ |
| Use default location | 規定の場所でマップを初期化します。 | ブール値 | プロパティ; 詳細: DefaultLocation |
| Default latitude | マップで 規定の場所を使用 が有効になっている場合、マップを表示する緯度座標を設定します。 | 浮動小数点数 | プロパティ; 詳細: DefaultLatitude |
| Default longitude | マップで 規定の場所を使用 が有効になっている場合、マップを表示する経度座標を設定します。 | 浮動小数点数 | プロパティ; 詳細: DefaultLongitude |
| Default zoom level | 規定の場所を使用 が有効になっている場合、ズーム レベルを 0 から 22 まで設定します。 | 整数 | プロパティ; 詳細: DefaultZoomLevel |
| Show current location | ユーザーの現在の場所を表示します。 | ブール値 | プロパティ; 詳細: CurrentLocation |
| Current location latitude | 現在の場所を表示 が有効になっている場合、マップが表示する緯度座標を設定します。 現在のユーザーの場所にピンを配置するには、このプロパティを Location.Latitude に設定します。 | 浮動小数点数 | プロパティ; 詳細: CurrentLocationLatitude |
| Current location longitude | 現在の場所を表示 が有効になっている場合、マップが表示する経度座標を設定します。 現在のユーザーの場所にピンを配置するには、このプロパティを Location.Longitude に設定します。 | 浮動小数点数 | プロパティ; 詳細: CurrentLocationLongitude |
| Satellite view | 地図を衛星ビューで表示します。 マップをロード ビューで表示するには、このプロパティをオフのままにします。 | ブール値 | プロパティ; 詳細: SatelliteView |
| Cluster pins | マップ ピンを個別に表示するのではなく、近くのマップ ピンをグループ化します。 | ブール値 | プロパティ; 詳細: Clustering |
| Zoom コントロール | zoom コントロールを表示します。 | ブール値 | プロパティ; 詳細: Zoom |
| Compass コントロール | Compass コントロールを表示します。 | ブール値 | プロパティ; 詳細: Compass |
| Pitch コントロール | Pitch (tilt) コントロールを表示します。 | ブール値 | プロパティ; 詳細: Pitch |
| Show info cards | ユーザーが選択したとき (クリック時) またはそれを指した時 (ホバー時) にマッピングされた場所についての 情報を表示します。 なし の場合、情報は表示されません。 | 列挙型 | プロパティ; 詳細: InfoCards |
| Pin color | マップに表示するピンの色を決定します。 | Color picker | プロパティ; 詳細: PinColor |
| Route waypoints(Items) | Excel ブックの表の形式でデータ ソース (RouteWaypoints_Items) に提供されたルート ウェイポートを表示します。 なし の場合、ウェイポートは表示されません。 | 列挙型 | プロパティ; 詳細: RouteWaypoints_Items |
| Enable routing | ユーザーが指定された場所への道順をリクエストできるかどうかを決定します。 | ブール値 | プロパティ; 詳細: UseRouting |
| ウェイポイントの順序を管理する | 計算されたルートが指定された順序でウェイポイントを維持するかどうかを決定します。 | ブール値 | プロパティ; 詳細: RouteMaintainOrder |
| ルートの最適化 | 計算されたルートが距離、時間に対して最適化されているか、最適化されていないかを決定します。 | 列挙型 | プロパティ; 詳細: RouteOptimization |
| ルート トラベル モード | ルートが車またはトラックのどちらで計算されるかを決定します。これには、特定の高さまたは重量の制限がある橋を避ける必要がある場合があります。 | 列挙型 | プロパティ; 詳細: RouteTravelMode |
| Show shapes | Shapes_Items の図形を表示します。 | ブール値 | プロパティ; 詳細: ShowShapes |
| Show shape labels | 提供されている場合は、図形ラベルを表示します。 | ブール値 | プロパティ; 詳細: ShowShapeLabels |
| Enable shape drawing | マップ上に描画ツールを表示します。 | ブール値 | プロパティ; 詳細: ShapeDrawing |
| Enable shape deleting and label editing | ユーザーが図形を削除してラベルを編集できるかどうかを決定します。 | ブール値 | プロパティ; 詳細: ShapeEditingDeleting |
| Border radius | マップの枠線の隅の半径を指定します。 | 浮動小数点数 | プロパティ; 詳細: BorderRadius |
| Border | マップの枠線のスタイル、幅、色を指定します。 | 該当なし | プロパティ; 詳細: BorderStyle、BorderThickness、BorderColor |
| TabIndex | ユーザーが Tab キーを使用してアプリをナビゲートする場合に、マップが選択される順序を指定します。 | 整数 | プロパティ; 詳細: Tab index |
| OnItemsChange | マップ上のピンが変更されたときに実行されるコードを含みます。 | イベント | 詳細 |
| OnLoad | マップがロードされたときに実行されるコードを含みます。 | イベント | 詳細 |
| OnMapClick | ユーザーがマップを選択したときに実行するコードを含みます。 | イベント | 詳細 |
| OnShapeCreated | ユーザーがマップに図形を追加するときに実行するコードを含みます。 | イベント | 詳細 |
| OnShapeSelected | ユーザーがマップで図形を選択するときに実行するコードを含みます。 | イベント | 詳細 |
| OnShapeEdited | ユーザーがマップで図形を変更するときに実行するコードを含みます。 | イベント | 詳細 |
| OnShapeDeleted | ユーザーがマップで図形を削除するときに実行するコードを含みます。 | イベント | 詳細 |
| OnRouteDirectionChange | 計算されたルート上でユーザーが方向を変えたことをアプリが検出したときに実行されるコードを含みます。 | イベント | 詳細 |
| OnChange | マップのいかなる側面が変更されたときに実行されるコードを含みます。 | イベント | 詳細 |
| OnSelect | ユーザーがマップで何かを選択するときに実行するコードを含みます。 | イベント | 詳細 |
| ItemsLabels | ピンのラベルを含む Items の列を指定します。 | ColumnName | 詳細 |
| ItemsLatitudes | ピンの緯度位置を含む Items の列を指定します。 | ColumnName | 詳細 |
| ItemsLongitudes | ピンの経度位置を含む Items の列を指定します。 | ColumnName | 詳細 |
| ItemsAddresses | ピンの場所を表示する住所を含む Items の列を指定します。 | ColumnName | 詳細 |
| ItemsColors | ピンの色を含む Items の列を指定します。 | ColumnName | 詳細 |
| ItemsIcons | ピンのアイコンを含む Items の列を指定します。 | ColumnName | 詳細 |
| Shapes_Items | マップで表示する図形を取得するための Excel ブックのテーブル形式の データ ソース (Shapes_Items) を指定します。 各行には、図形 (GeoJSON オブジェクト) および (オプションで) ラベルと色のエントリが必要です。 | TableName | 詳細 |
| ShapeGeoJSONObjects | 図形コレクションまたは単一図形 GeoJSON 形式で、図形の GeoJSON オブジェクトを表す文字列を持つ Shapes_Items の列を指定します | ColumnName | 詳細 |
| ShapeLabels | 図形のラベルを含む Shapes_Items の列を指定します。 | ColumnName | 詳細 |
| ShapeColors | 図形の色を含む Shapes_Items の列を指定します。 | ColumnName | 詳細 |
| RouteWaypoints_Items | マップで表示するウェイポイントを取得するための Excel ブックのテーブル形式の データ ソース (RouteWaypoints_Items) を指定します。 それぞれの行には、各行のラベル、経度、緯度 (または実際の住所) の入力が必要です。 | TableName | 詳細 |
| RouteWaypointsLabels | ウェイポイントのラベルを含む RouteWaypoints_Items の列を指定します。 | ColumnName | 詳細 |
| RouteWaypointsLatitudes | ウェイポイントの緯度位置を含む RouteWaypoints_Items の列を指定します。 | ColumnName | 詳細 |
| RouteWaypointsLongitudes | ウェイポイントの経度位置を含む RouteWaypoints_Items の列を指定します。 | ColumnName | 詳細 |
| RouteWaypointsAddresses | ウェイポイントの場所を表示する住所を含む RouteWaypoints_Items の列を指定します。 | ColumnName | 詳細 |
| Tooltip | ユーザーがビジュアルにカーソルを合わせたときに表示するテキストを指定します。 | 文字列 | 詳細 |
| ContentLanguage | アプリで使用されている言語と異なる場合は、マップの表示言語を指定します。 | 文字列 | 詳細 |
| DisplayMode | コントロールでユーザー入力を許可するか (Edit)、データの表示のみを許可するか (View)、無効にするか (Disabled) を指定します。 | 列挙型 | 詳細 |
出力プロパティ
ユーザーがマップを操作すると、その他のプロパティが使用可能になります。 これらの 出力プロパティ は、その他のコントロールで使用したり、アプリ エクスペリエンスをカスタマイズしたりできます。
| プロパティ | 説明 | タイプ |
|---|---|---|
| CenterLocation | マップの中心点をキャプチャします。 | 適用なし |
| OnMapClick | ユーザーが最後に選択した場所をキャプチャします。 | 適用なし |
| Selected | 選択したピンをキャプチャします。 | 記録 |
| SelectedItems | 選択されたクラスターのピン (単数や複数) をキャプチャします。 | テーブル |
| GeocodedItems | ピンの地理的な場所をキャプチャします。 | テーブル |
| ClickedLocation | ユーザーが最後に選択した場所を、緯度 または 経度 のいずれかでキャプチャします。 | 記録 |
| Shapes_Selected | Shapes_Items から選択した図形のレコードに対応します。 | 記録 |
| Shapes_SelectedItems | Shapes_Items で選択したオーバーラップした図形のレコードに対応します。 | テーブル |
| SelectedShape | 選択した図形の 周囲 と 領域 をキャプチャします。 | 記録 |
| DeletedShape | 最後に削除した図形の 周囲 と 領域 をキャプチャします。 | 記録 |
| GeoJSON | Feature Collection GeoJSON 形式の図形のリストをキャプチャします。 | 文字列 |
その他の地理空間コントロール
入力中に動的な住所候補を表示するには、Address input コントロールを使用します。
注意
ドキュメントの言語設定についてお聞かせください。 簡単な調査を行います。 (この調査は英語です)
この調査には約 7 分かかります。 個人データは収集されません (プライバシー ステートメント)。
既知の制限
- インターネット接続が必要
参照
フィードバック
フィードバックの送信と表示