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