MapTiler SDK Swift API Reference

Object representing the SDK global settings.

Exposes properties and options such as API Key and caching preferences.

Subclassable view for adding custom annotations to the map.

Annotation element that can be added to the map.

Basic text popup.

Can be attached to MTMarker or standalone.

Basic benchmarking class.

Object representing the map on the screen.

Exposes methods and properties that enable changes to the map, and fires events that can be interacted with.

Helper for creating a heatmap visualization layer from data and styling options.

Helper for creating a point visualization layer from data and styling options.

Uses the current style to create the underlying source and layers.

Helper for creating a polygon (fill) visualization layer from data and styling options.

Helper for creating a polyline (line) visualization layer from data and styling options.

Logger class used for SDK logs.

Class responsible for location updates.

Service responsible for gesture handling and state.

Sets combination of center, bearing and pitch, as well as roll and elevation.

The proxy object for the current map style.

Set of convenience methods for style, sources and layers manipulation. MTStyle is nil until map loading is complete. Since it is loaded asynchronously it should be manipulated only after MTEvent.didLoad triggers.

The background style layer covers the entire map. Use a background style layer to configure a color or pattern to show below all other map content. If the background layer is transparent or omitted from the style, any part of the map view that does not show another style layer is transparent.

The circle style layer renders one or more filled circles on the map.

The fill style layer that renders one or more filled (and optionally stroked) polygons on a map.

A fill-extrusion style layer renders one or more filled (and optionally stroked) extruded (3D) polygons on a map.

A heatmap style layer renders a range of colors to represent the density of points in an area.

A hillshade style layer renders digital elevation model (DEM) data on the client-side. Supports Terrain RGB and Mapzen Terrarium tiles via a raster-dem source.

The line style layer that renders one or more stroked polylines on the map.

The raster style layer renders raster map textures such as imagery.

The symbol style that layer renders icon and text labels at points or along lines on a map.

A geojson source.

An image source.

The url value contains the image location. The coordinates array contains [longitude, latitude] pairs for the image corners listed in clockwise order: top left, top right, bottom right, bottom left.

A raster DEM source. Only supports Terrain RGB.

A raster tile source.

For raster tiles hosted by MapTiler, the “url” value should be of the form https://api.maptiler.com/tiles/[tilesetid]/tiles.json?key=

Undocumented

A video source.

The urls value is an array. For each URL in the array, a video element source will be created. The coordinates array contains [longitude, latitude] pairs for the video corners listed in clockwise order: top left, top right, bottom right, bottom left.

Swift wrapper over the MapTiler SDK ColorRamp class.

Anchor positions for marker placement.

Alignment for marker rotation relative to map or viewport.

Alignment for marker pitch relative to map or viewport.

Represents all the errors that can occur in the MapTiler SDK.

All methods within the SDK throw MTError.

SDK log level.

Type of log messages in the SDK.

Events triggered by the SDK

Language of the map labels.

Custom language options.

Languages available for MTMapView object.

Enum representing MTLocationManager errors.

Units of measurement used in MTMapView object.

Gesture types available in the SDK.

Controls which map events are forwarded from the map object.

• essential: Low-frequency lifecycle events only (ready, load, moveend, etc.) plus taps.
• cameraOnly: Forwards only camera events (move, zoom) in addition to minimal lifecycle.
• all: Default. Forwards all events including high-frequency move/zoom/touch/render (use with caution on low-end devices).
• off: Minimal wiring to keep internal lifecycle (ready/load) functioning; all other events are suppressed.

Performance-oriented presets for MapTiler Swift SDK.

Padding values accepted by MTFitBoundsOptions.

Helper to construct common style expressions without raw strings.

Commonly-used feature keys

Helper to construct common filter expressions without raw strings.

Typed keys for circle paint properties.

Typed keys for symbol layout properties.

Typed keys for symbol paint properties.

Orientation of the circle when map is pitched.

Controls the scaling behavior of the circle when the map is pitched.

Controls the frame of reference for circle translate.

Enum controlling the frame of reference for fill translate.

Controls the frame of reference for fill-extrusion translate.

Direction of light source when map is rotated.

