Add geodesic, startCap/endCap, and spans support for polylines and polygons (#14)

* Add 2 markers and clean up the docs

* Add toolbars, update the doc

* Draw dashed polylines when highlighted

* Add zoom-to-fit when navigating between overlays in Example04

Author: afarber

README.md

@@ -14,7 +14,7 @@ Add to your `build.gradle.kts`:
 
 ```kotlin
 dependencies {
-    implementation("de.afarber:openmapview:0.12.0")
+    implementation("de.afarber:openmapview:0.13.0")
 }
 ```
 

docs/PERFORMANCE.md

@@ -269,7 +269,7 @@ HttpClient(Android) {
 All requests include a user-agent header as required by OSM tile usage policy:
 
 ```kotlin
-header("User-Agent", "OpenMapView/0.12.0 (https://github.com/afarber/OpenMapView)")
+header("User-Agent", "OpenMapView/0.13.0 (https://github.com/afarber/OpenMapView)")
 ```
 
 ### Coroutine-Based Downloads

docs/REPLACING_GOOGLE_MAPS.md

@@ -107,7 +107,7 @@ dependencies {
 ```kotlin
 // Add to build.gradle.kts
 dependencies {
-    implementation("de.afarber:openmapview:0.12.0")
+    implementation("de.afarber:openmapview:0.13.0")
 }
 ```
 

examples/Example01Pan/README.md

@@ -64,7 +64,7 @@ fun MapViewScreen() {
             factory = { ctx ->
                 OpenMapView(ctx).apply {
                     lifecycleOwner.lifecycle.addObserver(this)
-                    setCenter(LatLng(51.4661, 7.2491)) // Bochum, Germany
+                    setCenter(LatLng(51.4661, 7.2491))
                     setZoom(14.0f)
                     mapView = this
                 }
@@ -81,14 +81,6 @@ fun MapViewScreen() {
 }
 ```
 
-### OSM-Inspired Colors (Colors.kt)
-
-```kotlin
-val OsmParkGreen = Color(0xFFAAD3A2)   // Parks and forests
-val OsmHighwayPink = Color(0xFFE892A2)  // Highways and roads
-val OsmWaterBlue = Color(0xFFAAD3DF)    // Water areas
-```
-
 ### Key Concepts
 
 - **LatLng**: Represents geographic coordinates (latitude, longitude)
@@ -117,3 +109,4 @@ val OsmWaterBlue = Color(0xFFAAD3DF)    // Water areas
 - Location 2 (Green marker): East of center
 - Location 3 (Magenta marker): South-West of center
 - Initial (Cyan marker): Center position
+

examples/Example02Zoom/README.md

@@ -62,7 +62,7 @@ fun MapViewScreen() {
             factory = { ctx ->
                 OpenMapView(ctx).apply {
                     lifecycleOwner.lifecycle.addObserver(this)
-                    setCenter(LatLng(51.4661, 7.2491)) // Bochum, Germany
+                    setCenter(LatLng(51.4661, 7.2491))
                     setZoom(14.0f)
                     mapView = this
                 }
@@ -76,14 +76,6 @@ fun MapViewScreen() {
 }
 ```
 
-### OSM-Inspired Colors (Colors.kt)
-
-```kotlin
-val OsmParkGreen = Color(0xFFAAD3A2)   // Parks and forests
-val OsmHighwayPink = Color(0xFFE892A2)  // Highways and roads
-val OsmWaterBlue = Color(0xFFAAD3DF)    // Water areas
-```
-
 ### Key Concepts
 
 - **setZoom()**: Sets zoom level (2.0 = world view, 19.0 = street level)
@@ -122,3 +114,4 @@ OpenMapView uses:
 ## Map Location
 
 **Default Center:** Bochum, Germany (51.4661N, 7.2491E) at zoom 14.0
+

examples/Example03Markers/README.md

@@ -46,7 +46,7 @@ example03markers/
 ├── MarkerToolbar.kt     # Horizontal toolbar with prev/next navigation buttons
 ├── StatusToolbar.kt     # Status overlay showing selection index and camera state
 ├── MarkerData.kt        # Marker data class and Bochum POI locations
-└── Constants.kt         # Colors, dimensions, and durations
+└── Colors.kt            # OSM-inspired colors and shared dimensions
 ```
 
 ## Code Highlights
@@ -68,8 +68,8 @@ fun MapViewScreen() {
                 OpenMapView(ctx).apply {
                     lifecycleOwner.lifecycle.addObserver(this)
                     setCenter(initialLocation)
-                    setZoom(13.0f)
-                    getUiSettings().infoWindowAutoDismiss = 10.seconds
+                    setZoom(15.0f)
+                    getUiSettings().infoWindowAutoDismiss = 5.seconds
 
                     setOnMarkerClickListener { marker ->
                         selectedMarker = marker
@@ -98,7 +98,7 @@ addMarker(
     Marker(
         position = LatLng(51.4783, 7.2231),
         title = "Bochum Hauptbahnhof",
-        snippet = "Main railway station",
+        snippet = "Main Railway Station",
         icon = BitmapDescriptorFactory.defaultMarker(BitmapDescriptorFactory.HUE_RED),
     )
 )
@@ -116,14 +116,6 @@ addMarker(
 )
 ```
 
-### OSM-Inspired Colors (Constants.kt)
-
-```kotlin
-val OsmParkGreen = Color(0xFFAAD3A2)   // Navigation buttons (prev/next)
-val OsmHighwayPink = Color(0xFFE892A2)  // Info window toggle FAB
-val OsmWaterBlue = Color(0xFFAAD3DF)    // Reserved for future use
-```
-
 ### Key Concepts
 
 - **Marker**: Data class with position, title, snippet, icon, anchor, and tag
@@ -132,7 +124,6 @@ val OsmWaterBlue = Color(0xFFAAD3DF)    // Reserved for future use
 - **setOnMarkerClickListener()**: Handle marker click events
 - **setOnInfoWindowClickListener()**: Handle info window click events
 - **setOnInfoWindowCloseListener()**: Handle info window close events (manual or auto-dismiss)
-- **infoWindowAutoDismiss**: Auto-dismiss info windows after a duration
 
 ## What to Test
 
@@ -145,19 +136,6 @@ val OsmWaterBlue = Color(0xFFAAD3DF)    // Reserved for future use
 7. **Wait 10 seconds** - info window auto-dismisses, status text turns black
 8. **Pan/zoom the map** - markers stay at correct geographic positions
 
-## Marker Locations
-
-This example displays 6 markers at notable Bochum landmarks:
-
-| Location          | Coordinates         | Description          |
-| ----------------- | ------------------- | -------------------- |
-| Hauptbahnhof      | 51.4783°N, 7.2231°E | Main railway station |
-| Ruhr University   | 51.4452°N, 7.2622°E | Ruhr-Universitat     |
-| Rathaus           | 51.4816°N, 7.2166°E | City Hall            |
-| Bermuda3eck       | 51.4807°N, 7.2222°E | Entertainment dist.  |
-| Bergbau-Museum    | 51.4892°N, 7.2174°E | Mining Museum        |
-| Starlight Express | 51.4649°N, 7.2043°E | Musical theater      |
-
 ## Custom Marker Icons
 
 To use custom marker icons instead of the default teardrop:
@@ -211,4 +189,5 @@ Click detection uses:
 
 **Default Center:** Calculated from marker positions (~51.47°N, 7.22°E) at zoom 13.0
 
-All 6 markers are positioned around Bochum at real landmark locations.
+All 8 markers are positioned around Bochum at real landmark locations.
+

examples/Example03Markers/screenshot.gif

@@ -9,8 +9,6 @@ package de.afarber.openmapview.example03markers
 
 import androidx.compose.ui.graphics.Color
 import androidx.compose.ui.unit.dp
-import kotlin.time.Duration
-import kotlin.time.Duration.Companion.seconds
 
 /**
  * Constants for the Example03Markers app: colors, dimensions, and durations.
@@ -27,6 +25,3 @@ val OsmWaterBlue = Color(0xFFAAD3DF)
 
 /** Shared corner radius for all toolbar components (matches Material3 FAB). */
 val ToolbarCornerRadius = 16.dp
-
-/** Duration after which info windows are automatically dismissed. */
-val InfoWindowAutoDismissDuration: Duration = 5.seconds

…penmapview/example03markers/Constants.kt …r/openmapview/example03markers/Colors.ktexamples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/Constants.kt renamed to examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/Colors.kt examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/Constants.kt renamed to examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/Colors.kt

@@ -15,7 +15,7 @@ import androidx.compose.foundation.layout.Box
 import androidx.compose.foundation.layout.fillMaxSize
 import androidx.compose.foundation.layout.padding
 import androidx.compose.material.icons.Icons
-import androidx.compose.material.icons.filled.LocationOn
+import androidx.compose.material.icons.filled.LocationSearching
 import androidx.compose.material3.FloatingActionButton
 import androidx.compose.material3.Icon
 import androidx.compose.material3.MaterialTheme
@@ -39,6 +39,7 @@ import de.afarber.openmapview.LatLng
 import de.afarber.openmapview.Marker
 import de.afarber.openmapview.OnCameraMoveStartedListener
 import de.afarber.openmapview.OpenMapView
+import kotlin.time.Duration.Companion.seconds
 
 /**
  * Main activity demonstrating OpenMapView marker navigation.
@@ -83,7 +84,7 @@ fun MapViewScreen() {
         poiMarkers.map { it.position.latitude }.average(),
         poiMarkers.map { it.position.longitude }.average(),
     )
-    val initialZoom = 14.0f
+    val initialZoom = 15.0f
 
     // State variables - mapView is nullable because AndroidView.factory runs after first composition
     var mapView: OpenMapView? by remember { mutableStateOf(null) }
@@ -119,7 +120,7 @@ fun MapViewScreen() {
 
                     setCenter(initialLocation)
                     setZoom(initialZoom)
-                    getUiSettings().infoWindowAutoDismiss = InfoWindowAutoDismissDuration
+                    getUiSettings().infoWindowAutoDismiss = 5.seconds
 
                     createMarkers(this)
 
@@ -159,6 +160,7 @@ fun MapViewScreen() {
 
         // Status overlay at top
         StatusToolbar(
+            totalCount = poiMarkers.size,
             selectedIndex = selectedIndex,
             selectedMarkerTitle = selectedMarker?.title,
             cameraState = cameraState,
@@ -212,7 +214,7 @@ fun MapViewScreen() {
                 .padding(16.dp),
         ) {
             Icon(
-                imageVector = Icons.Default.LocationOn,
+                imageVector = Icons.Default.LocationSearching,
                 contentDescription = "Toggle Info Window",
             )
         }

examples/Example03Markers/src/main/kotlin/de/afarber/openmapview/example03markers/MainActivity.kt

@@ -30,13 +30,13 @@ val poiMarkers = listOf(
     MarkerData(
         position = LatLng(51.4783, 7.2231),
         title = "Bochum Hauptbahnhof",
-        snippet = "Main railway station",
+        snippet = "Main Railway Station",
         hue = BitmapDescriptorFactory.HUE_RED,
     ),
     MarkerData(
         position = LatLng(51.4452, 7.2622),
         title = "Ruhr University",
-        snippet = "Ruhr-Universität Bochum",
+        snippet = "Ruhr-University Bochum",
         hue = BitmapDescriptorFactory.HUE_BLUE,
     ),
     MarkerData(
@@ -46,9 +46,9 @@ val poiMarkers = listOf(
         hue = BitmapDescriptorFactory.HUE_GREEN,
     ),
     MarkerData(
-        position = LatLng(51.4807, 7.2222),
+        position = LatLng(51.4761, 7.2161),
         title = "Bermuda3eck",
-        snippet = "Entertainment district",
+        snippet = "Entertainment District",
         hue = BitmapDescriptorFactory.HUE_ORANGE,
     ),
     MarkerData(
@@ -58,9 +58,21 @@ val poiMarkers = listOf(
         hue = BitmapDescriptorFactory.HUE_MAGENTA,
     ),
     MarkerData(
-        position = LatLng(51.4649, 7.2043),
+        position = LatLng(51.4927, 7.2342),
         title = "Starlight Express",
-        snippet = "Musical theater",
+        snippet = "Musical Theater",
         hue = BitmapDescriptorFactory.HUE_CYAN,
     ),
+    MarkerData(
+        position = LatLng(51.4722, 7.2177),
+        title = "Schauspielhaus Bochum",
+        snippet = "Drama Theater",
+        hue = BitmapDescriptorFactory.HUE_YELLOW,
+    ),
+    MarkerData(
+        position = LatLng(51.4854, 7.2278),
+        title = "Zeiss Planetarium",
+        snippet = "Domed Astronomy Center",
+        hue = BitmapDescriptorFactory.HUE_VIOLET,
+    ),
 )