Skjölun / Uppsetning / Android / Mappls

Uppsetning á Mappls

Hvernig stýra má opinbera Android-SDK Mappls (MapmyIndia) gegnum MapConductor. Auðkenningin fer fram gegnum stillingaskrár sem þú kemur fyrir í forritinu.

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

Áður en þú byrjar

Android-þróunarumhverfi (Android Studio)
Mappls (MapmyIndia)-aðgangur og auðkenni
STEP 01

Náðu í auðkennin þín

Skráðu forritið þitt í forritarastjórnborði Mappls og náðu í auðkenni þess. Mappls auðkennir ekki með einum API-lykli eins og hinir þjónustuaðilarnir: það les stillingaskrár (.a.conf / .a.olf) sem þú kemur fyrir í forritinu.

STEP 02

Bættu við safninu

Mappls-SDK-ið er ekki á Maven Central; það kemur úr safni Mappls sjálfs.

settings.gradle.ktsKotlin
dependencyResolutionManagement {
    repositories {
        google()
        mavenCentral()
        maven { url = uri("https://maven.mappls.com/repository/mappls/") }
    }
}
STEP 03

Bættu við viðföngunum

Bættu við Mappls-SDK-inu og einingum MapConductor. BOM-ið festir útgáfurnar.

app/build.gradle.ktsKotlin
dependencies {
    // Mappls Android SDK
    implementation("com.mappls.sdk:mappls-android-sdk:9.0.3")

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

    implementation("com.mapconductor:core")
    implementation("com.mapconductor:compose")
    implementation("com.mapconductor:for-mappls")
}
STEP 04

Tengdu auðkenninguna

Komdu .a.conf / .a.olf skránum sem þú fékkst frá Mappls fyrir í forritinu og beittu Gradle-viðbót Mappls (com.mappls.services.android). MapConductor les ekki auðkenni Mappls úr lýsingunni: Mappls-SDK-ið verður að vera frumstillt á sinn eigin hátt áður en fyrsta kortið verður til. Haltu þessum skrám utan við útgáfustýringu.

STAÐFESTA

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

Sýndu kort miðað á Delhi. Hlaðist flísarnar ertu búin/n.

@Composable
fun TestMappls(modifier: Modifier = Modifier) {
    val mapState = rememberMapplsMapViewState(
        mapDesign = MapplsDesign.Default,
        cameraPosition = MapCameraPosition(
            position = GeoPoint(latitude = 28.6139, longitude = 77.2090),
            zoom = 11.0,
        ),
    )

    MapplsMapView(state = mapState, modifier = modifier.fillMaxSize())
}

Kortahönnun

Notes
Default
Sjálfgefni stíllinn, í boði á hvaða áskrift sem er
StandardDay
Staðlaði dagstíllinn
StandardNight / GreyDay
Greiddar viðbætur. Án réttindanna hafnar SDK-ið þeim

Bilanaleit

Kortið er autt og engar flísar berast

  • Athugaðu að auðkennin séu sett áður en fyrsta kortið verður til.
  • Staðfestu að lykillinn sé virkur í stjórnborði Mappls og að þú sért innan kvótans.
  • Staðfestu að tækið komist á netið.

Skipti um stíl skila „style not found“

  • StandardNight og GreyDay eru greiddar viðbætur. Án réttindanna skaltu nota Default eða StandardDay.

Rasterlög frá vefslóðum utan Mappls teiknast ekki

  • Innbyggða HTTP-lag Mappls hendir eða styttir beiðnir þar sem vefslóðin inniheldur hvorki mappls né mapmyindia. MapConductor kemst fram hjá þessu; skiptir þú HTTP-einingu SDK-sins út sjálf/ur fellur sú lausn niður.

Næst

Merki, fjöllínur, marghyrningar, hringir, jarðmyndir, rasterlög og upplýsingablöðrur virka öll gegnum sameiginlega API-ið. Skipti um þjónustuaðila breyta ekki kóða forritsins þíns.