Skip to content

Environment Setup - CPP Examples

In this guide you will learn how to setup your environment to run the CPP examples.

Create your account

First, create your Magic Lane account and get your API key token, see the Getting Started guide.

Working directory

Create the path


which will contain the SDK and all your Magic Lane projects.
You can give this path a different name, but to avoid problems, the name should not contain spaces; in this documentation, this path will be referred to as C:\MAGICLANE

Download examples

DOWNLOAD the cpp examples ZIP file and save it in C:\MAGICLANE

Maps SDK for C++ Examples

after downloading the examples, you will have a file like this:


Download the SDK

DOWNLOAD the win-x64 SDK and save it in C:\MAGICLANE

Maps SDK for C++

after downloading the SDK archive file, you will have a file like this:


Install 7zip

DOWNLOAD AND INSTALL 7zip in the default directory, such as:

"C:\Program Files\7-Zip"


Add 7zip to the Path

ADD the path where the 7z.exe binary executable is located to the system PATH:

Environment variables - example CPP screenshot

Go to the system Environment variables (click the start button and type env), and select the PATH variable. Click Edit, click New and add the 7z.exe binary path to the PATH environment variable, by pasting for example:

C:\Program Files\7-Zip

then click OK, OK, OK

Verify 7zip install

Start a new COMMAND PROMPT, and now typing


and pressing enter should display the 7-zip options, to verify that 7zip was correctly installed and configured; this will only work in a command prompt started after the PATH environment variable was updated in the above step;

Command prompt in working directory

GO to the C:MAGICLANE directory:

Command prompt - example CPP screenshot


Extract the examples archive

EXTRACT the CPP examples archive downloaded above using 7z.exe like this:

7z  x

a directory containing the examples and Visual Studio project files will be created:


Extract the SDK

EXTRACT the SDK archive downloaded above using 7z.exe like this: (replace the MAGICLANE*.tar.bz2 filename shown with the actual name of your MAGICLANE*.tar.bz2 file)


a tar archive file is extracted; now extract the tar archive like this:


a directory containing the SDK headers and lib files is created:


Rename the SDK directory

RENAME this directory to SDK: (replace the MAGICLANE-MAPS-SDK* directory name shown above with the actual name of the MAGICLANE-MAPS-SDK* directory that was extracted in the previous step)


Copy the SDK directory

COPY the contents of this SDK directory to the SDK directory within the CPP examples directory:

xcopy  /e  SDK  maps-sdk-examples-for-cpp-master\SDK

You can use the file explorer GUI instead of the above command to copy the SDK, if you prefer.



This is where the SDK must be located for the examples to be able to find it without making any changes.

Open an example in Visual Studio

START Visual Studio, OPEN an example

vstudio Open - example CPP screenshot

In the welcome dialog, click Open a project or solution or, if Visual Studio is already started, close the current project, if any, and then select from the menu


browse to:


click to open:


then click Open

Build and run


vstudio Project - example CPP screenshot

Make sure that Debug and x64 are selected at the top, then click the green arrow next to Local Windows Debugger

This will build and run your first Magic Lane CPP example.

vstudio run example - example CPP screenshot

Run any other example

To run any other example,

vstudio run another example - example CPP screenshot

right-click on any other example, such as CenterMap and select Set as Startup Project
then click the green arrow next to Local Windows Debugger

vstudio run example - example CPP screenshot

This will build and run the currently selected Magic Lane CPP example, CenterMap in this case.