Routes Preferred API 目前仅适用于部分客户。如需了解详情,请
与销售人员联系。
Package google.maps.routes.v1alpha
使用集合让一切井井有条
根据您的偏好保存内容并对其进行分类。
RoutesAlpha
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 概览。
|
如未另行说明,那么本页面中的内容已根据知识共享署名 4.0 许可获得了许可,并且代码示例已根据 Apache 2.0 许可获得了许可。有关详情,请参阅 Google 开发者网站政策。Java 是 Oracle 和/或其关联公司的注册商标。
最后更新时间 (UTC):2023-12-02。
[{
"type": "thumb-down",
"id": "missingTheInformationINeed",
"label":"没有我需要的信息"
},{
"type": "thumb-down",
"id": "tooComplicatedTooManySteps",
"label":"太复杂/步骤太多"
},{
"type": "thumb-down",
"id": "outOfDate",
"label":"内容需要更新"
},{
"type": "thumb-down",
"id": "translationIssue",
"label":"翻译问题"
},{
"type": "thumb-down",
"id": "samplesCodeIssue",
"label":"示例/代码问题"
},{
"type": "thumb-down",
"id": "otherDown",
"label":"其他"
}]
[{
"type": "thumb-up",
"id": "easyToUnderstand",
"label":"易于理解"
},{
"type": "thumb-up",
"id": "solvedMyProblem",
"label":"解决了我的问题"
},{
"type": "thumb-up",
"id": "otherUp",
"label":"其他"
}]
{
"last_modified": "最后更新时间 (UTC):2023-12-02。",
"state": ""
}