Configurazione

In questa pagina viene descritto cosa devi fare per iniziare a creare con l'SDK Maps 3D per iOS. La procedura di configurazione prevede la configurazione di un progetto Google Cloud e di un'API da utilizzare con l'SDK, quindi la configurazione di un progetto Xcode. Completa questi passaggi prima di aggiungere la tua prima mappa 3D alla tua app.

Prerequisiti

Per utilizzare Maps 3D SDK for iOS, il progetto e i dispositivi di destinazione devono soddisfare i seguenti requisiti:

  • Versione minima di iOS: scegli come target iOS 16.0 o versioni successive.
  • Xcode: Xcode versione 16.0 o successive.

Configura un progetto Google Cloud e una chiave API

Prima di poter iniziare a creare con l'SDK Maps 3D per iOS, devi configurare un progetto Google Cloud e una chiave API da utilizzare con l'SDK Maps 3D per iOS completando i seguenti passaggi:

Passaggio 1: configura il progetto

Console

  1. Nella console Google Cloud, nella pagina di selezione del progetto, fai clic su Crea progetto per iniziare a creare un nuovo progetto Cloud.

    Vai alla pagina del selettore dei progetti

  2. Verifica che la fatturazione sia attivata per il tuo progetto Cloud. Verifica che la fatturazione sia abilitata per il tuo progetto.

    Google Cloud offre una prova senza costi. La prova scade dopo 90 giorni o dopo che l'account ha accumulato addebiti per un valore di 300 $, a seconda dell'evento che si verifica per primo. Annulla in qualsiasi momento. Per ulteriori informazioni, consulta Crediti dell'account di fatturazione e Fatturazione.

Cloud SDK

gcloud projects create "PROJECT"

Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

Passaggio 2: abilita le API o gli SDK

Per utilizzare Google Maps Platform, devi abilitare le API o gli SDK che prevedi di utilizzare con il tuo progetto.

Tieni presente che alcune integrazioni richiedono l'abilitazione di più API/SDK. Se non sai con certezza quali API o SDK abilitare, prova a utilizzare Capabilities Explorer o consulta la documentazione relativa all'API o all'SDK che vuoi utilizzare.

Per abilitare una o più API o SDK:

Console

  1. Per visualizzare le API e gli SDK di Google Maps Platform che puoi abilitare, vai alla pagina della libreria delle API di Google Maps nella console Cloud:

    Vai alla pagina della libreria API di Google Maps

  2. Fai clic sull'API o sull'SDK che vuoi abilitare.
    • Se il pulsante indica ABILITA, fai clic per abilitare l'API o l'SDK.
    • Se il pulsante indica GESTISCI, l'API o l'SDK è già abilitato e non devi fare altro.
    • Se fai clic su uno dei pulsanti, viene visualizzata la dashboard per l'API o l'SDK. (Fai clic sul pulsante DISABILITA per rimuovere l'API o l'SDK da questo progetto.)

Cloud SDK

Il seguente comando abilita tutte le API di Maps, Routes e Places:

gcloud services enable \
    --project "PROJECT" \
    "addressvalidation.googleapis.com" \
    "areainsights.googleapis.com" \
    "tile.googleapis.com" \
    "aerialview.googleapis.com" \
    "elevation-backend.googleapis.com" \
    "routes.googleapis.com" \
    "geocoding-backend.googleapis.com" \
    "geolocation.googleapis.com" \
    "maps-android-backend.googleapis.com" \
    "maps-backend.googleapis.com" \
    "maps-embed-backend.googleapis.com" \
    "maps-ios-backend.googleapis.com" \
    "mapsplatformdatasets.googleapis.com" \
    "places-backend.googleapis.com" \
    "roads.googleapis.com" \
    "routeoptimization.googleapis.com" \
    "static-maps-backend.googleapis.com" \
    "street-view-image-backend.googleapis.com" \
    "timezone-backend.googleapis.com"

Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

Utilizza questo comando per abilitare le API Environment:

gcloud services enable \
    --project "PROJECT" \
    "airquality.googleapis.com" \
    "solar.googleapis.com" \
    "pollen.googleapis.com" \
    "weather.googleapis.com"

Passaggio 3: ottieni una chiave API

Questo passaggio illustra solo la procedura di creazione della chiave API. Se utilizzi la chiave API in produzione, ti consigliamo vivamente di limitarla. Puoi trovare ulteriori informazioni nella pagina Utilizzo delle chiavi API specifica per il prodotto.

La chiave API è un identificatore univoco che autentica le richieste associate al progetto a fini di utilizzo e fatturazione. Devi avere almeno una chiave API associata al tuo progetto. Per creare una nuova chiave o aggiungere un'API o un SDK a una chiave esistente, segui queste istruzioni.

