Codice di esempio di Maps SDK for iOS

Seleziona la piattaforma: Android iOS JavaScript

Il repository di Maps SDK for iOS su GitHub contiene esempi che illustrano l'utilizzo di Maps SDK for iOS nella tua app per iOS. L'app di esempio contiene il codice per le funzionalità principali dell'SDK e può essere utilizzata come punto di partenza per la tua app.

Risoluzione dei problemi: se l'app di esempio viene eseguita correttamente, ma non vedi una mappa, verifica di aver aggiunto la chiave API al file manifest dell'app, come descritto in Utilizzo delle chiavi API.

Elenco di esempi di Maps SDK for iOS

Le attività di esempio principali dell'app demo sono elencate di seguito e riprodotte nelle pagine collegate per un riferimento rapido. Consulta la cartella degli esempi di GitHub per l'elenco completo degli esempi disponibili.

• Visualizza una mappa di base
• Visualizza una finestra informativa per un indicatore
• Aggiungi un indicatore a una mappa
• Esegui la geocodifica inversa di una località
• Attiva e disattiva i gesti sulla mappa
• Gestisci gli eventi dei marker
• Attiva il pulsante Posizione
• Disegna poligoni su una mappa
• Disegna polilinee su una mappa

Esegui l'app di esempio completa in locale

L'app di esempio di Maps SDK for iOS è disponibile come archivio di download da GitHub. Segui questi passaggi per installare e provare l'app di esempio di Maps SDK for iOS.

Importante: devi rimuovere tutte le dipendenze esistenti aggiunte manualmente o utilizzando CocoaPods. Per istruzioni, consulta il passaggio 2 della sezione Configura un progetto Xcode.

1. Esegui git clone https://github.com/googlemaps-samples/maps-sdk-for-ios-samples.git per clonare il repository di esempi in una directory locale.

2. Apri una finestra del terminale, vai alla directory in cui hai clonato i file di esempio e accedi alla directory GoogleMaps:

   Swift

   cd maps-sdk-for-ios-samples/GoogleMaps-Swift
   open GoogleMapsSwiftXCFrameworkDemos.xcodeproj

   Objective-C

   cd maps-sdk-for-ios-samples-main/GoogleMaps
   open GoogleMapsDemos.xcodeproj

3. Nel progetto Xcode, vai a File > Add Package Dependencies (Aggiungi dipendenze pacchetto). Inserisci https://github.com/googlemaps/ios-maps-sdk come URL, premi Invio per inserire il pacchetto e fai clic su Add Package (Aggiungi pacchetto).
4. In Xcode, premi il pulsante di compilazione per creare l'app con lo schema corrente. La build genera un errore che ti chiede di inserire la chiave API nel file SDKConstants.swift per Swift o nel file SDKDemoAPIKey.h per Objective-C.
5. Ottieni una chiave API dal tuo progetto con Maps SDK for iOS abilitato.
6. Modifica il file SDKConstants.swift per Swift o il file SDKDemoAPIKey.h per Objective-C e incolla la chiave API nella definizione della costante apiKey o kAPIKey. Ad esempio:

   Swift

   static let apiKey = "YOUR_API_KEY"

   Objective-C

   static NSString *const kAPIKey = @"YOUR_API_KEY";

7. Nel file SDKConstants.swift (Swift) oSDKDemoAPIKey.h (Objective-C), rimuovi la riga seguente, perché viene utilizzata per registrare il problema definito dall'utente:

   Swift

   #error (Register for API Key and insert here. Then delete this line.)

   Objective-C

   #error Register for API Key and insert here.

8. Crea ed esegui il progetto. Viene visualizzata la finestra del simulatore iOS, che mostra un elenco di Maps SDK Demos.
9. Scegli una delle opzioni visualizzate per sperimentare una funzionalità di Maps SDK for iOS.
10. Se ti viene chiesto di consentire a GoogleMapsDemos di accedere alla tua posizione, scegli Consenti.