Remove vector tile providers

Author: afarber

docs/MAP_TYPES.md

@@ -4,7 +4,7 @@ This guide helps you choose and configure the right map type for your OpenMapVie
 
 ## Quick Start
 
-OpenMapView provides **10 map types** matching the OpenStreetMap.org layer switcher. Six types work without any configuration, while four premium types require free API keys.
+OpenMapView provides **9 map types** matching the OpenStreetMap.org layer switcher. Six types work without any configuration, while three premium types require free API keys.
 
 ```kotlin
 val mapView = OpenMapView(context)
@@ -49,7 +49,7 @@ mapView.setMapType(MapType.CYCLOSM)
 ```
 
 #### 3. HUMANITARIAN - Emergency Response
-**`MapType.HUMANITARIAN`** (constant value: 6)
+**`MapType.HUMANITARIAN`** (constant value: 7)
 
 Humanitarian OpenStreetMap Team (HOT) style with red/orange color scheme.
 
@@ -65,7 +65,7 @@ mapView.setMapType(MapType.HUMANITARIAN)
 ```
 
 #### 4. OPNVKARTE - German Public Transport
-**`MapType.OPNVKARTE`** (constant value: 7)
+**`MapType.OPNVKARTE`** (constant value: 8)
 
 Detailed public transport map focusing on German transit networks.
 
@@ -142,8 +142,27 @@ Public transport focused map with comprehensive transit information.
 mapView.setMapType(MapType.TRANSPORT)
 ```
 
-#### 8. TRACESTRACK_TOPO - Topographic Map
-**`MapType.TRACESTRACK_TOPO`** (constant value: 5) 🔑 **Requires Tracestrack API Key**
+#### 8. TRANSPORT_DARK - Dark Mode Public Transit Map
+**`MapType.TRANSPORT_DARK`** (constant value: 5) **Requires Thunderforest API Key**
+
+Dark variant of the public transport map with comprehensive transit information in a dark color scheme.
+
+- **Best for**: Night mode transit apps, low-light journey planning, dark mode applications
+- **Features**: Bus routes, train lines, tram tracks, transit stations
+- **Highlights**: Dark color scheme suitable for night mode
+- **Tile Server**: tile.thunderforest.com
+- **Max Zoom**: 21
+- **Free Tier**: 150,000 tiles/month
+- **Get API Key**: https://www.thunderforest.com/pricing/
+- **Attribution**: © OpenStreetMap contributors. Tiles courtesy of Andy Allan
+
+```kotlin
+// Same API key as CYCLEMAP and TRANSPORT
+mapView.setMapType(MapType.TRANSPORT_DARK)
+```
+
+#### 9. TRACESTRACK_TOPO - Topographic Map
+**`MapType.TRACESTRACK_TOPO`** (constant value: 6) **Requires Tracestrack API Key**
 
 Detailed topographic map with elevation contours and hillshading.
 
@@ -168,25 +187,6 @@ ApiKeyManager.setApiKey("tracestrack", "your_key_here")
 mapView.setMapType(MapType.TRACESTRACK_TOPO)
 ```
 
-#### 9. MAPTILER_OMT - OpenMapTiles Vector Style
-**`MapType.MAPTILER_OMT`** (constant value: 9) 🔑🚧 **Not Yet Supported**
-
-High-quality vector tile map based on OpenMapTiles schema.
-
-- **Status**: Not yet supported - requires MapLibre GL integration
-- **Get API Key**: https://www.maptiler.com/cloud/plans/
-- **Free Tier**: 100,000 tiles/month
-
-### Vector Tile Support
-
-#### 10. SHORTBREAD - Modern Vector Style
-**`MapType.SHORTBREAD`** (constant value: 8) 🚧 **Not Yet Supported**
-
-Modern, clean vector-based map style.
-
-- **Status**: Not yet supported - requires MapLibre GL integration
-- **No API Key Required**
-
 ## API Key Configuration
 
 ### Method 1: AndroidManifest.xml (Recommended)
@@ -195,7 +195,7 @@ Add API keys to your app's `AndroidManifest.xml`:
 
 ```xml
 <application>
