Skjölun / Uppsetning / iOS / MapTiler

Uppsetning á MapTiler

Hvernig teikna má stíla MapTiler Cloud gegnum MapConductor. iOS-þjónustuaðilinn teiknar með MapLibre Native og leyfir þér að velja viðmiðunarstíla MapTiler eftir heiti.

PACKAGE
ios-for-maptiler
API KEY
Nauðsynlegt
MIN iOS
15.1
VIEW
MapTilerMapView
Sami þjónustuaðili, aðrir vettvangarAndroidReact

Áður en þú byrjar

Xcode 15 eða nýrra
MapTiler Cloud-aðgangur og API-lykill
Útgáfumarkmið iOS 15.1 eða síðar
STEP 01

Fáðu API-lykil

Gefðu út API-lykil úr stjórnborði MapTiler Cloud. Þar er ókeypis þrep.

STEP 02

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

Notaðu File > Add Package Dependencies í Xcode og límdu inn slóð pakkans. MapLibre Native, sem sér um teiknunina, kemur sjálfkrafa með.

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

Komdu API-lyklinum til skila

Sendu hann með hverri sýn, eða settu hann í Info.plist — plist-in er varaleiðin þegar apiKey sýnarinnar er nil. Þetta speglar það hvernig Android-einingin les MAPTILER_API_KEY úr lýsingunni.

ContentView.swiftSwift
// Per view
MapTilerMapView(state: mapViewState, apiKey: "YOUR_MAPTILER_API_KEY")
Info.plistXML
<!-- Fallback, used when the view's apiKey is nil -->
<key>MapTilerAPIKey</key>
<string>YOUR_MAPTILER_API_KEY</string>
VARÚÐ
Í stað þess að harðkóða lykilinn skaltu skjóta honum inn við smíði úr xcconfig eða umhverfisbreytu.

STAÐFESTA

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

Uppsetningunni er lokið þegar kortið og merki þess teiknast.

ContentView.swiftSwiftUI
import SwiftUI
import MapConductorCore
import MapConductorForMapTiler

struct ContentView: View {
    @StateObject private var mapViewState = MapTilerViewState(
        cameraPosition: MapCameraPosition(
            position: GeoPoint(latitude: 35.6762, longitude: 139.6503),
            zoom: 11
        )
    )

    var body: some View {
        MapTilerMapView(state: mapViewState) {
            Marker(
                position: GeoPoint(latitude: 35.6762, longitude: 139.6503),
                icon: DefaultMarkerIcon(label: "Tokyo")
            )
        }
    }
}

Kortahönnun

MapTilerDesign nær yfir viðmiðunarstíla MapTiler Cloud.

MapTilerDesign
Notes
Streets / StreetsDark / StreetsLight
Staðlaða vegakortið auk ljósra og dökkra afbrigða
Basic / Bright
Einfaldaðir stílar
Satellite
Gervihnattamyndir
Outdoor / Winter / Topo
Útivist, vetur og landslag
Toner / Dataviz / Backdrop
Bakgrunnar fyrir þín eigin gögn
Ocean / Landscape / Aquarelle / OpenStreetMap
Fleiri stílar eftir þema

Bilanaleit

Kortið helst autt

  • Athugaðu hvort apiKey sýnarinnar eða MapTilerAPIKey í Info.plist beri raunverulega gildi.
  • Staðfestu að lykillinn sé virkur í MapTiler Cloud og að þú sért innan kvótans.

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

Þar sem iOS-þjónustuaðilinn teiknar með MapLibre Native virka merki, marghyrningar og önnur yfirlög öll gegnum sameiginlega API-ið.