ภาพรวม 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	เขียนคําขอที่ซับซ้อนมากขึ้น	ลองใช้คำขอที่ระบุต้นทางและปลายทางหลายแห่ง ดูข้อมูล เกี่ยวกับพารามิเตอร์ที่เป็นตัวเลือกเพื่อจำกัดการคำนวณ เช่น เวลาออกเดินทางหรือข้อจำกัดด้านเส้นทาง โปรดดูพารามิเตอร์ที่ไม่บังคับ ในคู่มือคำขอและการตอบกลับของ Distance Matrix
4	ทำความเข้าใจพื้นฐานของคำตอบ	สำรวจการตอบกลับข้อมูลเพื่อเตรียมใช้ข้อมูลเมทริกซ์ระยะทางสำหรับแอป โปรดดู การตอบสนองของเมทริกซ์ระยะทาง เพื่อดูรายละเอียด
5	รวมข้อมูลเมตริกระยะทางไว้ในแอปของคุณเอง	คุณใช้ข้อมูลนี้เพื่อคำนวณระยะทางและเวลาเดินทางได้

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

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

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

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

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

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