ArcGIS Developers 開発リソース集 > スタートアップガイド > アプリ開発 > Android

Android

出典：ArcGIS Maps SDK for Kotlin - Tutorials - Display a map

マップを表示する

このチュートリアルでは ArcGIS Maps SDK for Kotlin を使用して、マップとベースマップレイヤーを表示する方法を紹介します。

マップには、地理データのレイヤーが含まれています。マップには、ベースマップレイヤーと、オプションで 1 つ以上のデータレイヤーを追加できます。マップビューを使用し、場所とズームレベルを設定することで、マップの特定の領域を表示できます。

このチュートリアルでは、地形図ベースマップレイヤーを使用して、富士山付近を表示する地図を作成します。

このチュートリアルのトピックの背景情報については、Mapping API and location services guide の Maps (2D) とベースマップを参照してください。

前提条件

このチュートリアルを実施するには、以下が必要です。

API キーにアクセスするための ArcGIS 開発者アカウント。アカウントをお持ちでない場合は、サインアップ（無料）してください。アカウントの作成方法は「開発者アカウントの作成」をご覧ください。
開発環境がシステム要件を満たしていることを確認します。
Kotlin で Android 開発をするための IDE。

このチュートリアルのダウンロードソリューションで利用可能なコードは、Android Studio Ladybug | 2024.2.1 Patch で作成されています。しかし、以下のステップで説明するコードは、それ以降のバージョンの Android Studio を含め、Kotlin をサポートする最新の Android IDE であれば動作するはずです。

認証の設定

このチュートリアルで使用するセキュアな ArcGIS ロケーションサービスにアクセスするには、ArcGIS Location Platform または ArcGIS Online アカウントを使用して、API キー認証またはユーザー認証を実装する必要があります。

このチュートリアルでは、API キー認証またはユーザー認証を実装することができます。以下の違いを比較してください。

API キー認証

ユーザーはサインインする必要がありません。
適切な権限を持つ API キーの認証情報を作成する必要があります。
API キーは長期間のアクセストークンです。
サービス使用料は API キーの所有者/開発者に請求されます。
実装が最も簡単な認証方法です。
新規の ArcGIS 開発者に推奨される方法です。

詳しくは API キー認証をご覧ください。

このチュートリアルで使用するセキュアなリソースにアクセスする権限を持つ、新しい API キーのアクセストークンを作成します。

API キーの作成のチュートリアルを完了し、以下の権限を持つ API キーを作成します。
- Privileges
  - Location services > Basemaps
API キーのアクセストークン をコピーし、安全な場所に貼り付けます。これは後のステップで使用します。

ユーザー認証

ユーザーは、ArcGIS アカウントでサインインする必要があります。
ユーザーアカウントには、アプリケーションで使用する ArcGIS サービスにアクセスする権限が必要です。
OAuth 認証情報の作成が必要です。
アプリケーションは、リダイレクト URL とクライアント ID を使用します。
サービスの使用料は、アプリケーションにサインインしたユーザーの組織に請求されます。

詳しくは、ユーザー認証をご覧ください。

このチュートリアルで使用するセキュアなリソースにアクセスするための新しい OAuth 認証情報を作成します。

ユーザー認証用の OAuth 認証情報を作成するチュートリアルを完了します。
ClientID と RedirectURL をコピーして安全な場所に貼り付けます。これらは後のステップで使用します。

このアプリケーションにアクセスするすべてのユーザーには、ベースマップスタイルサービスにアクセスするためのアカウント権限が必要です。

セキュリティと認証ガイド : 認証の種類について詳しくは、認証の種類をご覧ください。

開発またはダウンロード

このチュートリアルを完了するには、2 つの選択肢があります。

オプション 1:コードを開発するか
オプション 2:完成したソリューションをダウンロードする

オプション 1:コードを開発する

新しい Android Studio プロジェクトを作成する

Android Studio を使用してアプリを作成し、API を参照するように構成します。

Android Studio を開きます。
- [Welcome to Android Studio] ウィンドウで [New Project] をクリックします。
  または、メニューバーで [File] → [New] → [New Project] をクリックします。
