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

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