การแก้ปัญหา

ข้อผิดพลาด

ในกรณีที่เกิดข้อผิดพลาด ระบบจะแสดงผลเนื้อหาการตอบกลับข้อผิดพลาดรูปแบบมาตรฐานและรหัสสถานะ HTTP จะเป็นสถานะข้อผิดพลาด

การตอบกลับมีออบเจ็กต์ error รายการเดียวที่มีคีย์ต่อไปนี้

  • code: นี่คือสถานะเดียวกับสถานะ HTTP ของการตอบกลับ
  • message: คำอธิบายสั้นๆ เกี่ยวกับข้อผิดพลาด
  • status: รหัสสถานะที่ระบุลักษณะของข้อผิดพลาด

ตัวอย่างเช่น การส่งพารามิเตอร์ placeId ที่ไม่ถูกต้องจะแสดงข้อผิดพลาดต่อไปนี้

{
  "error": {
    "code": 400,
    "message": "\"placeId\" value is malformed: \"aChIJqaknMTeuEmsRUYCD5Wd9ARM\"",
    "status": "INVALID_ARGUMENT"
  }
}

ข้อผิดพลาดที่อาจเป็นไปได้ ได้แก่

รหัส สถานะ ข้อความ การแก้ปัญหา
400 INVALID_ARGUMENT คีย์ที่คุณระบุไม่ถูกต้อง คีย์ API ไม่ถูกต้องหรือไม่รวมอยู่ในคำขอ โปรดตรวจสอบว่าคุณระบุทั้งคีย์และได้เปิดใช้ API สำหรับคีย์นี้แล้ว
400 INVALID_ARGUMENT พารามิเตอร์ "\"path\" มีค่าที่ไม่ถูกต้อง: ☃" คำขอของคุณมีอาร์กิวเมนต์ที่ไม่ถูกต้อง สาเหตุที่เป็นไปได้มากที่สุดของข้อผิดพลาดนี้คือ
  • เกิดปัญหากับพารามิเตอร์ path
    โปรดตรวจสอบว่าคุณมีคะแนนอย่างน้อย 1 คะแนนและน้อยกว่า 100 คะแนน แต่ละจุดควรเป็นตัวเลขคู่ โดยคั่นด้วยคอมมา เช่น 48.409114,-123.369158 ควรคั่นด้วยเครื่องหมายไปป์: '|'
  • คำขอของคุณมี placeId ที่ไม่ถูกต้อง
  • คำขอของคุณมีทั้ง placeId และ path ระบุพารามิเตอร์เหล่านี้ได้เพียงรายการเดียวสำหรับแต่ละคำขอ

ข้อผิดพลาดนี้จะไม่แสดงผลหากมีการผ่าน placeId สำหรับถนนที่ไม่มีอยู่อีกต่อไปแล้ว หรือสถานที่ที่ไม่ใช่ถนนเส้นนั้น

403 PERMISSION_DENIED คำขอที่ไม่ได้ลงทะเบียนถูกบล็อก โปรดลงชื่อสมัครใช้ด้วย Google Developers Console คำขอถูกปฏิเสธเนื่องจากเหตุผลอย่างน้อย 1 ข้อต่อไปนี้
  • ไม่มีคีย์ API หรือคีย์ไม่ถูกต้อง
  • ไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชี
  • การใช้งานเกินขีดจํากัดที่กําหนดเองแล้ว
  • วิธีการชำระเงินที่ระบุใช้ไม่ได้แล้ว (เช่น บัตรเครดิตหมดอายุ)

หากต้องการใช้ผลิตภัณฑ์ Google Maps Platform คุณต้องเปิดใช้การเรียกเก็บเงินในบัญชี และคำขอทั้งหมดต้องมีคีย์ API ที่ถูกต้อง หากต้องการแก้ไขปัญหานี้ โปรดทำตามขั้นตอนต่อไปนี้

404 NOT_FOUND จำเป็นต้องใช้ HTTPS สำหรับบริการนี้ โปรดตรวจสอบว่าคุณกำลังส่งคำขอไปยัง https://roads.googleapis.com/ ไม่ใช่ http://roads.googleapis.com/
429 RESOURCE_EXHAUSTED ระบบได้ควบคุมคำขอเนื่องจากมีคำขอโปรเจ็กต์ถึงขีดจำกัดแล้ว คุณส่งคำขอเกินขีดจำกัดตามที่กำหนดค่าไว้ในคอนโซล Google Cloud Platform แล้ว โดยทั่วไปขีดจำกัดนี้จะกำหนดเป็นคำขอต่อวัน คำขอต่อ 100 วินาที และคำขอต่อ 100 วินาทีต่อผู้ใช้ คุณควรกำหนดค่าขีดจำกัดนี้เพื่อป้องกันไม่ให้ผู้ใช้กลุ่มเดียวหรือกลุ่มเล็กๆ ใช้โควต้ารายวันจนหมด ในขณะที่ยังคงอนุญาตให้ผู้ใช้ทั้งหมดเข้าถึงได้ตามสมควร ดูขีดจำกัดการใช้งาน API เพื่อกำหนดค่าขีดจำกัดเหล่านี้

