从预览版中迁移

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

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

正式版中增加的新功能

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

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

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

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

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

    • Plus Code

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

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

现有预览版功能的变化

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

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

  • 设置新的 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"。