设置

本页介绍了您需要执行哪些操作才能开始使用 Maps 3D SDK for iOS 进行构建。设置过程包括配置 Google Cloud 项目和 API 以供 SDK 使用，然后设置 Xcode 项目。请先完成以下步骤，然后再向应用添加第一个 3D 地图。

设置 Google Cloud 项目和 API 密钥

在开始使用 Maps 3D SDK for iOS 进行构建之前，您需要设置一个 Google Cloud 项目和 API 密钥，以用于 Maps 3D SDK for iOS，具体方法是完成以下步骤：

第 1 步

控制台

  1. 在 Google Cloud 控制台中，打开项目选择器页面，点击创建项目以开始创建新的 Cloud 项目。

    转到项目选择器页面

  2. 确保您的 Cloud 项目已启用结算功能。确认您的项目已启用结算功能。

    Google Cloud 提供免费试用。试用期将在 90 天后或者账号费用累积达到 300 美元时（以先到者为准）结束。您随时可以取消试用。如需了解详情，请参阅结算账号赠金和结算。

Cloud SDK

gcloud projects create "PROJECT"

您可以详细了解 Google Cloud SDK、Cloud SDK 安装和以下命令：

第 2 步

如要使用 Google Maps Platform，您必须启用计划用于项目的 API 或 SDK。

请注意，有些集成需要您启用多个 API/SDK。如果您不确定要启用哪些 API 或 SDK，请尝试使用 API 选择器，或参阅想使用的 API/SDK 对应的文档。

如需启用一个或多个 API/SDK，请执行以下操作：

控制台

  1. 前往 Cloud 控制台中的“Maps API 库”页面，查看可启用的 Google Maps Platform API 和 SDK：

    前往“Maps API 库”页面

  2. 点击您想启用的 API 或 SDK。
    • 如果按钮显示启用，请点击此按钮以启用 API 或 SDK。
    • 如果按钮显示管理，则表示 API 或 SDK 已启用，您无需执行任何其他操作。
    • 点击任一按钮均可显示 API 或 SDK 的信息中心（点击停用按钮可从此项目中移除相应 API 或 SDK）。

Cloud SDK

以下命令会启用所有 Maps、Routes 和 Places API：

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"

详细了解 Google Cloud SDK、Cloud SDK 安装和以下命令：

使用以下命令启用环境 API：

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

第 3 步

此步骤仅包含 API 密钥的创建流程。如要在生产环境中使用 API 密钥，强烈建议您为相应密钥设置限制。如需了解详情，请参阅相应产品的使用 API 密钥页面。

API 密钥是唯一标识符，用于对与您的项目相关联的请求进行身份验证，以便计算用量和执行结算。您必须至少有一个与您项目相关联的 API 密钥。

如需创建 API 密钥，请执行以下操作：

控制台

  1. 前往 Google Maps Platform > 凭据页面。

    前往“凭据”页面

  2. 在凭据页面上，依次点击创建凭据 > API 密钥。
    已创建的 API 密钥对话框会显示您新创建的 API 密钥。
  3. 点击关闭。
    新的 API 密钥即会列在凭据页面的 API 密钥下。
    （在生产环境中使用 API 密钥之前，请务必对 API 密钥设置限制。）

Cloud SDK

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

详细了解 Google Cloud SDK、Cloud SDK 安装和以下命令：

如需启用该 SDK，请参阅 Google Cloud 控制台中的 Maps 3D SDK for iOS 页面。如需详细了解如何完成这些步骤，请参阅 Google Maps Platform 使用入门。

设置 Xcode 项目

本部分介绍了如何创建和配置 Xcode 项目，以便与 Maps 3D SDK for iOS 搭配使用。

启用结算功能并创建 API 密钥后，您便可以设置用于开发应用的 Xcode 项目。

第 1 步：安装所需的软件

若要使用 Maps 3D SDK for iOS 构建项目，您必须下载并安装：

  • Xcode 16.0 版或更高版本

第 2 步：创建 Xcode 项目并安装 Maps 3D SDK for iOS

Swift Package Manager

您可以使用 Swift Package Manager 安装 Maps 3D SDK for iOS。

如需将 SDK 添加到新的或现有项目，请按以下步骤操作：

  • 打开 Xcode project 或 workspace，然后依次前往 File > Add Package Dependencies。
  • 输入 https://github.com/googlemaps/ios-maps-3d-sdk 作为网址，按 Enter 键拉取软件包，然后点击“Add Package”（添加软件包）。
  • 在选择软件包产品窗口中，验证 GoogleMaps3D 是否会添加到指定的主要目标中。完成后，点击添加套餐。
  • 如需验证安装，请前往目标的常规窗格。在框架、库和嵌入式内容中，您应该会看到已安装的软件包。您还可以查看项目导航器的软件包依赖项部分，以验证软件包及其版本。

第 3 步：向您的应用添加 API 密钥

Swift Package Manager

按照以下方式将 API 密钥添加到应用的主入口点（或地图加载之前的任何时间）。

  1. 添加以下 import 语句： 
    import GoogleMaps3D
  2. 添加以下方法。将 YOUR_API_KEY 替换为您的 API 密钥。 
    struct ContentView: View {
  init () {
    Map.apiKey = "YOUR_API_KEY"
  }

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

第 4 步（可选）：检查 Apple 隐私清单文件

Apple 要求在 App Store 上发布的应用提供应用隐私详细信息。

Apple 隐私权清单文件包含在 SDK 的资源 bundle 中。如需验证是否已添加隐私清单文件并检查其内容，请创建应用归档，然后从该归档生成隐私报告。

后续步骤

现在，您已设置好 Google Cloud 项目、API 密钥和 Xcode 项目，可用于 Maps 3D SDK for iOS，接下来可以向应用添加 3D 地图。