หน้านี้อธิบายข้อความแสดงข้อผิดพลาดที่ Embed API ของ Maps อาจแสดง เมื่อเกิดข้อผิดพลาดขึ้น Embed Maps API จะแสดงข้อความแสดงข้อผิดพลาดแทนแผนที่ นอกจากนี้ ยังอาจเกิดข้อผิดพลาดบางอย่างขึ้น ซึ่งส่งผลให้แผนที่ที่มีลายน้ำปรากฏขึ้นแบบมืดลง
คำขอที่ไม่ถูกต้อง
ในกรณีที่คำขอไม่ถูกต้อง Maps Embed API จะแสดงรหัสสถานะ HTTP 4xx และข้อความที่อธิบายปัญหา ด้านล่างนี้คือตัวอย่างเงื่อนไขข้อผิดพลาดดังกล่าว หมายเหตุ: รายการนี้เป็นเพียงตัวอย่างข้อผิดพลาดที่อาจเกิดขึ้น โปรดตรวจสอบรหัสข้อผิดพลาดจริงและข้อความที่ API แสดงเพื่อดูรายละเอียดของปัญหาที่เฉพาะเจาะจง
| ตัวอย่างเงื่อนไขข้อผิดพลาด | รหัสสถานะ |
|---|---|
คำขอมีพารามิเตอร์ที่ไม่ถูกต้อง หรือไม่มีพารามิเตอร์ที่จำเป็น เช่น พารามิเตอร์ zoom ไม่ได้อยู่ในช่วงค่าตัวเลขที่คาดไว้ หรือคำขอไม่มีพารามิเตอร์ที่จําเป็น |
400 BAD REQUEST |
| คีย์ API ที่รวมอยู่ในคําขอไม่ถูกต้อง | 403 FORBIDDEN |
ข้อผิดพลาดเกี่ยวกับคีย์ API และโควต้า
ระบบจะถือว่าข้อผิดพลาดเกี่ยวกับคีย์ API และโควต้าเป็นคำขอที่ไม่ถูกต้อง สาเหตุที่เป็นไปได้มีดังนี้
- ไม่มีคีย์ API หรือคีย์ API ไม่ถูกต้อง หากต้องการแก้ไขข้อผิดพลาดนี้ ให้ตรวจสอบว่าคำขอของคุณมีคีย์ API ที่ถูกต้อง รับคีย์ API
- ไม่ได้เปิดใช้ Maps Embed API สำหรับโปรเจ็กต์ของคุณ ดูข้อมูลเกี่ยวกับการเปิดและปิดใช้ API
- คีย์ API มีการละเมิดข้อจํากัด อ่านข้อมูลเพิ่มเติมเกี่ยวกับแนวทางปฏิบัติแนะนำสำหรับคีย์ API
ข้อผิดพลาดเกี่ยวกับการเรียกเก็บเงินและ HTTP Referer
ระบบจะแสดงแผนที่ที่มืดลงหรือรูปภาพ Street View "เชิงลบ" ที่มีลายน้ำ"สำหรับการพัฒนาเท่านั้น" เมื่อเงื่อนไขต่อไปนี้เป็นจริง
- ไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชีของคุณ เปิดใช้การเรียกเก็บเงิน
- วิธีเรียกเก็บเงินที่ระบุไม่ถูกต้อง (เช่น บัตรเครดิตหมดอายุ) หากต้องการแก้ไขปัญหานี้ ให้ไปที่คอนโซล Google Cloud และตรวจสอบว่าคุณได้ระบุวิธีการชำระเงินที่ถูกต้อง
- เกินขีดจำกัดการใช้งานต่อวันที่กำหนดไว้เอง ดูวิธีดูหรือเปลี่ยนขีดจํากัดการเรียกเก็บเงินรายวัน
- คำขอไม่มีผู้อ้างอิง HTTP และคุณใช้คีย์ API ที่จำกัดผู้อ้างอิง ดูข้อมูลเพิ่มเติมเกี่ยวกับการเพิ่มผู้อ้างอิง
ตรวจสอบข้อผิดพลาดในเบราว์เซอร์
สําหรับข้อผิดพลาดเกี่ยวกับการเรียกเก็บเงินและผู้อ้างอิง HTTP ทาง Maps Embed API จะเขียนข้อความแสดงข้อผิดพลาดไปยัง window.console สําหรับคําขอที่ไม่ถูกต้อง (รวมถึงข้อผิดพลาดเกี่ยวกับคีย์ API และโควต้า) ระบบจะรายงานเฉพาะรหัสสถานะ HTTP 4xx ในคอนโซล ส่วนนี้จะอธิบายวิธีตรวจสอบเอาต์พุตคอนโซลใน Google Chrome หากคุณใช้เบราว์เซอร์อื่น โปรดดูเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์นั้น ต่อไปนี้เป็นรายการเครื่องมือสำหรับตรวจสอบเอาต์พุตคอนโซลในเบราว์เซอร์อื่นๆ
- คอนโซลสําหรับ Internet Explorer
- Web Console สําหรับ Firefox
- การแก้ไขข้อบกพร่องจากระยะไกลสำหรับ Android
- Web Inspector สำหรับ iOS
ใน Chrome คุณสามารถใช้คอนโซล JavaScript เพื่อตรวจสอบเอาต์พุตคอนโซลได้ ดังนี้
- หากต้องการเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ ให้เลือกไอคอนเมนู > เครื่องมือเพิ่มเติม > เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์
- หากต้องการเปิดคอนโซล JavaScript ให้คลิกแท็บคอนโซลที่ด้านบนของหน้าต่างเครื่องมือสําหรับนักพัฒนาซอฟต์แวร์ คุณใช้แป้น ESC เพื่อเปิด/ปิดคอนโซล JavaScript ได้ด้วย