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

TomTom का सेटअप

MapConductor से TomTom Orbis Maps का उपयोग करने की प्रक्रिया। Android संस्करण के समान सुविधाएं हैं, और यह Marker, Polyline, Polygon, Circle, GroundImage, RasterLayer, और InfoBubble का समर्थन करता है।

PACKAGE
ios-for-tomtom
API KEY
आवश्यक
MIN iOS
16.0
VIEW
TomTomMapView
वही प्रोवाइडर, दूसरे प्लेटफ़ॉर्मAndroidReact

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

Xcode 15 या इससे ऊपर
TomTom Developer Portal से Orbis Maps API कुंजी
डिप्लॉय टार्गेट iOS 16.0 या इससे ऊपर
STEP 01

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

TomTom Developer Portal पर Orbis Maps के लिए API कुंजी जारी करें।

STEP 02

TomTom SDK के स्रोत को जोड़ें

TomTom Orbis Maps Display SDK बाइनरी xcframework के रूप में TomTom के Artifactory से वितरित किया जाता है। MapConductor का पैकेज इसे बाइनरी टार्गेट के रूप में संदर्भित करता है, इसलिए ऐप के Podfile में TomTom का स्रोत जोड़ा जाता है।

PodfileRuby
source 'https://api.tomtom.com/maps-sdk-ios/cocoapods'
STEP 03

Swift Package Manager से जोड़ें

Xcode के File > Add Package Dependencies से पैकेज URL दर्ज करें।

Package URLSwift Package Manager
https://github.com/MapConductor/ios-for-tomtom
Package.swiftSwift
dependencies: [
    .package(url: "https://github.com/MapConductor/ios-sdk-core", from: "1.3.1"),
    .package(url: "https://github.com/MapConductor/ios-for-tomtom", from: "1.0.0"),
],
targets: [
    .target(
        name: "YourApp",
        dependencies: [
            .product(name: "MapConductorCore", package: "ios-sdk-core"),
            .product(name: "MapConductorForTomTom", package: "ios-for-tomtom"),
        ]
    ),
]
STEP 04

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

प्रत्येक व्यू में पास करें या Info.plist में रखें।

ContentView.swiftSwift
// Per view
TomTomMapView(state: state, apiKey: "YOUR_TOMTOM_API_KEY")
Info.plistXML
<key>TomTomAPIKey</key>
<string>YOUR_TOMTOM_API_KEY</string>

जाँच

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

नक्शा और मार्कर दिखाई देने पर पूर्ण हो जाता है। draggable मार्कर सीधे ड्रैग किए जा सकते हैं।

ContentView.swiftSwiftUI
import SwiftUI
import MapConductorCore
import MapConductorForTomTom

struct ContentView: View {
    @StateObject var state = TomTomMapViewState(
        mapDesignType: TomTomMapDesign.Standard,
        cameraPosition: MapCameraPosition(
            position: GeoPoint(latitude: 52.3676, longitude: 4.9041),
            zoom: 11
        )
    )

    var body: some View {
        TomTomMapView(state: state) {
            Marker(state: MarkerState(
                position: GeoPoint(latitude: 52.3676, longitude: 4.9041),
                icon: DefaultMarkerIcon(label: "Amsterdam"),
                draggable: true
            ))
        }
    }
}

मैप डिज़ाइन

TomTomMapDesign Orbis Maps के मानक शैली का समर्थन करता है।

TomTomMapDesign
Notes
Standard
मानक देखने के लिए शैली
Driving
ड्राइविंग के लिए
Satellite
उपग्रह छवि

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

नक्शा सफेद रहता है

  • जांचें कि व्यू के apiKey या Info.plist के TomTomAPIKey में मान है या नहीं।
  • जांचें कि डिप्लॉय टार्गेट iOS 16.0 या इससे ऊपर है या नहीं।

xcframework नहीं मिला

  • TomTom का SDK बाइनरी वितरण है। जांचें कि क्या आपने Podfile में TomTom का स्रोत जोड़ा है।

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

  • बिल्ड फ़ोल्डर साफ़ करें (Cmd+Shift+K)।
  • ~/Library/Developer/Xcode/DerivedData को हटाएं और पुनः बिल्ड करें।
  • Swift Package Manager निर्भरता अपडेट करें। CocoaPods के साथ सहउपयोग से बचें।

आगे

TomTom में मार्कर के लिए नेटिव ड्रैग नहीं है, इसलिए MapConductor सीधे MapView के जेस्चर को संसाधित करके ड्रैग लागू करता है। ज़ूम कैमरे की अक्षांश को ध्यान में रखकर Google के समतुल्य परिवर्तित किया जाता है।