Package google.maps.routes.v1alpha

rpc ComputeCustomRoutes(ComputeCustomRoutesRequest) returns (ComputeCustomRoutesResponse)

给定一组航点和中间航点以及路线目标，将根据路线目标计算最佳路线。返回最快路线和最短路线作为参考路线。

注意：此方法要求您在输入中指定响应字段掩码。您可以通过以下两种方式提供响应字段掩码：使用网址参数 $fields 或 fields，或者使用 HTTP/gRPC 标头 X-Goog-FieldMask（请参阅可用的网址参数和标头）。该值是以英文逗号分隔的字段路径列表。请参阅有关如何构造字段路径的详细文档。

例如，在此方法中：

• 所有可用字段的字段掩码（适用于人工检查）：X-Goog-FieldMask: *
• 路线距离、时长、令牌和过路费信息的字段掩码：X-Goog-FieldMask: routes.route.distanceMeters,routes.route.duration,routes.token,routes.route.travelAdvisory.tollInfo

Google 不建议使用通配符 (*) 响应字段掩码，也不建议在顶级 (routes) 指定字段掩码，因为：

• 仅选择您需要的字段有助于我们的服务器节省计算周期，从而以更低的延迟将结果返回给您。
• 在生产作业中仅选择您需要的字段，以确保延迟性能稳定。我们未来可能会添加更多响应字段，这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会出现性能下降，因为我们添加的任何新字段都会自动包含在响应中。
• 仅选择您需要的字段可减小响应大小，从而实现更高的网络吞吐量。

授权范围

需要以下 OAuth 范围：

• https://www.googleapis.com/auth/maps-platform.routespreferred

如需了解详情，请参阅 OAuth 2.0 概览。

rpc ComputeRouteMatrix(ComputeRouteMatrixRequest) returns (RouteMatrixElement)

接受出发地和目的地的列表，并返回包含每种出发地和目的地组合的路线信息的数据流。

注意：此方法要求您在输入中指定响应字段掩码。您可以使用网址参数 $fields 或 fields，或使用 HTTP/gRPC 标头 X-Goog-FieldMask 提供响应字段掩码（请参阅可用的网址参数和标头）。该值是以英文逗号分隔的字段路径列表。请参阅有关如何构建字段路径的详细文档。

例如，在此方法中：

• 所有可用字段的字段掩码（用于手动检查）：X-Goog-FieldMask: *
• 路线时长、距离、元素状态、条件和元素索引的字段掩码（一个生产设置示例）：X-Goog-FieldMask: originIndex,destinationIndex,status,condition,distanceMeters,duration

请务必在字段掩码中添加 status，否则所有消息都将显示为正常。Google 不建议使用通配符 (*) 响应字段掩码，因为：

• 仅选择您需要的字段有助于我们的服务器节省计算周期，从而以更低的延迟将结果返回给您。
• 在生产作业中仅选择您需要的字段，以确保延迟性能稳定。我们未来可能会添加更多响应字段，这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会出现性能下降，因为我们添加的任何新字段都会自动包含在响应中。
• 仅选择您需要的字段可减小响应大小，从而实现更高的网络吞吐量。

授权范围

需要以下 OAuth 范围：

• https://www.googleapis.com/auth/maps-platform.routespreferred

如需了解详情，请参阅 OAuth 2.0 概览。

rpc ComputeRoutes(ComputeRoutesRequest) returns (ComputeRoutesResponse)

在给定一组终端和中间航点的情况下，返回主路线以及可选的备选路线。

注意：此方法要求您在输入中指定响应字段掩码。您可以通过以下两种方式提供响应字段掩码：使用网址参数 $fields 或 fields，或者使用 HTTP/gRPC 标头 X-Goog-FieldMask（请参阅可用的网址参数和标头）。该值是以英文逗号分隔的字段路径列表。请参阅有关如何构造字段路径的详细文档。

例如，在此方法中：

• 所有可用字段的字段掩码（用于手动检查）：X-Goog-FieldMask: *
• 路线级时长、距离和多段线的字段掩码（生产设置示例）：X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline.encodedPolyline

Google 不建议使用通配符 (*) 响应字段掩码，也不建议在顶级 (routes) 指定字段掩码，因为：

• 仅选择您需要的字段有助于我们的服务器节省计算周期，从而以更低的延迟将结果返回给您。
• 在生产作业中仅选择您需要的字段，以确保延迟性能稳定。我们未来可能会添加更多响应字段，这些新字段可能需要额外的计算时间。如果您选择所有字段，或者选择顶级的所有字段，则可能会出现性能下降，因为我们添加的任何新字段都会自动包含在响应中。
• 仅选择您需要的字段可减小响应大小，从而实现更高的网络吞吐量。

授权范围

需要以下 OAuth 范围：

• https://www.googleapis.com/auth/maps-platform.routespreferred

如需了解详情，请参阅 OAuth 2.0 概览。