Skjölun / Uppsetning / Android / MapTiler

Uppsetning á MapTiler

Hvernig stýra má opinbera Android-SDK MapTiler (com.maptiler:maptiler-sdk-kotlin) gegnum MapConductor, og velja viðmiðunarstíla MapTiler Cloud eftir heiti.

MODULE
com.mapconductor:for-maptiler
API KEY
Nauðsynlegt
VIEW
MapTilerMapView
TIME
10 mín
Sami þjónustuaðili, aðrir vettvangariOSReact

Áður en þú byrjar

Android-þróunarumhverfi (Android Studio)
MapTiler Cloud-aðgangur og API-lykill
STEP 01

Fáðu API-lykil

Gefðu út API-lykil úr stjórnborði MapTiler Cloud. Þar er ókeypis þrep.

STEP 02

Bættu við viðföngunum

MapTiler-SDK-ið er fáanlegt frá Maven Central.

app/build.gradle.ktsKotlin
dependencies {
    // MapTiler Android SDK
    implementation("com.maptiler:maptiler-sdk-kotlin:2.1.0")

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

    implementation("com.mapconductor:core")
    implementation("com.mapconductor:for-maptiler")
}
STEP 03

Komdu API-lyklinum til skila

Einingin les lykilinn úr meta-data-færslu í lýsingunni — notaðu staðgengil ef þú beinir honum gegnum Secrets Gradle Plugin. Þú getur líka sett hann í kóða.

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

    <application>
        <meta-data
            android:name="MAPTILER_API_KEY"
            android:value="${MAPTILER_API_KEY}" />
    </application>
</manifest>
MainActivity.ktKotlin
// Alternative: set it in code before the first map is shown
com.maptiler.maptilersdk.MTConfig.apiKey = "YOUR_MAPTILER_API_KEY"
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.

STAÐFESTA

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

Veldu stíl og teiknaðu kortið. Hlaðist flísarnar ertu búin/n.

TestMapTiler.ktJetpack Compose
@Composable
fun TestMapTiler(modifier: Modifier = Modifier) {
    val mapState = rememberMapTilerMapViewState(
        mapDesign = MapTilerDesign.Streets,
        cameraPosition = MapCameraPosition(
            position = GeoPoint(35.6812, 139.7671),
            zoom = 11.0,
        ),
    )

    // If the map appears, the setup is correct.
    MapTilerMapView(state = mapState, modifier = modifier)
}

Kortahönnun

MapTilerDesign telur upp viðmiðunarstíla MapTiler Cloud óbreytta.

MapTilerDesign
Notes
Streets / StreetsDark / StreetsLight
Staðlaða vegakortið auk ljósra og dökkra afbrigða
Basic / Bright
Einfaldaðir stílar
Satellite
Gervihnattamyndir
Outdoor / Winter / Topo
Útivist, vetur og landslag
Toner / Dataviz / Backdrop
Bakgrunnar fyrir þín eigin gögn
Ocean / Landscape / Aquarelle / OpenStreetMap
Fleiri stílar eftir þema

Bilanaleit

Kortið helst autt

  • Athugaðu að MAPTILER_API_KEY í lýsingunni hafi raunverulega leyst upp í gildi.
  • Staðfestu að lykillinn sé virkur í MapTiler Cloud og að þú sért innan kvótans.
  • Staðfestu að INTERNET-heimildin sé til staðar.

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ð. Þar sem Android-SDK MapTiler keyrir MapLibre GL JS í WebView eru form sett inn í stílinn sem GeoJSON-uppsprettur með fill- og line-lögum — brúun eftir stystu leið og meðferð gata koma úr sameiginlega kjarnanum, svo útkoman stemmir við aðra þjónustuaðila.