Configurazione

Questo prodotto o funzionalità è sperimentale (pre-GA). I prodotti e le funzionalità pre-GA potrebbero avere un supporto limitato e le modifiche ai prodotti e alle funzionalità pre-GA potrebbero non essere compatibili con altre versioni pre-GA. Le offerte pre-GA sono coperte da Google Termini specifici di servizio di Google Maps Platform. Per ulteriori informazioni, consulta le descrizioni della fase di lancio.

Questa pagina descrive la procedura di configurazione per iniziare a creare con Maps SDK 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 prima mappa 3D alla tua app.

Configurare un progetto Google Cloud e una chiave API

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

Passaggio 1

Console

1. Nella console Google Cloud, nella pagina di selezione del progetto, fai clic 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 attivata per il tuo progetto.

   Google Cloud offre una prova con addebito di 0,00 $. La prova scade al termine di 90 giorni o dopo che l'account ha accumulato addebiti per un valore di 300 $, a seconda dell'evento che si verifica per primo. Puoi annullare in qualsiasi momento. Per ulteriori informazioni, vedi 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:

• gcloud projects create

Nota: se non prevedi di conservare le risorse che crei in un esercizio di apprendimento, crea un progetto invece di selezionarne uno già esistente. Una volta completato l'esercizio, puoi eliminare il progetto e tutte le relative risorse.

Passaggio 2

Per utilizzare Google Maps Platform, devi abilitare le API o gli SDK che intendi 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 Esplora funzionalità o consulta la documentazione dell'API/SDK che vuoi utilizzare.

Per abilitare una o più API o SDK:

Console

1. Consulta le API e gli SDK di Google Maps Platform che puoi abilitare andando alla pagina Libreria API di Google Maps nella console Cloud:

   Vai alla pagina Libreria API di Google Maps

2. Fai clic sull'API o sull'SDK che vuoi abilitare.
   • Se il pulsante indica ABILITA, fai clic sul pulsante 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 due pulsanti, viene visualizzata la dashboard dell'API o dell'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 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:

• gcloud services enable
• gcloud services disable

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"

Nota: l'abilitazione dell'API Places abilita anche la libreria Places, l'API Maps JavaScript, Places SDK for Android e Places SDK for iOS.

Passaggio 3

Questo passaggio riguarda 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 di chiavi API specifica del prodotto.

La chiave API è un identificatore univoco che autentica le richieste associate al progetto per utilizzo e fatturazione. Devi avere almeno una chiave API associata al tuo progetto.

Per creare una chiave API:

Console

1. Vai alla pagina Google Maps Platform > Credenziali.

   Vai alla pagina Credenziali

2. Nella pagina Credenziali, fai clic su Crea credenziali > Chiave API.
   La finestra di dialogo Chiave API creata mostra la chiave appena creata.
3. Fai clic su Chiudi.
   La nuova chiave API è elencata nella pagina Credenziali sotto Chiavi API.
   (Ricorda di limitare la chiave API prima di utilizzarla in produzione.)

Cloud SDK

gcloud services api-keys create \
    --project "PROJECT" \
    --display-name "DISPLAY_NAME"

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

• gcloud services api-keys create

Per abilitare l'SDK, consulta la pagina Maps SDK 3D per iOS nella console Google Cloud. Per ulteriori informazioni su come completare questi passaggi, vedi Iniziare a utilizzare Google Maps Platform.

Configurare un progetto Xcode

Questa sezione spiega come creare e configurare un progetto Xcode da utilizzare con Maps SDK 3D per 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 SDK 3D per iOS, devi scaricare e installare:

• Xcode versione 16.0 o successive

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

Swift Package Manager

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

Per aggiungere l'SDK a un progetto nuovo o esistente:

• Apri il project o workspace di Xcode, quindi vai a File > Add Package Dependencies (File > Aggiungi dipendenze pacchetto).
• Inserisci https://github.com/googlemaps/ios-maps-3d-sdk come URL, premi Invio per recuperare il pacchetto e fai clic su "Add Package" (Aggiungi pacchetto).
• Nella finestra Choose Package Products (Scegli prodotti pacchetto), verifica che GoogleMaps3D venga aggiunto alla destinazione principale designata. Al termine, fai clic su Add Package (Aggiungi pacchetto).
• Per verificare l'installazione, vai al riquadro General (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 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 della tua app (o in qualsiasi momento prima del caricamento della mappa) nel seguente modo.

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)
     }
   }
       

La chiave API può essere visualizzata nel punto di ingresso dell'app o separatamente per ogni visualizzazione della mappa. Tuttavia, se la chiave API è specificata sia nel punto di contatto sia nelle visualizzazioni della mappa, la console genererà un errore.

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

Nota: quanto segue è pertinente quando esegui il deployment dell'app nel web store.

Apple richiede i dettagli sulla privacy delle app 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 ed esaminarne i contenuti, crea un archivio dell'app e genera un report sulla privacy dall'archivio.

Passaggi successivi

Ora che hai configurato un progetto Google Cloud, una chiave API e un progetto Xcode da utilizzare con Maps SDK 3D per iOS, puoi aggiungere una mappa 3D alla tua app.