introduce MarkerTileRendering

.claude/settings.local.json

@@ -20,7 +20,9 @@
       "Bash(cat:*)",
       "Read(//Users/masashi/.gradle/caches/**)",
       "Bash(xargs jar tf:*)",
-      "Bash(npm run build:*)"
+      "Bash(npm run build:*)",
+      "WebFetch(domain:medium.com)",
+      "WebSearch"
     ],
     "deny": [],
     "ask": []

docs/src/components/core/mapviewholder/MapViewHolderAccessExample.astro

@@ -0,0 +1,16 @@
+---
+import { Code } from '@astrojs/starlight/components';
+
+const code = `// Any provider state exposes getMapViewHolder()
+val state = rememberGoogleMapViewState()
+
+// May be null until the map is initialized
+val holder = state.getMapViewHolder()
+
+// Use the concrete holder type when you need provider-specific APIs
+// (e.g. GoogleMapViewHolder / MapboxMapViewHolder / MapLibreMapViewHolder / ...)
+// holder?.googleMap?.uiSettings?.isZoomControlsEnabled = false`
+---
+
+<Code code={code} lang="kotlin" />
+

docs/src/content/docs/core/service-registry.mdx

@@ -0,0 +1,53 @@
+---
+title: "Map Service Registry"
+---
+
+MapConductor provides a lightweight “plugin” mechanism called `MapServiceRegistry`.
+It lets feature modules (like marker clustering/strategies) integrate with any provider module without requiring the provider’s `MapViewController` to implement feature-specific interfaces.
+
+## How It Works (Android)
+
+- Each `MapView` can provide a map-scoped registry.
+- `MapViewBase` exposes it via the CompositionLocal `LocalMapServiceRegistry`.
+- Feature modules resolve capabilities from the registry at runtime.
+
+This keeps modules decoupled: provider modules “register” capabilities, and feature modules “use” them.
+
+## Marker Rendering Support
+
+Marker clustering and strategy-based rendering need a provider-specific renderer/controller.
+Providers expose that via:
+
+- `MarkerRenderingSupport<ActualMarker>`
+- `MarkerRenderingSupportKey` (registry key)
+
+Built-in provider modules register `MarkerRenderingSupportKey` automatically, so `mapconductor-marker-clustering` works without any inheritance between controllers and feature interfaces.
+
+## Custom Provider Integration (Android)
+
+If you are implementing your own provider module, register `MarkerRenderingSupport` into a `MutableMapServiceRegistry` and pass it to `MapViewBase`.
+
+```kotlin
+val serviceRegistry =
+  remember {
+    MutableMapServiceRegistry().apply {
+      put(MarkerRenderingSupportKey, myMarkerRenderingSupport)
+    }
+  }
+
+MapViewBase(
+  state = state,
+  /* ... */
+  serviceRegistry = serviceRegistry,
+)
+```
+
+## iOS / SwiftUI Note
+
+The iOS SDK mirrors the same idea using SwiftUI `Environment`:
+
+- `EnvironmentValues.mapServiceRegistry`
+- `MarkerRenderingSupportKey<ActualMarker>`
+
+Provider views register capabilities into the registry so feature modules can remain provider-agnostic.
+

docs/src/content/docs/es-419/core/service-registry.mdx

@@ -0,0 +1,42 @@
+---
+title: "Map Service Registry"
+---
+
+MapConductor ofrece un mecanismo ligero de “plugins” llamado `MapServiceRegistry`.
+Permite que módulos de funcionalidades (como clustering/estrategias de marcadores) se integren con cualquier proveedor sin forzar que el `MapViewController` del proveedor implemente interfaces específicas.
+
+## Cómo funciona (Android)
+
+- Cada `MapView` puede proporcionar un registro con alcance del mapa.
+- `MapViewBase` lo expone mediante el CompositionLocal `LocalMapServiceRegistry`.
+- Los módulos de funcionalidades resuelven capabilities desde el registro en tiempo de ejecución.
+
+## MarkerRenderingSupport
+
+El clustering y el renderizado por estrategia requieren un renderer/controller específico del proveedor.
+Los proveedores lo exponen con:
+
+- `MarkerRenderingSupport<ActualMarker>`
+- `MarkerRenderingSupportKey` (clave del registro)
+
+Los módulos de proveedor incluidos ya registran `MarkerRenderingSupportKey`, por lo que `mapconductor-marker-clustering` funciona sin herencia.
+
+## Integración con un proveedor propio (Android)
+
+Registra `MarkerRenderingSupport` en un `MutableMapServiceRegistry` y pásalo a `MapViewBase`.
+
+```kotlin
+val serviceRegistry =
+  remember {
+    MutableMapServiceRegistry().apply {
+      put(MarkerRenderingSupportKey, myMarkerRenderingSupport)
+    }
+  }
+
+MapViewBase(
+  state = state,
+  /* ... */
+  serviceRegistry = serviceRegistry,
+)
+```
+

