Google Maps Platform 迁移指南

注意:Google Maps Platform 高级计划不再面向注册客户和新客户提供。

本指南向高级计划客户介绍了如何迁移到 Google Maps Platform 随用随付定价模式。

要点

  • 自 2018 年 11 月 1 日起,高级计划客户可以在其当前高级计划合同到期后迁移到 Google Maps Platform 随用随付定价模式。只有在 2018 年 11 月 1 日或之后到期的合同才能迁移到 Google Maps Platform。对于在 2018 年 11 月 1 日之前到期的高级计划合同,客户必须续订。
  • 现有高级计划客户无需更改任何代码即可迁移(例如,无需更改客户端 ID 或 API 密钥)。
  • 为做好迁移准备,您必须设置一个要关联到 API 项目的结算帐号。一旦高级计划合同到期,您的 API 项目将处于“解锁”状态,从而可以在 Cloud Console 内与新的结算帐号相关联。
  • 如果您的任何 API 用量超过 500000 次 API 调用/月,批量定价可能对您更合算。我们建议您与 Google 地图合作伙伴合作。如需详细了解定价,请参阅定价页面以及定价和用量矩阵

迁移过程

在 Google Maps Platform 上从高级计划迁移到转销商子结算

在合同到期之前

  • 客户:与合作伙伴签订包含 Google Maps Platform 服务条款的续订合同。
  • 合作伙伴:为客户执行批量价格折扣申请流程。我们建议您在续订前至少 2 周执行此步骤,以留出处理时间。
  • 合作伙伴:在转销商结算帐号中设置子结算帐号。
  • 合作伙伴:为客户设置权限和角色来访问其结算帐号。
  • 客户:确保您有权访问高级计划项目。如果您失去了访问权限,请参阅下文查看进一步的操作说明。

高级计划合同到期后的前几天

  • 在高级计划合同到期后的 3 天内,您的项目将处于“解锁”状态,可以与新的结算帐号相关联。
  • 请务必尽快将该项目关联到由您的合作伙伴创建的子结算帐号。为此,请按以下步骤操作:
    • 打开 Cloud Console,选择一个高级计划项目(例如“Google Maps -INT”),然后从左上角的导航菜单中选择结算
    • 选择管理结算帐号,然后点击我的项目标签页。
    • 选择项目名称,点击三个垂直点,然后选择更改结算帐号
    • 点击选择帐号,然后从列表中选择您的转销商结算帐号。然后,选择设置帐号
    • 如需了解详情,请参阅示例演示
  • 建议您在 7 天内为新帐号启用结算功能。启用结算功能后,您在此过渡期间的任何用量都将计入新的结算帐号。
  • 如果您未在高级计划合同到期后的 30 天内启用子结算功能,将无法使用 Google Maps Platform API。

在 Google Maps Platform 上从高级计划迁移到在线结算

在合同到期之前

  • 熟悉添加在线付款方式的流程。
  • 确保您有权访问高级计划项目。如果您失去了访问权限,请参阅下文查看进一步的操作说明。

高级计划合同到期后的前几天

  • 在高级计划合同到期后的 3 天内,您的项目将处于“解锁”状态,可以与新的结算帐号相关联。请务必为您的结算帐号添加在线付款方式。建议您在 7 天内添加付款方式并启用结算功能。启用结算功能后,您在此过渡期间的任何用量都将计入新的结算帐号。
  • 如果您未在高级计划合同到期后的 30 天内启用结算功能,将无法使用 Maps API。

在 Google Maps Platform 上从高级计划迁移到离线结算

请与您的 Google 专属客户经理联系。

常见问题解答

常见问题


如何迁移当前使用客户端 ID 的应用?

为了简化迁移过程,我们会自动生成客户端 ID 与高级计划项目之间的映射。这样,您就无需对编码进行任何更改。

可以获取用量优化方面的帮助吗?

可以,我们为客户提供部署支持。请与您的专属客户经理和/或合作伙伴联系。如需了解详情,请参阅优化指南

哪些人可以访问结算帐号并向他人授予访问权限?

