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-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- เริ่มต้นใช้งาน: ตั้งค่า Distance Matrix API
- ข้อมูลอ้างอิง: เอกสารอ้างอิง Distance Matrix API
- ราคา: การใช้งานและการเรียกเก็บเงินของ Distance Matrix API
- นโยบาย: นโยบาย Distance Matrix 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 APIcomputeRouteMatrix(ที่มีส่วนหัวX-Goog-FieldMask) เปิดใช้งาน API เดิมตามแบบฟอร์มเท่านั้นเพื่อเป็นมาตรการระยะสั้น ดู /maps/legacy#LegacyApiNotActivatedMapError