Configurazione e demo

Utilizzare Swift Package Manager

1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se non hai familiarità con lo sviluppo per iOS, crea un nuovo progetto e seleziona l'app per iOS modello. Su Xcode 11.7 o versioni precedenti, crea un'applicazione a visualizzazione singola.
2. Aggiungi Maps SDK for iOS come dipendenza. Consulta Installa l'SDK per visualizzare le opzioni.
3. Nel progetto Xcode, vai a File -> Pacchetti Swift -> Aggiungi dipendenza pacchetto.
4. Nella finestra visualizzata, inserisci l'URL del repository della libreria di utilità di Maps SDK for iOS https://github.com/googlemaps/google-maps-ios-utils e seleziona Avanti.
• A questo punto ti potrebbe essere chiesto di autenticarti con il tuo account GitHub. Segui le istruzioni per creare GitHub token di accesso personale per continuare la procedura.
5. Nella finestra successiva, seleziona l'opzione di opzione Version (Versione) e scegli Up to Next Major Version. dall'elenco a discesa e inserisci la versione più recente della libreria di utilità di Maps SDK for iOS (ad esempio "6.0.0").
6. Fai clic sul menu a discesa accanto ad Aggiungi al progetto, seleziona il progetto e seleziona Aggiungi pacchetto.

Usa CocoaPods

1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo della macchina locale. Se non hai esperienza di sviluppo iOS, crea un Single Visualizza applicazione.)
2. Se non hai ancora un file del pod per il tuo progetto, crea un file denominato Podfile nella directory del progetto. Questo file definisce delle dipendenze del progetto.
3. Modifica il file del pod del progetto e aggiungi una dipendenza Google-Maps-iOS-Utils pod. Ecco un che include le dipendenze necessarie Maps SDK for iOS e la libreria di utilità:

   source 'https://github.com/CocoaPods/Specs.git'
   platform :ios, '15.0'
   
   target 'YOUR_APPLICATION_TARGET_NAME_HERE' do
     use_frameworks!
     pod 'GoogleMaps', '9.0.0'
     pod 'Google-Maps-iOS-Utils', '6.0.0' # x-release-please-version
   end

4. Esegui pod install.
5. Chiudi Xcode, quindi apri (doppio clic) la sezione .xcworkspace per avviare Xcode. D'ora in poi, devi usare il file .xcworkspace per aprire il progetto.

Nota: l'utilità di clustering degli indicatori dipende dalla quadtree, ma puoi utilizzarla senza clustering di indicatori. Se vuoi solo l'utilità quadtree, puoi modificare Da pod 'Google-Maps-iOS-Utils' a 'Google-Maps-iOS-Utils/QuadTree' nel file del pod.

Usa i file di GitHub

1. Scarica l'archivio degli esempi di codice GitHub e apri l'archivio.
2. Apri una finestra del terminale, passa alla directory in cui hai espanso i file di esempio e visualizza in dettaglio la directory di esempio appropriata per il linguaggio che vuoi utilizzare:
   • Per Swift, corri cd google-maps-ios-utils-master/samples/SwiftDemoApp
   • Per Objective-C, esegui cd google-maps-ios-utils-master/samples/ObjCDemoApp
3. Esegui questo comando:
   

   pod install

4. Chiudi Xcode, quindi apri (doppio clic) la sezione .xcworkspace per avviare Xcode. D'ora in poi, devi usare il file .xcworkspace per aprire il progetto.

Uso di CocoaPods v1.6.1

1. Apri una finestra del terminale e installa la versione 1.6.1:

   sudo gem install cocoapods -v1.6.1

2. Recupera i file di Google Maps utilizzando Cocoapods:

   pod try Google-Maps-iOS-Utils

   Quando richiesto, scegli Swift o Objective-C. CocoaPods aggiorna i repository delle tue specifiche, apre la demo in un progetto Xcode temporaneo denominato SwiftDemoApp.xcodeproj o ObjCDemoApp.xcodeproj.

Swift

Aggiungi la chiave API a AppDelegate.swift nel seguente modo:

1. Aggiungi la seguente istruzione di importazione:

   import GoogleMaps

2. Modifica la riga seguente per aggiungere la tua chiave API tra virgolette doppie:

   // Change this key to a valid key registered with the demo app bundle id.
   let mapsAPIKey = ""

Objective-C

Aggiungi la chiave API a AppDelegate.m nel seguente modo:

1. Aggiungi la seguente istruzione di importazione:

   @import GoogleMaps;

2. Modifica la riga seguente per aggiungere la tua chiave API tra virgolette doppie:

   // Change this key to a valid key registered with the demo app bundle id.
   static NSString *const kMapsAPIKey = @"";