Skjölun / Uppsetning / iOS / TomTom

Uppsetning á TomTom

Hvernig stýra má TomTom Orbis Maps gegnum MapConductor. iOS-þjónustuaðilinn jafnast á við þann fyrir Android eiginleika fyrir eiginleika: merki, fjöllínu, marghyrning, hring, jarðmynd, rasterlag og upplýsingablöðru.

PACKAGE
ios-for-tomtom
API KEY
Nauðsynlegt
MIN iOS
16.0
VIEW
TomTomMapView
Sami þjónustuaðili, aðrir vettvangarAndroidReact

Áður en þú byrjar

Xcode 15 eða nýrra
TomTom Orbis Maps-API-lykill úr Developer Portal
Útgáfumarkmið iOS 16.0 eða síðar
STEP 01

Fáðu API-lykil

Gefðu út API-lykil fyrir Orbis Maps í TomTom Developer Portal.

STEP 02

Bættu við dreifingaruppsprettu TomTom

TomTom Orbis Maps Display SDK er dreift sem tvíundar-xcframework frá Artifactory TomTom. Pakki MapConductor vísar í þau sem tvíundarmarkmið, svo bættu uppsprettu TomTom við Podfile forritsins þíns.

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

Bættu því við með Swift Package Manager

Notaðu File > Add Package Dependencies í Xcode og límdu inn slóð pakkans.

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

Komdu API-lyklinum til skila

Sendu hann með hverri sýn, eða settu hann í 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>

STAÐFESTA

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

Uppsetningunni er lokið þegar kortið og merki þess teiknast — og merki sem má draga er hægt að draga.

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
            ))
        }
    }
}

Kortahönnun

TomTomMapDesign varpast á staðalstíla Orbis Maps.

TomTomMapDesign
Notes
Standard
Staðlaði skoðunarstíllinn
Driving
Sniðið að akstri
Satellite
Gervihnattamyndir

Bilanaleit

Kortið helst autt

  • Athugaðu hvort apiKey sýnarinnar eða TomTomAPIKey í Info.plist beri gildi.
  • Athugaðu að útgáfumarkmiðið sé iOS 16.0 eða síðar.

xcframework-skrárnar finnast ekki

  • TomTom-SDK-ið er tvíundardreifing — staðfestu að þú hafir bætt uppsprettu TomTom við Podfile.

Smíðin bregst

  • Hreinsaðu smíðamöppuna (Cmd+Shift+K).
  • Eyddu ~/Library/Developer/Xcode/DerivedData og smíðaðu aftur.
  • Endurnýjaðu viðföngin í Swift Package Manager, og forðastu að blanda CocoaPods saman við.

Næst

TomTom hefur engan innbyggðan merkjadrátt, svo MapConductor útfærir hann með eigin bendingagreini á MapView. Aðdrátturinn er umreiknaður á Google-jafngildan kvarða út frá breiddargráðu myndavélarinnar.