ข้อมูลอ้างอิงฉบับย่อของ Directions API

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

Directions API: ข้อเท็จจริงสำคัญ

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

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

ใช้ Directions API เมื่อ

  • คุณดูแลรักษาโปรเจ็กต์ที่อยู่ในระบบคลาวด์ของ Google ที่มีอยู่ซึ่งเปิดใช้ Directions API (เดิม) และเรียกใช้ maps/api/directions อยู่แล้ว
  • คุณต้องมีเส้นทางการขับรถ การเดิน การปั่นจักรยาน หรือโหมดโดยสารฝั่งเซิร์ฟเวอร์ (จุดอ้างอิงสำหรับโหมดที่ไม่ใช่โหมดโดยสารเท่านั้น) ในรูปแบบ JSON หรือ XML ในโปรเจ็กต์ที่มีอยู่

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

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

Directions API: การตั้งค่า

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

  • ปัญหา: คำขอไปยัง Directions API (เดิม) จากโปรเจ็กต์ที่ไม่ได้เปิดใช้ API เดิมไม่สำเร็จพร้อมข้อผิดพลาด LegacyApiNotActivatedMapError วิธีแก้ไข: หากคุณเป็นเจ้าของแอป ให้ย้ายข้อมูลไปยัง Routes API ในระหว่างที่ย้ายข้อมูลหรือรอการอัปเดตแอป คุณสามารถเปิดใช้งาน API เดิมได้โดยกรอกแบบฟอร์มการเปิดใช้งาน API เดิมเพื่อเป็นวิธีแก้ปัญหาในระยะสั้น ดู /maps/legacy
  • ปัญหา: การใช้คำนำหน้า via: กับจุดอ้างอิงจะทำให้จุดอ้างอิงเป็นจุดผ่านที่เข้มงวด ซึ่งอาจทำให้เกิดการอ้อมอย่างมากหรือสถานะ ZERO_RESULTS วิธีแก้ไข: ใช้จุดอ้างอิงแบบแวะพัก (ไม่มีคำนำหน้า via:) เว้นแต่จะต้องใช้จุดผ่านที่เข้มงวด ดู /maps/documentation/directions/get-directions
  • ปัญหา: คำขอที่มีจุดอ้างอิง 11 ถึง 25 จุด, optimize:true, ระยะเวลาที่คำนึงถึงสภาพการจราจร (duration_in_traffic) หรือตัวปรับแต่งตำแหน่ง side_of_road หรือ heading จะเรียกเก็บเงินตาม SKU ของ Directions Advanced (Pro) ที่สูงกว่า วิธีแก้ไข: ใช้ฟีเจอร์เหล่านี้เมื่อจำเป็นเท่านั้น โดยจำกัดจุดอ้างอิงไว้ที่ 10 จุดหรือน้อยกว่า และละเว้น optimize:true, departure_time (สำหรับการขับรถ), side_of_road และ heading เพื่อใช้ SKU Essentials ต่อไป ดู /maps/billing-and-pricing/sku-details/legacy#directions-advanced-pro-sku
  • ปัญหา: สำหรับการขับรถ departure_time จะเป็นอดีตไม่ได้ (คำขอจะดำเนินการไม่สำเร็จพร้อมข้อผิดพลาด INVALID_REQUEST) หากไม่มี departure_time เส้นทางและระยะเวลาจะใช้การจราจรเฉลี่ยที่ไม่ขึ้นอยู่กับเวลา และระบบจะไม่แสดงผล duration_in_traffic วิธีแก้ไข: ตั้งค่า departure_time เป็น now หรือเวลาในอนาคตด้วย mode=driving เพื่อรับ duration_in_traffic คำขอที่แสดงผล duration_in_traffic จะเรียกเก็บเงินตาม SKU ของ Directions Advanced (Pro) ดู /maps/documentation/directions/get-directions