เลือกช่องที่จะส่งคืน

เมื่อเรียกใช้เมธอด ComputeRoutes() คุณต้องระบุช่องที่ต้องการให้แสดงผลในการตอบกลับ โดยใช้ฟิลด์มาสก์การตอบกลับ ซึ่งคุณระบุด้วยพารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask ดูข้อมูลเพิ่มเติมได้ที่พารามิเตอร์ของระบบ

มาสก์ฟิลด์

ค่ามาสก์ของฟิลด์คือรายการเส้นทางของฟิลด์ที่คั่นด้วยคอมมา เส้นทางของแต่ละฟิลด์คือรายการชื่อฟิลด์ที่คั่นด้วยจุดซึ่งแสดงลำดับชั้นของข้อความ ชื่อฟิลด์คือคีย์ออบเจ็กต์ JSON หรือชื่อแท็กฟิลด์ protobuf เส้นทางของฟิลด์จะเริ่มต้นจากประเภทข้อความตอบกลับระดับบนสุด และอาจตามด้วยจุดอย่างน้อย 1 จุด แล้วตามด้วยชื่อฟิลด์ระดับถัดไป โดยทั่วไปแล้ว เส้นทางฟิลด์จะสร้างขึ้นในลักษณะต่อไปนี้

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

มาสก์ฟิลด์กรณีพิเศษคือไวลด์การ์ด "*" ซึ่งจะเลือกฟิลด์ระดับรูททั้งหมด

ตัวอย่าง

ตัวอย่างต่อไปนี้แสดงวิธีตั้งค่ามาสก์ฟิลด์สำหรับเมธอด ComputeRoutes()

ตัวอย่างที่ 1

ฟิลด์มาสก์ของฟิลด์ที่ใช้ได้ทั้งหมด (สำหรับการตรวจสอบด้วยตนเอง)

X-Goog-FieldMask: *

ตัวอย่างที่ 2

มาสก์ฟิลด์ของระยะเวลา ระยะทาง และเส้นประกอบระดับเส้นทาง (ตัวอย่างการตั้งค่าเวอร์ชันที่ใช้งานจริง)

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

เราไม่แนะนำให้ใช้มาสก์ช่องการตอบกลับแบบไวลด์การ์ด (*) หรือระบุมาสก์ช่องที่ระดับบนสุด (เส้นทาง) ในเวอร์ชันที่ใช้งานจริง การเลือกเฉพาะช่องที่ต้องการ

• ช่วยให้เซิร์ฟเวอร์ของเราประหยัดรอบการประมวลผล ซึ่งช่วยให้เราแสดงผลลัพธ์โดยมีเวลาในการตอบสนองต่ำลง

• ช่วยให้ประสิทธิภาพเวลาในการตอบสนองมีความเสถียร เราอาจเพิ่มช่องการตอบกลับอีกในอนาคต และช่องใหม่เหล่านั้นอาจต้องใช้เวลาในการประมวลผลเพิ่มเติม หากเลือกช่องทั้งหมดหรือเลือกช่องทั้งหมดที่ระดับบนสุด คุณอาจพบว่าประสิทธิภาพลดลงเนื่องจากช่องใหม่ที่เราเพิ่มจะรวมอยู่ในการตอบกลับโดยอัตโนมัติ

• ส่งผลให้การตอบกลับมีขนาดเล็กลง ซึ่งหมายถึงอัตราการส่งผ่านข้อมูลในเครือข่ายที่สูงขึ้น

ดูข้อมูลเพิ่มเติมเกี่ยวกับวิธีสร้างเส้นทางของช่องได้ที่ field_mask.proto