ภาพรวมระยะทางเมทริกซ์ API

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

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

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

คุณใช้ Distance Matrix API ทำอะไรได้บ้าง

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

Range Matrix API จะให้ข้อมูลตามเส้นทางที่แนะนำระหว่างต้นทางกับปลายทาง คุณสามารถขอข้อมูลระยะทางประเภทต่างๆ ต่อไปนี้

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

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

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

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

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

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

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

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

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

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