Skjölun / Uppsetning / Android / ArcGIS

Uppsetning á ArcGIS

Hvernig stýra má ArcGIS Maps SDK for Kotlin gegnum MapConductor: bættu við Esri-safninu og sendu API-lykilinn gegnum lýsinguna. Bæði 2D- og 3D-sýn eru í boði.

MODULE

com.mapconductor:for-arcgis

API KEY

Nauðsynlegt

VIEW

ArcGISMapView / 2D

TIME

20 mín

Sami þjónustuaðili, aðrir vettvangariOS React

Skoða sýnidæmiVerslanakort · React ↗

Áður en þú byrjar

Android-þróunarumhverfi (Android Studio)

ArcGIS-forritaraaðgangur

ArcGIS-API-lykill

STEP 01

Fáðu API-lykil

Stofnaðu ArcGIS-forritaraaðgang.
Opnaðu ArcGIS Developer Dashboard.
Búðu til forrit og gefðu út API-lykil með þeim sviðum sem þú þarft.

STEP 02

Bættu við Esri-safninu

settings.gradle.ktsKotlin

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")
        }
    }
}

STEP 03

Bættu við Secrets Gradle Plugin

Þannig helst lykillinn utan við útgáfustýringu: viðbótin les secrets.properties og setur gildið inn í staðgengilinn í AndroidManifest.xml við smíði.

(root)/build.gradle.ktsKotlin

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

STEP 04

Bættu við viðföngunum

ArcGIS hefur sitt eigið BOM, og Compose-verkfærakistueiningarnar eru líka nauðsynlegar.

app/build.gradle.ktsKotlin

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

dependencies {
    // ArcGIS Maps SDK
    implementation(platform("com.esri:arcgis-maps-kotlin-toolkit-bom:300.1.0"))
    implementation("com.esri:arcgis-maps-kotlin:300.1.0")
    implementation("com.esri:arcgis-maps-kotlin-toolkit-geoview-compose")
    implementation("com.esri:arcgis-maps-kotlin-toolkit-authentication")

    // MapConductor BOM pins every module below
    implementation(platform("com.mapconductor:mapconductor-bom:1.3.1"))

    implementation("com.mapconductor:core")
    implementation("com.mapconductor:for-arcgis")
}

STEP 05

Tengdu lýsinguna og lykilinn

AndroidManifest.xmlXML

<manifest>
    <!-- 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>
        <!-- ArcGIS API Key -->
        <meta-data
            android:name="ARCGIS_API_KEY"
            android:value="${ARCGIS_API_KEY}" />
    </application>
</manifest>

secrets.propertiesProperties

ARCGIS_API_KEY=your_actual_arcgis_api_key_here

VARÚÐ

Aldrei skila secrets.properties inn í útgáfustýringu. Bættu henni við .gitignore svo hún geti ekki laumast með, og komdu gildinu til skila gegnum umhverfisbreytur (eða aðra örugga leið) í CI.

STEP 06

Stilltu leyfið (aðeins fyrir raunnotkun)

Óþarft fyrir einfalda kortabirtingu. Fyrir raunnotkun skaltu setja leyfið eins og skjölun Esri lýsir.

MainActivity.ktKotlin

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

STAÐFESTA

Það sem þú ættir að sjá

Þú ert búin/n þegar ArcGIS-kortið teiknast og aðdráttur, hliðrun og — á 3D-sýninni — halli virka.

TestArcGIS.ktJetpack Compose

@Composable
fun TestArcGIS(modifier: Modifier = Modifier) {
    val mapState = rememberArcGISMapViewState(
        cameraPosition = MapCameraPosition(
            position = GeoPoint(35.6762, 139.6503),
            zoom = 12.0,
        ),
    )

    // If the map appears, the setup is correct.
    // ArcGISMapView is the 3D scene view; ArcGISMapView2D shares the same state.
    ArcGISMapView(modifier = modifier, state = mapState)
}

Kortahönnun

ArcGISDesign varpast á grunnkort Esri. Listinn hér að neðan er úrval — gerðin kemur með mun fleiri.

ArcGISDesign

Notes

Streets

Staðlaða götukortið

Imagery

Gervihnattamyndir

Topographic

Landslagskort

OsmStandard

Staðalstíll OpenStreetMap

NavigationNight

Næturleiðsögn

DarkGray / LightGray

Daufir stílar ætlaðir sem bakgrunnur fyrir þín eigin gögn

Bilanaleit

Kortið hleðst aldrei

Athugaðu API-lykilinn í secrets.properties.
Staðfestu í Dashboard að lykillinn beri tilskilin svið.

Leyfisvilla birtist

Fyrir raunnotkun skaltu setja upp leyfið eins og skjölun Esri lýsir.

Smíðin bregst

Athugaðu hvort hnit og útgáfa korta-SDK-sins passi við það sem útgáfuskráin lýsir.
Gakktu úr skugga um að safnið sé skilgreint í settings.gradle.kts — með repositoriesMode stillt á FAIL_ON_PROJECT_REPOS eru repositories-blokkir í einstökum einingum hunsaðar.
Ef fleiri en eitt korta-SDK er til staðar í einu, leitaðu að árekstrum viðfanga með ./gradlew :app:dependencies.

Næst

ArcGISMapView er 3D-sýnin og ArcGISMapView2D sú tvívíða. Þær deila stöðuhlut, svo þú getur skipt á milli þeirra á keyrslutíma.