从 Directions API 或 Distance Matrix API 迁移

本指南介绍了如何将使用 Directions API 或 Distance Matrix API 的应用改为使用 Routes API。如需详细了解 Routes API,请参阅产品概览

更新 REST API 端点

更新您的代码以使用新的 Routes API 端点

来自 Directions API

Directions API https://maps.googleapis.com/maps/api/directions/outputFormat?parameters
Routes API https://routes.googleapis.com/directions/v2:computeRoutes

通过 Distance Matrix API

Distance Matrix API https://maps.googleapis.com/maps/api/distancematrix/outputFormat?parameters
Routes API https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix

将网址参数转换为使用 HTTPS 请求正文

借助 Directions API 和 Distance Matrix API,您可以将配置属性作为网址参数传递给 HTTP GET 请求。例如,对于 Directions API:

https://maps.googleapis.com/maps/api/directions/outputFormat?parameters

借助 Routes API,您可以在请求正文或标头中作为 HTTP POST 请求的一部分传递参数。有关示例,请参阅:

将以编码多段线表示的航点转换为中间航点

您可以在 Directions API 中将航点指定为编码多段线,这样可以容纳 8192 个字符的网址限制中的大量航点。Routes API 中不需要此功能,因为航点可以在 REST 或 gRPC 请求正文中作为中间航点传输。

将现有参数转换为 Routes API 参数

下表列出了 Directions API 和 Distance Matrix API 中已重命名或修改的参数,或正式版中不支持的参数。如果您使用了以下任一参数,请更新您的代码。

路线或距离矩阵参数 Routes API 参数 备注
alternatives computeAlternativeRoutes
arrival_time 无法使用,因为无法使用TRANSIT模式。
avoid routeModifiers
copyrights

不会包含在响应中。向用户显示结果时,您必须添加以下语句:

Powered by Google, ©YEAR Google

例如:

Powered by Google, ©2022 Google

departure_time departureTime
distance distanceMeters 距离仅以米为单位。
duration_in_traffic 在 Routes API 中已移除,请使用 duration。如需了解详情,请参阅上文全新 Routes API 的功能变化
language languageCode 仅适用于计算路由。
mode travelMode

添加了对 TWO_WHEELER 的支持。

无法使用“TRANSIT”模式。

region regionCode

status 不可用。对于 API 报告的错误,可以使用 HTTP 响应代码。如需了解详情,请参阅处理请求错误
traffic_model 不可用。
transit_mode 无法使用,因为无法使用TRANSIT模式。
transit_routing_preference 无法使用,因为无法使用TRANSIT模式。
units 不适用于路线矩阵。
waypoints intermediates 不再支持编码多段线
optimize=true 个航点 不可用。