- [Create New Project] ウィンドウで、[Phone and Tablet] タブが選択されていることを確認してから、[Empty Activity] を選択して、[Next] をクリックします。
- 次のウィンドウで、以下の項目を設定し、[Finish]をクリックします。
  - Name: Tutorial
  - Package name： com.example.app に変更します。または、組織に合わせて変更してください。
  - Save location: 新しいフォルダーに設定します。
  - Minimum SDK: API 26 (“Oreo”; Android 8.0)
  - Build configuration language: Kotlin DSL (build.gradle.kts)
[プロジェクト]のツールウィンドウで、現在のビューが [Android] であることを確認してください。チュートリアルの説明では、そのビューを参照しています。

ビュー名が [Android] 以外の名前（[プロジェクト]や[パッケージ]など）の場合、プロジェクトツールウィンドウのタイトルバーの左端のコントロールをクリックし、リストから [Android] を選択します。

[Android] ビューから、[Gradle Scripts] > [build.gradle.kts (Project: Tutorial)] を開きます。ファイルの内容を次のコードに置き換えます。

build.gradle.kts (Project: Tutorial)

// すべてのサブプロジェクト/モジュールに共通の構成オプションを追加できる最上位のビルド ファイル
plugins {
    alias(libs.plugins.android.application) apply false
    alias(libs.plugins.kotlin.android) apply false
    alias(libs.plugins.kotlin.compose) apply false
}

[Android] ビューから、[Gradle Scripts] > [build.gradle.kts (Module: app)] を開きます。ファイルの内容を次のコードに置き換えます。

build.gradle.kts (Module: app)

plugins {
    alias(libs.plugins.android.application)
    alias(libs.plugins.kotlin.android)
    alias(libs.plugins.kotlin.compose)
}

android {
    namespace = "com.example.app"
    compileSdk = libs.versions.compileSdk.get().toInt()

    defaultConfig {
        applicationId = "com.example.app"
        minSdk = libs.versions.minSdk.get().toInt()
        targetSdk = libs.versions.targetSdk.get().toInt()
        versionCode = 1
        versionName = "1.0"
        testInstrumentationRunner = "androidx.test.runner.AndroidJUnitRunner"
        vectorDrawables {
            useSupportLibrary = true
        }
    }

    buildTypes {
        release {
            isMinifyEnabled = false
            proguardFiles(getDefaultProguardFile("proguard-android-optimize.txt"), "proguard-rules.pro")
        }
    }
    compileOptions {
        sourceCompatibility = JavaVersion.VERSION_17
        targetCompatibility = JavaVersion.VERSION_17
    }
    kotlinOptions {
        jvmTarget = "17"
    }
    buildFeatures {
        compose = true
    }
    packaging {
        resources {
            excludes += "/META-INF/{AL2.0,LGPL2.1}"
        }
    }
}

dependencies {

    implementation(libs.androidx.core.ktx)
    implementation(libs.androidx.lifecycle.runtime.ktx)
    implementation(libs.androidx.activity.compose)
    implementation(platform(libs.androidx.compose.bom))
    implementation(libs.androidx.ui)
    implementation(libs.androidx.ui.graphics)
    implementation(libs.androidx.ui.tooling.preview)
    implementation(libs.androidx.material3)
    testImplementation(libs.junit)
    androidTestImplementation(libs.androidx.junit)
    androidTestImplementation(libs.androidx.espresso.core)
    androidTestImplementation(platform(libs.androidx.compose.bom))
    androidTestImplementation(libs.androidx.ui.test.junit4)
    debugImplementation(libs.androidx.ui.tooling)
    debugImplementation(libs.androidx.ui.test.manifest)

    // ArcGIS Maps for Kotlin - SDK dependency
    implementation(libs.arcgis.maps.kotlin)
    // Toolkit dependencies
    implementation(platform(libs.arcgis.maps.kotlin.toolkit.bom))
    implementation(libs.arcgis.maps.kotlin.toolkit.geoview.compose)
    implementation(libs.arcgis.maps.kotlin.toolkit.authentication)

}

