Package google.maps.routes.v1alpha

索引

RoutesAlpha

Routes Preferred API。

ComputeCustomRoutes

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 概览。
ComputeRouteMatrix

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 概览。
ComputeRoutes

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 概览。