syncfusion-maui-maps

.NET MAUI Maps（SfMaps）の実装

Syncfusion® .NET MAUI Maps コントロールを実装するための包括的なスキルです。SfMaps コントロールは、地理的な領域にわたる統計情報を表示するための強力なデータ視覚化コンポーネントで、高度にインタラクティブでカスタマイズ可能な機能を備えています。

このスキルを使用する場面

次のことが必要な場合に、このスキルを使用してください。

• Syncfusion® .NET MAUI Maps（SfMaps）コントロールをインストールして構成する
• シェープファイルデータを使用して、シェイプレイヤーで地理データを表示する
• プロバイダーのタイルベースのマップを統合する
• 組み込みシンボルまたはカスタムコンテンツを使って、位置を示すマーカーを追加する
• バブル、カラー マッピング、コロプレスマップでデータを視覚化する
• カスタマイズ可能な外観の凡例を、シェイプまたはバブルに対して表示する
• スマートな位置調整で、マップシェイプ上にデータラベルを表示する
• 追加のデータ視覚化のために、サブレイヤー（円、弧、線、多角形、ポリライン）を追加する
• ズーム、パン、シェイプの選択、ツールチップなどのインタラクションを有効にする
• スマートなジオコーディングと検索のために、AI 駆動の位置検索を実装する

コンポーネントの概要

.NET MAUI Maps には、主に 2 種類のレイヤーがあります。

1. シェイプレイヤー（MapShapeLayer）：GeoJSON またはシェープファイルデータからベクターマップを描画します
2. タイルレイヤー（MapTileLayer）：ウェブマップタイルサービスからラスター地図タイルを描画します

主な機能：

• サブレイヤーを含む複数レイヤーのサポート
• 組み込みテンプレートおよびカスタムテンプレートを使用したマーカー
• データ表現のためのバブル視覚化
• カラーマッピング（均等および範囲ベース）
• インタラクティブな凡例
• スマートな位置調整が可能なデータラベル
• ズームおよびパン機能
• シェイプの選択およびツールチップ
• AI 駆動の位置検索

対応プラットフォーム： Android、iOS、Windows、macOS

ドキュメントとナビゲーションガイド

はじめに

📄 参照： references/getting-started.md

参照する場面：初回セットアップ、インストール、基本的なマップの作成

• NuGet パッケージのインストール（Syncfusion.Maui.Maps）
• MauiProgram.cs でのハンドラー登録
• シェイプレイヤーを使った最初のマップの作成
• ローカルからのシェープファイルデータの読み込み
• タイルレイヤーを使った最初のマップの作成
• 基本的な構成とマップの表示

レイヤーの種類

シェイプレイヤー

📄 参照： references/shape-layer.md

参照する場面：ベクターマップ、シェープファイルデータ、コロプレスマップ、データバインディングの操作

• MapShapeLayer の概要と構成
• シェイプデータの読み込み
• DataSource、PrimaryValuePath、ShapeDataField を使用したデータソースのバインディング
• カラーマッピングの方法（EqualColorMapping、RangeColorMapping）
• シェイプのスタイル設定（塗りつぶし、ストローク、ホバー状態）
• シェイプのカスタマイズとテーマ設定
• AOT モードに関する考慮事項と保持属性

タイルレイヤー

📄 参照： references/tile-layer.md

参照する場面：OpenStreetMap、Bing Maps、その他のタイルプロバイダーの統合

• MapTileLayer の概要
• URL テンプレート形式と WMTS 仕様
• サブスクリプションキーの構成
• マップの中心位置とズームの設定
• マップの種類（Road、Aerial など）

視覚要素

マーカー

📄 参照： references/markers.md

参照する場面：マップへの位置マーカー、ピン、カスタムマーカーの追加

