ข้อมูลอ้างอิงด่วนของ Distance Matrix API

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

Distance Matrix API: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Distance Matrix API
  • หรือที่เรียกว่า Distance Matrix API (เดิม), Distance Matrix (เดิม)
  • หมวดหมู่: เส้นทาง
  • แพลตฟอร์ม: บริการผ่านเว็บ (REST)
  • ทำงานใน: เซิร์ฟเวอร์ (โค้ดแบ็กเอนด์)
  • ระยะการเปิดตัว: GA
  • วงจร: เดิม
  • แทนที่ด้วย: Routes API
  • ภาพรวม: ภาพรวมของ Distance Matrix API

Distance Matrix API: กรณีที่ควรใช้

ใช้ Distance Matrix API ในกรณีต่อไปนี้

  • คุณดูแลรักษาโปรเจ็กต์ที่มีอยู่ซึ่งเปิดใช้ Distance Matrix API (เดิม) และเรียกใช้ /maps/api/distancematrix อยู่แล้ว
  • คุณต้องการระยะทางและเวลาเดินทางระหว่างต้นทางหลายแห่งและปลายทางหลายแห่งจากเซิร์ฟเวอร์
  • คุณต้องมีระยะเวลาในการจราจรสำหรับการขับขี่ โดยใช้ departure_time และ traffic_model (ไม่บังคับ)

อย่าใช้ Distance Matrix API ในกรณีต่อไปนี้

  • คุณกำลังเริ่มโปรเจ็กต์ Google Cloud ใหม่ ตั้งแต่เดือนตุลาคม 2026 เป็นต้นไป คุณจะเปิดใช้ Distance Matrix API (เดิม) สำหรับโปรเจ็กต์ใหม่ไม่ได้ โปรดใช้ Routes API แทน
  • คุณต้องการฟีเจอร์ใหม่หรือเมทริกซ์เส้นทางที่มีองค์ประกอบสูงสุด 625 รายการพร้อมการตอบกลับแบบสตรีม (computeRouteMatrix) ให้ใช้ Routes API แทน
  • คุณต้องมีเส้นทางแบบเต็มพร้อมขั้นตอนและเส้นประกอบระหว่างจุดต่างๆ ไม่ใช่แค่ค่าระยะทางและระยะเวลา โปรดใช้ Routes API แทน

Distance Matrix API: การตั้งค่า

Distance Matrix API: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: คำขอฝั่งเซิร์ฟเวอร์แต่ละรายการจำกัดไว้ที่ 100 องค์ประกอบ (ต้นทาง × ปลายทาง) และต้นทาง 25 รายการหรือปลายทาง 25 รายการ คำขอที่มีขนาดใหญ่กว่าจะแสดงผลเป็น MAX_ELEMENTS_EXCEEDED หรือ MAX_DIMENSIONS_EXCEEDED วิธีแก้ไข: แบ่งเมทริกซ์ออกเป็นคำขอที่มีองค์ประกอบไม่เกิน 100 รายการและต้นทางหรือปลายทางไม่เกิน 25 รายการ ดู /maps/documentation/distance-matrix/usage-and-billing#usage-limits
  • ปัญหา: หากคุณไม่ได้ระบุ departure_time เส้นทางและระยะเวลาจะอิงตามการจราจรเฉลี่ยที่ไม่ขึ้นอยู่กับเวลา และระบบจะไม่แสดงผล duration_in_traffic ผลลัพธ์อาจแตกต่างกันไปตามช่วงเวลา วิธีแก้ไข: ตั้งค่า departure_time เป็น now หรือเวลาในอนาคตด้วย mode=driving เพื่อดูระยะเวลาที่อิงตามสภาพการจราจร โปรดทราบว่าระบบจะเรียกเก็บเงินคำขอการเข้าชมในอัตราที่สูงขึ้น ดู /maps/documentation/distance-matrix/distance-matrix
  • ปัญหา: พารามิเตอร์ units จะเปลี่ยนเฉพาะข้อความในช่องระยะทาง ค่าระยะทางจะแสดงเป็นเมตรเสมอ วิธีแก้ไข: อ่าน distance.value เป็นเมตร หรือใช้ distance.text สำหรับการแสดงผล ดู /maps/documentation/distance-matrix/distance-matrix
  • ปัญหา: การเรียก Distance Matrix API (เดิม) จากโปรเจ็กต์ที่ไม่ได้เปิดใช้จะแสดงผล REQUEST_DENIED ใน status และ error_message ที่ลิงก์ไปยัง LegacyApiNotActivatedMapError ผู้ช่วย AI มักจะสร้างโค้ด API เดิมโดยค่าเริ่มต้น วิธีแก้ไข: ย้ายข้อมูลไปยัง Routes API computeRouteMatrix (ที่มีส่วนหัว X-Goog-FieldMask) เปิดใช้งาน API เดิมตามแบบฟอร์มเท่านั้นเพื่อเป็นมาตรการระยะสั้น ดู /maps/legacy#LegacyApiNotActivatedMapError