Kotlin 2.0+では、Compose Compiler Gradle プラグインが必要です。このプラグインは、build.gradle.kts(Module :app)の plugins ブロックで alias(libs.plugins.kotlin.compose) として参照され、libs.versions.toml ファイルでは kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" } として宣言されています。Compose Compiler Gradle プラグインと Kotlin Android プラグインのバージョンは同じです。

2.0 より前の Kotlin バージョンを使用している場合は、Compose コンパイラーと Kotlin コンパイラーのバージョンが互換性があることを確認する必要があります。詳細については、Compose to Kotlin Compatibility Map を参照してください。

[Android] ビューから、[Gradle Scripts] > [libs.versions.toml] を開きます。[version] セクションで、ArcGIS Maps SDK for Kotlin のバージョン番号を宣言します。また、[libraries] セクションには、以下のライブラリの宣言を追加します。

ArcGIS Maps SDK for Kotlin SDK
ArcGIS Maps SDK for Kotlin Toolkit BOM
アプリで使用するすべてのツールキットコンポーネント。マップビューまたはシーンビューを表示するには、コンポーザブルな MapView とSceneView を含む geoview-compose モジュールの宣言が必要です。ユーザー認証を実装するには、authentication モジュールが必要です。

Toolkit BOM のバージョンは、宣言したすべての Toolkit コンポーネントに適用されます。

Gradle バージョンカタログは依存関係のバージョンを宣言するための標準的な Android のアプローチです。build.gradle.kts でバージョン番号を指定したり、version.gradle でバージョン番号を列挙するよりも推奨されます。Android Studio の最近のリリースでは、[New Project Wizard] がこの標準をサポートする build.gradle.kts と gradle/libs.version.toml ファイルを生成します。

Gradle バージョンカタログでは、BOM ファイルを使用して、BOM 内のすべての成果物に対して単一のバージョン番号を指定することもできます。詳細については、ArcGIS Maps SDK for Kotlin Toolkit の README の Using the BOM を参照してください。

gradle/libs.versions.toml

[versions]
arcgisMapsKotlin = "200.6.0"

[libraries]
arcgis-maps-kotlin = { group = "com.esri", name = "arcgis-maps-kotlin", version.ref = "arcgisMapsKotlin" }
arcgis-maps-kotlin-toolkit-bom = { group = "com.esri", name = "arcgis-maps-kotlin-toolkit-bom", version.ref = "arcgisMapsKotlin" }
arcgis-maps-kotlin-toolkit-geoview-compose = { group = "com.esri", name = "arcgis-maps-kotlin-toolkit-geoview-compose" }
arcgis-maps-kotlin-toolkit-authentication = { group = "com.esri", name = "arcgis-maps-kotlin-toolkit-authentication" }

libs.versions.toml を手で編集しないでください。代わりに、以下のコードを展開し、展開した内容をすべてコピーして libs.versions.toml ファイルに貼り付け、新規プロジェクトウィザードで生成された元の内容を置き換えてください。

[versions]
arcgisMapsKotlin = "200.7.0"

# Version numbers added by Android Studio New Project Wizard
agp = "8.7.3"
kotlin = "2.0.0"
coreKtx = "1.15.0"
junit = "4.13.2"
junitVersion = "1.2.1"
espressoCore = "3.6.1"
lifecycleRuntimeKtx = "2.8.7"
activityCompose = "1.9.3"
composeBom = "2024.11.00"

# Other version numbers
compileSdk = "35"
minSdk = "26"
targetSdk = "35"

[libraries]
arcgis-maps-kotlin = { group = "com.esri", name = "arcgis-maps-kotlin", version.ref = "arcgisMapsKotlin" }
arcgis-maps-kotlin-toolkit-bom = { group = "com.esri", name = "arcgis-maps-kotlin-toolkit-bom", version.ref = "arcgisMapsKotlin" }
arcgis-maps-kotlin-toolkit-geoview-compose = { group = "com.esri", name = "arcgis-maps-kotlin-toolkit-geoview-compose" }
arcgis-maps-kotlin-toolkit-authentication = { group = "com.esri", name = "arcgis-maps-kotlin-toolkit-authentication" }

