Follow these steps to migrate your existing ArcGIS Runtime app to use ArcGIS location services.
This information is intended for developers who have an existing app built with one of the ArcGIS Runtime APIs and would like to update it to use ArcGIS location services. To use the services, your app must use ArcGIS Runtime version 100.10 or later. Use the current version of ArcGIS Runtime to ensure that you have access to the latest capabilities.
If your app was built with ArcGIS Runtime version 10.x, refer to the Migrate to 100.x from 10.2.x topic for help migrating to 100.x.
Authentication
To use any of the ArcGIS location services, your app must provide authentication with an access token. Access tokens define the privileges available to your application.
There are three types of authentication that can be used to obtain an access token:
- API key authentication: This type of authentication uses a long-lived access token to authenticate requests to location services and private content. Go to the Create an API key tutorial to obtain a new API Key access token. It is the recommended type of authentication for developers new to ArcGIS or to development in general.
- User authentication: This generates a short-lived token via OAuth 2.0, authorizing your application to access location services, content, and resources on behalf of a logged in ArcGIS user.
- App authentication: This generates a short-lived token via OAuth 2.0, authorizing your application to access location services on your behalf.
Learn more about getting and using an access token in Security and authentication and the Display a map tutorial.
Global API key
When your app starts you can set API Key access token on the
ArcGISRuntimeEnvironment
. This will allow your app to access location services according to the privileges of the access token.
const QString accessToken = QStringLiteral("YOUR_ACCESS_TOKEN");
if (accessToken.isEmpty())
{
qWarning() << "Use of ArcGIS location services, such as the basemap styles service, requires "
"you to authenticate with an ArcGIS account or set the API Key property.";
}
else
{
ArcGISRuntimeEnvironment::setApiKey(accessToken);
}
When your app starts you can set API Key access token on the
ArcGISRuntimeEnvironment
. This will allow your app to access location services according to the privileges of the access token.
Basemaps
Review the basemap styles service and the variety of basemaps available. Create a new basemap using one of the enumeration values from
BasemapStyle
and use it to create your
Map
.
You can set an access token directly on the basemap or default to a global access token, if one is set on the
ArcGISRuntimeEnvironment
.
// Create a new 'topographic' basemap.
Basemap* basemap = new Basemap(BasemapStyle::ArcGISTopographic, this);
// Optionally, set a specific API key for the basemap.
// (Not required if a global API key is set)
basemap->setApiKey("YOUR_ACCESS_TOKEN");
// Create a map that uses the basemap.
Map* map = new Map(basemap, this);
Geocoding
Use the geocoding service and provide an API key, either globally for the app, or by setting it explicitly on your
LocatorTask
.
Routes and directions
Access to routing and directions APIs is unchanged with the new ArcGIS location services introduced with ArcGIS Location Platform. Authentication is required to access these services, using any Type of authentication.
See the Find routes and directions topic for more information.
Other services
See all the Location services available.