docs/src/content/docs/ja/core/service-registry.mdx

@@ -0,0 +1,46 @@
+---
+title: "Map Service Registry"
+---
+
+MapConductor には、軽量な「プラグイン」機構として `MapServiceRegistry` があります。
+地図SDKモジュール（Google Maps / Mapbox / MapLibre など）と、機能モジュール（クラスタリング / マーカー戦略など）を **継承に頼らずに** 連携させるための仕組みです。
+
+## 仕組み（Android）
+
+- 各 `MapView` が map-scoped なレジストリを提供します
+- `MapViewBase` が CompositionLocal の `LocalMapServiceRegistry` で公開します
+- 機能モジュール側はレジストリから capability を解決して利用します
+
+つまり、地図SDKモジュールが capability を「登録」し、機能モジュールがそれを「利用」することで分離を保ちます。
+
+## MarkerRenderingSupport
+
+クラスタリングや strategy ベースのレンダリングは、地図SDKごとの renderer/controller が必要です。
+それを `MarkerRenderingSupport<ActualMarker>` と `MarkerRenderingSupportKey` で表現します。
+
+組み込みの地図SDKモジュールは `MarkerRenderingSupportKey` を自動登録するため、`mapconductor-marker-clustering` はコントローラの継承なしで動きます。
+
+## 独自地図SDKモジュールでの連携（Android）
+
+独自の地図SDKモジュールを実装する場合は、`MutableMapServiceRegistry` に `MarkerRenderingSupport` を登録し、それを `MapViewBase` に渡してください。
+
+```kotlin
+val serviceRegistry =
+  remember {
+    MutableMapServiceRegistry().apply {
+      put(MarkerRenderingSupportKey, myMarkerRenderingSupport)
+    }
+  }
+
+MapViewBase(
+  state = state,
+  /* ... */
+  serviceRegistry = serviceRegistry,
+)
+```
+
+## iOS / SwiftUI 補足
+
+iOS でも同じ考え方で、SwiftUI `Environment` にレジストリを流し込みます（`EnvironmentValues.mapServiceRegistry`）。
+provider 側が capability を登録することで、機能側は provider 非依存のまま拡張できます。
+

example-app/src/main/java/com/mapconductor/example/MapViewContainer.kt

@@ -9,6 +9,7 @@ import com.mapconductor.core.map.MapViewStateInterface
 import com.mapconductor.core.map.OnCameraMoveHandler
 import com.mapconductor.core.map.OnMapEventHandler
 import com.mapconductor.core.map.OnMapLoadedHandler
+import com.mapconductor.core.marker.MarkerTilingOptions
 import com.mapconductor.googlemaps.GoogleMapView
 import com.mapconductor.googlemaps.GoogleMapViewState
 import com.mapconductor.here.HereMapView
