เหตุผลที่ควรใช้ 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 ถึง C
- A ถึง D
- B ถึง C
- B ถึง D
ตัวอย่างต่อไปนี้แสดงคำขอสำหรับต้นทาง 2 แห่ง ได้แก่ Washington, DC และ Boston ที่มีปลายทางเดียวคือนิวยอร์กซิตี้ นิวยอร์ก ในรูปแบบ 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, Python Client, Go Client และ Node.js สำหรับบริการ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่รองรับชุมชน และเป็นโอเพนซอร์สภายใต้ใบอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณยังสามารถดูวิธีการติดตั้งและโค้ดตัวอย่างได้อีกด้วย
ขั้นตอนถัดไป
- เริ่มใช้เมทริกซ์ระยะทาง: ไปที่เริ่มต้นใช้งาน
- เริ่มต้นใช้งานคำขอและการตอบกลับตัวอย่าง: ไปที่คำขอและการตอบกลับ Distance Matrix
- ทำตามแนวทางปฏิบัติแนะนำ: ไปที่แนวทางปฏิบัติแนะนำสำหรับบริการเว็บ