Console

  1. Vai alla pagina Google Maps Platform > Chiavi e credenziali.

    Vai alla pagina Chiavi e credenziali

  2. Se richiesto, seleziona il progetto.

  3. Procedi in uno dei seguenti modi:

    • Crea una nuova chiave:

      1. Fai clic su Crea credenziali > Chiave API.
      2. Nel riquadro Crea chiave API, apri l'elenco Seleziona limitazioni dell'API.
      3. Cancella tutte le API che non sono necessarie per questa chiave e assicurati che le API che prevedi di utilizzare rimangano selezionate.
      4. Fai clic su Crea. Nel riquadro viene visualizzata la nuova chiave API.

    • Utilizza una chiave esistente:

      1. Fai clic sul nome della chiave.
      2. Nell'elenco Seleziona limitazioni dell'API, seleziona le API che prevedi di utilizzare.
      3. Fai clic su Salva.

    La selezione di un'API qui non la abilita. Assicurati che ogni API che selezioni sia abilitata nella libreria API.

  4. Per visualizzare la stringa della chiave in un secondo momento, vai alla pagina Chiavi e credenziali e fai clic su Mostra chiave per la chiave.

Se la console ha un aspetto diverso da questi passaggi, consulta Crea una chiave API e Aggiungi limitazioni API nella documentazione di Google Cloud.

Cloud SDK

Sostituisci PROJECT_ID con l'ID progetto nei comandi seguenti.

  • Crea una nuova chiave: esegui il comando seguente e sostituisci DISPLAY_NAME con un nome per la chiave. Sostituisci SERVICE_NAME con il nome del servizio di un'API che prevedi di utilizzare, ad esempio places.googleapis.com. Per consentire più API, ripeti il flag --api-target.

    gcloud services api-keys create \
    --project="PROJECT_ID" \
    --display-name="DISPLAY_NAME" \
    --api-target=service=SERVICE_NAME

    Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

  • Utilizza una chiave esistente: esegui il comando seguente e sostituisci KEY_ID con l'ID della chiave. Sostituisci SERVICE_NAME con il nome del servizio dell'API da aggiungere. Il flag --append mantiene le API già consentite dalla chiave. In caso contrario, il comando le sostituisce.

    gcloud services api-keys update KEY_ID \
    --project="PROJECT_ID" \
    --append \
    --api-target=service=SERVICE_NAME

    Scopri di più su Google Cloud SDK, sull'installazione di Cloud SDK e sui seguenti comandi:

    L'ID chiave non è la stringa della chiave o il nome visualizzato. Per trovarlo, esegui gcloud services api-keys list --project="PROJECT_ID". L'ID è l'ultima parte del campo name: projects/PROJECT_NUMBER/locations/global/keys/KEY_ID.

Per visualizzare la stringa della chiave, esegui gcloud services api-keys get-key-string KEY_ID --project="PROJECT_ID".

Per attivare l'SDK, consulta la pagina Maps 3D SDK for iOS nella console Google Cloud. Per saperne di più su come completare questi passaggi, consulta Inizia a utilizzare Google Maps Platform.

Configura un progetto Xcode

Questa sezione spiega come creare e configurare un progetto Xcode da utilizzare con Maps 3D SDK for iOS.

Dopo aver abilitato la fatturazione e creato una chiave API, puoi configurare il progetto Xcode che utilizzi per sviluppare la tua app.

Passaggio 1: installa il software richiesto

Per creare un progetto utilizzando Maps 3D SDK per iOS, devi scaricare e installare:

  • Xcode versione 16.0 o successive

Passaggio 2: crea il progetto Xcode e installa Maps 3D SDK for iOS

Swift Package Manager

Maps 3D SDK per iOS può essere installato utilizzando Swift Package Manager.

Per aggiungere l'SDK a un progetto nuovo o esistente, segui questi passaggi:

  • Apri il tuo project o workspace Xcode, quindi vai a File > Add Package Dependencies (Aggiungi dipendenze pacchetto).
  • Inserisci https://github.com/googlemaps/ios-maps-3d-sdk come URL, premi Invio per inserire il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
  • Nella finestra Scegli i prodotti del pacchetto, verifica che GoogleMaps3D venga aggiunto al target principale designato. Al termine, fai clic su Aggiungi pacchetto.
  • Per verificare l'installazione, vai al riquadro Generale della destinazione. In Frameworks, Libraries, and Embedded Content (Framework, librerie e contenuti incorporati), dovresti vedere i pacchetti installati. Puoi anche visualizzare la sezione Package Dependencies (Dipendenze del pacchetto) di Project Navigator (Navigatore progetto) per verificare il pacchetto e la relativa versione.

Passaggio 3: aggiungi la chiave API alla tua app

Swift Package Manager

Aggiungi la chiave API al punto di ingresso principale dell'app (o in qualsiasi momento prima del caricamento della mappa) come segue.

  1. Aggiungi la seguente istruzione di importazione: 
    import GoogleMaps3D
  2. Aggiungi il seguente metodo. Sostituisci YOUR_API_KEY con la tua chiave API. 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

  var body: some View {
    Map(mode: .hybrid)
  }
}

(Facoltativo) Passaggio 4: esamina il file manifest della privacy di Apple

Apple richiede i dettagli sulla privacy delle app per le app presenti nell'App Store.

Il file manifest della privacy di Apple è incluso nel bundle di risorse per l'SDK. Per verificare che il file manifest della privacy sia stato incluso e per esaminarne i contenuti, crea un archivio della tua app e genera un report sulla privacy dall'archivio.

Passaggi successivi

Ora che hai un progetto Google Cloud, una chiave API e un progetto Xcode configurati per l'utilizzo con Maps SDK 3D per iOS, puoi aggiungere una mappa 3D alla tua app.