Routes API 于 2022 年 9 月发布为公开预览版(预发布正式版)。非正式版产品受《Google Maps Platform 服务专用条款》约束。如需了解详情,请参阅发布阶段说明。
本部分介绍了如何将应用从预览版迁移到正式版。
正式版中新增的功能
正式版新增了以下预览版中未包含的功能:
除了地点 ID 和纬度/经度坐标之外,您现在还可以在正式版中使用以下内容指定地点:
地址字符串(例如“伊利诺伊州芝加哥市”或“澳大利亚北领地达尔文市”)
地址字符串通常是用户输入地址的方式。不过,{product_name} 必须先在内部对地址字符串进行地理编码,将其转换为纬度/经度坐标,然后才能计算路线。
此外,还添加了对
regionCode请求参数的支持,该参数可让您指定返回特定地理区域的地理编码结果。-
Plus Code 就像是针对没有实际地址的人或地点的街道地址。与包含街道名称和门牌号码的地址不同,Plus Code 基于经纬度,并以数字和字母的形式显示。
计算路线响应现在包含
geocodingResults数组。对于请求中指定为地址字符串或 Plus Code 的每个位置(出发地、目的地或中途经停点),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"。