---
title: "MTMapReferenceStyle | Mobile sdk | Mobile sdk ios | Ios"
description: "Defines purpose and guidelines on what information is displayed."
---

> For AI agents: a documentation index is available at [/llms.txt](https://docs.maptiler.com/llms.txt). Markdown versions of all pages are available by appending .md to any URL.

# MTMapReferenceStyle

```
public enum MTMapReferenceStyle : Identifiable, Hashable, Sendable, Codable
```

Defines purpose and guidelines on what information is displayed.

-   `[id](#/s:11MapTilerSDK19MTMapReferenceStyleO2idSSvp)`
    
    Unique id of the style.
    
    #### Declaration
    
    Swift
    
    ```
    public var id: String { get }
    ```
    
-   `[streets](#/s:11MapTilerSDK19MTMapReferenceStyleO7streetsyA2CmF)`
    
    The classic default style, perfect for urban areas.
    
    #### Declaration
    
    Swift
    
    ```
    case streets
    ```
    
-   `[satellite](#/s:11MapTilerSDK19MTMapReferenceStyleO9satelliteyA2CmF)`
    
    High resolution satellite images.
    
    #### Declaration
    
    Swift
    
    ```
    case satellite
    ```
    
-   `[outdoor](#/s:11MapTilerSDK19MTMapReferenceStyleO7outdooryA2CmF)`
    
    A solid hiking companion, with peaks, parks, isolines and more.
    
    #### Declaration
    
    Swift
    
    ```
    case outdoor
    ```
    
-   `[winter](#/s:11MapTilerSDK19MTMapReferenceStyleO6winteryA2CmF)`
    
    A map for developing skiing, snowboarding and other winter activities and adventures.
    
    #### Declaration
    
    Swift
    
    ```
    case winter
    ```
    
-   `[dataviz](#/s:11MapTilerSDK19MTMapReferenceStyleO7datavizyA2CmF)`
    
    A minimalist style for data visualization.
    
    #### Declaration
    
    Swift
    
    ```
    case dataviz
    ```
    
-   `[base](#/s:11MapTilerSDK19MTMapReferenceStyleO4baseyA2CmF)`
    
    A clear general purpose map.
    
    #### Declaration
    
    Swift
    
    ```
    case base
    ```
    
-   `[bright](#/s:11MapTilerSDK19MTMapReferenceStyleO6brightyA2CmF)`
    
    A minimalist style for high contrast navigation.
    
    #### Declaration
    
    Swift
    
    ```
    case bright
    ```
    
-   `[topo](#/s:11MapTilerSDK19MTMapReferenceStyleO4topoyA2CmF)`
    
    Reference style for topographic study.
    
    #### Declaration
    
    Swift
    
    ```
    case topo
    ```
    
-   `[toner](#/s:11MapTilerSDK19MTMapReferenceStyleO5toneryA2CmF)`
    
    Reference style for very high contrast stylish maps.
    
    #### Declaration
    
    Swift
    
    ```
    case toner
    ```
    
-   `[backdrop](#/s:11MapTilerSDK19MTMapReferenceStyleO8backdropyA2CmF)`
    
    Neutral greyscale style with hillshading suitable for colorful terrain-aware visualization.
    
    #### Declaration
    
    Swift
    
    ```
    case backdrop
    ```
    
-   `[openStreetMap](#/s:11MapTilerSDK19MTMapReferenceStyleO010openStreetA0yA2CmF)`
    
    Reference style without any variants.
    
    #### Declaration
    
    Swift
    
    ```
    case openStreetMap
    ```
    
-   `[aquarelle](#/s:11MapTilerSDK19MTMapReferenceStyleO9aquarelleyA2CmF)`
    
    Watercolor map for creative use.
    
    #### Declaration
    
    Swift
    
    ```
    case aquarelle
    ```
    
-   `[landscape](#/s:11MapTilerSDK19MTMapReferenceStyleO9landscapeyA2CmF)`
    
    Light terrain map for data overlays.
    
    #### Declaration
    
    Swift
    
    ```
    case landscape
    ```
    
-   `[ocean](#/s:11MapTilerSDK19MTMapReferenceStyleO5oceanyA2CmF)`
    
    Detailed map of the ocean seafloor and bathymetry.
    
    #### Declaration
    
    Swift
    
    ```
    case ocean
    ```
    
-   `[custom(_:)](#/s:11MapTilerSDK19MTMapReferenceStyleO6customyAC10Foundation3URLVcACmF)`
    
    Custom style from the URL.
    
    Custom style does not have variants.
    
    #### Declaration
    
    Swift
    
    ```
    case custom(URL)
    ```
    

[](#/Codable)

### Codable

-   `[init(from:)](#/s:Se4fromxs7Decoder_p_tKcfc)`
    
    #### Declaration
    
    Swift
    
    ```
    public init(from decoder: Decoder) throws
    ```
    
-   `[encode(to:)](#/s:SE6encode2toys7Encoder_p_tKF)`
    
    #### Declaration
    
    Swift
    
    ```
    public func encode(to encoder: Encoder) throws
    ```
    
-   `[getVariants()](#/s:11MapTilerSDK19MTMapReferenceStyleO11getVariantsSayAA0dF7VariantOGSgyF)`
    
    Returns all child variants.
    
    #### Declaration
    
    Swift
    
    ```
    public func getVariants() -> [MTMapStyleVariant]?
    ```
    
-   `[isCustom()](#/s:11MapTilerSDK19MTMapReferenceStyleO8isCustomSbyF)`
    
    Returns boolean indicating whether style is custom or pre-made.
    
    #### Declaration
    
    Swift
    
    ```
    public func isCustom() -> Bool
    ```
    
-   `[getName()](#/s:11MapTilerSDK19MTMapReferenceStyleO7getNameSSyF)`
    
    Returns the reference style name.
    
    #### Declaration
    
    Swift
    
    ```
    public func getName() -> String
    ```
    
-   `[fetchStyleURL(variant:apiKey:)](#/s:11MapTilerSDK19MTMapReferenceStyleO05fetchF3URL7variant6apiKey10Foundation0H0VSgAA0dF7VariantOSg_SStF)`
    
    Resolves the concrete MapTiler Cloud style URL for this reference style and optional variant. Returns `nil` if the configuration is invalid or the custom URL is malformed.
    
    #### Declaration
    
    Swift
    
    ```
    public func fetchStyleURL(variant: MTMapStyleVariant? = nil, apiKey: String) -> URL?
    ```
    
-   `[all()](#/s:11MapTilerSDK19MTMapReferenceStyleO3allSayACGyFZ)`
    
    Returns all pre-made styles.
    
    #### Declaration
    
    Swift
    
    ```
    public static func all() -> [MTMapReferenceStyle]
    ```