androidx-core-ktx = { group = "androidx.core", name = "core-ktx", version.ref = "coreKtx" }
junit = { group = "junit", name = "junit", version.ref = "junit" }
androidx-junit = { group = "androidx.test.ext", name = "junit", version.ref = "junitVersion" }
androidx-espresso-core = { group = "androidx.test.espresso", name = "espresso-core", version.ref = "espressoCore" }
androidx-lifecycle-runtime-ktx = { group = "androidx.lifecycle", name = "lifecycle-runtime-ktx", version.ref = "lifecycleRuntimeKtx" }
androidx-activity-compose = { group = "androidx.activity", name = "activity-compose", version.ref = "activityCompose" }
androidx-compose-bom = { group = "androidx.compose", name = "compose-bom", version.ref = "composeBom" }
androidx-ui = { group = "androidx.compose.ui", name = "ui" }
androidx-ui-graphics = { group = "androidx.compose.ui", name = "ui-graphics" }
androidx-ui-tooling = { group = "androidx.compose.ui", name = "ui-tooling" }
androidx-ui-tooling-preview = { group = "androidx.compose.ui", name = "ui-tooling-preview" }
androidx-ui-test-manifest = { group = "androidx.compose.ui", name = "ui-test-manifest" }
androidx-ui-test-junit4 = { group = "androidx.compose.ui", name = "ui-test-junit4" }
androidx-material3 = { group = "androidx.compose.material3", name = "material3" }

[plugins]
android-application = { id = "com.android.application", version.ref = "agp" }
kotlin-android = { id = "org.jetbrains.kotlin.android", version.ref = "kotlin" }
kotlin-compose = { id = "org.jetbrains.kotlin.plugin.compose", version.ref = "kotlin" }

[Android] ビューから、[Gradle Scripts] > [settings.gradle.kts] を開きます。ファイルの内容を次のコードに置き換えます。

settings.gradle.kts (Tutorial)

pluginManagement {
    repositories {
        google {
            content {
                includeGroupByRegex("com\\.android.*")
                includeGroupByRegex("com\\.google.*")
                includeGroupByRegex("androidx.*")
            }
        }

        mavenCentral()
        gradlePluginPortal()
    }
}

dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://esri.jfrog.io/artifactory/arcgis") }
    }
}

rootProject.name = "Tutorial"
include(":app")

Gradle の変更を同期します。[Sync now] プロンプトをクリックするか、ツールバーの更新アイコン ([Sync Project with Gradle Files]) をクリックします。同期に数分かかるかもしれません。
[Android] ビューから、[app] > [manifests] > [AndroidManifest.xml] を開きます。Android マニフェストを更新して、インターネット接続を許可します。

これらの新しい要素を manifest 要素内に挿入します。他のステートメントを変更または削除しないでください。

今後のチュートリアルで追加する ArcGIS の機能によっては、マニフェストに追加のアクセス許可を追加する必要がある可能性があります。

AndroidManifest.xml
```
<manifest xmlns:android="http://schemas.android.com/apk/res/android">


<uses-permission android:name="android.permission.INTERNET"/>


<application
    ・・・
```

マップを作成する

[Android] ビューから、[app] > [Kotlin+java] > [com.example.app] を右クリックし、リストから [New] > [package] を選択します。パッケージ名に com.example.app.screens と入力し、キーボードのキーを押します。このステップで、すべての UI ファイルを含む新しいパッケージが作成されます。
作成した screens パッケージを右クリックし、リストから [New] > [Kotlin Class/File] を選択します。ポップアップウィンドウで [File] を選択し、ファイル名に MainScreen と入力し、キーボードのキーを押します。

MainScreen.kt で、Android Studio によって自動的に挿入されたコード行をすべて削除します。次に、以下のオプトインアノテーション、パッケージ名、インポートを追加します。

以下のコードブロックでコンポーザブル関数 com.arcgismaps.tookit.geoviewcompose.MapView をインポートしていることを確認してください。これは ArcGIS Maps SDK for Kotlin Toolkit で定義されています。コンポーザブルに対応したコードでは ArcGIS Maps SDK API の com.arcgismaps.mapping.view.MapView という名前のクラスは使用しないでください。

MainScreen.kt