拥有结算帐号管理员角色的任何人都可以访问结算帐号并向他人授予访问权限(请参阅 IAM 中的 Billing 角色概览)。请检查结算帐号并确保角色已正确设置。对于转销商子结算帐号迁移,请向合作伙伴提供有权访问子结算帐号的客户联系人信息。

我有多个 SKU。管理这些 SKU 的最佳做法是什么?

如果您有多个 SKU(例如 Maps-INT、Maps-OEM),系统会按 SKU 创建多个结算帐号(即,Maps-INT 和 Maps-OEM 分别拥有各自的帐号)。我们建议您将它们整合到一个结算帐号中。

在 11 月 1 日之后,印度的高级计划客户能否迁移到随用随付定价模式?

随用随付定价模式将于 2019 年 11 月 18 日在印度推出。我们会在该模式在您所在的地区推出之前与您联系。在此期间,您的高级计划定价不会发生变化。

支持


迁移到随用随付定价模式后,如何与技术支持人员联系?

客户和合作伙伴应访问 Google Cloud Console 中的 Google Maps Platform 支持页面,查看可用的支持选项。如果客户与某个合作伙伴有关联,则该合作伙伴会提供第一线技术支持。

如果客户可以享受高级计划许可黄金级支持服务,那么在迁移到随用随付定价模式后的 12 个月内,仍然可以访问同等级别的功能(包括全天候支持)。此类用户应继续使用支持门户来提交支持请求。

我无法访问高级计划项目或结算帐号,该怎么办?

能够访问高级计划项目至关重要,因为这样您才能启用结算功能并通过续订避免服务中断。即使您仅使用客户端 ID,也需要拥有项目访问权限才能启用结算功能。

如果您无法访问高级计划项目,请与您的同事联系,确定他们是否有权访问您的项目(如果是,他们或许可以授予您访问权限)。如果仍然无法恢复对高级计划项目的访问权限,请与支持团队联系

如果您无法访问高级计划结算帐号,别担心,只需切换到新的结算帐号即可。高级计划合同到期后,您便可以将项目与新的结算帐号相关联。

如果您的客户端 ID 已过期,某些链接将不会再显示在左侧菜单中。如需访问这些链接,请点击此链接

产品


我可以继续查看按渠道细分的使用情况吗?

拥有高级计划许可的客户现在可以将 channel 参数与 API 密钥或客户端 ID 配合使用(此项变更仅适用于已支持将 channel 参数与客户端 ID 配合使用的 API;如需查看示例,请参阅 Maps JavaScript API)。

已迁移到 Google Maps Platform 随用随付定价模式的客户应在 Google Cloud Platform Console地图结算报告中查看按渠道细分的使用情况。为项目启用结算功能后,您还可以通过将结算活动导出到 BigQuery 来访问渠道数据(请参阅下面的示例)。

以下示例展示了如何通过将结算活动导出到 BigQuery 来访问渠道数据。在运行此查询之前,您必须执行以下操作:

  • 为您的帐号启用结算和 BigQuery 帐单导出功能。
  • 表格格式为 PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID,其中:
    • PROJECT_ID 是您的实际项目 ID(例如“my-project-123456”)。
    • DATASET_NAME 是您创建的数据集的名称(例如“SampleDataSet”)。
    • BILLING_ACCOUNT_ID 引用了您的结算帐号 ID,带有“gcp_billing_export_v1_”前缀,并将短划线 (-) 更改为下划线 (_)。例如,结算帐号 ID 123456-7890AB-CDEF01 将变为 gcp_billing_export_v1_123456_789AB_CDEF01
#standardSQL
SELECT   Date(usage_start_time, "America/Los_Angeles") AS billing_day,
         invoice.month                                 AS invoice_month,
         service.description                           AS service,
         sku.description                               AS sku,
         (
                SELECT l.value
                FROM   Unnest(labels) AS l
                WHERE  l.KEY = 'goog-maps-channel' ) AS goog_maps_channel,
         Round(Sum(usage.amount), 2)                 AS usage_amount,
         usage.unit                                  AS usage_unit,
         Round(Sum(cost), 2)                         AS cost,
         cost_type,
         currency
