Navigate Route¶
In this guide you will learn how to render an interactive map centered on your current position. The map is fully 3D, supporting pan, pinch-zoom, rotate and tilt.
Setup¶
First, get an API key token, see the Getting Started guide.
See the Setup Maps SDK for iOS guide.
Download the NavigateRoute project
example or clone the project with Git.
Extract/unpack the NavigateRoute project archive to a folder/directory of your choice. You can create a new directory where to unpack it.
Open the Project¶
![Xcode welcome dialog](../_images/example_ios_xcode_welcome_dialog.png)
Start Xcode, and in the welcome dialog, choose
Open an existing project
.
![Xcode File Open](../_images/example_ios_xcode_file_open_menu.png)
If Xcode is already started, go to the File menu and choose Open.
![Xcode open NavigateRoute](../_images/example_ios_xcode_open_ex_navigateroute.png)
Select the NavigateRoute.xcodeproj file and click Open.
Verify that Maps SDK for iOS is configured in Xcode, see the Setup Maps SDK for iOS guide.
Set the API key token¶
![Set your API key](../_images/example_ios_xcode_set_your_api_key.png)
In any of the Maps SDK for iOS example projects,
click the AppDelegate.swift
file and
scroll down to the getProjectApiToken()
function,
and replace YOUR_TOKEN
with your actual
Magic Lane API Key token, see the
Getting Started guide.
The project is now ready to build and run!
Run the example¶
![Xcode select virtual device](../_images/example_ios_xcode_choose_iphone8_navigateroute.png)
Either connect a device via USB cable, or select a virtual device.
Run the NavigateRoute example. You will be asked to give the app permission to access your location.
![Xcode run NavigateRoute](../_images/example_ios_xcode_run_ex_navigateroute1.png)
If you are not running this example on a device outside for a real
navigation along a route, you can set a simulated departure location.
In the Xcode menu, select Features->Location->Custom Location...
![Xcode run NavigateRoute](../_images/example_ios_xcode_run_ex_navigateroute2.png)
Enter a latitude and a longitude coordinate for the simulated location of the virtual device.
![Xcode run NavigateRoute](../_images/example_ios_xcode_run_ex_navigateroute3.png)
Click the blue route icon in the upper right corner to compute the route and render it on the map.
Click the blue triangle play button to start real navigation along the route.