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-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- เริ่มต้นใช้งาน: ตั้งค่า Directions API
- ข้อมูลอ้างอิง: เอกสารอ้างอิง Directions API
- ราคา: การใช้งานและการเรียกเก็บเงินของ Directions API
- นโยบาย: นโยบาย Directions 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