There are a number of ways to get started to develop with ArcGIS Maps SDK for Kotlin. If you are new, follow the steps below to get started with Kotlin and Android Studio.
TopicBefore proceeding, review the System requirements to ensure your machine has the required hardware and correct versions for software dependencies.
1. Sign up for an accountTo use ArcGIS Maps SDK for Kotlin to access content, services, or an organization, you need an ArcGIS Location Platform 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 a free account for ArcGIS Location Platform
Get a free trial and account for ArcGIS Online
TipTo get an account for an existing ArcGIS organization contact your ArcGIS Online or ArcGIS Enterprise administrator.
2. Get the SDK and dependenciesTo use the ArcGIS Maps SDK for Kotlin, install Android Studio, install the JDK used by Gradle, and get the ArcGIS Maps SDK for Kotlin and its dependencies.
Install an Android IDE with Gradle integrated.The official IDE for Android app development is Android Studio, which can be installed as follows.
Check the Android Studio system requirements for your operating system, architecture, and version.
Download Android Studio.
You should install the latest stable version of Android Studio.
Run the installation file, following instructions in the Android Studio Setup wizard.
Installing Android Studio automatically installs an embedded version of the JDK, normally in a subdirectory named jbr
. Gradle, however, uses its own JVM when starting the Gradle daemon. If these two versions of the JVM are not the same, Gradle may spawn extra deamons, which can slow down builds.
You should manually set the JDK that Gradle uses and make sure the embedded JDK and the Gradle JDK are the same version.
On the file system of your development machine, go to the jbr
directory underneath the Android Studio installation. Open the release
file and find the value of the JAVA_VERSION environment variable.
That is the embedded JDK that Android Studio is using.
In Android Studio, select File > Settings (Windows) or Android Studio > Settings (macOS).
In the Settings dialog, click Build, Execution, Deployment > Build Tools > Gradle.
In the Gradle JDK field, select one of the JDKs from the drop-down menu. Make sure that the JDK you select has the same version as the embedded JDK.
For best results, select a JDK named JetBrains Runtime xx.y.z, where xx.y.z is the same version used by Android Studio. If you do not see that JDK in the drop-down list, then ask Android Studio to download and install it for you.
Click the Gradle JDK drop-down list, and then click Download JDK....
In the Download JDK dialog, select the appropriate version number for Version and select JetBrains Runtime for Vendor.
Follow all instructions on the Install and set up page. Note that you do not need to manually download the ArcGIS Maps SDK for Kotlin API. Once the Gradle files are properly configured, the Gradle build system will download the API and the versions of the dependencies you specify.
If you are developing ArcGIS Maps SDK for Kotlin applications in an environment that is disconnected from the internet, first obtain the API from the downloads page. Then follow the download's README, which provides instructions for the disconnected workflow.
3. Implement authenticationTo access secure ArcGIS services and resources, you need to implement authentication. The easiest way to get started is to obtain an access token from an API Key and implement API key authentication. If you want to build an app that requires users to sign in with their ArcGIS account, implement user authentication.
API key authentication
User authentication
API key authentication
User authentication
4. Create your first mapping applicationFollow 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.
Expand
Use dark colors for code blocks Copy1
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
@Composable
fun MainScreen() {
val map = remember {
createMap()
}
Scaffold(
topBar = { TopAppBar(title = { Text(text = stringResource(id = R.string.app_name)) }) }
) {
MapView(
modifier = Modifier.fillMaxSize().padding(it),
arcGISMap = map
)
}
}
fun createMap(): ArcGISMap {
return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {
initialViewpoint = Viewpoint(
latitude = 34.0270,
longitude = -118.8050,
scale = 72000.0
)
}
}
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 tutorialsGo to the tutorials to create and run applications to perform different operations.
6. Explore the samplesGo to the samples to learn how to perform more tasks with the API.
Next stepsRetroSearch is an open source project built by @garambo | Open a GitHub Issue
Search and Browse the WWW like it's 1997 | Search results from DuckDuckGo
HTML:
3.2
| Encoding:
UTF-8
| Version:
0.7.4