ภาพรวม Distance Matrix API

Distance Matrix API เป็นบริการที่ยอมรับคําขอ HTTPS ซึ่งมีต้นทางและปลายทางสําหรับรูปแบบการขนส่งหนึ่งๆ สำหรับชุดค่าผสมของต้นทางและปลายทางแต่ละชุด ระบบจะแสดงระยะทางและระยะเวลาในการเดินทาง

เหตุผลที่ควรใช้ Distance Matrix API

คุณสามารถใช้ Distance Matrix API เพื่อช่วยระบุเส้นทางที่มีประสิทธิภาพมากที่สุดระหว่างต้นทางและปลายทางที่เป็นไปได้หลายแห่ง เช่น แรงงานที่จะส่งไปยังสถานที่ทำงาน หรือคลังสินค้าที่จะส่งพัสดุ

API นี้ไม่ได้ออกแบบมาเพื่อแสดงเส้นทาง คุณดูเส้นทางจากต้นทางและปลายทางแห่งเดียวได้โดยใช้ Directions API

สิ่งที่คุณทําได้ด้วย Distance Matrix API

เมื่อใช้ Distance Matrix API คุณสามารถระบุระยะทางและเวลาเดินทางสำหรับเมทริกซ์ต้นทางและปลายทาง คุณสามารถระบุตัวเลือกต่างๆ ได้ ซึ่งรวมถึงรูปแบบการเดินทาง เช่น การขับรถ การปั่นจักรยาน ขนส่งสาธารณะ หรือการเดิน ตลอดจนรูปแบบขนส่งสาธารณะ เช่น รถเมล์ รถไฟใต้ดิน รถไฟ รถราง หรือรถไฟ

Distance Matrix API ให้ข้อมูลตามเส้นทางที่แนะนำระหว่างจุดเริ่มต้นและจุดสิ้นสุด คุณขอข้อมูลระยะทางประเภทต่อไปนี้ได้

• ระยะทางสำหรับโหมดการเดินทางที่เลือก
• ระยะทางเป็นกิโลเมตรหรือไมล์
• เวลาเดินทางโดยประมาณเมื่อเกิดรถติด

วิธีการทํางานของ Distance Matrix API

Distance Matrix API ใช้ต้นทาง (จุดเริ่มต้น) และปลายทางจํานวนเท่าใดก็ได้ และจะแสดงระยะทางและเวลาเดินทางระหว่างต้นทางแต่ละแห่งกับปลายทางทั้งหมดที่ขอ โดยเริ่มจากต้นทางแรกในคําขอ แล้วดำเนินการทีละขั้นต่อไปยังต้นทางถัดไป

ตัวอย่างเช่น หากคำขอระบุ A และ B เป็นต้นทาง และ C และ D เป็นปลายทาง ระบบจะแสดงระยะทางและเวลาเดินทางตามลำดับนี้

• A ถึง 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 พร้อมกับข้อมูลที่แสดง

แหล่งข้อมูล	ข้อมูลที่แสดงผล	รูปแบบการแสดงผล
เมทริกซ์ระยะทาง ระบุต้นทางและปลายทางในรูปแบบรหัสสถานที่ ที่อยู่ หรือพิกัดละติจูด/ลองจิจูด	ระยะทางและเวลาเดินทางระหว่างต้นทางแต่ละแห่งและจุดหมายแต่ละแห่ง ระยะเวลาในการจราจรหากคุณระบุโหมดการขับขี่และเวลาออกเดินทาง	JSON XML

วิธีใช้ Distance Matrix API

1	ตั้งค่า	เริ่มต้นด้วยตั้งค่าโปรเจ็กต์ Google Cloud แล้วทําตามวิธีการตั้งค่าที่ระบุไว้
2	ลองส่งคำขอเมทริกซ์ระยะทาง	เมื่อมีคีย์ API แล้ว คุณสามารถเริ่มทดสอบ Distance Matrix API จากเบราว์เซอร์ได้โดยตรง ดูตัวอย่างคำขอในคู่มือเริ่มต้นใช้งาน
3	เขียนคําขอที่ซับซ้อนมากขึ้น	ลองใช้คำขอที่ระบุต้นทางและปลายทางหลายรายการ ดูข้อมูลเกี่ยวกับพารามิเตอร์ที่ไม่บังคับเพื่อจำกัดการคํานวณ เช่น เวลาออกเดินทางที่ระบุ หรือข้อจํากัดของเส้นทาง ดูพารามิเตอร์ที่ไม่บังคับ ในคู่มือคำขอและการตอบกลับของเมตริกระยะทาง
4	ทำความเข้าใจพื้นฐานของคำตอบ	สำรวจคําตอบของข้อมูลเพื่อเตรียมใช้ข้อมูลเมตริกระยะทางสําหรับแอปของคุณ ดูรายละเอียดได้ที่คําตอบของเมตริกระยะทาง
5	รวมข้อมูลเมตริกระยะทางไว้ในแอปของคุณเอง	คุณใช้ข้อมูลนี้เพื่อคำนวณระยะทางและเวลาเดินทางได้

ไลบรารีของไคลเอ็นต์ที่ใช้ได้

เรียกใช้ API นี้ในภาษาที่ต้องการผ่านไลบรารีของไคลเอ็นต์อย่างใดอย่างหนึ่งต่อไปนี้

• Java ไคลเอ็นต์สําหรับบริการ Google Maps
• ไคลเอ็นต์ Python สำหรับบริการ Google Maps
• Go Client สำหรับบริการ Google Maps
• Node.js ไคลเอ็นต์สําหรับบริการของ Google Maps

ไคลเอ็นต์ Java, ไคลเอ็นต์ Python, ไคลเอ็นต์ Go และไคลเอ็นต์ Node.js สำหรับบริการของ Google Maps เป็นไลบรารีของไคลเอ็นต์ที่ชุมชนสนับสนุนและเป็นโอเพนซอร์สภายใต้สัญญาอนุญาต Apache 2.0 ดาวน์โหลดได้จาก GitHub ซึ่งคุณจะดูวิธีการติดตั้งและโค้ดตัวอย่างได้ด้วย

ขั้นตอนถัดไป

• เริ่มใช้ตารางระยะทาง: ไปที่เริ่มต้นใช้งาน
• เริ่มต้นใช้งานคำขอและคำตอบตัวอย่าง โดยไปที่คำขอและคำตอบของเมตริกระยะทาง
• ทําตามแนวทางปฏิบัติแนะนำ: ไปที่แนวทางปฏิบัติแนะนำสำหรับบริการเว็บ