ภาพรวม Distance Matrix API

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

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