ข้อความแสดงข้อผิดพลาดใน 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, Web Console ของ Firefox หรือเครื่องมืออื่นๆ ที่เทียบเท่าในเบราว์เซอร์