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

เมื่อเรียกใช้เมธอด 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