モジュール構成

MapConductor は複数の Gradle モジュールに分割されているため、必要なものだけに依存できます。このページでは、v1.1.7 の各 android-xxx モジュールを要約します。

コアと BOM

`mapconductor-bom`

すべての MapConductor アーティファクトの Bill of Materials です。

すべてのモジュール間でバージョンを調整します
すべてのプロジェクトに推奨されます

implementation(platform("com.mapconductor:mapconductor-bom:1.1.7"))

`android-sdk-core`

コアランタイムと共有抽象化:

ジオメトリ型: GeoPointInterface, GeoRectBounds
カメラ型: MapCameraPositionInterface, VisibleRegion
マップ抽象化: MapViewStateInterface, MapViewControllerInterface, MapViewBase
プラグイン / capability レジストリ: MapServiceRegistry（LocalMapServiceRegistry）
オーバーレイプリミティブ: MarkerState, PolylineState, PolygonState, CircleState, GroundImageState

他のすべてのモジュールは mapconductor-core の上に構築されています。

地図SDK統合

地図SDK固有のモジュールは、各 SDK に統一 API を実装します:

`android-for-googlemaps`

GoogleMapView Composable
GoogleMapViewState
Google Maps 固有のオーバーレイコントローラ

`android-for-mapbox`

MapboxMapView Composable
MapboxViewState

`android-for-here`

HereMapView Composable
HereViewState

`android-for-arcgis`

ArcGISMapView Composable
ArcGISMapView2D Composable（詳しくは ArcGISMapView2D（2D フラットビュー）を参照してください）
ArcGISMapViewState

`android-for-maplibre`

MapLibreMapView Composable
MapLibreViewState

各地図SDKモジュールは:

MapViewStateInterface とコントローラバインディングを実装します
地図SDK固有のカメラと表示可能領域を MapCameraPositionInterface にマッピングします
オーバーレイコントローラ（マーカー、ポリライン、ポリゴン、円、サポートされている場合はグラウンドイメージ）を公開します

実験的 / ユーティリティモジュール

`android-icons`

純粋な Compose で実装された Composable マーカーアイコン:

CircleIcon, FlagIcon
情報バブルスタイル（丸、尾付きなど）

地図SDK固有の drawable に依存せずに、地図SDK間で一貫したマーカービジュアルが必要な場合に便利です。

`android-heatmap`

地図実装非依存なヒートマップオーバーレイ:

HeatmapOverlay Composable
バッチ更新用の HeatmapPoints
動的プロパティ変更のための HeatmapOverlayState
カスタム HeatmapGradient サポート

タイルベースのラスターレイヤーを通じてすべての地図プロバイダで動作します。詳しくはヒートマップを参照してください。

`android-geojson-layer`

地図実装非依存な GeoJSON レイヤー:

GeoJSONLayer Composable
静的データ向けの GeoJSONFeature
Compose state と連携する GeoJSONFeatureState
GeoJSONParser による一括パースとストリームパース

タイルベースのラスターレイヤーを通じてすべての地図プロバイダで動作します。詳しくは GeoJSON レイヤーを参照してください。

`android-marker-clustering`

すべての地図プロバイダに対応した自動マーカークラスタリング:

MarkerClusterGroup Composable
クラスタリング動作設定のための MarkerClusterGroupState
カスタム clusterIconProvider サポート
ズーム/パンアニメーション

詳しくはマーカークラスタリングを参照してください。

例示アプリケーション

`example-app`

以下を実証するショーケースアプリケーション:

基本的なマップ使用と地図SDKの切り替え
カメラ処理と表示可能領域（VisibleRegionPage, ZoomCalibrationPage）
ポリライン、ポリゴン、円、グラウンドイメージ
情報バブルとカスタムマーカーアイコン

`simple-map-app`

クイック統合テストとデバッグのための最小限の例です。

モジュールの選択方法

典型的な構成:

// 最小限: Google Maps のみ
implementation(platform("com.mapconductor:mapconductor-bom:1.1.7"))
implementation("com.mapconductor:core")
implementation("com.mapconductor:for-googlemaps")

// アイコンと戦略を使用したマルチ地図SDK
implementation(platform("com.mapconductor:mapconductor-bom:1.1.7"))
implementation("com.mapconductor:core")
implementation("com.mapconductor:for-googlemaps")
implementation("com.mapconductor:for-mapbox")
implementation("com.mapconductor:icons")
implementation("com.mapconductor:marker-strategy")

このページを高レベルのマップとして使用してください。各領域（コア、コンポーネント、状態、実験的）の詳細な API 情報は、既存のセクション（docs/src/core, docs/src/components など）から移行できます。