Exponential Backoff

เมื่อคำขอล้มเหลว คุณควรลองส่งคำขออีกครั้งโดยใช้ Exponential Backoff ตัวอย่างเช่น หากคำขอล้มเหลว 1 ครั้ง ให้ลองใหม่หลังจากผ่านไป 1 วินาที หากคำขอไม่สำเร็จ ให้ลองอีกครั้งหลังจากผ่านไป 2 วินาที จากนั้นลองอีกครั้ง 4 วินาที และเรียงตามลำดับไปเรื่อยๆ ซึ่งทำให้มั่นใจได้ว่าคำขอที่ไม่สมบูรณ์หรือความล้มเหลวในวงกว้างจะไม่ทำให้เซิร์ฟเวอร์ของ Google ท่วมท้น เนื่องจากไคลเอ็นต์จำนวนมากพยายามส่งคำขออีกครั้งอย่างรวดเร็ว

คำถามที่พบบ่อยเกี่ยวกับการแก้ปัญหา

ปัญหาการติดตั้งใช้งาน

ฉันควรสุ่มตัวอย่างตำแหน่งรถของฉันที่ความถี่ใด
ขอแนะนำให้ทุกๆ 1-10 วินาทีเพื่อให้ได้ผลลัพธ์แบบรวดเร็วและคุณภาพสูง
มีการจำกัดจำนวนคะแนนที่ฉันสามารถส่งได้ต่อการค้นหาไหม
ได้ การค้นหามีคะแนนได้สูงสุด 100 คะแนน
ฉันควรใช้ความแม่นยำระดับใดเพื่อเก็บคู่ละติจูด/ลองจิจูดที่สแนปไว้
คุณควรจัดเก็บคู่ละติจูด/ลองจิจูดที่สแนปไว้ตรงทศนิยม 7 ตำแหน่งเพื่อให้เส้นทางที่ตัดตามถนนทุกระดับการซูม แม้แต่ที่ระดับการซูมสูงสุด
ฉันจะใช้โพลีไลน์ที่เข้ารหัสเพื่อแสดงเส้นทางที่สแนปได้ไหม
ระบบจะระบุเส้นประกอบที่เข้ารหัสที่ความแม่นยำ 5 หลักเท่านั้น ซึ่งส่งผลให้เกิดข้อผิดพลาดประมาณ 2 เมตร เส้นประกอบที่เข้ารหัสจึงไม่เหมาะสำหรับ หากคุณต้องการให้เส้นทางนั้นตัดผ่านถนนในมุมสูง

ปัญหาที่พบบ่อย

ไม่มีการสแนปบางจุดหรือฉันมีช่องว่างในเส้นทางสแนป ฉันจะแก้ไขได้อย่างไร
  • หากคุณสุ่มตัวอย่างจุดในช่วงเวลาที่กำหนด ให้ตรวจสอบว่าได้สุ่มตัวอย่างจุดในช่วงเวลาที่สั้นลง (ทุกๆ 1-10 วินาที) หากใช้ช่วงเวลาที่นานขึ้น (เช่น 60 วินาที) อัลกอริทึมแบบสแนปไปยังถนนอาจไม่สามารถระบุถนนที่มีความแม่นยำเพียงพอ
  • ถ้าคุณคลิกแผนที่เพื่อสร้างจุดด้วยตัวเอง ก็เป็นเรื่องง่ายมากที่จะสร้างเส้นทางที่มีจุดน้อย หรือบางจุดซึ่งอัลกอริทึมการสแนปทำได้ไม่ดี อัลกอริทึมการสแนปจะทำงานได้ดีที่สุดกับจุด ที่อยู่ใกล้กัน ลองใช้การสาธิตการสแนปไปยังถนนหรือใช้เครื่องมือตรวจสอบถนนเพื่อทดสอบเส้นทาง
