Configurazione e demo

Seleziona la piattaforma: Android iOS

Questa pagina descrive come configurare la libreria di utilità per Maps SDK for iOS.

Per provare queste utilità, puoi:

Aggiungere la libreria di utilità di Maps SDK for iOS a un progetto Xcode

Segui questi passaggi per aggiungere la libreria di utilità al tuo workspace Xcode:

Utilizzare Swift Package Manager

  1. Se non hai ancora un progetto Xcode, creane uno ora e salvalo sul computer locale. Se non hai familiarità con lo sviluppo per iOS, crea un nuovo progetto e seleziona il modello di app per iOS template. Su Xcode 11.7 o versioni precedenti, crea un'applicazione a visualizzazione singola.
  2. Aggiungi Maps SDK for iOS come dipendenza. Per le opzioni, consulta Installare l'SDK.
  3. Nel progetto Xcode, vai a File -> Swift Packages -> Add Package Dependency (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, potrebbe esserti 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 radio Versione, seleziona Fino alla prossima versione principale dall'elenco a discesa e inserisci l'ultima versione della libreria di utilità di Maps SDK for iOS (ad esempio "6.0.0").
  6. Fai clic sul menu a discesa accanto a Aggiungi al progetto, seleziona il tuo progetto e poi Aggiungi pacchetto.

Aggiungere la chiave API all'app

Per istruzioni su come generare una chiave API e aggiungerla al progetto Xcode, consulta Configurare un progetto Xcode.

Creare ed eseguire il progetto

Dopo aver aggiunto la chiave API, crea ed esegui il progetto.

Utilizzare un'utilità nell'app

Per saperne di più su come utilizzare ogni utilità nella tua app, consulta la documentazione relativa:

Installare ed eseguire l'app demo

La libreria di utilità include un'app demo che puoi installare e poi provare ogni utilità.

Installa l'app demo:

Utilizzare i file di GitHub

  1. Scarica l'archivio dell'esempio di codice da GitHub ed estrailo. In alternativa, clona il repository in una directory locale: 
    git clone https://github.com/googlemaps/google-maps-ios-utils.git
  2. Apri una finestra del terminale, vai alla directory in cui hai espanso i file di esempio e approfondisci la directory degli esempi appropriata per la lingua che vuoi utilizzare:

    Swift

    cd google-maps-ios-utils/samples/SwiftDemoApp
open SwiftDemoApp.xcodeproj

    Objective-C

    cd google-maps-ios-utils/samples/ObjCDemoApp
open ObjCDemoApp.xcodeproj

Aggiungere la chiave API all'app demo

In Ottenere una chiave API, generi una chiave API per la tua app. Ora aggiungi questa chiave al progetto Xcode per l'app demo. , consulta Ottenere una chiave API.

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 chiave API tra le 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 chiave API tra le virgolette doppie: 
    // Change this key to a valid key registered with the demo app bundle id.
static NSString *const kMapsAPIKey = @"";

Creare ed eseguire l'app demo

Dopo aver aggiunto la chiave API, crea ed esegui il progetto:

  • Se esegui la versione Swift della demo, puoi selezionare l'utilità da visualizzare nell'app.
  • Se esegui la versione Objective-C della demo, vedrai la demo dell' utilità di clustering dei marker. Puoi quindi modificare la versione Objective-C della demo per provare ogni utilità. Per saperne di più, consulta la sezione Aggiungere un'utilità all'app di seguito.