Setup

This product or feature is Experimental (pre-GA). Pre-GA products and features might have limited support, and changes to pre-GA products and features might not be compatible with other pre-GA versions. Pre-GA Offerings are covered by the Google Maps Platform Service Specific Terms. For more information, see the launch stage descriptions.

This page describes what you need to do to get set up to start building with the Maps 3D SDK for iOS. The setup process involves configuring a Google Cloud project and API for use with the SDK, and then setting up an Xcode project. Complete these steps before adding your first 3D map to your app.

Set up a Google Cloud project and API key

Before you can start building with the Maps 3D SDK for iOS, you need to set up a Google Cloud project and API key to use with the Maps 3D SDK for iOS by completing the following steps:

Step 1

Console

1. In the Google Cloud console, on the project selector page, click Create Project to begin creating a new Cloud project.

   Go to the project selector page

2. Make sure that billing is enabled for your Cloud project. Confirm that billing is enabled for your project.

   Google Cloud offers a $0.00 charge trial. The trial expires at either end of 90 days or after the account has accrued $300 worth of charges, whichever comes first. Cancel anytime. For more information, see Billing account credits and Billing.

Cloud SDK

gcloud projects create "PROJECT"

Read more about the Google Cloud SDK , Cloud SDK installation , and the following commands:

• gcloud projects create

Note: If you don't plan to keep the resources that you create in a learning exercise, create a project instead of selecting an existing project. After you finish the exercise, you can delete the project, removing all resources associated with the project.

Step 2

To use Google Maps Platform, you must enable the APIs or SDKs you plan to use with your project.

Note that some integrations require you to enable multiple APIs/SDKs. If you are not sure which APIs or SDKs to enable, try using the API Picker, or consult the documentation for the API/SDK you want to use.

To enable one or more APIs or SDKs:

Console

1. See the Google Maps Platform APIs and SDKs that you can enable by going to the Maps API Library page in the Cloud console:

   Go to the Maps API Library page

2. Click the API or SDK you want to enable.
   • If the button says ENABLE, click the button to enable the API or SDK.
   • If the button says MANAGE, the API or SDK is already enabled and you don't need to do anything further.
   • Clicking either button will display the dashboard for the API or SDK. (Click the DISABLE button to remove the API or SDK from this project.)

Cloud SDK

The following command enables all of the Maps, Routes, and Places APIs:

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"

Read more about the Google Cloud SDK , Cloud SDK installation , and the following commands:

• gcloud services enable
• gcloud services disable

Use this command to enable the Environment APIs:

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

Note: Enabling Places API also enables the Places Library, Maps JavaScript API, Places SDK for Android and Places SDK for iOS.

Step 3

This step only goes through the API Key creation process. If you use your API Key in production, we strongly recommend that you restrict your API key. You can find more information in the product-specific Using API Keys page.

The API key is a unique identifier that authenticates requests associated with your project for usage and billing purposes. You must have at least one API key associated with your project.

To create an API key:

Console

1. Go to the Google Maps Platform > Credentials page.

   Go to the Credentials page

2. On the Credentials page, click Create credentials > API key.
   The API key created dialog displays your newly created API key.
3. Click Close.
   The new API key is listed on the Credentials page under API keys.
   (Remember to restrict the API key before using it in production.)

Cloud SDK

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

Read more about the Google Cloud SDK , Cloud SDK installation , and the following commands:

• gcloud services api-keys create

To enable the SDK, see the Maps 3D SDK for iOS page in the Google Cloud console. For more information about completing these steps, see Getting started with the Google Maps Platform.

Set up an Xcode project

This section explains how to create and configure an Xcode project for use with the Maps 3D SDK for iOS.

After you enable billing and create an API key, you're ready to set up the Xcode project that you use to develop your app.

Step 1: Install the required software

To build a project using the Maps 3D SDK for iOS, you must download and install:

• Xcode version 16.0 or later

Step 2: Create the Xcode project and install the Maps 3D SDK for iOS

Swift Package Manager

The Maps 3D SDK for iOS can be installed using Swift Package Manager.

To add the SDK to a new or existing project, follow these steps:

• Open your Xcode project or workspace, then go to File > Add Package Dependencies.
• Enter https://github.com/googlemaps/ios-maps-3d-sdk as the URL, press Enter to pull in the package, and click "Add Package".
• From the Choose Package Products window, verify that GoogleMaps3D will be added to your designated main target. Once complete, click Add Package.
• To verify your installation, navigate to your target's General pane. In Frameworks, Libraries, and Embedded Content, you should see the installed packages. You can also view the Package Dependencies section of Project Navigator to verify the package and its version.

Step 3: Add the API key to your app

Swift Package Manager

Add your API key to the main entry point for your app (or any time before the map loads) as follows.

1. Add the following import statement:

   import GoogleMaps3D

2. Add the following method. Replace YOUR_API_KEY with your API key.

   struct ContentView: View {
     init () {
       Map.apiKey = "YOUR_API_KEY"
     }
   
     var body: some View {
       Map(mode: .hybrid)
     }
   }
       

The API key can appear in your app's entry point or separately for each map view. If the API key is specified both in the entry point and the map views, however, the console will produce an error.

Step 4 (optional): Inspect Apple Privacy Manifest file

Note: The following is relevant when you deploy your app to the web store.

Apple requires app privacy details for apps on the App Store.

The Apple Privacy Manifest file is included in the resources bundle for the SDK. To verify that the Privacy Manifest File has been included, and to inspect its contents, create an archive of your app and generate a privacy report from the archive.

Next steps

Now that you have a Google Cloud project, API key, and Xcode project set up for use with the Maps 3D SDK for iOS, you can Add a 3D map to your app.