เหตุผลที่ควรใช้ Routes API
Routes API ช่วยให้คุณได้รับข้อมูลเส้นทางและข้อมูลการเดินทางที่แม่นยำโดยใช้รายละเอียดการเดินทาง สภาพการจราจรและสภาพถนนล่าสุด รวมถึงค่ากำหนดเส้นทาง
ประเภทและความสามารถของการขนส่งรูปแบบต่างๆ
ทิศทางที่พาหนะจะมุ่งหน้าไป
บริเวณถนนที่มีรถไปรับหรือส่งคืน
สภาพการจราจรและการปิดถนน
ข้อกังวลด้านความปลอดภัย เช่น การหลีกเลี่ยงพื้นที่อันตราย หรือการให้บริการจุดรับพัสดุที่ปลอดภัย
รักษาสมดุลระหว่างเวลาในการตอบสนอง คุณภาพ และค่าใช้จ่ายตลอดเส้นทางตามความต้องการด้วยฟีเจอร์เสริม เช่น ค่าผ่านทางและข้อมูลเมตาการเดินทาง เช่น เวลาและระยะทาง ตลอดจนการประหยัดพลังงาน
นอกจากนี้ คุณยังสามารถกำหนดเส้นทางที่มีประสิทธิภาพที่สุดสำหรับการกำหนดเวลาการส่งงาน เช่น
วิธีที่ดีที่สุดในการมอบหมายผู้ปฏิบัติงานให้มารับชุดแพ็กเกจ
เลือกคลังสินค้าที่ดีที่สุดสำหรับการจัดส่งพัสดุไปยังปลายทางสุดท้าย
Routes API ใช้ทำอะไรได้บ้าง
Routes API จะให้คุณรับข้อมูลการกำหนดเส้นทาง 2 หมวดหมู่หลักดังนี้
เส้นทางจากสถานที่หนึ่งไปยังจุดหมายเดียวหรือหลายแห่ง
เมทริกซ์ของเส้นทางที่เป็นไปได้ระหว่างตำแหน่งเริ่มต้นและจุดหมายหลายแห่ง
รับเส้นทางสำหรับจุดหมายเดียวหรือหลายแห่ง
เมื่อใช้เมธอด Routes API Compute Routes
คุณจะคำนวณตำแหน่งต่อไปนี้ได้
ดูคำแนะนำสำหรับวิธีการเดินทางต่างๆ และจุดหมายเดียวหรือหลายจุดหมาย ดังนี้
รูปแบบการเดินทาง ซึ่งรวมถึงการขนส่งสาธารณะ การขับขี่ ยานพาหนะ 2 ล้อ การเดิน หรือขี่จักรยาน
ชุดจุดอ้างอิงที่คุณสามารถเพิ่มประสิทธิภาพเพื่อให้ลำดับในการเดินทางไปถึงนั้นมีประสิทธิภาพที่สุด
การระบุต้นทาง ปลายทาง และจุดอ้างอิงมีหลายวิธี
สตริงข้อความ ตัวอย่างเช่น "ชิคาโก, อิลลินอยส์", "ดาร์วิน, นอร์ทแคโรไลนา, ออสเตรเลีย", "1800 Amphitheatre Parkway, Mountain View, CA 94043" หรือ "CWF6+FWX Mountain View, California"
รหัสสถานที่
พิกัดละติจูดและลองจิจูด (ไม่บังคับ) กับทิศทางของยานพาหนะ
ปรับแต่งตัวเลือกเส้นทางตามความต้องการและเป้าหมายของคุณ ดังนี้
เลือกเส้นทางที่ประหยัดเชื้อเพลิงหรือพลังงานสำหรับประเภทเครื่องยนต์ของรถ ได้แก่ ดีเซล ไฟฟ้า ไฮบริด แก๊ส ดูข้อมูลเพิ่มเติมได้ที่รับเส้นทางที่เป็นมิตรต่อสิ่งแวดล้อม
ตั้งค่าตัวเลือกแบบละเอียดสำหรับการคำนวณการเข้าชม ช่วยให้คุณตัดสินใจระหว่างคุณภาพกับเวลาในการตอบสนองได้ โปรดดูรายละเอียดที่หัวข้อระบุวิธีและกรณีที่จะรวมข้อมูลการเข้าชม
ตั้งทิศทางการขับขี่ของรถ (ทิศทางการเดินทาง) และข้อมูลข้างถนนสําหรับจุดอ้างอิงเพื่อเพิ่มความแม่นยําของเวลาถึงโดยประมาณ ดูรายละเอียดได้ที่ระบุทิศทางของรถและด้านข้างของถนน
ระบุ Pass-through เทียบกับตำแหน่งเทอร์มินัล และจุดแวะพักที่ปลอดภัย โปรดดูรายละเอียดที่กำหนดจุดแวะระหว่างเส้นทางและกำหนดจุดสำหรับเส้นทางที่จะผ่าน
ขอข้อมูลค่าผ่านทาง พร้อมระยะทางของเส้นทางและเวลาถึงโดยประมาณ ดูรายละเอียดได้ที่คำนวณค่าผ่านทางสำหรับเส้นทาง
ควบคุมเวลาในการตอบสนองและคุณภาพโดยการขอเฉพาะข้อมูลที่ต้องการโดยใช้ฟิลด์มาสก์ ซึ่งช่วยหลีกเลี่ยงเวลาประมวลผลที่ไม่จำเป็นและมีอัตราการเรียกเก็บเงินคำขอที่สูงขึ้น โปรดดูรายละเอียดที่เลือกข้อมูลที่จะแสดง
รับเมทริกซ์ของเส้นทางที่เป็นไปได้
เมธอด Routes API Compute Route Matrix
จะให้ข้อมูลเมทริกซ์ของข้อมูลเส้นทางที่แนะนำระหว่างจุดเริ่มต้นกับจุดสิ้นสุดหลายจุด รวมถึงระยะทางและเวลาถึงโดยประมาณ เพื่อช่วยให้คุณเลือกต้นทางและปลายทางที่ดีที่สุดตามความต้องการทางธุรกิจของคุณ คุณสามารถขอข้อมูลระยะทางประเภทต่อไปนี้
ระยะทางสำหรับรูปแบบการเดินทางที่เลือก
ระยะทางเป็นกิโลเมตรหรือไมล์
ระยะเวลาเดินทางโดยประมาณเมื่อรถติด
ข้อมูลระยะทางจะช่วยให้คุณเลือกวิธีที่มีประสิทธิภาพมากที่สุดในการกำหนดเส้นทางผู้โดยสาร การจัดส่ง หรือผู้ปฏิบัติงานระหว่างต้นทางและปลายทางที่เป็นไปได้หลายแห่ง
คุณสามารถสตรีมองค์ประกอบของการตอบสนองก่อนที่ระบบจะคำนวณเมทริกซ์ทั้งหมด เพื่อลดเวลาในการตอบสนองของการตอบสนอง
คุณสามารถระบุต้นทางและปลายทางได้หลายรายการต่อคำขอฝั่งเซิร์ฟเวอร์ โดยมีจำนวนต้นทางคูณกับจำนวนปลายทางสูงสุด 625 รายการ
Routes API ทำงานอย่างไร
Routes API มี 2 วิธี ได้แก่ ComputeRoutes
และ ComputeRouteMatrix
ComputeRoutes
เมธอด Routes API ComputeRoutes
จะยอมรับคำขอ 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'
จากนั้นบริการจะคำนวณเส้นทางที่ขอ และแสดงผลช่องที่คุณขอ
ComputeRouteMatrix
Routes API ComputeRouteMatrix
จะยอมรับคำขอ HTTP POST ที่มีเนื้อหาของคำขอ JSON ที่มีรายละเอียดคำขอ ต้องระบุต้นทางอย่างน้อย 1 แห่ง, ปลายทาง 2 แห่งขึ้นไป, travelMode และมาสก์ของช่อง เพื่อระบุช่องที่จะแสดงผล
ตัวอย่าง
curl -X POST -d '{ "origins": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420761, "longitude": -122.081356 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.403184, "longitude": -122.097371 } } } } ], "destinations": [ { "waypoint": { "location": { "latLng": { "latitude": 37.420999, "longitude": -122.086894 } } } }, { "waypoint": { "location": { "latLng": { "latitude": 37.383047, "longitude": -122.044651 } } } } ], "travelMode": "DRIVE" }' \ -H 'Content-Type: application/json' -H 'X-Goog-Api-Key: YOUR_API_KEY' \ -H 'X-Goog-FieldMask: originIndex,destinationIndex,duration,distanceMeters,status,condition' \ 'https://routes.googleapis.com/distanceMatrix/v2:computeRouteMatrix'
คำตอบประกอบด้วยเส้นทางที่เป็นไปได้สำหรับการรวมจุดอ้างอิงต้นทางและปลายทางทั้งหมด
แหล่งข้อมูล
ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Routes API พร้อมกับข้อมูลที่ส่งมา
แหล่งข้อมูล | ข้อมูลที่ส่งคืน | รูปแบบการคืนสินค้า |
---|---|---|
ComputeRoutes | แสดงผลเส้นทาง ขา และขั้นตอนสำหรับเส้นทาง พร้อมด้วยเส้นทางอื่น หากมีการร้องขอ | JSON |
ComputeRouteMatrix | แสดงผลอาร์เรย์ของเส้นทางจากจุดอ้างอิงต้นทางหนึ่งไปยังจุดอ้างอิงปลายทาง 1 แห่ง |
วิธีใช้ Routes API
1 | ตั้งค่า | เริ่มต้นจากตั้งค่าโปรเจ็กต์ Google Cloud แล้วทำตามวิธีการตั้งค่าตามที่ระบุ |
2 | คำนวณเส้นทางและตรวจสอบคำตอบ | ดูข้อมูลเพิ่มเติมได้ที่รับเส้นทางและดูการตอบกลับของเส้นทาง |
3 | คำนวณเมทริกซ์ของเส้นทางและตรวจสอบการตอบสนอง | ดูข้อมูลเพิ่มเติมได้ที่รับเมทริกซ์เส้นทางและดูการตอบสนองของเมทริกซ์เส้นทาง |
ไลบรารีของไคลเอ็นต์ที่ใช้ได้
ดูรายการไลบรารีของไคลเอ็นต์ที่พร้อมใช้งานสำหรับ Routes API ได้ที่ไลบรารีของไคลเอ็นต์