@file:OptIn(ExperimentalMaterial3Api::class)

package com.example.app.screens

import androidx.compose.foundation.layout.fillMaxSize
import androidx.compose.foundation.layout.padding
import androidx.compose.material3.ExperimentalMaterial3Api
import androidx.compose.material3.Scaffold
import androidx.compose.material3.Text
import androidx.compose.material3.TopAppBar
import androidx.compose.runtime.Composable
import androidx.compose.runtime.remember
import androidx.compose.ui.Modifier
import androidx.compose.ui.res.stringResource
import com.arcgismaps.mapping.ArcGISMap
import com.arcgismaps.mapping.BasemapStyle
import com.arcgismaps.mapping.Viewpoint
import com.arcgismaps.toolkit.geoviewcompose.MapView
import com.example.app.R

ArcGISMap を返す createMap() という名前のトップレベル関数を作成します。

MainScreen.kt
```
// 追加開始
fun createMap(): ArcGISMap {

}
// 追加終了
```
BasemapStyle.ArcGISTopographic を使用して ArcGISMap を作成し、マップ上で apply{} を呼び出します。この関数は ArcGISMap を返します。

apply {} の詳細については Kotlin の Scope functions を参照してください。

MainScreen.kt
```
fun createMap(): ArcGISMap {

    // 追加開始
    return ArcGISMap(BasemapStyle.ArcGISTopographic).apply {

    }
    // 追加終了

}
```

apply ブロックで、x (経度) と y (緯度) の座標と縮尺を持つ Viewpoint を作成します。この Viewpoint を ArcGISMap の initialViewpoint プロパティに割り当てます。
また、ベースマップのデフォルトのラベル表示は英語のため、日本語に変更します。

MainScreen.kt

fun createMap(): ArcGISMap {

    // 追加開始
    val basemapStyleParams = BasemapStyleParameters()
    basemapStyleParams.languageStrategy = BasemapStyleLanguageStrategy.Specific(Locale("ja"))
    // 追加終了

    return ArcGISMap(Basemap(BasemapStyle.ArcGISTopographic, basemapStyleParams)).apply {

        // 追加開始
        initialViewpoint = Viewpoint(
            latitude = 35.360626,
            longitude = 138.727363,

            scale = 200000.0

        )
        // 追加終了

    }

}

マップを保持する MainScreen を作成する

MapView を呼び出す MainScreen という名前のコンポーザブル関数を作成します。

MainScreen.kt

// 追加開始
@Composable
fun MainScreen() {

}
// 追加終了

fun createMap(): ArcGISMap {
    ・・・

remember ブロックを追加し、その中で createMap() を呼び出します。そして remember を map というローカル変数に割り当てます。

トップレベルのコンポーザブル関数 remember は再構成時に状態を保持するために使用されます。

MainScreen.kt
```
@Composable
fun MainScreen() {

    // 追加開始
    val map = remember {
        createMap()
    }
    // 追加終了

}
```

Android Jetpack Compose からいくつかのコンポーザブル関数を呼び出します。Scaffold を呼び出し、アプリ名 (R.string.app_name) を含む Text で TopAppBar を渡します。

MainScreen.kt

@Composable
fun MainScreen() {

    val map = remember {
        createMap()
    }

    // 追加開始
    Scaffold(
        topBar = { TopAppBar(title = { Text(text = stringResource(id = R.string.app_name)) }) }
    ) {

    }
    // 追加終了

}

Scaffold の末尾のラムダで、ArcGIS Maps SDK for Kotlin Toolkit で定義されている MapView コンポーザブルを呼び出し、最大サイズとデフォルトのパディングを持つ Modifier を設定します。そして、map を arcGISMap パラメーターとして渡します。

MainScreen.kt

@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
        )
        // 追加終了

    }

}

MainActivity クラス内で MainScreen を呼び出す

[app] > [kotlin+java] > [com.example.app] の MainActivity.kt を開きます。ファイル内のコードをすべて削除します。パッケージ宣言、import 文、 MainActivity クラスを追加します。

MainActivity.kt

//追加開始
package com.example.app