ทำไมทางที่ตัดแล้วของฉันจึงเป็นทางขรุขระหรือคดเคี้ยวออกจากถนนเล็กน้อยเมื่อซูมเข้า
  • คุณตัดความแม่นยำของคู่ละติจูด/ลองจิจูดที่สแนปออกก่อนที่จะแสดงคู่เหล่านั้นใช่ไหม การจัดเก็บคู่ละติจูด/ลองจิจูดที่สแนปด้วยความแม่นยำน้อยกว่า 7 จุดทศนิยมจะทําให้เกิดข้อผิดพลาดความแม่นยําเมื่อเส้นทางที่สแนปแสดงบนแผนที่
  • คุณกำลังใช้โพลีไลน์ที่เข้ารหัสใช่ไหม เส้นโพลีไลน์ที่เข้ารหัสจะตัดคู่ละติจูด/ลองจิจูดให้เหลือทศนิยม 5 ตำแหน่ง ทำให้เกิดข้อผิดพลาดหลายเมตร ทำให้มีเส้นที่หยักหรือคดเคี้ยวออกจากถนนเล็กน้อยที่ระดับการซูมสูง

หากไม่ตรงกับกรณีใดๆ ข้างต้น แสดงว่าชิ้นส่วนแผนที่อาจไม่ได้อัปเดตเมื่อเร็วๆ นี้ ซึ่งทำให้ภาพเหล่านั้นไม่ตรงกับดัชนีถนนที่ใช้สำหรับการสแนป หากมีคำค้นหาเพียงไม่กี่รายการที่ได้รับผลกระทบ ก็น่าจะเป็นสาเหตุ เนื่องจาก Google Maps มีการอัปเดตเป็นประจำ จึงอาจเกิดเหตุการณ์นี้เป็นครั้งคราวและเกิดขึ้นได้บ่อยขึ้นหากคุณดูเส้นทางเก่าบนแผนที่เป็นประจำ (เช่น เส้นทางที่ถูกข้ามเมื่อหลายสัปดาห์ก่อน) เพื่อสร้างภาพที่ดีที่สุด คุณควรสแนปเส้นทางเก่าก่อนที่จะแสดงบนแผนที่ เพื่อลดความไม่สอดคล้องกันระหว่างชิ้นส่วนแผนที่และดัชนีถนนที่ใช้ในการสแนป

อะไรเป็นสาเหตุให้การจำกัดความเร็วของถนน X แสดงอย่างไม่ถูกต้อง
ขีดจำกัดความเร็วมาจากแหล่งที่มาหลายแหล่งซึ่งมีความแม่นยำและความครอบคลุมที่แตกต่างกัน หากพบรูปแบบ เช่น การจำกัดความเร็วสำหรับถนนบางประเภท หรือบางพื้นที่ไม่ถูกต้องอย่างต่อเนื่อง โปรดทำตามขั้นตอนต่อไปนี้เพื่อแจ้งให้เราทราบ
  1. เปิด Google Maps บนคอมพิวเตอร์เดสก์ท็อปหรือแอป Google Maps สำหรับ Android
  2. เปิดเมนูด้านซ้าย
  3. เลือกส่งความคิดเห็น หมายเหตุ: ระบบอาจแจ้งให้คุณลงชื่อเข้าใช้
  4. เลือกแก้ไขแผนที่
  5. เลือกส่วนของถนนที่คุณต้องการแก้ไข
  6. เลือกถัดไป
  7. ในช่อง "อื่นๆ" ให้ระบุว่าขีดจำกัดความเร็วสำหรับถนนเส้นนั้นไม่ถูกต้อง
  8. เลือกส่ง
นอกจากนี้ คุณยังรายงานปัญหาอื่นๆ ได้ที่นี่ (เช่น หากถนนมีชื่อไม่ถูกต้อง วาดไม่ถูกต้อง ปิด หรือเป็นส่วนตัว)
ทำไมทางที่ตัดกันถึงตัดมุมแทนที่จะขับตามถนน
หากต้องการแก้ไขปัญหานี้ โปรดตรวจสอบสิ่งต่อไปนี้
  • ตรวจสอบว่าตั้งค่าพารามิเตอร์ interpolate เป็น true
  • ตรวจสอบว่าจุดข้อมูลต้นฉบับได้รับการสุ่มตัวอย่างตามช่วงเวลาที่ใกล้เพียงพอ (ทุกๆ 1-10 วินาที)
ทำไมฉันจึงได้รับส่วนของถนนจำนวนมากที่ส่งคืนในเส้นทางที่ถูกสแนปสำหรับถนนที่ไม่มีการเปลี่ยนแปลงการจำกัดความเร็ว
เมื่อตั้งค่าพารามิเตอร์ interpolate เป็น true การค้นหาแบบสแนปไปยังถนนจะแสดงเส้นประกอบที่ไปตามมุมถนน ทางโค้ง และวงเวียน หากถนนมีความโค้ง ระบบจะแสดงผลหลายส่วนของถนนกลับมาแม้ว่าการจำกัดความเร็วจะไม่เปลี่ยนไป เพื่อสร้างเส้นประกอบที่วิ่งตามเรขาคณิตของถนนอย่างใกล้เคียง