ข้อความแสดงข้อผิดพลาดใน Maps Static API

Maps Static API อาจแสดงข้อผิดพลาดหรือคำเตือนเมื่อเกิดข้อผิดพลาด คู่มือนี้จะอธิบายข้อความแสดงข้อผิดพลาดแต่ละรายการและให้วิธีการเพิ่มเติมในการแก้ไขข้อผิดพลาด

คำขอที่ไม่ถูกต้อง

ในกรณีที่คำขอไม่ถูกต้อง Maps Static API จะแสดงรหัสสถานะ HTTP 4xx และข้อความที่อธิบายปัญหา ด้านล่างนี้คือตัวอย่างเงื่อนไขข้อผิดพลาดดังกล่าว หมายเหตุ: รายการนี้เป็นเพียงตัวอย่างข้อผิดพลาดที่อาจเกิดขึ้น โปรดตรวจสอบรหัสข้อผิดพลาดจริงและข้อความที่ API แสดงเพื่อดูรายละเอียดของปัญหาที่เฉพาะเจาะจง

ตัวอย่างเงื่อนไขข้อผิดพลาด รหัสสถานะ
คำขอมีพารามิเตอร์ที่ไม่ถูกต้อง หรือไม่มีพารามิเตอร์ที่จำเป็น เช่น พารามิเตอร์ size ไม่ได้อยู่ในช่วงค่าตัวเลขที่คาดไว้ หรือไม่มีอยู่ในคําขอ 400 BAD REQUEST
คีย์ API ที่รวมอยู่ในคําขอไม่ถูกต้อง 403 FORBIDDEN

ข้อผิดพลาดที่ทำให้แผนที่ไม่แสดง

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

รูปภาพแสดงข้อผิดพลาดแทนแผนที่
รูปภาพ: รูปภาพแสดงข้อผิดพลาดแทนแผนที่

หากคุณใช้ Maps Static API โดยไม่มีคีย์ API หรือไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชี หน้าเว็บจะแสดงรูปภาพแสดงข้อผิดพลาดแทนแผนที่ พร้อมลิงก์ที่ระบุประเภทข้อผิดพลาด เช่น "g.co/staticmaperror/key"

ข้อผิดพลาดและวิธีแก้ไขเกี่ยวกับระบบล็อก/ปลดล็อกรถอัตโนมัติ
ข้อผิดพลาดเกี่ยวกับขีดจํากัดการใช้งาน: โหลดแผนที่เกินขีดจํากัดการโหลดแผนที่รายวันที่ระบุ คุณกำลังใช้ Maps Static API โดยไม่มีคีย์ API หากต้องการแก้ไข คุณต้องดำเนินการดังนี้
  1. รับคีย์ API
  2. เปิดใช้การเรียกเก็บเงิน
  3. ลงนาม URL
ข้อผิดพลาดเกี่ยวกับขีดจํากัดการใช้งาน: URL คำขอไม่มีลายเซ็นดิจิทัล คำขอของคุณไม่มีลายเซ็นดิจิทัล (ต้องระบุ) วิธีแก้ไข ลงชื่อ URL

คำเตือน

สำหรับเงื่อนไขข้อผิดพลาดบางประการ API จะแสดงผลแผนที่ แต่ข้อมูลบางอย่างอาจหายไปจากแผนที่ เมื่อเกิดกรณีนี้ขึ้น จะมี 2 เงื่อนไขที่จะแจ้งให้คุณทราบเกี่ยวกับคำเตือน

  • กรณีแรกคือแผนที่แสดงขึ้นโดยมีแถบข้อผิดพลาดสีเหลืองวางซ้อนอยู่ด้านบนแผนที่พร้อมข้อความ "ข้อผิดพลาดของแผนที่: g.co/staticmaperror"
  • 2. API จะแสดงคำเตือนในรูปแบบส่วนหัว HTTP ชื่อ X-Staticmap-API-Warning

ตัวอย่างเช่น URL ต่อไปนี้มีค่าที่ไม่คาดคิดในพารามิเตอร์ markers

https://maps.googleapis.com/maps/api/staticmap?center=Williamsburg,Brooklyn,NY&zoom=13&scale=1&size=400x400&markers=sdgaags&key=YOUR_API_KEY

API แสดงแผนที่ แต่แสดงแถบข้อผิดพลาดสีเหลืองวางซ้อนบนรูปภาพพร้อม "ข้อผิดพลาดของแผนที่: g.co/staticmaperror"

แผนที่แสดงขึ้น แต่มีข้อผิดพลาดเกี่ยวกับแผนที่: g.co/staticmaperror

นอกจากนี้ API จะแสดงผลส่วนหัว HTTP ต่อไปนี้ด้วย

X-Staticmap-API-Warning:Error geocoding: marker 1

ตารางต่อไปนี้อธิบายคำเตือนที่ API อาจแสดงเป็นส่วนหัว HTTP

คำเตือนในส่วนหัว X-Staticmap-API-Warning
Error geocoding: [center, ][marker #number, ][visible #num, ][path #num, ]* เกิดข้อผิดพลาดขณะพยายามจับคู่พิกัดภูมิศาสตร์ของคำขอ ข้อความนี้มีรูปแบบต่างๆ มากมาย โดยขึ้นอยู่กับองค์ประกอบที่การจับคู่พิกัดภูมิศาสตร์ไม่สําเร็จ (จุดศูนย์กลาง เครื่องหมาย ที่มองเห็นได้ หรือเส้นทาง) และจํานวนองค์ประกอบที่ไม่สําเร็จ ตัวอย่างหนึ่งของคำเตือนนี้คือ X-Staticmap-API-Warning:Error geocoding: marker 1 ดังที่แสดงในตัวอย่างด้านบน
Too many geocoded markers requested (max is 15). คำขอระบุเครื่องหมายที่มีที่อยู่ซึ่งมนุษย์อ่านได้มากกว่าจำนวนสูงสุดที่อนุญาต โดยสูงสุดไม่เกิน 15 รายการ โปรดทราบว่าขีดจํากัดนี้มีผลกับเครื่องหมายที่ระบุเป็นที่อยู่ซึ่งมนุษย์อ่านได้ซึ่งต้องใช้การเข้ารหัสพิกัดทางภูมิศาสตร์เท่านั้น และไม่มีผลกับเครื่องหมายที่ระบุด้วยพิกัดละติจูด/ลองจิจูด
Too many geocoded polyline vertices requested (max is 15). คำขอระบุจำนวนเส้นประกอบที่มีที่อยู่ซึ่งมนุษย์อ่านได้เกินจำนวนสูงสุดที่อนุญาต โดยสูงสุดไม่เกิน 15 รายการ โปรดทราบว่าขีดจํากัดนี้มีผลกับเส้นประกอบที่มีจุดยอดที่ระบุเป็นที่อยู่ซึ่งมนุษย์อ่านได้ซึ่งต้องใช้การแปลงพิกัดภูมิศาสตร์เท่านั้น และไม่มีผลกับเส้นประกอบที่ระบุด้วยพิกัดละติจูด/ลองจิจูด

คุณจะเห็นคำเตือนส่วนหัว HTTP ในคอนโซลเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Chrome, Firefox Web Console หรือเครื่องมืออื่นๆ ที่เทียบเท่าในเบราว์เซอร์