import android.os.Bundle
import androidx.activity.ComponentActivity
import androidx.activity.compose.setContent
import androidx.activity.enableEdgeToEdge
import com.arcgismaps.ApiKey
import com.arcgismaps.ArcGISEnvironment
import com.arcgismaps.httpcore.authentication.OAuthUserConfiguration
import com.arcgismaps.toolkit.authentication.AuthenticatorState
import com.arcgismaps.toolkit.authentication.DialogAuthenticator
import com.example.app.screens.MainScreen
import com.example.app.ui.theme.TutorialTheme

class MainActivity : ComponentActivity() {

}
//追加終了

onCreate() ライフサイクル関数の setContent ブロックでは、デフォルトのテーマが適用されたコンポーザブル関数 MainScreen を呼び出します。これを行うには、onCreate() に以下のコードを追加します。

MainActivity.kt

class MainActivity : ComponentActivity() {

    // 追加開始
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        setContent {
            DisplayAMapTheme {
                MainScreen()
            }
        }

    }
    // 追加終了
}

開発者認証情報を設定する

アプリのユーザーが ArcGIS Location Services にアクセスできるようにするには、認証の設定ステップで作成した開発者認証情報を使用して、リソースへの要求を認証します。

API キーでの認証

API キーを使用すると、ArcGIS Online でホストされているサービス、Web マップ、および Web シーンにアクセスできるようになります。

Android Studio の [Android] ビューで、[app] > [kotlin+java] > [com.example.app] > [MainActivity] を開きます。
MainActivity クラスの onCreate() ライフサイクルメソッドで、ApiKey.create() を呼び出して ArcGISEnvironment.apiKey プロパティを設定します。API キーのアクセストークンを文字列として渡し、二重引用符を忘れないでください。これは setContent ブロックの前に行います。

MainActivity.kt
```
class MainActivity : ComponentActivity() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        //追加開始
        ArcGISEnvironment.apiKey = ApiKey.create("YOUR_ACCESS_TOKEN")
        //追加終了

        enableEdgeToEdge()

        setContent {
            TutorialTheme {
                MainScreen()
            }
        }
    }
}
```
ベストプラクティス: アクセストークンは、このチュートリアルの便宜のためにコードに直接格納されています。本番環境では、認証情報をソースコードに直接保存しないでください。

ユーザー認証

Android Studio の [Android] ビューで、[app] > [kotlin+java] > [com.example.app] > [MainActivity] を開きます。MainActivity クラスで、ArcGIS Maps SDK for Kotlin Toolkit の authentication モジュール AuthenticatorState のインスタンスを作成します。これを setContent ブロックの前に追加します。

MainActivity.kt

class MainActivity : ComponentActivity() {

    //追加開始
    private val authenticatorState = AuthenticatorState()
    //追加終了

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        enableEdgeToEdge()

        setContent {
            TutorialTheme {
                MainScreen()

            }
        }
    }

}

MainActivity クラスの onCreate() ライフサイクルメソッドで、OAuthUserConfiguration をインスタンス化して authenticatorState.oAuthUserConfiguration プロパティを設定します。以前のステップで作成した clientId と redirectURL を渡します。

redirectURL は、scheme と host コンポーネントで構成されます。リダイレクト URL の形式は scheme://host です。たとえば、リダイレクト URL が myscheme://myhost の場合、スキームは myscheme、ホストは myhost となります。認証の設定ステップのユーザー認証の部分で、アプリに指定した RedirectURL を使用する必要があります。

MainActivity.kt

```kt
override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    //追加開始
    authenticatorState.oAuthUserConfiguration = OAuthUserConfiguration(

        portalUrl = "https://www.arcgis.com",
        clientId = "YOUR_CLIENT_ID",
        redirectUrl = "YOUR_REDIRECT_URL"

    )
    //追加終了

    enableEdgeToEdge()

    setContent {
        TutorialTheme {
            MainScreen()

        }
    }
}
```

setContent ブロックで、DialogAuthenticator コンポーザブル関数を呼び出し、authenticatorState を渡します。DialogAuthenticator 組み込み関数を、MainScreen() 組み込み関数の後で呼び出します。

