Get started

There are a number of ways to get started to develop with the ArcGIS Maps SDK for Qt. If you are new, follow the steps below to get started with Qt and Qt Creator.

1. Sign up for an account

To use the ArcGIS Maps SDK for Qt to access content, services, or an organization, you need an ArcGIS Developer account, ArcGIS Online account, or ArcGIS Enterprise account. The type of account, user type, and role you need depends on the resource you need to access and the operations you wish to undertake.

If you do not have an account, select one of the options below:

Get started for free with ArcGIS Platform

Get a free trial for ArcGIS Online

2. Get the SDK and dependencies

The ArcGIS Maps SDK for Qt has APIs for developing desktop apps for Windows, Linux, and macOS. Mobile apps can be developed for iOS and Android. You can install this SDK on Windows, macOS, and Linux. For a full discussion for the various development configurations, see the Install and set up topic.

The following describes the abbreviated steps to develop Windows desktop apps (this is the most common option for developers new to the ArcGIS Maps SDK for Qt), you need to:

1. Ensure that your Windows development environment meets the system requirements (ex: Windows 11 (64-bit) version 21H2 or Windows 10 (64-bit) version 21H2).

2. Install a supported Microsoft Visual Studio C++ compiler (ex: MSVC2019 v142 C++ x64/x86 build tools) that is provided as part of a Visual Studio Build Tools 2019 installer.

3. Run the Qt installer available from the Qt Group and install the latest Qt Framework (ex: version 6.5.x) and the Qt Creator IDE (ex: version 10.x)

4. Install the latest version of the ArcGIS Maps SDK for Qt (ex: version 200.x) from the downloads page.

5. Optionally clone the ArcGIS Maps SDK for Qt Toolkit GitHub repo. The toolkit contains user interface (UI) controls and components that you can to use out-of-the-box or customize them to suit your needs.

3. Get an access token

To access secure ArcGIS services and resources, you need to use an access token. The easiest way to get started is to create an API key. Learn more about access tokens and authentication in Security and authentication.

Get an API key

Implement OAuth 2.0

4. Create your first mapping application

Follow the step-by-step instructions in the Display a map tutorial to create your first mapping application. The following code shows how you can create and display a map.

Highlights from that tutorial (C++ version) include the following code snippets:

• Setting the API Key, in the main.cpp file:

  Use dark colors for code blocksCopy

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68
  69
  70
  71
  72
  73
  74
  75
  76
  77
  78
  79
  80
      const QString apiKey = QString("");
  

• Creating a map from an ArcGIS basemap, in the Display_a_map.cpp file:

  Use dark colors for code blocksCopy

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68
  Display_a_map::Display_a_map(QObject* parent /* = nullptr */):
  
      QObject(parent),
  
      m_map(new Map(BasemapStyle::ArcGISTopographic, this))
  

• Adding the map to the map view control, the Display_a_map.cpp file:

  Use dark colors for code blocksCopy

  1
  2
  3
  4
  5
  6
  7
  8
  9
  10
  11
  12
  13
  14
  15
  16
  17
  18
  19
  20
  21
  22
  23
  24
  25
  26
  27
  28
  29
  30
  31
  32
  33
  34
  35
  36
  37
  38
  39
  40
  41
  42
  43
  44
  45
  46
  47
  48
  49
  50
  51
  52
  53
  54
  55
  56
  57
  58
  59
  60
  61
  62
  63
  64
  65
  66
  67
  68
      m_mapView->setMap(m_map);
  

Once you are done building your application, make sure to license it before deploying to production. For more information, see License and deployment topic for details.

5. Follow the tutorials

Go to the tutorials to create and run applications to perform different operations.

6. Explore the samples

Go to the samples to learn how to perform more tasks with the API.

Next steps

• Overview

  Learn about the API and developer resources.

• Key features

  Discover the capabilities of the API.

• Get started

  Get started using the API.