दस्तावेज़ / सेटअप / iOS / Mappls

Mappls का सेटअप

MapConductor से Mappls (MapmyIndia) के आधिकारिक iOS SDK का उपयोग करने के चरण। इसे Swift Package Manager के माध्यम से जोड़ें, और प्रमाणीकरण ऐप में रखी गई कॉन्फ़िगरेशन फ़ाइल के माध्यम से किया जाता है।

MODULE
MapConductorForMappls
API KEY
आवश्यक
VIEW
MapplsMapView
TIME
15 मिनट
वही प्रोवाइडर, दूसरे प्लेटफ़ॉर्मAndroidReact

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

Xcode 15 या इससे ऊपर
iOS 16.0 या इससे ऊपर को लक्षित करने वाला ऐप
Mappls (MapmyIndia) का खाता और क्रेडेंशियल्स
STEP 01

क्रेडेंशियल्स प्राप्त करें

Mappls डेवलपर कंसोल पर ऐप रजिस्टर करें और क्रेडेंशियल्स प्राप्त करें। iOS में .i.conf / .i.olf नामक कॉन्फ़िगरेशन फ़ाइल से प्रमाणीकरण होता है। एक API कुंजी पास करने की विधि नहीं है।

STEP 02

पैकेज जोड़ें

Mappls के वितरण रिपॉजिटरी और MapConductor मॉड्यूल को Swift Package Manager से जोड़ें।

Package.swiftSwift
dependencies: [
    .package(url: "https://github.com/mappls-api/mappls-map-ios-distribution.git", from: "6.1.5"),
    .package(url: "https://github.com/MapConductor/ios-sdk-core", from: "1.3.1"),
    .package(url: "https://github.com/MapConductor/ios-for-mappls", from: "1.0.0"),
]
STEP 03

प्रमाणीकरण फ़ाइल रखें

Mappls से प्राप्त .i.conf / .i.olf को ऐप बंडल में शामिल करें। MapConductor मैप बनाने से पहले इसे लोड करता है। फ़ाइल को स्रोत नियंत्रण में न रखें।

जाँच

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

दिल्ली को केंद्र में रखकर मैप प्रदर्शित करें। टाइल्स लोड हो जाने पर पूर्ण हो जाएगा।

import SwiftUI
import MapConductorCore
import MapConductorForMappls

struct TestMappls: View {
    @StateObject private var state = MapplsViewState(
        mapDesignType: MapplsDesign.Default,
        cameraPosition: MapCameraPosition(
            position: GeoPoint(latitude: 28.6139, longitude: 77.2090),
            zoom: 11
        )
    )

    var body: some View {
        MapplsMapView(state: state)
    }
}

मैप डिज़ाइन

Notes
Default
अनुबंध के बावजूद उपयोग करने योग्य डिफ़ॉल्ट शैली
StandardDay
मानक दिन की शैली
StandardNight / GreyDay
अतिरिक्त शुल्क वाला सशुल्क विकल्प। अनुबंध न होने पर SDK इसे अस्वीकार कर देगा

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

मैप पूरी तरह सफेद है और कोई भी टाइल नहीं आ रही है

  • जांचें कि क्या क्रेडेंशियल्स मैप जनरेशन से पहले सेट हैं।
  • Mappls कंसोल पर जांचें कि क्या कुंजी मान्य है और उपयोग सीमा से अधिक तो नहीं है।
  • जांचें कि क्या डिवाइस नेटवर्क तक पहुंच सकता है।

शैली बदलने पर style not found हो रहा है

  • StandardNight और GreyDay अतिरिक्त शुल्क वाले सशुल्क विकल्प हैं। यदि आपने अनुबंध नहीं किया है, तो कृपया Default या StandardDay का उपयोग करें।

रास्टर लेयर आदि, Mappls के अलावा URL वाली टाइल्स नहीं आ रही हैं

  • Mappls का नेटिव HTTP लेयर, वे अनुरोधों को छोड़ता या काटता है जिनके URL में mappls / mapmyindia शामिल नहीं है। MapConductor इसे बायपास कर चुका है, लेकिन यदि आप SDK के HTTP मॉड्यूल को स्वयं बदल रहे हैं, तो बायपास भी हट जाता है।

आगे

मार्कर, पॉलीलाइन, पॉलीगन, सर्कल, ग्राउंड इमेज, रास्टर लेयर और InfoBubble का उपयोग सामान्य API के माध्यम से किया जा सकता है।