MainActivity.kt

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)

    authenticatorState.oAuthUserConfiguration = OAuthUserConfiguration(

        portalUrl = "https://www.arcgis.com",
        clientId = "YOUR_CLIENT_ID",
        redirectUrl = "YOUR_REDIRECT_URL"

    )

    enableEdgeToEdge()

    setContent {
        TutorialTheme {
            MainScreen()

            //追加開始
            DialogAuthenticator(authenticatorState)
            //追加終了

        }
    }
}

[app] > [manifests] > [AndroidManifest.xml] を開きます。OAuth ユーザーサインインアクティビティを宣言する <activity> タグを追加します。RedirectURL のスキームとホストを使用して、android:scheme と android:host を設定します。
redirectURL は scheme と host コンポーネントで構成されます。リダイレクト URL のフォーマットは scheme://host です。たとえば、リダイレクト URL が myscheme://myhost の場合、スキームは myscheme、ホストは myhost となります。認証の設定ステップのユーザー認証の部分で、アプリに指定した RedirectURL を使用する必要があります。

AndroidManifest.xml

</activity>

<!--追加開始-->
<activity
    android:name="com.arcgismaps.toolkit.authentication.OAuthUserSignInActivity"
    android:configChanges="keyboard|keyboardHidden|orientation|screenSize"
    android:exported="true"
    android:launchMode="singleTop" >
    <intent-filter>
        <action android:name="android.intent.action.VIEW" />

        <category android:name="android.intent.category.DEFAULT" />
        <category android:name="android.intent.category.BROWSABLE" />

        <data
            android:scheme="your_redirect_url_scheme"
            android:host="your_redirect_url_host" />

    </intent-filter>
</activity>
<!--追加終了-->

ベストプラクティス: OAuth 認証情報は、このチュートリアルの便宜のためにコードに直接保存されています。本番環境では、認証情報をソースコードに直接保存しないでください。

アプリを実行する

[Run] > [Run] > [app] をクリックして、アプリを実行します。

Android Studio では、アプリを実行するのに、実際の Android 端末と Android エミュレータの 2 通りの方法があります。

Android デバイス

パソコンと Android 端末を、USB または Wi-Fi で接続します。詳しくは、「Android デバイスを接続する方法」をご覧ください。

Android エミュレーター

Android エミュレーターで動作させるための AVD(Android Virtual Device) を作成します。詳しくは、「Android Emulator 上でアプリを実行する」をご覧ください。

デバイスの選択

Android Studio でアプリをビルドして実行する場合、まずデバイスを選択する必要があります。Android Studio のツールバーから、現在利用可能なデバイス（仮想および物理の両方）のドロップダウンリストにアクセスできます。

ツールバーのリストにアクセスできない場合は、[Tools] → [Device Manader] をクリックします。

富士山を中心に、地形ベースマップレイヤーが追加されたマップが表示されます。マップビュー上でマウスホイールをダブルクリック、ドラッグ、およびスクロールして、マップを操作します。

あるいは、以下のチュートリアルソリューションをダウンロードすることもできます。

オプション 2:完成したソリューションをダウンロードする

Download solution をクリックしてください。
マシンの任意の場所にファイルを解凍します。
Android Studio を起動します。
[File] > [Open…] に進みます。ソリューションフォルダーに移動し、[開く]をクリックします。
Windows の場合
[Welcome to Android Studio] ダイアログが表示されたら、[開く]をクリックし、ソリューションフォルダーに移動します。次に、[開く]をクリックします。

ダウンロードしたソリューションには認証情報が含まれていないため、認証の設定セクションで作成した開発者認証情報を追加する必要があります。

ソリューションに開発者認証情報を設定する

アプリのユーザが ArcGIS 位置情報サービスにアクセスできるようにするには、認証の設定ステップで作成した開発者認証情報を使用して、リソースへの要求を認証します。

API キー認証

Android Studio の [Android] ビューで、[app] > [kotlin+java] > [com.example.app] > [MainActivity] を開きます。AuthenticationMode を .API_KEY に設定します。

MainActivity.kt

class MainActivity : ComponentActivity() {

    private enum class AuthenticationMode { API_KEY, USER_AUTH }
    
