Skjölun / Uppsetning / Android / TomTom

Uppsetning á TomTom

Hvernig stýra má TomTom Orbis Maps Display SDK gegnum MapConductor: bættu við Maven-safni TomTom og sendu API-lykilinn gegnum lýsinguna.

MODULE

com.mapconductor:for-tomtom

API KEY

Nauðsynlegt

VIEW

TomTomMapView

TIME

15 mín

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

Skoða sýnidæmiVerslanakort · React ↗

Áður en þú byrjar

Android-þróunarumhverfi (Android Studio)

Aðgangur að TomTom Developer Portal og API-lykill fyrir Orbis Maps

STEP 01

Fáðu API-lykil

Gefðu út API-lykil fyrir Orbis Maps í TomTom Developer Portal.

STEP 02

Bættu við TomTom-safninu

settings.gradle.ktsKotlin

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

        // TomTom Orbis Maps SDK repository
        maven {
            url = uri("https://repositories.tomtom.com/artifactory/maven")
        }
    }
}

STEP 03

Bættu við viðföngunum

app/build.gradle.ktsKotlin

dependencies {
    // TomTom Orbis Maps Display SDK
    implementation("com.tomtom.sdk.maps:map-display-standard:2.4.2")

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

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

STEP 04

Settu lykilinn í lýsinguna

AndroidManifest.xmlXML

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

    <application>
        <meta-data
            android:name="TOMTOM_API_KEY"
            android:value="${TOMTOM_API_KEY}" />
    </application>
</manifest>

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 05

Athugaðu þemað þitt

Yfirlög TomTom í viðmótinu (merki, áttaviti) gera ráð fyrir þema úr AppCompat-fjölskyldunni. Önnur þemu teiknast áfram, en skrá viðvörun — veldu frekar Theme.AppCompat eða Theme.MaterialComponents.

STAÐFESTA

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

Uppsetningunni er lokið þegar kortið og merki þess teiknast.

TestTomTom.ktJetpack Compose

@Composable
fun TestTomTom(modifier: Modifier = Modifier) {
    val mapState = rememberTomTomMapViewState(
        mapDesign = TomTomMapDesign.Standard,
        cameraPosition = MapCameraPosition(
            position = GeoPoint(52.3676, 4.9041),
            zoom = 11.0,
        ),
    )

    TomTomMapView(state = mapState, modifier = modifier) {
        Marker(
            MarkerState(
                position = GeoPoint(52.3676, 4.9041),
                icon = DefaultMarkerIcon().copy(label = "Amsterdam"),
            ),
        )
    }
}

Kortahönnun

TomTomMapDesign varpast á staðalstíla Orbis Maps.

TomTomMapDesign

Notes

Standard

Staðlaði skoðunarstíllinn

Driving

Sniðið að akstri

Satellite

Gervihnattamyndir

Bilanaleit

Kortið teiknast á röngum stað

MapConductor sendir MapOptions(renderToTexture = true) af því sjálfgefna SurfaceView-leiðin rekst á mælingar SubcomposeLayout í Compose. Ef þú býrð MapOptions til sjálf/ur skaltu halda þeirri stillingu.

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

Merki, fjöllínur, marghyrningar, hringir, jarðmyndir, rasterlög og upplýsingablöðrur virka öll gegnum sameiginlega API-ið. TomTom hefur engan innbyggðan merkjadrátt, svo MapConductor útfærir hann með því að meðhöndla MotionEvent beint — merki sem má draga virka einfaldlega.