从预览版中迁移

欧洲经济区 (EEA) 开发者

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

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

正式版中新增的功能

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

  • 除了地点 ID 和纬度/经度坐标之外，您现在还可以在正式版中使用以下方式 指定位置：

    • 地址字符串（“Chicago, IL”或 “Darwin, NT, Australia”）

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

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

    • Plus 代码

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

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

对现有预览版功能的更改

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

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

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