从预览版中迁移

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

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

正式版中新增的功能

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

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

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

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

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

  • Plus Code

    Plus Code 就像是未分配实际地址的人员或地点的街道地址。Plus Code 不使用包含街道名称和门牌号码的地址，而是以经纬度为依据，并以数字和字母的形式显示。

• 计算路线响应现在包含 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"。