MapType

Map type constants for OpenMapView.

Defines 15 map tile styles from various providers. Twelve 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

• OPENTOPOMAP: Free topographic map with contours

• CARTO_LIGHT: Minimalist light theme for data visualization

• CARTO_DARK: Dark theme for night mode

• CARTO_VOYAGER: Modern colorful basemap

• STAMEN_TONER: High-contrast black and white

• STAMEN_WATERCOLOR: Artistic watercolor rendering

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)

API Key Configuration

Configure API keys in AndroidManifest.xml:

<meta-data
    android:name="de.afarber.openmapview.THUNDERFOREST_API_KEY"
    android:value="your_key_here"/>
<meta-data
    android:name="de.afarber.openmapview.TRACESTRACK_API_KEY"
    android:value="your_key_here"/>

Or programmatically:

ApiKeyManager.setApiKey("thunderforest", "your_key_here")

When an API key is required but not configured, OpenMapView displays the STANDARD map with an overlay indicating the missing key. The map remains interactive.

Obtaining API Keys

• 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

See also