    //追加開始
    private val authenticationMode = AuthenticationMode.API_KEY
    //追加終了

    private val authenticatorState = AuthenticatorState()

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        when (authenticationMode) {
            AuthenticationMode.API_KEY -> {

                ArcGISEnvironment.apiKey =   ApiKey.create("YOUR_ACCESS_TOKEN")

            }

            AuthenticationMode.USER_AUTH -> {
                authenticatorState.oAuthUserConfiguration =   OAuthUserConfiguration(
                    portalUrl = "https://www.arcgis.com",

                    clientId = "YOUR_CLIENT_ID",
                    redirectUrl = "YOUR_REDIRECT_URL"

                )

            }
        }

        enableEdgeToEdge()

        setContent {
            TutorialTheme {
                MainScreen()

                if (authenticationMode == AuthenticationMode.USER_AUTH) {
                    DialogAuthenticator(authenticatorState)
                }

            }
        }
    }

}

apiKey プロパティに API キーのアクセストークンを設定します。

MainActivity.kt

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    when (authenticationMode) {
        AuthenticationMode.API_KEY -> {

            //追加開始
            ArcGISEnvironment.apiKey = Apikey.create("YOUR_ACCESS_TOKEN")
            //追加終了

        }

ベストプラクティス: アクセストークンは、このチュートリアルの便宜のためにコードに直接格納されています。本番環境では、認証情報をソースコードに直接保存しないでください。

ユーザー認証

Android Studio の [Android] ビューで、[app] > [kotlin+java] > [com.example.app] > [MainActivity] を開きます。AuthenticationMode を .USER_AUTH に設定します。

MainActivity.kt

class MainActivity : ComponentActivity() {
    private enum class AuthenticationMode { API_KEY, USER_AUTH }

    //追加開始
    private val authenticationMode = AuthenticationMode.USER_AUTH
    //追加終了

clientID と redirectURL の値を設定します。認証の設定ステップのユーザー認証パートでアプリに提供した RedirectURL を使用する必要があります。

MainActivity.kt

            AuthenticationMode.USER_AUTH -> {
                authenticatorState.oAuthUserConfiguration = OAuthUserConfiguration(
                    portalUrl = "https://www.arcgis.com",

                    //追加開始
                    clientId = "YOUR_CLIENT_ID",
                    redirectUrl = "YOUR_REDIRECT_URL"
                    //追加終了
                )

[app] > [manifests] > [AndroidManifest.xml] を開きます。
android:scheme と android:hostは、RedirectURL の scheme と host を使って設定します。
RedirectURL は scheme と host コンポーネントで構成されます。リダイレクト URL のフォーマットは scheme://host です。たとえば、リダイレクト URL が myscheme://myhost の場合、スキームは myscheme、ホストは myhost となります。

AndroidManifest.xml

            <category android:name="android.intent.category.BROWSABLE" />

            <!--追加開始-->
            <data
                android:scheme="your_redirect_url_scheme"
                android:host="your_redirect_url_host" />
            <!--追加終了-->

        </intent-filter>

アプリを実行する

[Run] > [Run] > [app] をクリックしてアプリを実行します。

カリフォルニア州サンタモニカ山脈を中心とした地形ベースマップレイヤーの地図が表示されるはずです。マップビューをピンチ、ドラッグ、ダブルタップしてマップを探索します。

次のチュートリアル

これらのチュートリアルでは、追加の API 機能、ArcGIS ロケーションサービス、および ArcGIS ツールの使用方法について説明します。(英語ページ)

Android

マップを表示する

前提条件

認証の設定

API キー認証

ユーザー認証

開発またはダウンロード

オプション 1:コードを開発する

新しい Android Studio プロジェクトを作成する

マップを作成する

マップを保持する MainScreen を作成する

MainActivity クラス内で MainScreen を呼び出す

開発者認証情報を設定する

API キーでの認証

ユーザー認証

アプリを実行する

Android デバイス

Android エミュレーター

デバイスの選択

オプション 2:完成したソリューションをダウンロードする

ソリューションに開発者認証情報を設定する

API キー認証

ユーザー認証

アプリを実行する

次のチュートリアル