-    <!-- Thunderforest (for CYCLEMAP and TRANSPORT) -->
+    <!-- Thunderforest (for CYCLEMAP, TRANSPORT, and TRANSPORT_DARK) -->
     <meta-data
         android:name="de.afarber.openmapview.THUNDERFOREST_API_KEY"
         android:value="your_thunderforest_key_here"/>
@@ -204,11 +204,6 @@ Add API keys to your app's `AndroidManifest.xml`:
     <meta-data
         android:name="de.afarber.openmapview.TRACESTRACK_API_KEY"
         android:value="your_tracestrack_key_here"/>
-
-    <!-- MapTiler (for MAPTILER_OMT - when supported) -->
-    <meta-data
-        android:name="de.afarber.openmapview.MAPTILER_API_KEY"
-        android:value="your_maptiler_key_here"/>
 </application>
 ```
 
@@ -221,30 +216,23 @@ import de.afarber.openmapview.ApiKeyManager
 
 ApiKeyManager.setApiKey("thunderforest", "your_key_here")
 ApiKeyManager.setApiKey("tracestrack", "your_key_here")
-ApiKeyManager.setApiKey("maptiler", "your_key_here")
 ```
 
 ### Obtaining API Keys
 
 All providers offer generous free tiers suitable for development and small-scale production use:
 
-#### Thunderforest (CYCLEMAP, TRANSPORT)
+#### Thunderforest (CYCLEMAP, TRANSPORT, TRANSPORT_DARK)
 - **Website**: https://www.thunderforest.com/pricing/
 - **Free Tier**: 150,000 tiles/month
 - **Sign Up**: Register for free account
-- **One key works for**: Both CYCLEMAP and TRANSPORT
+- **One key works for**: CYCLEMAP, TRANSPORT, and TRANSPORT_DARK
 
 #### Tracestrack (TRACESTRACK_TOPO)
 - **Website**: https://www.tracestrack.com/en/signup
 - **Free Tier**: 100,000 tiles/month
 - **Sign Up**: Register for free account
 
-#### MapTiler (MAPTILER_OMT)
-- **Website**: https://www.maptiler.com/cloud/plans/
-- **Free Tier**: 100,000 tiles/month
-- **Sign Up**: Register for free account
-- **Note**: MAPTILER_OMT not yet supported (vector tiles)
-
 ### Security Best Practices
 
 1. **Use Domain Restrictions**: Configure API keys on provider websites to restrict usage to your app's domain/bundle ID
@@ -262,6 +250,7 @@ All providers offer generous free tiers suitable for development and small-scale
 | Cycling/bike app (free) | `CYCLOSM` |
 | Cycling/bike app (premium) | `CYCLEMAP` (requires API key) |
 | Public transit app | `TRANSPORT` (requires API key) |
+| Public transit app (dark mode) | `TRANSPORT_DARK` (requires API key) |
 | German transit app | `OPNVKARTE` |
 | Hiking/outdoor app | `TRACESTRACK_TOPO` (requires API key) |
 | Emergency/humanitarian | `HUMANITARIAN` |
@@ -294,8 +283,8 @@ See `PredefinedTileProviders.kt` for predefined overlay sources, or create custo
 ## Example Usage
 
 See the **Example11MapTypes** sample app for a complete demonstration of all map types with:
-- Buttons to switch between all 10 map types
-- Visual indicators for API key requirements (🔑) and coming soon features (🚧)
+- Buttons to switch between all 9 map types
+- Visual indicators for API key requirements
 - Descriptions of each map type
 - Instructions for API key configuration
 

openmapview/src/main/kotlin/de/afarber/openmapview/ApiKeyManager.kt