• MapMarker の概要と MapMarkerCollection
• シェイプレイヤーへのマーカーの追加
• タイルレイヤーへのマーカーの追加
• 組み込みアイコンの種類（Circle、Diamond、Rectangle、Square）
• 緯度と経度によるマーカーの位置指定
• アイコンのカスタマイズ（サイズ、色、塗りつぶし、ストローク）
• MarkerTemplate を使用したカスタムマーカーテンプレート
• マーカーの配置、オフセット、アンカー
• マーカーのツールチップ
• マーカーのイベントと選択

バブル

📄 参照： references/bubbles.md

参照するタイミング：形状上に、サイズや色で値を表すバブルを可視化する場合

• バブル可視化の概要
• ShowBubbles によるバブルの有効化
• BubbleSettings の設定
• SizeValuePath、MinSize、MaxSize によるサイズベースのバブル
• ColorValuePath による色ベースのバブル
• バブルのスタイル設定（塗りつぶし、ストローク、不透明度）
• バブルのツールチップ
• バブルの色のマッピング
• 複数のバブル系列

データラベル

📄 参照： references/data-labels.md

参照するタイミング：地図上の形状にテキストラベルを表示する場合

• データラベルの概要と目的
• ShowDataLabels によるラベルの有効化
• DataLabelSettings の設定
• ラベルテキストのバインドに使用する DataLabelPath
• ラベルのスタイル設定（フォント、色、サイズ、太さ）
• ラベルの配置と整列
• スマートラベルの動作（省略、はみ出し時に非表示）
• カスタムラベルテンプレート
• ラベルのインタラクションとイベント

凡例

📄 参照： references/legends.md

参照するタイミング：形状やバブルの凡例を追加する場合

• 凡例の概要と MapLegend の設定
• SourceType.Shape による形状の凡例
• SourceType.Bubble によるバブルの凡例
• 凡例の配置（上、下、左、右）
• ColorMapping.Text による凡例テキストのカスタマイズ
• アイコンのカスタマイズ（サイズ、種類、間隔）
• 凡例の位置とパディング
• TextStyle によるテキストスタイルの設定
• カスタム凡例テンプレート
• 凡例の表示と切り替え

高度な機能

サブレイヤー

📄 参照： references/sublayers.md

参照するタイミング：複数のレイヤー、円、弧、線、多角形、またはポリラインを追加する場合

• サブレイヤーの概要と種類
• 形状レイヤーの追加に使用する MapShapeSublayer
• 半径ベースの円に使用する MapCircle
• 2 点を弧で結ぶ MapArc
• シンプルな線で接続する MapLine
• カスタム多角形の形状に使用する MapPolygon
• 複数点を結ぶ線のパスに使用する MapPolyline
• サブレイヤーのデータバインドとコレクション
• サブレイヤーのスタイルと外観
• 複数のサブレイヤーと重ね合わせ
• レイヤーの z-index と順序

インタラクション機能

📄 参照： references/interaction-features.md

参照するタイミング：ズーム、パン、選択、またはツールチップを有効にする場合

• ズームとパン：
  • EnableZooming プロパティと EnablePanning プロパティ
  • ZoomPanBehavior の設定
  • MinZoomLevel と MaxZoomLevel
  • プログラムによるズームメソッド
  • 特定の地域へのズーム
• 選択：
  • EnableSelection による形状の選択
  • 選択時の外観のカスタマイズ
  • 選択イベントとハンドラー
• ツールチップ：
  • 形状のツールチップに使用する ShowShapeTooltip
  • ツールチップのテンプレートとスタイル設定
  • マーカーとバブルのツールチップ
  • カスタムツールチップの内容

AI 駆動の位置検索

📄 参照： references/ai-location-search.md

参照するタイミング：スマートな位置検索とジオコーディングを実装する場合

• AI 駆動の位置検索の概要
• スマート検索機能
• 位置のオートコンプリート
• ジオコーディングの統合
• 検索の設定
• 検索結果の処理
• カスタム検索プロバイダー