दस्तावेज़ / सेटअप / Android / Longdo

Longdo का सेटअप

MapConductor से Longdo Map API3 SDK का उपयोग करने की प्रक्रिया। थाईलैंड के नक्शे के लिए एक मजबूत प्रदाता, और इसे Longdo के स्वयं के Maven रिपॉजिटरी से प्राप्त किया जाता है।

MODULE

com.mapconductor:for-longdo

API KEY

आवश्यक

VIEW

LongdoMapView

TIME

15 मिनट

वही प्रोवाइडर, दूसरे प्लेटफ़ॉर्मiOS React

डेमो देखेंस्टोर मैप · React ↗

शुरू करने से पहले

Android विकास वातावरण (Android Studio)

Longdo Map कंसोल पर जारी किया गया API कुंजी

STEP 01

API कुंजी प्राप्त करें

Longdo Map कंसोल पर एक कुंजी जारी करें। SDK सत्यापन के लिए ऐप के पैकेज नाम भेजता है, इसलिए कुंजी को उस पैकेज नाम से जोड़कर पंजीकृत करना आवश्यक है।

STEP 02

Longdo का रिपॉजिटरी जोड़ें

settings.gradle.ktsKotlin

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

        // Longdo Map API3 SDK repository
        maven {
            url = uri("https://maven.longdo.com/artifactory/libs-release-public")
        }
    }
}

STEP 03

निर्भरता जोड़ें

app/build.gradle.ktsKotlin

dependencies {
    // Longdo Map API3 SDK
    implementation("com.longdo.map:sdk3:1.3.0")

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

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

STEP 04

API कुंजी पास करें

मॉड्यूल मेनिफेस्ट के longdo.map.key को पढ़ता है। कोड से भी कॉन्फ़िगर किया जा सकता है।

AndroidManifest.xmlXML

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

    <application>
        <meta-data
            android:name="longdo.map.key"
            android:value="${LONGDO_API_KEY}" />
    </application>
</manifest>

MainActivity.ktKotlin

// Alternative: set it in code before the first map is shown
com.longdo.sdk3.LongdoMap.API_KEY = "YOUR_LONGDO_API_KEY"

सावधानी

secrets.properties को वर्जन नियंत्रण में कमिट न करें। इसे .gitignore में जोड़ने से दुर्घटनाओं को रोका जा सकता है। CI में इसे पर्यावरण चर आदि के माध्यम से अलग सुरक्षित मार्ग से पारित किया जाता है।

जाँच

आपको क्या दिखना चाहिए

बैंकॉक को केंद्र में रखकर नक्शा प्रदर्शित होने पर पूर्ण हो जाता है।

TestLongdo.ktJetpack Compose

@Composable
fun TestLongdo(modifier: Modifier = Modifier) {
    val mapState = rememberLongdoMapViewState(
        mapDesign = LongdoDesign.Normal,
        cameraPosition = MapCameraPosition(
            position = GeoPoint(13.7563, 100.5018),
            zoom = 12.0,
        ),
    )

    LongdoMapView(
        state = mapState,
        modifier = modifier,
        onMapLoaded = { /* map ready */ },
        onMapClick = { point -> /* tapped at point */ },
    )
}

मैप डिज़ाइन

LongdoDesign Longdo के बेस लेयर का समर्थन करता है।

LongdoDesign

Notes

Normal / Easy / Political

मानक शैलियाँ

Pastel / PastelGray / Light / Gray

हल्की शैली

Night / Dark / Hard

डार्क, हाई कंट्रास्ट

Satellite / Hybrid

उपग्रह छवि और हाइब्रिड

Osm

OpenStreetMap आधारित

समस्या निवारण

नक्शा प्रदर्शित नहीं हो रहा है

कंसोल में जांचें कि कुंजी ऐप के पैकेज नाम से जुड़ी है या नहीं। SDK सत्यापन के लिए पैकेज नाम भेजता है।
जांचें कि INTERNET अनुमति दी गई है या नहीं।

बिल्ड विफल हो रहा है

नक्शा SDK के निर्देशांक और संस्करण वर्जन कैटलॉग की विनिर्देश के साथ मेल खाते हैं या नहीं, इसकी जांच करें।
settings.gradle.kts में रिपॉजिटरी परिभाषा है या नहीं, इसकी जांच करें (यदि repositoriesMode FAIL_ON_PROJECT_REPOS है, तो मॉड्यूल की repositories को नजरअंदाज कर दिया जाएगा)।
यदि आप एक साथ कई नक्शा SDK का उपयोग कर रहे हैं, तो ./gradlew :app:dependencies के साथ किसी भी निर्भरता संघर्ष की जांच करें।

आगे

मार्कर, पॉलीलाइन, पॉलीगॉन, सर्कल, ग्राउंड इमेज, रास्टर लेयर और InfoBubble सभी एक सामान्य API के साथ उपयोग किए जा सकते हैं। Longdo का Android SDK Longdo Map JS API3 को WebView में चलाने वाला कॉन्फ़िगरेशन है, इसलिए आकृतियाँ आंतरिक MapLibre GL में GeoJSON स्रोत और fill / line लेयर के रूप में जोड़ी जाती हैं। हिट टेस्ट कोर पक्ष की जियोडेसिक संगत निर्धारण द्वारा संभाला जाता है।