บทนำ
Compute Routes เป็นเมธอดในบริการ Routes API ที่ยอมรับคำขอ HTTPS และแสดงผลเส้นทางที่เหมาะสมที่สุดระหว่างสถานที่ 2 แห่ง แสดงเส้นทางพร้อมข้อมูลการจราจรแบบเรียลไทม์สำหรับการขนส่งสาธารณะ การปั่นจักรยาน การขับรถ การขับขี่ยานพาหนะ 2 ล้อ หรือการเดินระหว่างสถานที่ต่างๆ
ต้องการเมทริกซ์เส้นทางใช่ไหม หากสนใจเมทริกซ์เส้นทาง โปรดดูภาพรวมของ Compute Route Matrix
หากต้องการย้ายข้อมูล หากคุณย้ายข้อมูลจาก Distance Matrix API (เดิม) โปรดดูวิธีการย้ายข้อมูลโดยเริ่มจากเหตุผลที่ควรย้ายข้อมูลไปยัง Routes API
เหตุผลที่ควรใช้ Compute Routes
Compute Routes มีรายละเอียดเส้นทางที่หลากหลาย คุณจึงสามารถกำหนดเส้นทางยานพาหนะหรือพัสดุตามความต้องการได้ พร้อมทั้งเพิ่มประสิทธิภาพด้านต้นทุนและคุณภาพ
คุณทำอะไรได้บ้างด้วย Compute Routes
เมื่อใช้เมธอด Compute Routes ของ Routes API คุณจะทำสิ่งต่อไปนี้ได้
ขอเส้นทางสำหรับการเดินทางด้วยวิธีต่างๆ และสำหรับจุดหมายเดียวหรือหลายจุดหมาย ดังนี้
รูปแบบการเดินทาง: ขนส่งสาธารณะ การขับรถ ยานพาหนะ 2 ล้อ รถบรรทุก การเดิน หรือการปั่นจักรยาน
ชุดจุดอ้างอิงที่คุณสามารถเพิ่มประสิทธิภาพเพื่อให้ได้ลำดับการเดินทางที่มีประสิทธิภาพมากที่สุด
ใช้วิธีต่างๆ ในการระบุจุดเริ่มต้น จุดหมาย และจุดอ้างอิง ดังนี้
สตริงข้อความ เช่น "Chicago, IL", "Darwin, NT, Australia", "1800 Amphitheatre Parkway, Mountain View, CA 94043" หรือ "CWF6+FWX Mountain View, California"
รหัสสถานที่
พิกัดละติจูดและลองจิจูด โดยอาจระบุทิศทางของยานพาหนะด้วย
ปรับแต่งตัวเลือกเส้นทางตามความต้องการและเป้าหมายของคุณ
ปรับแต่งเส้นทางสำหรับรถบรรทุกและยานพาหนะขนาดใหญ่อื่นๆ โดยระบุแอตทริบิวต์ของยานพาหนะ เช่น ขนาด น้ำหนัก และวัตถุอันตราย โปรดดูรายละเอียดที่หัวข้อภาพรวมการกำหนดเส้นทางสำหรับยานพาหนะขนาดใหญ่
เลือกเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานสำหรับประเภทเครื่องยนต์ของรถคุณ ซึ่งได้แก่ ดีเซล ไฟฟ้า ไฮบริด หรือเบนซิน ดูข้อมูลเพิ่มเติมได้ที่ใช้เส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม
ตั้งค่าตัวเลือกแบบละเอียดสำหรับการคำนวณการจราจรของข้อมูล ซึ่งช่วยให้คุณตัดสินใจเลือกคุณภาพเทียบกับเวลาในการตอบสนองได้ โปรดดูรายละเอียดที่หัวข้อระบุวิธีและกรณีที่จะรวมข้อมูลการเข้าชม
ตั้งค่าทิศทางของยานพาหนะ (ทิศทางการเดินทาง) และข้อมูลด้านข้างถนนสำหรับจุดอ้างอิงเพื่อเพิ่มความแม่นยำของ ETA โปรดดูรายละเอียดที่หัวข้อระบุทิศทางของยานพาหนะและด้านข้างของถนน
ระบุสถานที่ผ่านทางเทียบกับสถานที่ปลายทางและสถานที่แวะพักที่ปลอดภัย โปรดดูรายละเอียดที่หัวข้อกำหนดจุดแวะพักตามเส้นทางและกำหนดจุดที่เส้นทางต้องผ่าน
ขอข้อมูลค่าผ่านทาง รวมถึงระยะทางของเส้นทางและเวลาถึงโดยประมาณ โปรดดูรายละเอียดที่หัวข้อคำนวณค่าผ่านทางสำหรับเส้นทาง
ควบคุมเวลาในการตอบสนองและคุณภาพโดยขอเฉพาะข้อมูลที่ต้องการโดยใช้มาสก์ฟิลด์ ซึ่งจะช่วยหลีกเลี่ยงเวลาในการประมวลผลที่ไม่จำเป็นและอัตราการเรียกเก็บเงินสำหรับคำขอที่สูงขึ้น โปรดดูรายละเอียดที่หัวข้อเลือกข้อมูลที่จะแสดงผล
วิธีการทำงานของ Compute Routes
เมธอด 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 Routes ได้ที่ไลบรารีของไคลเอ็นต์
ขั้นตอนถัดไป
- รับเส้นทาง
- ตัวเลือกเส้นทางที่ใช้ได้
- เลือกข้อมูลที่จะแสดงผล
- ย้ายข้อมูลจาก Directions API (เดิม)
- ย้ายข้อมูลจากเวอร์ชันตัวอย่างของ Routes API ไปยังเวอร์ชัน GA
