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 esperienza con lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS. In Xcode 11.7 o versioni precedenti, crea un'applicazione con una sola vista.
2. Aggiungi Maps SDK for iOS come dipendenza. Per conoscere le opzioni, consulta la sezione Installazione dell'SDK.
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, è possibile che ti venga chiesto di autenticarti con il tuo account GitHub. Segui le istruzioni per creare un token di accesso personale GitHub per continuare la procedura.
5. Nella finestra successiva, seleziona l'opzione di opzione radio Versione, seleziona Fino alla prossima versione principale dall'elenco a discesa e inserisci la versione più recente della libreria di utilità Maps SDK per 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.

Utilizzare CocoaPods

1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sulla tua macchina locale. Se non hai esperienza nello sviluppo per iOS, crea un'applicazione con una sola vista.
2. Se non hai ancora un file pod per il progetto, crea un file denominato Podfile nella directory del progetto. Questo file definisce le dipendenze del progetto.
3. Modifica il file pod del progetto e aggiungi una dipendenza dal pod Google-Maps-iOS-Utils. Ecco un esempio che include le dipendenze necessarie per 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.1.0' # x-release-please-version
   end

4. Esegui pod install.
5. Chiudi Xcode, quindi apri (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Da questo momento in poi, dovrai utilizzare il file .xcworkspace per aprire il progetto.

Nota:l'utilità di raggruppamento degli indicatori dipende dal quadtree, ma puoi utilizzare il quadtree senza il raggruppamento degli indicatori. Se vuoi solo l'utilità quadtree, puoi cambiare pod 'Google-Maps-iOS-Utils' in 'Google-Maps-iOS-Utils/QuadTree' nel file pod.

Utilizzare i file di GitHub

1. Scarica l'archivio di codice di esempio da GitHub e decomprimilo.
2. Apri una finestra del terminale, vai alla directory in cui hai espanso i file di esempio e accedi alla directory dei sample appropriata per la lingua che vuoi utilizzare:
   • Per Swift, esegui 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 (fai doppio clic) il file .xcworkspace del progetto per avviare Xcode. Da questo momento in poi, dovrai utilizzare il file .xcworkspace per aprire il progetto.

Swift

Aggiungi la tua chiave API a AppDelegate.swift come segue:

1. Aggiungi la seguente istruzione di importazione:

   import GoogleMaps

2. Modifica la riga seguente per aggiungere la 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 tua chiave API a AppDelegate.m come segue:

1. Aggiungi la seguente istruzione di importazione:

   @import GoogleMaps;

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

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