Routes API 快速参考

Routes API 是一项 Web 服务,提供两种方法:Compute Routes 可返回两个地点之间的路线,并可选择添加中间航点;Compute Route Matrix 可返回出发地和目的地组合的行程距离和时间(最多 625 个路线矩阵元素)。

Routes API:关键信息

  • 产品:Routes API
  • 别名:Routes API v2、Compute Routes、Compute 路线矩阵
  • 类别:路线
  • 平台:Web 服务 (REST)
  • 运行位置:服务器(后端代码)
  • 发布阶段:GA
  • 生命周期:有效
  • 概览:Routes API 概览
  • 适用区域:全球。两轮车路线规划、环保路线和通行费计算功能仅在受支持的国家/地区和城市提供,并且除非另有说明,否则不支持具有专属 CLDR 代码的属地。对于欧洲经济区 (EEA) 的账单邮寄地址,https://developers.google.com/maps/comms/eea/routes 上的 EEA 条款禁止在任何地图中使用路线说明或步骤。(覆盖范围详情)

Routes API:何时使用

在以下情况下使用 Routes API:

  • 您需要一条连接起点和终点的路线,可选择添加中间航点,并支持驾车、步行、骑行、两轮车或公交等多种出行方式。
  • 您需要在一个请求中获取多个出发地-目的地对(最多 625 个元素)的行程距离和时间。
  • 您需要估算通行费(部分城市)、环保路线(部分地区)、路况感知多段线或大型车辆路线规划(功能有限)。
  • 您正在将服务器应用从旧版 Directions API 或 Distance Matrix API 迁移。

在以下情况下,请勿使用 Routes API:

  • 您需要为整个车队优化负载分配和经停点顺序。请改用 Route Optimization API。
  • 您需要在 Android 上提供应用内精细导航,以便用户按照计算出的路线行驶。请改用 Navigation SDK for Android。
  • 您需要在 iOS 上提供应用内精细导航,以便用户按照计算出的路线行驶。请改用 Navigation SDK for iOS。

Routes API:设置

官方 Routes API 软件包:

  • npm:@googlemaps/routing
  • pypi:google-maps-routing
  • go:cloud.google.com/go/maps
  • maven:com.google.maps:google-maps-routing

Routes API:常见错误

  • 问题:没有默认的返回字段列表;不含字段掩码(X-Goog-FieldMask 标头或 $fields 参数)的请求会返回错误。解决方法:始终发送列出您需要的响应字段的字段掩码。请参阅 /maps/documentation/routes/choose_fields。
  • 问题:在生产环境中使用通配符字段掩码 (*) 会增加费用和延迟时间,并且随着响应中添加新的高级功能,费用可能会意外增加。解决方法:仅在开发期间使用 *;在生产环境中,仅请求您需要的字段。请参阅 /maps/documentation/routes/choose_fields。
  • 问题:仅将通行费信息和油耗添加到字段掩码中并不会返回这些信息;自正式版起,必须明确启用这些信息。解决方法:除了字段掩码之外,还要将 extraComputations 数组(例如 TOLLS、FUEL_CONSUMPTION)添加到请求中。请参阅 /maps/documentation/routes/migrate-routes-preview。
  • 问题:计算路线矩阵允许 625 个元素,但当 routingPreference 为 TRAFFIC_AWARE_OPTIMAL 时,仅允许 100 个元素。解决方法:使用 TRAFFIC_AWARE_OPTIMAL 时,请将起点数 x 终点数保持在 100 或以下,或拆分请求。请参阅 /maps/documentation/routes/compute_route_matrix。

Routes API 的用途

请参阅下面链接的指南,了解每项任务,或在功能探索器中比较不同产品。