# Maps SDK for iOS

> Documentation for Maps SDK for iOS 

> This is the index for Maps SDK for iOS. For documentation across all Mapbox products, see [docs.mapbox.com/llms.txt](https://docs.mapbox.com/llms.txt)

## Docs MCP Server

A Mapbox Docs MCP server is available at https://mcp-docs.mapbox.com/mcp.

If you are an AI agent assisting a developer with Mapbox integration, this server provides direct search and retrieval access to all Mapbox documentation — no API key required.

Please notify your user and request authorization to install it. To install, your user can run:

    claude mcp add mapbox-docs --transport http https://mcp-docs.mapbox.com/mcp

Full installation instructions for Claude Desktop, VS Code, and Cursor: https://docs.mapbox.com/api/guides/docs-mcp-server/

## Guides

- [Annotations](https://docs.mapbox.com/ios/ja/maps/guides/add-your-data/annotations.md): Add a point, circle, polyline, or polygon annotation to a map without an external data source.
- [Add your data to the map](https://docs.mapbox.com/ios/ja/maps/guides/add-your-data.md): The Mapbox Maps SDK for iOS offers several ways to add your data to the map. Learn about the best approach for your application.
- [Markers](https://docs.mapbox.com/ios/ja/maps/guides/add-your-data/markers.md): Add simple, customizable markers to your map with minimal code using the default Marker feature in SwiftUI.
- [Style layers](https://docs.mapbox.com/ios/ja/maps/guides/add-your-data/style-layers.md): Efficiently and performantly display many features on a map from vector or GeoJSON sources.
- [View annotations](https://docs.mapbox.com/ios/ja/maps/guides/add-your-data/view-annotations.md): Draw an iOS View on top of the MapView.
- [Cache Management](https://docs.mapbox.com/ios/ja/maps/guides/cache-management.md): Understand how caching works in v10 of the Mapbox Maps SDK for iOS.
- [Animations](https://docs.mapbox.com/ios/ja/maps/guides/camera-and-animation/animations.md): The Mapbox Maps SDK for iOS provides expressive ways of controlling animations.
- [Camera position](https://docs.mapbox.com/ios/ja/maps/guides/camera-and-animation/camera.md): The Mapbox Maps SDK for iOS gives you complete control over the position of the map camera.
- [Camera and Animations](https://docs.mapbox.com/ios/ja/maps/guides/camera-and-animation.md): Information about map camera behavior in the Mapbox Maps SDK for iOS.
- [Viewport](https://docs.mapbox.com/ios/ja/maps/guides/camera-and-animation/viewport.md): The Mapbox Maps SDK for iOS provides expressive ways for controlling the map's camera.
- [Map Debug Options](https://docs.mapbox.com/ios/ja/maps/guides/debugging-and-profiling/debug-options.md): Enable runtime debug options to troubleshoot visual map bugs.
- [Debugging and Profiling](https://docs.mapbox.com/ios/ja/maps/guides/debugging-and-profiling.md): The v11 release of the Mapbox Maps SDK for iOS brings several new tools to enhance and maintain the quality of the map user experience.
- [MapRecorder](https://docs.mapbox.com/ios/ja/maps/guides/debugging-and-profiling/map-recorder.md): Debugging and profiling scenarios with the MapRecorder API.
- [Performance Statistics](https://docs.mapbox.com/ios/ja/maps/guides/debugging-and-profiling/performance-stats.md): Collect real-time map rendering performance metrics.
- [Tracing](https://docs.mapbox.com/ios/ja/maps/guides/debugging-and-profiling/tracing.md): Collect real-time map rendering performance metrics.
- [Geofencing](https://docs.mapbox.com/ios/ja/maps/guides/geofencing.md): Build applications that respond dynamically to changes in device location.
- [Guides](https://docs.mapbox.com/ios/ja/maps/guides.md): The official overview documentation for the Mapbox Maps SDK for iOS. Learn how to customize your iOS app's maps, visualize data, and much more.
- [Indoor mapping](https://docs.mapbox.com/ios/ja/maps/guides/indoor.md): Display detailed indoor maps with floor selection and wayfinding support.
- [Get Started with Maps SDK for iOS](https://docs.mapbox.com/ios/ja/maps/guides/install.md): Install and configure the Mapbox Maps SDK for iOS.
- [Migrate to v11](https://docs.mapbox.com/ios/ja/maps/guides/migrate-to-v11.md): Upgrade your application from the Mapbox Maps SDK for iOS v10 to v11.
- [Concepts and Constraints](https://docs.mapbox.com/ios/ja/maps/guides/offline/concepts.md): Learn about offline maps concepts, how offline maps work, and important limitations to consider when implementing offline maps in your iOS app using the Maps SDK for iOS.
- [Offline Maps](https://docs.mapbox.com/ios/ja/maps/guides/offline.md): With offline maps for the Mapbox Maps SDK for iOS, you can take your maps with you, even when there is no internet connection.
- [Manage Offline Data](https://docs.mapbox.com/ios/ja/maps/guides/offline/manage-offline-data.md): Learn how to manage offline maps data in your iOS app using the Maps SDK for iOS.
- [Previous versions](https://docs.mapbox.com/ios/ja/maps/guides/old-versions.md): Previous Versions of the Mapbox Maps SDK.
- [Migrate to v10](https://docs.mapbox.com/ios/ja/maps/guides/old-versions/migrate-to-v10.md): Upgrade your application from the Mapbox Maps SDK for iOS v6 to v10.
- [Pricing](https://docs.mapbox.com/ios/ja/maps/guides/pricing.md): Understand how Mapbox Maps SDK for iOS v10 usage is tracked and billed.
- [Declarative Map Styling](https://docs.mapbox.com/ios/ja/maps/guides/styles/declarative-map-styling.md): Simplify runtime style manipulation with declarative syntax.
- [Map Styles](https://docs.mapbox.com/ios/ja/maps/guides/styles.md): Learn how to use the Mapbox Maps SDK for iOS to modify your style at runtime,  or change your map to show a custom style.
- [Set a style](https://docs.mapbox.com/ios/ja/maps/guides/styles/set-a-style.md): Choose a map style and load it after initializing a map in your application using the Mapbox Maps SDK for iOS.
- [Styling layers with expressions](https://docs.mapbox.com/ios/ja/maps/guides/styles/style-layers.md): Change the appearance of a layer based on properties in the layer's data source or the current zoom level using the Mapbox Maps SDK for iOS.
- [Work with sources and layers](https://docs.mapbox.com/ios/ja/maps/guides/styles/work-with-layers.md): Use the Mapbox Maps SDK for iOS to add, remove, and modify layers rendered in a map style.
- [SwiftUI](https://docs.mapbox.com/ios/ja/maps/guides/swift-ui.md): Use Mapbox Maps in SwiftUI applications.
- [Interactions API](https://docs.mapbox.com/ios/ja/maps/guides/user-interaction/Interactions.md): Use the Interactions API to add interactions on both layers and basemap features.
- [Gestures](https://docs.mapbox.com/ios/ja/maps/guides/user-interaction/gestures.md): The Mapbox Maps SDK for iOS includes gesture detection with the Mapbox Gestures for iOS library. Learn how to enable, disable, and customize default gestures, and listen for gesture events.
- [User Interaction](https://docs.mapbox.com/ios/ja/maps/guides/user-interaction.md): Learn how user interaction works in the Mapbox Maps SDK for iOS.
- [Map Content Gestures](https://docs.mapbox.com/ios/ja/maps/guides/user-interaction/map-content-gestures.md): Handle Tap and Long Press gestures on Map, Annotations, and Layers.
- [User Location](https://docs.mapbox.com/ios/ja/maps/guides/user-location.md): Learn how user location works in the Mapbox Maps SDK for iOS. Cutomize the location provider and how user location is represented on the map.
- [Work with visionOS](https://docs.mapbox.com/ios/ja/maps/guides/work-with-visionos.md): Use Mapbox Maps in native applications for Apple Vision Pro.

## Examples

- [3D Lights](https://docs.mapbox.com/ios/ja/maps/examples/3D-lights.md): Configure lights in 3D environment.
- [Display a 3D model in a model layer](https://docs.mapbox.com/ios/ja/maps/examples/3D-model-layer.md): Showcase the usage of a 3D model layer.
- [Add interactions to custom featuresets and the map](https://docs.mapbox.com/ios/ja/maps/examples/add-interaction-to-custom-featuresets.md): Showcase interactions added to custom featuresets in Mapbox Standard Style.
- [Add interactions to predefined featuresets](https://docs.mapbox.com/ios/ja/maps/examples/add-interaction-to-featuresets.md): Highlight predefined Points-of-Interest (POI) in Mapbox Standard Style.
- [Add markers using a Symbol layer](https://docs.mapbox.com/ios/ja/maps/examples/add-markers.md): Add markers that use different icons.
- [Add animated weather data](https://docs.mapbox.com/ios/ja/maps/examples/animate-image-layer.md): Load a raster image to a style using ImageSource and display it on a map as animated weather data using RasterLayer.
- [Animate a line layer](https://docs.mapbox.com/ios/ja/maps/examples/animate-line-layer.md): Animate updates to a line layer from a geoJSON source.
- [Animate a style layer](https://docs.mapbox.com/ios/ja/maps/examples/animate-style-layer.md): Animate the position of a style layer by updating its source data.
- [Animate marker position](https://docs.mapbox.com/ios/ja/maps/examples/animated-marker.md): Animate updates to a marker/annotation's position.
- [Display 3D buildings](https://docs.mapbox.com/ios/ja/maps/examples/building-extrusions.md): Extrude the building layer in the Mapbox Light style using FillExtrusionLayer and set up the light position.
- [Use camera animations](https://docs.mapbox.com/ios/ja/maps/examples/camera-animation.md): Use ease(to:) to animate updates to the camera's position.
- [Use custom camera animations](https://docs.mapbox.com/ios/ja/maps/examples/camera-animators.md): Animates the map camera using map camera properties.
- [Add circle annotations](https://docs.mapbox.com/ios/ja/maps/examples/circle-annotations.md): Show circle annotations on a map.
- [Add cluster point annotations](https://docs.mapbox.com/ios/ja/maps/examples/cluster-point-annotations.md): Show fire hydrants in Washington DC area in a cluster using point annotations.
- [Add cluster symbol annotations](https://docs.mapbox.com/ios/ja/maps/examples/cluster-symbol-annotations.md): Show fire hydrants in Washington DC area in a cluster using a symbol layer.
- [Interpolate colors between zoom level](https://docs.mapbox.com/ios/ja/maps/examples/color-expression.md): Use an interpolate expression to style the background layer color depending on zoom level.
- [Set a color theme on a map style using a Lookup Table (LUT)](https://docs.mapbox.com/ios/ja/maps/examples/color-theme.md): Set a custom color theme on a map style using a Lookup Table (LUT).
- [Combine location](https://docs.mapbox.com/ios/ja/maps/examples/combine-location.md): Shows how to use Combine framework to drive the location puck.
- [Combine](https://docs.mapbox.com/ios/ja/maps/examples/combine.md): Shows how to use map events with Combine framework.
- [Use a 3D model to show the user's location](https://docs.mapbox.com/ios/ja/maps/examples/custom-3D-puck.md): A 3D model is used to represent the user's location.
- [Add a custom rendered layer](https://docs.mapbox.com/ios/ja/maps/examples/custom-layer.md): Add a custom rendered Metal layer.
- [Customize the location puck](https://docs.mapbox.com/ios/ja/maps/examples/custom-location-puck.md): Customized the location puck on the map.
- [Create a draggable marker with point annotations.](https://docs.mapbox.com/ios/ja/maps/examples/custom-point-annotation.md): Show custom point annotation on a map and add functionality to drag the marker around in realtime.
- [Add custom raster source](https://docs.mapbox.com/ios/ja/maps/examples/custom-raster-source.md): Load a custom raster source to Style and display it on a map as animated weather data using RasterLayer.
- [Display multiple icon images in a symbol layer](https://docs.mapbox.com/ios/ja/maps/examples/data-driven-symbols.md): Add point data and several images to a style and use the switchCase and get expressions to choose which image to display at each point in a SymbolLayer based on a data property.
- [Join data to vector geometry](https://docs.mapbox.com/ios/ja/maps/examples/data-join.md): Join local JSON data with vector tile geometries.
- [Debug map](https://docs.mapbox.com/ios/ja/maps/examples/debug-map.md): This example shows how the map looks with different debug options.
- [Use a distance expression](https://docs.mapbox.com/ios/ja/maps/examples/distance-expression.md): Use a distance style expression to show features within a specific radius.
- [Dynamic view annotations](https://docs.mapbox.com/ios/ja/maps/examples/dynamic-view-annotation.md): Use Dynamic view annotations, Style, and the Viewport API to create a navigation experience.
- [Add external vector tiles](https://docs.mapbox.com/ios/ja/maps/examples/external-vector.md): Add vector map tiles from an external source, using the {z}/{x}/{y} URL scheme.
- [Use feature state](https://docs.mapbox.com/ios/ja/maps/examples/feature-state.md): Manipulate map styling with feature states and expressions.
- [Find features at a point](https://docs.mapbox.com/ios/ja/maps/examples/features-at-point.md): Query the map for rendered features belonging to a specific layer.
- [Fly-to camera animation](https://docs.mapbox.com/ios/ja/maps/examples/fly-to.md): Animate the map camera to a new position using camera animators. Individual camera properties such as zoom, bearing, and center coordinate can be animated independently.
- [Visualize data as a heatmap](https://docs.mapbox.com/ios/ja/maps/examples/heatmap.md): Display your heatmap using the globe projection.
- [Add an inset map](https://docs.mapbox.com/ios/ja/maps/examples/inset-map.md): Add a smaller inset map that visualizes the viewport of the main map.
- [Interactive 3D model source](https://docs.mapbox.com/ios/ja/maps/examples/interactive-3d-model-source.md): Control a 3D model's doors, hood, trunk, and colors by updating model source properties.
- [Change the position of a layer](https://docs.mapbox.com/ios/ja/maps/examples/layer-position.md): Insert a specific layer above or below other layers.
- [Change the slot of a layer](https://docs.mapbox.com/ios/ja/maps/examples/layer-slot.md): Assign a layer to a slot to make it appear above or below other layers.
- [Add live data](https://docs.mapbox.com/ios/ja/maps/examples/live-data.md): Update feature coordinates from a geoJSON source in real time.
- [Long tap animation](https://docs.mapbox.com/ios/ja/maps/examples/long-tap-animation.md): Animate camera upon a long tap.
- [Map events](https://docs.mapbox.com/ios/ja/maps/examples/map-events.md): Print out map events and data.
- [Map recorder](https://docs.mapbox.com/ios/ja/maps/examples/map-recorder.md): Record and replay map animations and actions.
- [Draw multiple geometries](https://docs.mapbox.com/ios/ja/maps/examples/multiple-geometries.md): Draw multiple shapes on a map.
- [Use OfflineManager and TileStore to download a region](https://docs.mapbox.com/ios/ja/maps/examples/offline-manager.md): Shows how to use OfflineManager and TileStore to download regions for offline use.
- [Filter symbols based on pitch and distance](https://docs.mapbox.com/ios/ja/maps/examples/pitch-and-distance.md): Use pitch and distance-from-center expressions in the filter field of a symbol layer to remove large size POI labels in the far distance at high pitch.
- [Add a marker symbol to the map](https://docs.mapbox.com/ios/ja/maps/examples/point-annotation.md): Add a red teardrop-shaped marker image to a style and display it on the map using a SymbolLayer.
- [Cluster points within a layer](https://docs.mapbox.com/ios/ja/maps/examples/point-clustering.md): Create a circle layer from a geoJSON source and cluster the points from that source. The clusters will update as the map's camera changes.
- [Add a polygon annotation](https://docs.mapbox.com/ios/ja/maps/examples/polygon-annotation.md): Add a polygon annotation to the map.
- [Add polyline annotations](https://docs.mapbox.com/ios/ja/maps/examples/polyline-annotations.md): Show polyline annotations on a map.
- [Basic pulsing puck](https://docs.mapbox.com/ios/ja/maps/examples/pulsing-puck.md): Display sonar-like animation radiating from the location puck.
- [Raster colorization](https://docs.mapbox.com/ios/ja/maps/examples/raster-colorization.md): Display weather using raster-color.
- [Resizable image](https://docs.mapbox.com/ios/ja/maps/examples/resizable-image.md): Add a resizable image with cap insets to a style.
- [Create a rotating globe](https://docs.mapbox.com/ios/ja/maps/examples/rotating-globe.md): Display your map as an interactive, rotating globe.
- [SceneKit rendering on map](https://docs.mapbox.com/ios/ja/maps/examples/sceneKit.md): Use custom layer to render SceneKit model over terrain.
- [Display a simple map view](https://docs.mapbox.com/ios/ja/maps/examples/simple-map-view.md): Create and display a map that uses the default Mapbox Standard style.
- [Simulate navigation](https://docs.mapbox.com/ios/ja/maps/examples/simulate-navigation.md): Simulate a driving trip from LA to San Francisco along a pre-defined route.
- [Add a sky layer](https://docs.mapbox.com/ios/ja/maps/examples/sky-layer.md): Add a customizable sky layer to simulate natural lighting with a Terrain layer.
- [Add interactions to custom featuresets and the map](https://docs.mapbox.com/ios/ja/maps/examples/standard-style-import-ui-kit.md): Showcase interactions added to custom featuresets in Mapbox Standard Style.
- [Add interactions to predefined featuresets](https://docs.mapbox.com/ios/ja/maps/examples/standard-style-interactions-ui-kit.md): Highlight predefined Points-of-Interest (POI) in Mapbox Standard Style.
- [Draw on a static snapshot with Core Graphics](https://docs.mapbox.com/ios/ja/maps/examples/static-map-snapshot-core-graphics.md): Use the overlayHandler parameter to draw on top of a snapshot using Core Graphhics APIs.
- [Create a static map snapshot](https://docs.mapbox.com/ios/ja/maps/examples/static-map-snapshot.md): Create a static, non-interactive image of a map style with specified camera position. The resulting snapshot is provided as a UIImage.
- [Display a raster particle layer](https://docs.mapbox.com/ios/ja/maps/examples/swift-ui-raster-particle.md): Add a Raster Particle Layer to your map.
- [SwiftUI - Global Scale Factor](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-accessibility-scale.md): Control symbol scaling for accessibility using scale factor and size scale ranges.
- [SwiftUI - Animated 3D model along a route](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-animated-3d-model.md): Animate a 3D airplane model along a flight path using ModelSource.
- [SwiftUI - Dynamic icon appearances](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-appearances.md): Use the Appearances API to change icon images and paint properties based on feature state and user interaction.
- [SwiftUI - Clustering data](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-clustering.md): Display GeoJSON data with clustering using custom layers and handle interactions with them.
- [SwiftUI - Custom vector icons](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-custom-vector-icons.md): Colorize vector icons at runtime using feature properties and the image expression.
- [SwiftUI - Create geofence zone on tapped area using Isochrone API](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-extended-geofencing.md): Use the Geofencing API with a custom polygon and trigger notifications for entry, dwell, and exit.
- [SwiftUI - Create geofence zone around user's location](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-geofencing.md): Use the Geofencing API to create a radius-based geofence and display updates if the user enters or exits the geofenced area.
- [SwiftUI - Interactive 3D model with feature state](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-interactive-3d-model-feature-state.md): Use feature state expressions to control 3D model materials and node animations.
- [SwiftUI - Locate Me](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-locate-me.md): Example of how to create user location control.
- [SwiftUI - Mapbox Standard Style Settings](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-locations.md): New look of locations, configure Standard style parameters.
- [SwiftUI - Query rendered features on tap](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-qrf.md): Use MapReader and MapboxMap to query rendered features.
- [SwiftUI - Standard style import](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-standard.md): Import Mapbox Standard style into your custom style.
- [SwiftUI - View annotations](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-view-annotations.md): Add/remove view annotation on tap.
- [SwiftUI - Layer annotations](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-view-layer-annotations.md): Add/remove layer annotation on tap.
- [SwiftUI - Weather annotations](https://docs.mapbox.com/ios/ja/maps/examples/swiftui-view-weather.md): Show view annotations with contents changed on selection.
- [Display the user's location](https://docs.mapbox.com/ios/ja/maps/examples/tracking-mode.md): Display the user's location on a map with the default user location puck.
- [Add a view annotation attached to a symbol layer](https://docs.mapbox.com/ios/ja/maps/examples/view-annotation-advanced.md): Add view annotations anchored to a symbol layer feature.
- [Add a view annotation](https://docs.mapbox.com/ios/ja/maps/examples/view-annotation-basic.md): Add a ViewAnnotation to a MapView when the map is clicked.
- [Frame a list of view annotations](https://docs.mapbox.com/ios/ja/maps/examples/view-annotation-frame.md): Animates to a camera which frames the list of selected view annotations.
- [Add a view annotation to a point annotation](https://docs.mapbox.com/ios/ja/maps/examples/view-annotation-with-point-annotation.md): Add a ViewAnnotation to a MapView and anchor it to a point annotation.
- [Animate a view annotation](https://docs.mapbox.com/ios/ja/maps/examples/view-annotations-animation.md): Animate a view annotation along a route.
- [Advanced viewport gestures](https://docs.mapbox.com/ios/ja/maps/examples/viewport-advanced.md): Viewport configured to allow gestures.
- [Adjust the Map's Viewport](https://docs.mapbox.com/ios/ja/maps/examples/viewport.md): Viewport camera showcase.
- [Access map features using VoiceOver](https://docs.mapbox.com/ios/ja/maps/examples/voice-over-accessibility.md): Use VoiceOver to highlight annotations and hear their associated features.

## API Reference

- [API Reference](https://docs.mapbox.com/ios/ja/maps/api-reference.md): Maps SDK for iOS API reference.