@@ -15,7 +15,7 @@ import java.util.concurrent.ConcurrentHashMap
 /**
  * Manages API keys for third-party tile providers.
  *
- * Some map types (CYCLEMAP, TRANSPORT, TRACESTRACK_TOPO, MAPTILER_OMT) require API keys
+ * Some map types (CYCLEMAP, TRANSPORT, TRANSPORT_DARK, TRACESTRACK_TOPO) require API keys
  * from tile providers. Keys can be configured in two ways:
  *
  * **1. AndroidManifest.xml** (Recommended):
@@ -27,30 +27,24 @@ import java.util.concurrent.ConcurrentHashMap
  *     <meta-data
  *         android:name="de.afarber.openmapview.TRACESTRACK_API_KEY"
  *         android:value="your_tracestrack_key_here"/>
- *     <meta-data
- *         android:name="de.afarber.openmapview.MAPTILER_API_KEY"
- *         android:value="your_maptiler_key_here"/>
  * </application>
  * ```
  *
  * **2. Programmatically** (Runtime):
  * ```kotlin
  * ApiKeyManager.setApiKey("thunderforest", "your_key_here")
  * ApiKeyManager.setApiKey("tracestrack", "your_key_here")
- * ApiKeyManager.setApiKey("maptiler", "your_key_here")
  * ```
  *
  * API keys set programmatically override keys from the manifest.
  *
  * ## Provider Names
- * - `"thunderforest"` - For CYCLEMAP and TRANSPORT map types
+ * - `"thunderforest"` - For CYCLEMAP, TRANSPORT, and TRANSPORT_DARK map types
  * - `"tracestrack"` - For TRACESTRACK_TOPO map type
- * - `"maptiler"` - For MAPTILER_OMT map type (vector tiles, not yet supported)
  *
  * ## Obtaining API Keys
  * - **Thunderforest**: https://www.thunderforest.com/pricing/ (Free: 150k tiles/month)
  * - **Tracestrack**: https://www.tracestrack.com/en/signup (Free tier available)
- * - **MapTiler**: https://www.maptiler.com/cloud/plans/ (Free: 100k tiles/month)
  *
  * @see TileSource
  * @see MapType
@@ -59,7 +53,6 @@ object ApiKeyManager {
     private const val META_DATA_PREFIX = "de.afarber.openmapview."
     private const val THUNDERFOREST_KEY_NAME = "THUNDERFOREST_API_KEY"
     private const val TRACESTRACK_KEY_NAME = "TRACESTRACK_API_KEY"
-    private const val MAPTILER_KEY_NAME = "MAPTILER_API_KEY"
 
     /**
      * Thread-safe storage for API keys set programmatically.
@@ -116,7 +109,7 @@ object ApiKeyManager {
      *
      * Keys set this way override keys from AndroidManifest.xml.
      *
-     * @param provider Provider name ("thunderforest", "tracestrack", or "maptiler")
+     * @param provider Provider name ("thunderforest" or "tracestrack")
      * @param key API key string
      */
     @Synchronized
