เหตุผลที่ควรใช้ Distance Matrix API
คุณใช้ Distance Matrix API เพื่อช่วยกำหนดเส้นทางการเดินทางที่มีประสิทธิภาพที่สุดระหว่างต้นทางและปลายทางที่เป็นไปได้หลายแห่ง เช่น พนักงานคนใดที่จะส่งไปยังไซต์งาน หรือคลังสินค้าสำหรับส่งพัสดุ
สิ่งที่คุณทำได้ด้วย Distance Matrix API
Distance Matrix API ช่วยให้คุณระบุระยะทางและเวลาเดินทางสำหรับเมทริกซ์ของต้นทางและจุดหมายได้ คุณสามารถระบุตัวเลือกได้หลายแบบ เช่น รูปแบบการเดินทาง เช่น การขับรถ จักรยาน ขนส่งสาธารณะ หรือการเดิน รวมทั้งรูปแบบการเดินทาง เช่น รถประจำทาง รถไฟใต้ดิน รถไฟ รถราง หรือรถไฟ
Distance Matrix API จะให้ข้อมูลตามเส้นทางที่แนะนำระหว่างจุดเริ่มต้นและจุดสิ้นสุด คุณสามารถขอข้อมูลระยะทางประเภทต่อไปนี้
- ระยะทางสำหรับรูปแบบการเดินทางที่เลือก
- ระยะทางเป็นกิโลเมตรหรือไมล์
- ระยะเวลาเดินทางโดยประมาณเมื่อรถติด
Distance Matrix API ทำงานอย่างไร
Distance Matrix API จะใช้ต้นทาง (จุดเริ่มต้น) และจุดหมายกี่จุดก็ได้ และส่งคืนระยะทางและเวลาเดินทางระหว่างแต่ละต้นทางกับปลายทางที่ขอทั้งหมด โดยเริ่มจากต้นทางแรกในคำขอ แล้วดำเนินการต่อทีละขั้น
ตัวอย่างเช่น หากคำขอระบุ A และ B เป็นต้นทาง และเลือก C และ D เป็นปลายทาง คำขอจะแสดงระยะทางและเวลาเดินทางตามลำดับต่อไปนี้
- ก ถึง ค
- A ถึง D
- B ถึง C
- B ถึง D
ตัวอย่างต่อไปนี้แสดงคำขอต้นทาง 2 แห่ง ได้แก่ วอชิงตัน ดี.ซี. และบอสตัน โดยมีปลายทางเดียวคือนิวยอร์กซิตี้ รัฐนิวยอร์ก ในรูปแบบ JSON
https://maps.googleapis.com/maps/api/distancematrix/json ?destinations=New%20York%20City%2C%20NY &origins=Washington%2C%20DC%7CBoston &units=imperial &key=YOUR_API_KEY
แหล่งข้อมูล
ตารางต่อไปนี้สรุปทรัพยากรที่พร้อมใช้งานผ่าน Distance Matrix API พร้อมกับข้อมูลที่แสดงผล
แหล่งข้อมูล | ข้อมูลที่ส่งคืน | รูปแบบการคืนสินค้า |
---|---|---|
เมทริกซ์ระยะทาง
ระบุต้นทางและปลายทางในรูปแบบรหัสสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูด |
|
|
วิธีใช้ Distance Matrix API
1 | ตั้งค่าเลย | เริ่มต้นจากตั้งค่าโปรเจ็กต์ Google Cloud แล้วทำตามวิธีการตั้งค่าต่อไปนี้ให้เสร็จสิ้น |
2 | ลองใช้คำขอเมทริกซ์ระยะทาง | เมื่อมีคีย์ API แล้ว คุณสามารถเริ่มทดสอบ Distance Matrix API จากเบราว์เซอร์ได้โดยตรง ดูตัวอย่างคำขอในคู่มือเริ่มต้นใช้งานเพื่อดูตัวอย่าง |
3 | เขียนคำขอที่ซับซ้อนมากขึ้น | ลองใช้คําขอที่ใส่ต้นทางและปลายทางหลายรายการ ดูข้อมูลเกี่ยวกับพารามิเตอร์ที่ไม่บังคับเพื่อจำกัดการคำนวณ เช่น เวลาออกเดินทางหรือข้อจำกัดด้านเส้นทางที่ระบุ โปรดดูพารามิเตอร์ที่ไม่บังคับ ในคู่มือคำขอและการตอบกลับเมทริกซ์ระยะทาง |
4 | ทําความเข้าใจพื้นฐานของคําตอบ | สำรวจการตอบสนองของข้อมูลเพื่อเตรียมใช้ข้อมูลเมทริกซ์ระยะทางสำหรับแอป ดูรายละเอียดได้ที่ การตอบสนองของเมทริกซ์ระยะทาง |
5 | รวมข้อมูลเมทริกซ์ระยะทางลงในแอปของคุณเอง | คุณใช้ข้อมูลนี้เพื่อคำนวณระยะทางและเวลาเดินทางได้ |
ไลบรารีของไคลเอ็นต์ที่ใช้ได้
เรียก API นี้ในภาษาที่คุณต้องการผ่านไลบรารีของไคลเอ็นต์ดังต่อไปนี้
- ไคลเอ็นต์ Java สำหรับบริการ Google Maps
- ไคลเอ็นต์ Python สำหรับบริการ Google Maps
- ไคลเอ็นต์ Go สำหรับบริการของ Google Maps
- ไคลเอ็นต์ Node.js สำหรับบริการของ Google Maps
Java Client, Python Client, Go Client และ Node.js Client สำหรับบริการ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่สนับสนุนโดยชุมชนและเป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดเวอร์ชันดังกล่าวได้จาก GitHub ซึ่งคุณจะดูวิธีการติดตั้งและโค้ดตัวอย่างได้ด้วย
ขั้นตอนถัดไป
- เริ่มใช้เมทริกซ์ระยะทาง โดยไปที่เริ่มต้นใช้งาน
- เริ่มต้นใช้งานด้วยคำขอและคำตอบตัวอย่าง โดยไปที่คำขอและการตอบกลับ Distance Matrix
- ทำตามแนวทางปฏิบัติแนะนำ: ไปที่แนวทางปฏิบัติแนะนำของบริการบนเว็บ