Migrate to ArcGIS location services

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 scope and permissions available to your application.

There are three types of authentication that can be used to obtain an access token:

  • API key authentication: This creates a permanent token that grants your application access to location services and, with an ArcGIS developer account, private content.
  • User authentication (formerly ArcGIS identity): 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 credential authentication: This generates a short-lived token via OAuth 2.0, authorizing your application to access ready-to-use 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

You can provide your API key to ArcGIS Runtime when your app starts by setting it on AGSArcGISRuntimeEnvironment .

AppDelegate.swift
Expand
Use dark colors for code blocksCopy
15 15 15 15 15 15 15 15 15 15 15 15 15 15 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35
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
import UIKit

import ArcGIS


@UIApplicationMain
class AppDelegate: UIResponder, UIApplicationDelegate {
    var window: UIWindow?

    func application(_ application: UIApplication,
                     didFinishLaunchingWithOptions launchOptions: [UIApplication.LaunchOptionsKey: Any]?) -> Bool {
        // Note: it is not best practice to store API keys in source code.
        // The API key is referenced here for the convenience of this tutorial.

        AGSArcGISRuntimeEnvironment.apiKey = "YOUR_API_KEY"

        return true
    }

}

This sets a global API key that will be used to access all ArcGIS location services used by your app. If needed, you can override this key by explicitly setting a different key on layers, basemaps, or any other classes that use platform location services (those that inherit AGSAPIKeyResource ).

Basemaps

Review the basemap layer service and the variety of basemaps available. Create a new basemap using one of the enumeration values from AGSBasemapStyle and use it to create your AGSMap .

You can set an API key directly on the basemap or default to a global API key if one is set for the app.

Geocoding

Use the geocoding service and provide an API key, either globally for the app, or by setting it explicitly on your AGSLocatorTask .

Routes and directions

Access to routing and directions APIs is unchanged with the new ArcGIS location services introduced with ArcGIS Platform. While authentication has always been required to access these services, you now have the ability to use these services with an API key in addition to user authentication.

See the Find routes and directions topic for more information.

Other services

See all the Location services available.

Your browser is no longer supported. Please upgrade your browser for the best experience. See our browser deprecation post for more details.