KMaP

A flexible and powerful compose multiplatform mapping library

KMaP is a Kotlin Compose Multiplatform mapping library designed for shared map UIs across all KMP targets. It gives you a single composable API to build map experiences once in commonMain, while still supporting platform-specific runtime targets.

KMaP Demo App (WASM)

Documentation Page

🧭 Project Status

🚧 Vector tiles paused: Work is on hold until Compose provides async measurement + async drawing, which are needed for smooth, non-blocking rendering.
✅ Raster tiles done: All raster features are complete and ready to use.

Key Features

• Cross-Platform Compatibility: Use a single KMaP Composable in your common code for a consistent user experience across all platforms.
• Interactive Elements: Features like zooming, panning, and rotating maps.
• Marker and Popup Support: Adding markers, popups, and tooltips to maps for enhanced interactivity.
• Layer Management: Support for multiple layers.
• Clustering: Visualizing data density with clustering markers.
• Offline Maps: Ability to use maps without an internet connection.
• Projection Support: Handling different map projections and coordinate systems.
• Performance: Efficient rendering and handling of large datasets.
• Easy Integration: Seamlessly integrate KMaP into your existing compose projects.
• Customizable: Tailor the map's behavior to fit your needs.

Setup

Add KMaP to your commonMain dependencies:

kotlin {
    sourceSets {
        commonMain.dependencies {
            implementation("com.rafambn:KMaP:0.4.1")
        }
    }
}

Usage

With KMaP, you implement your map logic once. Provide a MapProperties and a TileSource and use it across targets:

val mapProperties = /* your MapProperties implementation */
val tileSource = /* your TileSource<RasterTile> implementation */
val mapState = rememberMapState(mapProperties = mapProperties)

KMaP(
    modifier = Modifier.fillMaxSize(),
    mapState = mapState,
) {
    rasterCanvas(
        parameters = RasterCanvasParameters(
            id = 1,
            tileSource = tileSource::getTile,
        ),
        gestureWrapper = MapGestureWrapper(
            onGesture = { centroid, pan, zoom, rotation ->
                mapState.motionController.move {
                    rotateByCentered(rotation.toDouble(), centroid)
                    zoomByCentered(zoom, centroid)
                    positionBy(pan)
                }
            },
        )
    )
}