@@ -23,6 +24,7 @@ import com.mapconductor.maplibre.MapLibreViewState
 fun MapViewContainer(
     modifier: Modifier = Modifier,
     state: MapViewStateInterface<*>? = null,
+    markerTiling: MarkerTilingOptions? = null,
     onMapLoaded: OnMapLoadedHandler? = null,
     onMapClick: OnMapEventHandler? = null,
     onCameraMoveStart: OnCameraMoveHandler? = null,
@@ -36,6 +38,7 @@ fun MapViewContainer(
             GoogleMapView(
                 modifier = modifier,
                 state = state,
+                markerTiling = markerTiling,
                 onMapLoaded = onMapLoaded,
                 onMapClick = onMapClick,
                 onCameraMoveStart = onCameraMoveStart,
@@ -48,6 +51,7 @@ fun MapViewContainer(
             HereMapView(
                 modifier = modifier,
                 state = state,
+                markerTiling = markerTiling,
                 onMapLoaded = onMapLoaded,
                 onMapClick = onMapClick,
                 onCameraMoveStart = onCameraMoveStart,
@@ -60,6 +64,7 @@ fun MapViewContainer(
             MapboxMapView(
                 modifier = modifier,
                 state = state,
+                markerTiling = markerTiling,
                 onMapLoaded = onMapLoaded,
                 onMapClick = onMapClick,
                 onCameraMoveStart = onCameraMoveStart,
@@ -72,6 +77,7 @@ fun MapViewContainer(
             ArcGISMapView(
                 modifier = modifier,
                 state = state,
+                markerTiling = markerTiling,
                 onMapLoaded = onMapLoaded,
                 onMapClick = onMapClick,
                 onCameraMoveStart = onCameraMoveStart,
@@ -84,6 +90,7 @@ fun MapViewContainer(
             MapLibreMapView(
                 modifier = modifier,
                 state = state,
+                markerTiling = markerTiling,
                 onMapLoaded = onMapLoaded,
                 onMapClick = onMapClick,
                 onCameraMoveStart = onCameraMoveStart,

example-app/src/main/java/com/mapconductor/example/pages/heatmaplayer/HeatmapLayerMapComponent.kt

@@ -1,35 +1,40 @@
 package com.mapconductor.example.pages.heatmaplayer
 
 import androidx.compose.runtime.Composable
+import androidx.compose.runtime.remember
 import androidx.compose.ui.Modifier
 import com.mapconductor.core.map.MapViewStateInterface
 import com.mapconductor.core.map.OnMapLoadedHandler
 import com.mapconductor.example.MapViewContainer
 import com.mapconductor.heatmap.HeatmapOverlay
-import com.mapconductor.heatmap.HeatmapPoint
+import com.mapconductor.heatmap.HeatmapPointState
+import com.mapconductor.heatmap.HeatmapPoints
 import com.mapconductor.postoffice.PostOffice
 
 @Composable
 fun HeatmapLayerMapComponent(
     mapViewState: MapViewStateInterface<*>?,
-    points: List<PostOffice>,
+    points: List<HeatmapPointState>,
     modifier: Modifier = Modifier,
     onMapLoaded: OnMapLoadedHandler? = null,
 ) {
+    val heatmapPoints =
+        remember(points) {
+            points.map {
+                HeatmapPointState(
+                    position = it.position,
+                )
+            }
+        }
     mapViewState?.let { it ->
         MapViewContainer(
             modifier = modifier,
             state = it,
             onMapLoaded = onMapLoaded,
         ) {
             HeatmapOverlay {
-                points.forEach { point ->
-                    HeatmapPoint(
-                        position = point.position
-                    )
-                }
+                HeatmapPoints(heatmapPoints)
             }
-
         }
     }
 }

example-app/src/main/java/com/mapconductor/example/pages/heatmaplayer/HeatmapLayerPageViewModel.kt

@@ -4,6 +4,7 @@ import androidx.lifecycle.ViewModel
 import com.mapconductor.core.features.GeoPoint
 import com.mapconductor.core.map.MapCameraPosition
 import com.mapconductor.core.map.MapViewStateInterface
+import com.mapconductor.heatmap.HeatmapPointState
 import com.mapconductor.postoffice.PostOffice
 import com.mapconductor.postoffice.PostOfficeDataLoader
 import java.lang.Thread.sleep
@@ -17,7 +18,7 @@ import kotlinx.coroutines.launch
 interface HeatmapLayerViewModelInterface {
     val initCameraPosition: MapCameraPosition
 
-    val points: StateFlow<List<PostOffice>>
+    val points: StateFlow<List<HeatmapPointState>>
     val mapViewState: StateFlow<MapViewStateInterface<*>?>
     val isMapLoaded: StateFlow<Boolean>
     val isDataLoading: StateFlow<Boolean>
@@ -46,8 +47,8 @@ class HeatmapLayerPageViewModel(
             tilt = 0.0,
             paddings = null,
         )
-    private val _points: MutableStateFlow<List<PostOffice>> = MutableStateFlow(emptyList())
-    override val points: StateFlow<List<PostOffice>> = _points.asStateFlow()
+    private val _points: MutableStateFlow<List<HeatmapPointState>> = MutableStateFlow(emptyList())
+    override val points: StateFlow<List<HeatmapPointState>> = _points.asStateFlow()
 
     private val _isMapLoaded: MutableStateFlow<Boolean> = MutableStateFlow(false)
     override val isMapLoaded: StateFlow<Boolean> = _isMapLoaded.asStateFlow()
@@ -65,9 +66,7 @@ class HeatmapLayerPageViewModel(
 
         coroutine.launch {
             _isDataLoading.value = true
-            sleep(3000)
-            _points.value = dataLoader.loadAllPostOffices()
-            sleep(1000)
+            _points.value = dataLoader.loadAllPostOffices().map { HeatmapPointState(it.position) }
             _isDataLoading.value = false
         }
     }

example-app/src/main/java/com/mapconductor/example/pages/marker/postoffice/PostOfficeMapComponent.kt

@@ -13,6 +13,7 @@ import com.mapconductor.core.map.OnMapEventHandler
 import com.mapconductor.core.map.OnMapLoadedHandler
 import com.mapconductor.core.marker.Marker
 import com.mapconductor.core.marker.MarkerState
+import com.mapconductor.core.marker.MarkerTilingOptions
 import com.mapconductor.core.marker.Markers
 import com.mapconductor.example.MapViewContainer
 import com.mapconductor.postoffice.PostOffice
@@ -22,6 +23,7 @@ import com.mapconductor.postoffice.PostOfficeInfoView
 fun PostOfficeMapComponent(
     modifier: Modifier = Modifier,
     mapViewState: MapViewStateInterface<*>,
+    markerTiling: MarkerTilingOptions? = null,
     selectedMarker: MarkerState?,
     markers: List<MarkerState> = emptyList<MarkerState>(),
     onMapLoaded: OnMapLoadedHandler? = null,
@@ -36,6 +38,7 @@ fun PostOfficeMapComponent(
     MapViewContainer(
         modifier = modifier,
         state = mapViewState,
+        markerTiling = markerTiling,
         onMapLoaded = onMapLoaded,
         onMapClick = onMapClick,
     ) {

example-app/src/main/java/com/mapconductor/example/pages/marker/postoffice/PostOfficePage.kt

@@ -65,6 +65,7 @@ fun PostOfficePage(
         ) {
             mapViewState?.let { mapViewState ->
                 PostOfficeMapComponent(
+                    markerTiling = viewModel.markerTiling,
                     mapViewState = mapViewState,
                     selectedMarker = selectedMarker,
                     markers = markers,

example-app/src/main/java/com/mapconductor/example/pages/marker/postoffice/PostOfficeViewModel.kt

@@ -6,6 +6,7 @@ import com.mapconductor.core.map.MapCameraPosition
 import com.mapconductor.core.map.MapViewStateInterface
 import com.mapconductor.core.marker.ImageIcon
 import com.mapconductor.core.marker.MarkerState
+import com.mapconductor.core.marker.MarkerTilingOptions
 import com.mapconductor.postoffice.PostOffice
 import com.mapconductor.postoffice.PostOfficeDataLoader
 import java.lang.Thread.sleep
@@ -23,6 +24,7 @@ interface PostOfficeViewModelInterface {
     val mapViewState: StateFlow<MapViewStateInterface<*>?>
     val isMapLoaded: StateFlow<Boolean>
     val isDataLoading: StateFlow<Boolean>
+    val markerTiling: MarkerTilingOptions
 
     fun onMapViewChanged(mapViewState: MapViewStateInterface<*>)
 
@@ -58,6 +60,22 @@ class PostOfficeViewModel(
     private val _markerList: MutableStateFlow<List<MarkerState>> = MutableStateFlow(emptyList())
     override val markerList: StateFlow<List<MarkerState>> = _markerList.asStateFlow()
 
+    override val markerTiling: MarkerTilingOptions = MarkerTilingOptions.Default.copy(
+        iconScaleCallback = { _, zoom ->
+            if (zoom > 12.0) {
+                return@copy 1.3
+            } else if (zoom > 10.0) {
+                return@copy 1.0
+            } else if (zoom > 8.0) {
+                return@copy 0.8
+            } else if (zoom > 5.0) {
+                return@copy 0.5
+            } else {
+                return@copy 0.2
+            }
+        }
+    )
+
     private val _isMapLoaded: MutableStateFlow<Boolean> = MutableStateFlow(false)
     override val isMapLoaded: StateFlow<Boolean> = _isMapLoaded.asStateFlow()