Khi gọi phương thức ComputeRoutes(), bạn phải chỉ định những trường mà bạn muốn trả về trong phản hồi. Bạn có thể thực hiện việc này bằng cách sử dụng mặt nạ trường phản hồi mà
bạn cung cấp bằng tham số URL $fields hoặc fields, hoặc bằng cách sử dụng
tiêu đề HTTP/gRPC X-Goog-FieldMask. Để biết thêm thông tin, hãy xem bài viết
Tham số hệ thống.
Mặt nạ trường
Giá trị mặt nạ trường là danh sách các đường dẫn trường được phân tách bằng dấu phẩy. Mỗi đường dẫn trường là một danh sách tên trường được phân tách bằng dấu chấm, đại diện cho hệ phân cấp thông báo. Tên trường là khoá đối tượng JSON hoặc tên thẻ trường protobuf. Đường dẫn trường bắt đầu từ loại thông báo phản hồi cấp cao nhất, và có thể được theo sau bằng một hoặc nhiều dấu chấm, sau đó là tên trường ở cấp tiếp theo. Nhìn chung, đường dẫn trường được tạo theo cách sau:
topLevelField[.secondLevelField][.thirdLevelField][...]
Mặt nạ trường trường hợp đặc biệt là ký tự đại diện "*", chọn tất cả các trường ở cấp gốc.
Ví dụ
Ví dụ sau đây minh hoạ cách thiết lập mặt nạ trường cho phương thức ComputeRoutes().
Ví dụ 1
Mặt nạ trường của tất cả các trường có sẵn (để kiểm tra thủ công).
X-Goog-FieldMask: *
Ví dụ 2
Mặt nạ trường của thời lượng, khoảng cách và hình nhiều đường ở cấp Tuyến đường (ví dụ về thiết lập phát hành công khai).
X-Goog-FieldMask: routes.duration,routes.distanceMeters,routes.polyline
Bạn không nên sử dụng mặt nạ trường phản hồi ký tự đại diện (*) hoặc chỉ định mặt nạ trường ở cấp cao nhất (tuyến đường) trong quá trình sản xuất. Chỉ chọn những trường bạn cần:
Cho phép máy chủ của chúng tôi lưu các chu kỳ xử lý, nhờ đó chúng tôi có thể trả về kết quả cho bạn với độ trễ thấp hơn.
Đảm bảo hiệu suất độ trễ ổn định. Chúng tôi có thể thêm nhiều trường phản hồi hơn trong tương lai và những trường mới đó có thể cần thêm thời gian tính toán. Nếu bạn chọn tất cả các trường hoặc nếu bạn chọn tất cả các trường ở cấp cao nhất, thì hiệu suất có thể bị giảm vì mọi trường mới mà chúng tôi thêm sẽ tự động được đưa vào phản hồi của bạn.
Giúp giảm kích thước phản hồi, nhờ đó tăng thông lượng mạng.
Để biết thêm thông tin về cách tạo đường dẫn trường, hãy xem field_mask.proto.