เมื่อคุณกำลังพิจารณาเส้นทางที่ดีที่สุดสำหรับการเดินทางโดยร่วมเดินทาง เส้นทางที่เร็วที่สุดอาจไม่ใช่ตัวเลือกที่ดีที่สุดเสมอไป คุณอาจต้องวางแผนเส้นทาง
Routes Preferred API ช่วยให้คุณวางแผนเส้นทางได้โดยระบุวัตถุประสงค์ของเส้นทางโดยใช้เมธอด ComputeCustomRoutes
เมธอด ComputeCustomRoutes ยังช่วยในการปฏิบัติตามข้อกำหนดของเส้นทางอีกด้วย โดยให้คุณลดความแตกต่างระหว่างเส้นทางที่โอเปอเรเตอร์เลือกและเส้นทางที่ผู้ดำเนินการเลือก
ใช้ทั้ง Routes Preferred API และ navigation SDK เพื่อให้ทราบถึงประโยชน์ทั้งหมดของการวางแผนเส้นทาง
เปิดใช้เมธอด ComputeCustomRoutes
ก่อนที่คุณจะสามารถใช้เมธอด ComputeCustomRoutes ในโค้ดได้ คุณต้องเปิดใช้งานก่อน ดูข้อมูลเพิ่มเติมเกี่ยวกับการเปิดใช้เมธอด API ของ Routes Preferred ได้ในการเริ่มต้นใช้งาน
ใช้เมธอด ComputeCustomRoutes
เมธอด ComputeCustomRoutes กำหนดให้คุณต้องระบุมาสก์ช่องการตอบกลับในอินพุต คุณระบุมาสก์ช่องการตอบกลับได้โดยใช้พารามิเตอร์ของ URL $fields หรือ fields หรือใช้ส่วนหัว HTTP/gRPC X-Goog-FieldMask ดูข้อมูลเพิ่มเติมได้ที่พารามิเตอร์ระบบ
ค่ามาสก์ของช่องเป็นรายการเส้นทางช่องที่คั่นด้วยคอมมา เส้นทางช่องแต่ละเส้นทาง คือรายการชื่อช่องที่คั่นด้วยจุดซึ่งแสดงถึงลำดับชั้นของข้อความ ชื่อช่องคือคีย์ออบเจ็กต์ JSON หรือชื่อแท็กช่อง Protobuf เส้นทางช่องจะเริ่มต้นจากประเภทข้อความตอบกลับระดับบนสุด และอาจตามด้วยจุดอย่างน้อย 1 จุด แล้วจึงตามด้วยชื่อช่องระดับถัดไป โดยทั่วไปแล้ว เส้นทางของฟิลด์จะสร้างขึ้นในลักษณะต่อไปนี้
topLevelField[.secondLevelField][.thirdLevelField][...]
มาสก์ช่องกรณีพิเศษคือไวลด์การ์ด "*" ซึ่งจะเลือกช่องระดับรากทั้งหมด
ดูข้อมูลเพิ่มเติมได้ที่
ดูตัวอย่างการใช้เมธอด ComputeCustomRoutes ได้ในตัวอย่างการคำนวณเส้นทางที่กำหนดเอง (เบต้า)
กำลังคำนวณค่าผ่านทาง
สำหรับข้อมูลเกี่ยวกับการคำนวณค่าผ่านทาง โปรดดูที่คำนวณค่าผ่านทาง
ดูตัวอย่างการคำนวณค่าผ่านทางได้ที่การคำนวณตัวอย่างเส้นทางที่กำหนดเอง