选择要返回的字段

调用 ComputeRoutes() 方法时,您必须指定要 返回的值。为此,您可以使用响应字段掩码 您提供网址参数 $fieldsfields,或使用 HTTP/gRPC 标头 X-Goog-FieldMask。如需了解详情,请参阅 系统参数

字段掩码

字段掩码值是以英文逗号分隔的字段路径列表。每个字段路径 是以点分隔的字段名称列表,表示消息层次结构。字段名称是 JSON 对象键或 protobuf 字段标记名称。字段路径从顶级响应消息类型开始,后跟一个或多个点(可选),然后是下一级字段名称。一般来说, 字段路径的构建方式如下:

topLevelField[.secondLevelField][.thirdLevelField][...]

特殊情况字段掩码是通配符“*”,用于选择所有根级字段。

示例

以下示例展示了如何为 ComputeRoutes() 方法结合使用。

示例 1

所有可用字段的字段掩码(用于手动检查)。

X-Goog-FieldMask: *

示例 2

路线级时长、距离和多段线的字段掩码(示例生产设置)。

X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline

我们不建议使用通配符 (*) 响应字段掩码,也不鼓励指定 顶级(路由)字段掩码。仅选择所需的字段:

  • 允许我们的服务器节省处理周期,从而 从而缩短延迟时间

  • 确保延迟性能稳定。我们可能会在 这些新字段可能需要额外的计算时间。如果您选择 或者如果您选择顶级的所有字段 因为我们添加的任何新字段都会自动 。

  • 减小响应大小,从而增加网络容量 吞吐量。

如需详细了解如何构建字段路径,请参阅 field_mask.proto