从预览版中迁移

Routes API 于 2022 年 9 月发布为公开预览版（正式发布前）。正式发布前的产品或功能受 Google Maps Platform 服务专用条款的约束。如需了解详情，请参阅发布阶段说明。

本部分介绍如何将应用从预览版迁移到正式版。

正式版中增加的新功能

正式版添加了预览版中未包含的以下新功能：

  • 除了地点 ID 和纬度/经度坐标外，您现在还可以在 GA 版本中指定位置，方法如下：

    • 地址字符串（“伊利诺伊州芝加哥市”或“澳大利亚新南威尔士州达尔文市”）

      地址字符串通常是用户输入地址的方式。不过，{product_name} 必须先在内部对地址字符串进行地理编码，将其转换为纬度/经度坐标，然后才能计算路线。

      此外，新增了对 regionCode 请求参数的支持，可让您指定返回特定地理区域的地理编码结果。

    • Plus 代码

      Plus Code 类似于没有实际地址的人物或地点的街道地址。Plus Code 基于纬度和经度，以数字和字母形式显示，而不是以街道名称和门牌号开头的地址。

  • 计算路由响应现在包含 geocodingResults 数组。对于请求中指定为地址字符串或 Plus Code 的每个位置（出发地、目的地或中间航点），API 会执行地点 ID 查询。此数组的每个元素都包含与某个营业地点对应的地点 ID 以及有关该营业地点的其他元数据。请求中指定为地点 ID 或纬度/经度坐标的位置会被忽略。

现有预览版功能的变化

现在，您必须通过向请求添加新的数组 extraComputations 字段，在 Google Analytics（分析）中明确启用以下功能：

在预览版中，您使用字段掩码指定在响应中返回这些功能的信息。现在，您必须同时执行以下操作：

  • 设置新的 extraComputations 数组请求参数即可启用这些功能。
  • 设置要指定的字段掩码，以在响应中返回信息。

重要须知

除非通过设置 extraComputations 明确启用，否则 computeRouteMatrix 响应中将不再包含以下字段：

  • travelAdvisory.tollInfo（收费信息）

除非通过设置 extraComputations 明确启用，否则 computeRoutes 响应中将不再包含以下字段：

  • routes.legs.travelAdvisory.tollInfo（收费信息）
  • routes.travelAdvisory.tollInfo（收费信息）
  • routes.travelAdvisory.fuelConsumptionMicroliters（耗油量）
  • routes.travelAdvisory.speedReadingIntervals（多段线上的路况）
  • routes.legs.travelAdvisory.speedReadingIntervals（多段线上的路况）

我需要做什么？

如需接收多段线上通行费信息、油耗或路况的响应字段，您必须将新的请求数组字段 extraComputations 设置为包含以下一个或多个值：

  • 如需接收收费信息，请将新的 extraComputations 数组字段设置为 "TOLLS"。

  • 如需接收耗油量，请将新的 extraComputations 数组字段设置为 "FUEL_CONSUMPTION"。

  • 如需接收多段线上的路况信息，请将新的 extraComputations 数组字段设置为 "TRAFFIC_ON_POLYLINE"。