> For the complete documentation index, see [llms.txt](https://docs.mapbox.com/ios/ja/navigation/v2/llms.txt)

# Navigation SDK for iOS

現在のバージョン：`v2.21.0`  
  
[変更履歴を表示](https://github.com/mapbox/mapbox-navigation-ios/blob/main/CHANGELOG.md)

-   Navigation UI components ready to integrate into your application
    
-   Professionally designed map styles
    
-   Worldwide driving, cycling, and walking directions
    
-   Traffic avoidance and proactive rerouting
    

[Githubで貢献](https://github.com/mapbox/mapbox-navigation-ios)

![](https://docs.mapbox.com/ios/ja/assets/ideal-img/navigation-overview-header-image.883b7a0.480.png)

> **Note (legacy): A newer version of the Navigation SDK is available**
> 
> This page uses 2.21.0 of the Mapbox Navigation SDK. A newer version of the SDK is available. Learn about the latest version, 3.29.0, in the [Navigation SDK documentation](https://docs.mapbox.com/ios/ja/navigation/guides/).

The Navigation SDK for iOS allows you to build a complete navigation experience with the power of the [Mapbox Directions API](https://docs.mapbox.com/api/navigation/directions/). You can build a complete turn-by-turn navigation UI inside your application using our pre-built components or use the core logic directly to build something truly custom.

The Navigation SDK provides a collection of features that are critical when building navigation projects, including:

-   Navigation routes
-   Accurate device location updates
-   Voice instruction announcements
-   Real-time user progress to their destination
-   Off-route detection and rerouting
-   Dynamic camera adjustments during turn-by-turn navigation
-   Pre-built UI components to show changing navigation information
-   Support for navigating with limited or no network connection

## Types of navigation

The Navigation SDK offers two types of navigation: turn-by-turn navigation and free-drive navigation.

### Turn-by-turn navigation

Turn-by-turn navigation, also referred to as *active guidance*, is likely what comes to mind when you think about a typical navigation application: a user receives turn-by-turn instructions as they progress along the route. Read more in the [Turn-by-turn navigation](https://docs.mapbox.com/ios/ja/navigation/v2/guides/turn-by-turn-navigation/) guides.

### Free-drive navigation

Free-drive navigation, also referred to as *passive navigation*, is a unique Mapbox Navigation SDK feature that allows drivers to take advantage of some navigation features without selecting a route and following turn-by-turn instructions to a set destination. Read more in the [Free-drive navigation](https://docs.mapbox.com/ios/ja/navigation/v2/guides/free-drive/) guide.

## Requirements

The Mapbox Navigation SDK is compatible with applications that are:

-   Built in Xcode 13.3.1 or higher
-   Written in Swift 5.6 or higher
-   Run on iOS 12 or higher

## Use with other Mapbox tools

The Mapbox Navigation SDK for iOS is designed to be used with several other Mapbox products.

### Directions API

The Navigation SDK uses the Mapbox Directions API to generate routes between two or more coordinates. The Mapbox Directions for Swift framework has many route options like setting a profile identifier (for example driving, driving with traffic, or walking), waypoint heading (to influence the direction in which a route will begin), and `roadClassesToAvoid` (for example, avoiding tolls). Read more about Mapbox [Directions for Swift in the API documentation](https://docs.mapbox.com/ios/directions/api/2.14.4/).

### Maps SDK for iOS

By default, the Navigation SDK comes with access to the Mapbox Maps SDK for iOS. The Navigation SDK uses the Maps SDK to display routes on a map and show the user's location on the map throughout their trip to provide both navigation-related context and nearby places that may be of interest to the driver. The Navigation SDK uses Mapbox Maps SDK v10, you can find documentation for your version in the [Maps SDK API references listing](https://docs.mapbox.com/ios/ja/maps/api-reference/).

## Conditions

### Attribution

If you use a Mapbox map in your application, you are required to provide attribution according to the [Mapbox Maps SDK documentation](https://docs.mapbox.com/ios/ja/maps/guides/#attribution).

### Terms

The Mapbox Navigation SDK is distributed under [Mapbox's Terms of Service](https://www.mapbox.com/legal/tos).

### Pricing

Read more about pricing for the Navigation SDK in the [pricing guide](https://docs.mapbox.com/ios/ja/navigation/v2/guides/pricing/).

## Older versions of the SDK

Looking for an older version of the Navigation SDK? See the [Navigation SDK v1 documentation](https://docs.mapbox.com/ios/ja/legacy/navigation/guides/).