ภาพรวม Distance Matrix API

นักพัฒนาซอฟต์แวร์ในเขตเศรษฐกิจยุโรป (EEA)

บทนำ

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

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

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

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

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

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

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

แผนที่แสดงต้นทางและปลายทางบนแผนที่และในการตอบกลับของ API

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

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

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

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

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