Routes Preferred API 目前仅适用于部分客户。如需了解详情，请与销售人员联系。

计算路线矩阵

您可以使用 Routes Preferred API 的 ComputeRouteMatrix 方法针对多个出发地和目的地计算路线的距离和时长。ComputeRouteMatrix 支持流式传输 gRPC 调用和 REST HTTP 调用。

给定出发地和目的地对的列表，ComputeRouteMatrix 会计算路线的从每个出发地开始，到每个目的地结束的距离和时长。数据流的每个元素都对应于单个路线的信息。

与距离矩阵服务相比，ComputeRouteMatrix 方法具有多项优势：

  • 流式传输允许在计算整个矩阵之前返回元素，从而缩短延迟时间。
  • ComputeRouteMatrix 具有精细的流量计算选项，可让您权衡质量延迟情况。
  • 请求在 Google 基础架构中以更高的优先级运行，因此可用性更高。
  • 您可以为航点指定方向（行程方向）和道路一侧信息。
  • 您可以请求返回通行费信息，以及路线距离和预计到达时间。

启用 ComputeRouteMatrix 方法

您必须先启用 ComputeRouteMatrix 方法，然后才能在代码中使用该方法。如需详细了解如何启用 Routes Preferred API 方法，请参阅使用入门。

使用 ComputeRouteMatrix 方法

ComputeRouteMatrix 方法可通过 Routes Preferred v1 端点使用。

如需了解详情，请参阅以下文档：

gRPC：https://developers.google.com/maps/documentation/routes_preferred/reference/rpc/google.maps.routes.v1

REST：https://developers.google.com/maps/documentation/routes_preferred/reference/rest/v1/TopLevel/computeRouteMatrix

以下常规步骤介绍了如何使用 gRPC 调用 ComputeRouteMatrix 方法：

  1. 从 googleapis 代码库中签出必要的协议缓冲区：

    https://github.com/googleapis/googleapis/tree/master/google/maps/routes

    请注意，某些构建系统（例如 Go）可能会自动为您执行此操作。

  2. 使用您的首选语言和构建工具集生成相关的协议缓冲区代码。

  3. 生成请求。必须随请求发送两段必需的元数据：

    • X-Goog-Api-Key 必须设置为您的 API 密钥。

    • X-Goog-Fieldmask 必须设置为响应中要求包含的字段的逗号分隔列表。例如，X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status。 您可以使用通配符 (*) 来表示所有字段，但我们不建议这样做。使用通配符来测试和理解 API 响应，但在生产代码中的字段掩码中明确列出所需的字段。

      如需详细了解如何构建字段掩码字符串，请参阅 https://github.com/protocolbuffers/protobuf/blob/master/src/google/protobuf/field_mask.proto。请注意，停用您不需要的字段可以缩短延迟时间，因为这些字段可能需要进一步计算。如果您指定所需的字段，并且稍后添加了需要更多计算的新字段，延迟时间将保持稳定。

  4. 将您的请求发送至 routespreferred.googleapis.com:443。您必须使用 TLS 协议。

如需查看使用 ComputeRouteMatrix 方法的示例，请参阅计算路线矩阵（Beta 版）示例。

ComputeRouteMatrix 方法的一个不同之处在于，可以为整个数据流或单个元素返回错误代码。例如，如果请求的格式不正确（例如，请求的源数为零），则流连接会返回错误。但是，如果错误仅出现在数据流中的几个元素（例如，为出发地设置无效的地点 ID），则只有受该错误影响的元素会包含错误代码。

数据流返回的元素不保证会按任何顺序返回。因此，每个元素都包含一个 origin_index 和一个 destination_index。对于请求指定的出发地和目的地，对于给定元素，路线出发地等同于 origins[origin_index]，而路线目的地则等同于 destinations[destination_index]。这些数组为零索引。请务必存储出发地和目的地列表顺序。

正在计算通行费

如需了解如何计算通行费，请参阅计算通行费。

如需查看计算通行费的示例，请参阅计算路线矩阵示例。