コンテンツにスキップ
MapConductor

ArcGIS Maps セットアップ

このセクションでは、ArcGIS Maps SDK と MapConductor を統合するためのセットアップ手順について説明します。

前提条件

Section titled “前提条件”
  • Android 開発環境
  • ArcGIS 開発者アカウント
  • ArcGIS API キー

セットアップ手順

Section titled “セットアップ手順”

1. ArcGIS Developer Dashboard の設定

Section titled “1. ArcGIS Developer Dashboard の設定”
  1. ArcGIS Developer アカウントにサインアップします
  2. ArcGIS Developer Dashboardにアクセスします
  3. 新しいアプリケーションを作成するか、既存のものを選択します
  4. 適切なスコープで API キーを生成します
  5. アプリで使用するために API キーをメモします

2. Gradle の設定

Section titled “2. Gradle の設定”

Esri リポジトリが設定されていることを確認します（このリポジトリの settings.gradle.kts には既に含まれています）:

settings.gradle.kts
dependencyResolutionManagement {
    repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS)
    repositories {
        google()
        mavenCentral()


        // Esri public repository for ArcGIS Maps SDK
        maven {
            url = uri("https://esri.jfrog.io/artifactory/arcgis")
        }
    }
}

プロジェクトのルート build.gradle.kts または build.gradle に Secrets Gradle Plugin を追加します:

// (root)/build.gradle.kts
plugins {
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin") version "2.0.1" apply false
}

次に、アプリの build.gradle.kts または build.gradle に依存関係を追加し、プラグインを適用します:

App/build.gradle.kts
plugins {
    // ... other plugins
    id("com.google.android.libraries.mapsplatform.secrets-gradle-plugin")
}


dependencies {
    // ArcGIS Maps SDK (version managed via libs.versions.toml)
    implementation(platform(libs.arcgis.maps.kotlin.toolkit.bom))
    implementation(libs.arcgis.maps.kotlin)
    implementation(libs.arcgis.maps.kotlin.toolkit.geoview.compose)
    implementation(libs.arcgis.maps.kotlin.toolkit.authentication)


    // MapConductor BOM for version management (v1.1.2)
    implementation(platform("com.mapconductor:mapconductor-bom:1.1.2"))


    // MapConductor modules (versions managed by BOM)
    implementation("com.mapconductor:core")
    implementation("com.mapconductor:for-arcgis")
}

Secrets Gradle Plugin は secrets.properties ファイルを読み取り、ビルド時に値を AndroidManifest.xml に注入できます。

3. Android Manifest の設定

Section titled “3. Android Manifest の設定”

AndroidManifest.xml に ArcGIS API キーのプレースホルダーを追加します:

AndroidManifest.xml
<application>
    <!-- ArcGIS API Key -->
    <meta-data
        android:name="ARCGIS_API_KEY"
        android:value="${ARCGIS_API_KEY}" />


    <!-- Add internet and location permissions -->
    <uses-permission android:name="android.permission.INTERNET" />
    <uses-permission android:name="android.permission.ACCESS_COARSE_LOCATION" />
    <uses-permission android:name="android.permission.ACCESS_FINE_LOCATION" />
</application>

4. API キーの設定

Section titled “4. API キーの設定”

secrets.properties ファイルに実際の API キーを追加します。 Secrets Gradle Plugin は、このファイルの実際の値で AndroidManifest.xml の ${ARCGIS_API_KEY} を自動的に置き換えます。

secrets.properties
ARCGIS_API_KEY=your_actual_arcgis_api_key_here

5. ライセンスの設定

Section titled “5. ライセンスの設定”

ArcGIS SDK は適切なライセンス設定が必要です。アプリケーションでライセンスを設定します:

// In your Application class or MainActivity
// ArcGISEnvironment.setLicense("your_license_key_here") // Optional for basic use

検証

Section titled “検証”

ArcGIS のセットアップを確認するには:

  1. アプリをビルドして実行します
  2. ArcGIS マップが正しく表示されることを確認します
  3. GIS 固有の機能をテストします（使用している場合）
  4. 認証が機能していることを確認します
@Composable
fun TestArcGIS() {
    val state = rememberArcGISMapViewState(
        cameraPosition =
            MapCameraPositionImpl(
                position = GeoPointImpl.fromLatLong(0.0, 0.0),
                zoom = 5.0,
            ),
    )


    ArcGISMapView(
        modifier = modifier,
        state = state,
    ) {
        // もし地図が表示されれば、セットアップが正しくできています
    }
}

TestArcGISの実行結果

トラブルシューティング

Section titled “トラブルシューティング”

よくある問題

Section titled “よくある問題”

マップが読み込まれない

  • secrets.properties の API キーが正しいことを確認してください
  • API キーが ArcGIS Dashboard で適切なスコープを持っていることを確認してください

ライセンスエラー

  • 本番アプリの場合は、Esri のドキュメントに従って適切なライセンスを設定してください

ビルドエラー

  • ArcGIS SDK の座標がプロジェクト設定と一致していることを確認してください
  • BOM がバージョン管理に使用されていることを確認してください
  • Compose ツールキットの依存関係が含まれていることを確認してください

次のステップ

Section titled “次のステップ”

ArcGIS Maps SDK が適切に設定されたら、統一 API を使用して MapConductor の ArcGISMapView コンポーネントを使用できます。