从 Directions API 或 Distance Matrix API 迁移

本指南介绍了如何迁移使用 Directions API 或 Distance Matrix API 来使用 Routes API。如需详细了解 Routes API,请参阅 product 概览

更新 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 支持将路径点指定为编码多段线,以便在网址限制为 16384 个字符的情况下容纳大量路径点。此功能不支持 因为航点可以通过 REST 或 gRPC 请求正文作为纬度/经度坐标。如需查看示例,请参阅计算路线矩阵文档中的 HTTP 示例,或指定中间航点文档中的定义中间航点

转换参数

下表列出了 Directions API 和 Distance Matrix API 中已重命名或修改的参数,或 GA 版本不支持的参数。如果您使用的是上述任何参数,请更新您的代码。

请求参数转换

路线或距离矩阵参数 Routes API 参数 备注
alternatives computeAlternativeRoutes
arrival_time arrivalTime 仅在 TRANSIT 模式下可用,不支持相同的模式 时长为 departureTime
avoid routeModifiers
departure_time departureTime 无法与arrivalTime同时使用。
language languageCode 仅适用于计算路由。
mode travelMode

添加了对 TWO_WHEELERTRANSIT

region regionCode
traffic_model trafficModel 了解详情
transit_mode "travelMode": "TRANSIT" 在 Directions API 中,在公交路线中 行程中包含相同出行方式的路段(例如,步行或 公交路线)视为一个步骤,并且各个路线的 出行方式在子阶段中的占比。相比之下,在 Routes API,路段一直是一条导航指令 。因此,每条导航指令都是一个步骤。 对于一种出行方式中的多个路段,Routes API 提供 元数据,其中包含该出行方式步骤摘要, `stepsOverview`.要请求此元数据,请使用 “routes.legs.stepsOverview”字段掩码。 了解详情
transit_routing_preference transitRoutingPreference 了解详情
units 不适用于路线矩阵。
waypoints intermediates 移除了对编码多段线的支持。
optimize=true 适用于航点 "optimizeWaypointOrder": "true" 了解详情

响应参数转化

路线或距离矩阵参数 Routes API 参数 备注
copyrights

未包含在回答中。您必须添加以下内容 语句:

Powered by Google, ©YEAR Google

例如:

Powered by Google, ©2022 Google

distance distanceMeters 距离只能以米为单位。
duration_in_traffic duration 已从 Routes API 中移除,请改用 duration
status 不可用。使用 HTTP 响应代码 报告的错误。请参阅处理请求错误
geocoded_waypoints geocoding_results 仅适用于计算路由。仅包含指定为地址的航点的地理编码响应信息。
bounds viewport
legs.end_address 不可用。
legs.start_address 不可用。
overview_polyline 多段线
summary description
waypoint_order optimizedIntermediateWaypointIndex