บทนำ
Compute Routes เป็นเมธอดในบริการ Routes API ที่ยอมรับ คำขอ HTTPS และแสดงเส้นทางที่เหมาะสมที่สุดระหว่าง 2 สถานที่ แสดงเส้นทางพร้อมสภาพการจราจรแบบเรียลไทม์สำหรับขนส่งสาธารณะ การปั่นจักรยาน การขับรถ ยานพาหนะ 2 ล้อที่ใช้เครื่องยนต์ หรือการเดินระหว่างหลายสถานที่
ต้องการเมทริกซ์เส้นทางใช่ไหม หากสนใจเมทริกซ์เส้นทาง โปรดดูภาพรวม Compute Route Matrix
กำลังย้ายข้อมูลใช่ไหม หากคุณกำลังย้ายข้อมูลจาก Distance Matrix API (เดิม) โปรดดูวิธีการย้ายข้อมูลโดยเริ่มจาก เหตุผลที่ควรย้ายข้อมูลไปยัง Routes API
เหตุผลที่ควรใช้เส้นทางการประมวลผล
เมื่อใช้ Compute Routes คุณจะกำหนดเส้นทางสำหรับยานพาหนะหรือแพ็กเกจได้ตามต้องการ พร้อมทั้งเพิ่มประสิทธิภาพด้านต้นทุนและคุณภาพด้วยรายละเอียดเส้นทางที่หลากหลาย
สิ่งที่คุณทำได้ด้วยเส้นทางการคำนวณ
Routes API Compute Routes ช่วยให้คุณทำสิ่งต่อไปนี้ได้
ขอเส้นทางสำหรับการเดินทางด้วยวิธีต่างๆ และสำหรับจุดหมายปลายทางเดียวหรือหลายแห่ง
รูปแบบการเดินทาง: ขนส่งสาธารณะ ขับรถ ยานพาหนะสองล้อ รถบรรทุก เดิน หรือปั่นจักรยาน
ชุดจุดแวะพักที่คุณสามารถเพิ่มประสิทธิภาพเพื่อให้เดินทางไปยังจุดแวะพักเหล่านั้นได้อย่างมีประสิทธิภาพมากที่สุด
ใช้หลายวิธีในการระบุต้นทาง ปลายทาง และจุดแวะพัก
สตริงข้อความ เช่น "ชิคาโก รัฐอิลลินอยส์" "ดาร์วิน นอร์เทิร์นเทร์ริทอรี ออสเตรเลีย" "1800 Amphitheatre Parkway, Mountain View, CA 94043" หรือ "CWF6+FWX Mountain View, California"
รหัสสถานที่
พิกัดละติจูดและลองจิจูด พร้อมด้วยทิศทางของยานพาหนะ (ไม่บังคับ)
ปรับแต่งตัวเลือกเส้นทางตามความต้องการและเป้าหมาย
ปรับแต่งเส้นทางสำหรับรถบรรทุกและยานพาหนะขนาดใหญ่อื่นๆ โดยระบุ แอตทริบิวต์ของยานพาหนะ เช่น ขนาด น้ำหนัก และวัตถุอันตราย ดูรายละเอียดได้ที่ภาพรวมการกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่
เลือกเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานสำหรับประเภทเครื่องยนต์ของรถยนต์ ได้แก่ ดีเซล ไฟฟ้า ไฮบริด และเบนซิน ดูข้อมูลเพิ่มเติมได้ที่ รับเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม
ตั้งค่าตัวเลือกแบบละเอียดสำหรับการคำนวณการเข้าชม เพื่อให้คุณตัดสินใจ เลือกระหว่างคุณภาพกับเวลาในการตอบสนองได้ โปรดดูรายละเอียดที่หัวข้อ ระบุวิธีและระบุว่าจะรวมข้อมูลการจราจรหรือไม่
ตั้งค่าส่วนหัวของยานพาหนะ (ทิศทางการเดินทาง) และข้อมูลด้านข้างของถนน สำหรับจุดอ้างอิงเพื่อเพิ่มความแม่นยำของเวลาถึงโดยประมาณ ดูรายละเอียดได้ที่ ระบุทิศทางของยานพาหนะและด้านข้างของถนน
ระบุตำแหน่งที่ผ่านเทียบกับตำแหน่งปลายทางและตำแหน่งแวะพักที่ปลอดภัย โปรดดูรายละเอียดที่หัวข้อกำหนดจุดแวะพักตามเส้นทางและ กำหนดจุดให้เส้นทางผ่าน
ขอข้อมูลค่าผ่านทางพร้อมระยะทางของเส้นทางและเวลาถึงโดยประมาณ โปรดดูรายละเอียดที่หัวข้อคำนวณค่าธรรมเนียมทางด่วนสำหรับเส้นทาง
ควบคุมเวลาในการตอบสนองและคุณภาพโดยขอเฉพาะข้อมูลที่ต้องการ โดยใช้ Field Mask ซึ่งจะช่วยให้คุณหลีกเลี่ยงเวลาในการประมวลผลที่ไม่จำเป็นและ อัตราการเรียกเก็บเงินสำหรับคำขอที่สูงขึ้น โปรดดูรายละเอียดที่หัวข้อเลือกข้อมูลที่จะแสดง
วิธีการทำงานของเส้นทาง Compute
เมธอด ComputeRoutes ของ Routes API ยอมรับคำขอ HTTP POST ที่มี
เนื้อหาคำขอ JSON ที่มีรายละเอียดคำขอ ต้องระบุต้นทาง ปลายทาง travelMode และฟิลด์มาสก์เพื่อระบุช่องที่จะแสดงผล
ตัวอย่าง
curl -X POST -d '{ "origin": { "address": "1800 Amphitheatre Parkway, Mountain View, CA 94043" }, "destination": { "address": "Sloat Blvd &, Upper Great Hwy, San Francisco, CA 94132" }, "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: routes.duration,routes.distanceMeters' \ 'https://routes.googleapis.com/directions/v2:computeRoutes'
จากนั้นบริการจะคำนวณเส้นทางที่ขอและแสดงผลช่องที่คุณขอ
แหล่งข้อมูล
ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่านเมธอด Compute Routes ของ Routes API พร้อมกับข้อมูลที่ส่งคืน
| แหล่งข้อมูล | ข้อมูลที่แสดงผล | รูปแบบการแสดงผล |
|---|---|---|
| ComputeRoutes | แสดงผลเส้นทาง ขา และขั้นตอนสำหรับเส้นทาง พร้อมเส้นทางอื่น หากมีการขอ | JSON |
วิธีใช้ Compute Routes
| 1 | เริ่มตั้งค่า | เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud และทําตามวิธีการตั้งค่าที่ตามมาให้เสร็จสมบูรณ์ |
| 2 | ทำความเข้าใจวิธีที่ Routes API เรียกเก็บเงิน | โปรดดูข้อมูลที่หัวข้อการใช้งานและการเรียกเก็บเงิน |
| 3 | คำนวณเส้นทางและตรวจสอบการตอบกลับ | ดูข้อมูลเพิ่มเติมได้ที่ ขอเส้นทางและ ตรวจสอบการตอบกลับของเส้นทาง |
ไลบรารีของไคลเอ็นต์ที่พร้อมใช้งาน
ดูรายการไลบรารีของไคลเอ็นต์ที่พร้อมใช้งานสำหรับเส้นทาง Compute ได้ที่ไลบรารีของไคลเอ็นต์
ขั้นตอนถัดไป
- รับเส้นทาง
- ตัวเลือกเส้นทางที่ใช้ได้
- เลือกข้อมูลที่จะแสดง
- ย้ายข้อมูลจาก Directions API (เดิม)
- ย้ายข้อมูลจากเวอร์ชันตัวอย่างของ Routes API ไปยัง GA
