Skip to content

GPX Route

In this guide you will learn how to play back, that is, a simulated navigation, of a previously recorded GPX route.


First, get an API key token, see the Getting Started guide.

See the Setup Maps SDK for iOS guide.

Download the GpxRoute project example or clone the project with Git.

Extract/unpack the GpxRoute 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

Start Xcode, and in the welcome dialog, choose Open an existing project.

Xcode File Open

If Xcode is already started, go to the File menu and choose Open.

Xcode open RouteInstructions

Select the GpxRoute.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

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

Either connect a device via USB cable, or select a virtual device.

Xcode run GPX Route

Run the GpxRoute example.

Xcode run GPX Route

Click the blue route icon in the upper right corner to compute the route and render it on the map.

Xcode run GPX Route

Click the blue triangle play icon in the top panel to start playback/simulated navigation of the previously recorded GPX route.

Xcode run GPX Route

Pressing the square stop button with an X inside ends the simulated navigation/playback of the GPX datafile.

iOS Examples

Maps SDK for iOS Examples can be downloaded or cloned with Git