获取 API 密钥

请选择平台： Android iOS JavaScript

现在，您已经设置了结算和项目、启用了 SDK，并安装了首选依赖项管理器和其他软件，接下来可以创建、添加和限制 API 密钥了。

创建 API 密钥

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

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

控制台

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

    前往“凭据”页面

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

Cloud SDK

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

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

按照设置 Xcode 项目中的说明，您需要在创建 Xcode 项目时使用此 API 密钥。

限制 API 密钥

Google 强烈建议您限制 API 密钥，仅将其用于您的应用所需要的 API。通过限制 API 密钥，可防止您的应用收到无保证的请求，从而提高应用安全性。如需了解详情，请参阅 API 安全性最佳实践。

如需限制 API 密钥，请执行以下操作：

控制台

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

    前往“凭据”页面

  2. 选择您要设置限制的 API 密钥。系统随即会显示 API 密钥属性页面。
  3. 在密钥限制下，设置以下限制：
    • 应用限制：
      1. 选择 iOS 应用。
      2. 要接受来自您提供的包含软件包标识符的 iOS 应用的请求，请从列表中选择相应的 iOS 软件包标识符。
    • API 限制：
      1. 点击限制密钥。
      2. 从选择 API 下拉列表中选择 Maps SDK for iOS。 如果 Maps SDK for iOS 未列出，您需要启用它。
  4. 点击保存以完成更改。

Cloud SDK

列出现有密钥。 

gcloud services api-keys list --project="PROJECT"

清除对现有密钥的现有限制。

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --clear-restrictions

为现有密钥设置新限制。 

gcloud alpha services api-keys update "projects/PROJECT/keys/KEY_ID" \
    --api-target="maps-ios-backend.googleapis.com"
    --allowed-bundle-ids="BUNDLE_NAME"

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

现在，您已经获得了 Maps SDK for iOS 的 API 密钥，可以开始使用了。

后续步骤

现在您已经有了 API 密钥，请按照设置 Xcode 项目中的说明创建和配置 Xcode 项目。