@@ -132,7 +125,7 @@ object ApiKeyManager {
      *
      * Checks programmatic keys first, then falls back to manifest meta-data.
      *
-     * @param provider Provider name ("thunderforest", "tracestrack", or "maptiler")
+     * @param provider Provider name ("thunderforest" or "tracestrack")
      * @return API key string, or null if not configured
      */
     @Synchronized
@@ -147,7 +140,6 @@ object ApiKeyManager {
             when (normalizedProvider) {
                 "thunderforest" -> META_DATA_PREFIX + THUNDERFOREST_KEY_NAME
                 "tracestrack" -> META_DATA_PREFIX + TRACESTRACK_KEY_NAME
-                "maptiler" -> META_DATA_PREFIX + MAPTILER_KEY_NAME
                 else -> null
             }
 
@@ -157,7 +149,7 @@ object ApiKeyManager {
     /**
      * Checks if an API key is configured for the given provider.
      *
-     * @param provider Provider name ("thunderforest", "tracestrack", or "maptiler")
+     * @param provider Provider name ("thunderforest" or "tracestrack")
      * @return true if a key is available, false otherwise
      */
     fun hasApiKey(provider: String): Boolean = !getApiKey(provider).isNullOrEmpty()

openmapview/src/main/kotlin/de/afarber/openmapview/MapController.kt

@@ -258,10 +258,6 @@ class MapController(
      * - Creates an overlay indicating the missing API key
      * - The map remains interactive (touch events pass through)
      *
-     * If the map type is vector-based (not yet supported):
-     * - Falls back to STANDARD tile source
-     * - Creates an overlay indicating vector tiles are not yet supported
-     *
      * @param mapType The MapType constant
      */
     fun setMapType(mapType: Int) {
@@ -273,22 +269,8 @@ class MapController(
         // Get the tile source for this map type
         val source = TileSource.fromMapType(mapType)
 
-        // Check if the tile source is supported (not vector tiles)
-        if (!source.isSupported()) {
-            // Vector tiles not supported - use STANDARD and show overlay
-            actualTileSource = TileSource.STANDARD
-            apiKeyErrorOverlay =
-                ApiKeyErrorOverlay(
-                    context,
-                    source.getProviderName(),
-                    TileSource.getMapTypeName(mapType),
-                )
-            android.util.Log.i(
-                "OpenMapView",
-                "${TileSource.getMapTypeName(mapType)} requires vector tile support (MapLibre GL). " +
-                    "Displaying STANDARD map instead.",
-            )
-        } else if (source.requiresApiKey && !source.hasApiKey()) {
+        // Check if an API key is required but not configured
+        if (source.requiresApiKey && !source.hasApiKey()) {
             // API key required but not configured - use STANDARD and show overlay
             actualTileSource = TileSource.STANDARD
             apiKeyErrorOverlay =

openmapview/src/main/kotlin/de/afarber/openmapview/MapType.kt

@@ -10,22 +10,21 @@ package de.afarber.openmapview
 /**
  * Map type constants for OpenMapView.
  *
- * Defines 10 map tile styles matching the openstreetmap.org layer switcher.
- * Six map types work without API keys, four require API keys from third-party providers.
+ * Defines 9 map tile styles matching the openstreetmap.org layer switcher.
+ * Six map types work without API keys, three require API keys from third-party providers.
  *
  * **Free Map Types (No API Key Required):**
  * - [NONE]: No base map tiles
  * - [STANDARD]: Default OpenStreetMap Mapnik rendering
  * - [CYCLOSM]: Cycling-focused map from OpenStreetMap France
  * - [HUMANITARIAN]: Humanitarian OSM style for emergency response
  * - [OPNVKARTE]: German public transport map
- * - [SHORTBREAD]: Modern vector tile style (not yet supported)
  *
  * **Premium Map Types (API Key Required):**
  * - [CYCLEMAP]: Thunderforest cycling map (requires Thunderforest API key)
  * - [TRANSPORT]: Public transport focused map (requires Thunderforest API key)
+ * - [TRANSPORT_DARK]: Dark mode public transport map (requires Thunderforest API key)
  * - [TRACESTRACK_TOPO]: Topographic with contours (requires Tracestrack API key)
- * - [MAPTILER_OMT]: OpenMapTiles vector style (requires MapTiler API key, not yet supported)
  *
  * ## API Key Configuration
  *
@@ -37,9 +36,6 @@ package de.afarber.openmapview
  * <meta-data
  *     android:name="de.afarber.openmapview.TRACESTRACK_API_KEY"
  *     android:value="your_key_here"/>
- * <meta-data
- *     android:name="de.afarber.openmapview.MAPTILER_API_KEY"
- *     android:value="your_key_here"/>
  * ```
  *
  * Or programmatically:
@@ -51,12 +47,10 @@ package de.afarber.openmapview
  * with an overlay indicating the missing key. The map remains interactive.
  *
  * ## Obtaining API Keys
- * - **Thunderforest** (CYCLEMAP, TRANSPORT): https://www.thunderforest.com/pricing/
+ * - **Thunderforest** (CYCLEMAP, TRANSPORT, TRANSPORT_DARK): https://www.thunderforest.com/pricing/
  *   - Free tier: 150,000 tiles/month
  * - **Tracestrack** (TRACESTRACK_TOPO): https://www.tracestrack.com/en/signup
  *   - Free tier: 100,000 tiles/month
- * - **MapTiler** (MAPTILER_OMT): https://www.maptiler.com/cloud/plans/
- *   - Free tier: 100,000 tiles/month
  *
  * @see OpenMapView.setMapType
  * @see OpenMapView.getMapType
@@ -185,38 +179,4 @@ object MapType {
      * - **Use Cases**: German transit apps, ÖPNV journey planning
      */
     const val OPNVKARTE: Int = 8
-
-    /**
-     * Shortbread - Modern vector tile style.
-     *
-     * Modern, clean vector-based map style with smooth rendering and customizable styling.
-     *
-     * **Note**: Vector tiles are not yet supported in OpenMapView. This map type requires
-     * MapLibre GL integration which is planned for a future release. Selecting this type
-     * will display a "not yet supported" overlay.
-     *
-     * - **Tile Server**: vector.openstreetmap.org
-     * - **Max Zoom**: 23
-     * - **API Key**: Not required
-     * - **Status**: Coming soon
-     */
-    const val SHORTBREAD: Int = 9
-
-    /**
-     * MapTiler OMT - OpenMapTiles vector style.
-     *
-     * High-quality vector tile map based on OpenMapTiles schema. Provides smooth
-     * rendering, client-side styling, and excellent performance.
-     *
-     * **Note**: Vector tiles are not yet supported in OpenMapView. This map type requires
-     * MapLibre GL integration and a MapTiler API key. Planned for a future release.
-     *
-     * - **Tile Server**: api.maptiler.com
-     * - **Max Zoom**: 23
-     * - **API Key**: Required (MapTiler)
-     * - **Status**: Coming soon
-     *
-     * @see ApiKeyManager
-     */
-    const val MAPTILER_OMT: Int = 10
 }

openmapview/src/main/kotlin/de/afarber/openmapview/OpenMapView.kt

@@ -444,11 +444,10 @@ class OpenMapView
          * - [MapType.CYCLOSM] - Cycling-focused map style
          * - [MapType.CYCLEMAP] - Thunderforest cycling map (requires API key)
          * - [MapType.TRANSPORT] - Public transport map (requires API key)
+         * - [MapType.TRANSPORT_DARK] - Dark mode public transport map (requires API key)
          * - [MapType.TRACESTRACK_TOPO] - Topographic map with contour lines (requires API key)
          * - [MapType.HUMANITARIAN] - Humanitarian-focused style
          * - [MapType.OPNVKARTE] - German public transport
-         * - [MapType.SHORTBREAD] - Vector tiles (not yet supported)
-         * - [MapType.MAPTILER_OMT] - Vector tiles (not yet supported, requires API key)
          *
          * When the map type changes, the tile cache is cleared and the map is redrawn.
          *
@@ -465,16 +464,16 @@ class OpenMapView
          */
         fun setMapType(type: Int) {
             // Validate map type
-            if (type !in 0..10) {
-                throw IllegalArgumentException("Unknown map type: $type. Must be a valid MapType constant (0-10).")
+            if (type !in 0..8) {
+                throw IllegalArgumentException("Unknown map type: $type. Must be a valid MapType constant (0-8).")
             }
 
             currentMapType = type
             controller.setMapType(type)
 
             // Update attribution for the actual tile source being used
             val source = TileSource.fromMapType(type)
-            if (type != MapType.NONE && source.isSupported()) {
+            if (type != MapType.NONE) {
                 attributionOverlay.setAttributionText(source.attributionText)
                 attributionOverlay.setAttributionUrl(source.attributionUrl)
             }