The display of line endings.

The display of lines when joining.

Controls the frame of reference for line translate.

Types of layers.

Enum representing the visibility of the layer.

Resampling/interpolation method to use for overscaling.

Defines purpose and guidelines on what information is displayed.

Variants of the reference styles.

A typed value container

Represents the exceptions raised by the MTStyle object.

A unified style value that may be a constant or an expression.

A scheme used for tiles.

Encoding used by the Raster DEM source.

Types of sources.

Sources state which data the map should display.

Symbol text anchor positions.

Common text field tokens

Representing the control of the change rate of the animation.

Option that can enable default halo or configure it.

Sets whether extruded geometries are lit relative to the map or viewport.

Represents corners of the map.

Type of projection the map uses.

Predefined cubemap presets for space backgrounds.

Option that can enable default space or configure it.

Resampling methods supported by MapTiler SDK.

Built-in presets shipped with the SDK.

Either a numeric value or zoom-ramped numeric values.

Either a string value or zoom-ramped string values.

Either a numeric value or property-mapped numeric values.

Heatmap radius can be a number, zoom-ramped numbers, or property-mapped numbers.

Represents a dash pattern that can be provided as an array of numbers or as a string pattern composed of underscores and spaces (e.g. “___ _ ”).

Expression element used to build MapTiler style expressions for sky values.

Represents a color or expression for the sky configuration.

Represents a numeric value or expression for the sky configuration.

Protocol requirements for all annotation objects.

Base protocol adopted by vector layer helpers to share defaults and common option normalization logic.

Protocol requirement for all Logger objects.

Protocol requirements for location manager.

Defines methods for adding the map controls.

Defines methods for navigating the map.

Defines methods for adjusting rendering parameters.

Defines methods for map styling methods.

Defines methods for manipulating zoom level.

Defines gestures behaviour.

Map view content requirements.

Delegate responsible for map event propagation

Protocol requirements for all types of Layers.

Protocol requirements for all types of Sources.

Protocol requirements for all tile type sources.

Represents body of the MTError exception.

Color wrapper.

Options for building a heatmap visualization layer through the helper.

Options for building a point visualization layer through the helper.

Mirrors the available configuration including common shape options.

Options for building a polygon (fill) visualization layer through the helper.

Options for building a polyline (line) visualization layer through the helper.

Log object used with MTLogger.

Handles zooming in the map with double tap.

Handles panning the map by dragging.

Handles zoom and rotate by pinching with two fingers.

Handles changing the pitch by dragging with two fingers.

Map view content builder.

Parameters of the map object.

Declarative Map view for use in SwiftUI

Provides animation options for navigation functions.

Options for controlling the desired location, zoom, bearing, and pitch of the camera.

Options for drag and pan gesstures.

Options that configure how the map fits to a set of bounds.

Options describing the destination and animation of the flyTo transition.

Options for setting padding on calls to map methods.

Supporting type to add validation to another style related type.

Configuration that controls how an image is registered within the MapTiler style.

Represents rectangular geographic bounds defined by southwest and northeast corners.

Object sent together with MTEvent.

One stop in the halo radial gradient: position in [0,1] and color.

Configuration for the atmospheric glow (halo).

A style’s light property provides a global light source for that style.

Two numbers representing x and y screen coordinates in pixels.

The style spec representation of the source if the event has a dataType of source .

Faces definition for a custom cubemap.

Path-based configuration for cubemap files.

This fetches all images from a path, this assumes all files are named px, nx, py, ny, pz, nz and suffixed with the appropriate extension specified in format.

Configuration for the “space” background.

RGBA color represented by 0…255 components.

A stop describing the value and color to apply.

Bounds of a color ramp.

Options used when instantiating a color ramp.

Options for rendering the ramp to a canvas strip.

Array-based stop definition for fromArrayDefinition.

A single string value at a given zoom level.

A single numeric value at a given zoom level.

A single mapping from a property value to an associated numeric value.

Encodes a color to a hex string when converted to JSON. Accepts either a hex color string (e.g. “#RRGGBB”) or a UIColor.

Sky configuration used by map.setSky.