FROM     `PROJECT_ID.DATASET_NAME.gcp_billing_export_v1_BILLING_ACCOUNT_ID`
WHERE    invoice.month = '201906' -- Change the invoice month with the same format as the example.
GROUP BY billing_day,
         invoice_month,
         service,
         sku,
         goog_maps_channel,
         usage_unit,
         cost_type,
         currency
ORDER BY billing_day,
         service,
         sku

Google Cloud Console 中支持多少个渠道?

我们将一如既往地为客户端 ID 请求提供渠道支持,您可以通过控制台中的帐单导出功能访问这些渠道。控制台中支持 1000 个渠道。

我还能继续使用高级计划专有功能(如大型静态地图)吗?

您仍然可以通过现有的高级计划标识符(客户端 ID 或项目 ID)使用高级计划专有功能,但无法通过您创建的新项目使用这些功能。

我可以创建新项目并将其与我的结算帐号相关联吗?

您可以创建新项目,但不能超出配额限制。新项目将无法使用某些高级计划专有功能,例如大型静态地图

我应该停止使用客户端 ID 吗?

尽管在可预见的未来我们不打算终止客户端 ID 的使用,但建议您将应用从使用客户端 ID 身份验证更新为使用 API 密钥身份验证。API 密钥提供等效功能,并在控制台中获得全面的支持。

我应该在哪里管理客户端 ID?

您应继续使用 Google Cloud 支持门户管理客户端 ID:注册授权网址并获取私有加密签名密钥

我的特殊配额会保留下来吗?

会。如果目前超出 Maps 高级计划默认限额的 QPS 对您来说更合算,那么您可以在 Maps Platform 下保留该 QPS 限额(对于任何 API)。

对于 Maps JavaScript API,可用于 JavaScript 服务(地理编码、路线等)的 QPS 仍不受限制。

例外情况:Places API(网络服务和 JavaScript)。您的高级计划合同到期后,Places Library、JavaScript APIPlaces API 将共享 QPS 限额,其默认值为 100 QPS(在高级计划中,Places JavaScript 服务可以使用无限的 QPS,网络服务单独受到限制,其默认 QPS 限额为 50 QPS)。为确保地点产品的共享 QPS 限额足够,我们分析了您的共享流量,并授予可覆盖流量总和的共享 QPS 限额(凑整为下一个最接近的百位数)。今后,在预测增长情况时,您必须确保共享 QPS 限额设置得足够高。如果您需要提高此限额,请与支持团队联系。

我仍然可以获取支持门户使用情况报告吗?

在迁移到随用随付定价模式后的 12 个月内,您可以获取支持门户使用情况报告

我可以在 Google Cloud Platform Console 中查看高级计划客户端 ID 的使用情况吗?

您的客户端 ID 使用情况现在会显示在 Google Cloud Platform Console 中。如需了解详情,请参阅 Google Maps Platform 报告

使用情况报告
您可以在控制台的 Google 地图“指标”页面上查看您的客户端 ID 的相关使用情况。您会在多个图表(流量/错误/按凭据划分的延迟时间)中看到与客户端 ID 使用情况相关的图(带有标签“project_number: 12345678”)。图下方的说明有时没有足够的屏幕空间来显示该标签,在这种情况下,只需将鼠标悬停在图上即可查看整个标签。

此功能适用于目前支持客户端 ID 身份验证的所有 API,Places Library 和 JavaScript API 除外。

控制台的 Google 地图概览信息中心或 Google 地图 API 信息中心上列出了已启用的 API 或 SDK,您可以通过选择其中一个 API 或 SDK,访问“指标”页面。

配额报告
客户端 ID 流量不受高级计划项目的配额限制所约束,因此不会包含在控制台的“配额”报告中。约束客户端 ID 流量的配额限制无法在控制台中直观显示。

结算报告
控制台结算报告现在包含客户端 ID 使用情况。

在哪里可以查看我的结算信息?

如需了解结算功能,请参阅 Google Maps Platform 结算

资源