Maps SDK for iOS:获取 API 密钥

注意:Google Maps Platform 高级计划不再适用于注册客户或新客户。

如需使用 Maps SDK for iOS,您必须拥有一个 API 密钥。API 密钥是唯一标识符,用于对与您的项目相关联的请求进行身份验证,以便您使用相关产品和执行结算。

创建 API 密钥

您必须至少有一个与您的项目相关联的 API 密钥。

要获取 API 密钥,请执行以下操作:

  1. 访问 Google Cloud Platform Console
  2. 点击项目下拉菜单,选择在您购买高级计划时系统为您创建的项目。项目名称以 Google Maps API for Business 或 Google Maps for Work 或 Google Maps 开头。
  3. 注意:如需拥有对计划中的功能的完整访问权限,高级计划客户应使用与其高级计划帐号相关联的项目。购买许可时,您会收到如下格式的高级计划资产名称:gme-[company] & proj-[number] ([type])。为确保您访问的是正确的项目,请通过 console.cloud.google.com/project/number(将 number 替换为您的项目编号)以项目所有者身份登录控制台。您可以在欢迎邮件中找到项目所有者。

  4. 点击菜单按钮 ,然后依次选择 API 和服务 > 凭据
  5. 凭据页面上,依次点击创建凭据 > API 密钥
    已创建的 API 密钥对话框会显示您新创建的 API 密钥(一个加密字符串)。
  6. 点击关闭
    新的 API 密钥位于凭据页面的 API 密钥下。

向您的应用添加 API 密钥

在以下示例中,将 YOUR_API_KEY 替换为您的 API 密钥。

Swift

按以下步骤向 AppDelegate.swift 添加 API 密钥:

  1. 添加以下 import 语句:
    import GoogleMaps
  2. 将以下内容添加到您的 application(_:didFinishLaunchingWithOptions:) 方法,并将其中的“YOUR_API_KEY”替换为您的 API 密钥:
    GMSServices.provideAPIKey("YOUR_API_KEY")
  3. 如果您也使用 Places API,请按照下面的内容再次添加密钥:
    GMSPlacesClient.provideAPIKey("YOUR_API_KEY")

Objective-C

按以下步骤向 AppDelegate.m 添加 API 密钥:

  1. 添加以下 import 语句:
    @import GoogleMaps;
  2. 将以下内容添加到您的 application:didFinishLaunchingWithOptions: 方法,并将其中的“YOUR_API_KEY”替换为您的 API 密钥:
    [GMSServices provideAPIKey:@"YOUR_API_KEY"];
  3. 如果您也使用 Places API,请按照下面的内容再次添加密钥:
    [GMSPlacesClient provideAPIKey:@"YOUR_API_KEY"];

限制 API 密钥

通过限制 API 密钥,您可以确保只能使用您的 API 密钥发出已授权的请求,从而提高应用安全性。我们强烈建议您按照相关说明为您的 API 密钥设置限制。如需了解详情,请参阅 API 密钥最佳做法

如需限制 API 密钥,请执行以下操作:

  1. 在 GCP Console 中,打开项目选择器页面,选择或创建要向其添加 API 密钥的 Google Cloud 项目。

    转到项目选择器页面

  2. 依次转到 API 和服务 > 凭据页面。

    转到“凭据”页面

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