ข้อความแสดงข้อผิดพลาดใน 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, ]* เกิดข้อผิดพลาดขณะพยายามเข้ารหัสพิกัดภูมิศาสตร์ของคำขอ ข้อความนี้มีหลายรูปแบบ ขึ้นอยู่กับองค์ประกอบที่เข้ารหัสพิกัดภูมิศาสตร์ไม่สำเร็จ (กึ่งกลาง เครื่องหมาย มองเห็นได้ หรือเส้นทาง) และจำนวนองค์ประกอบที่ล้มเหลว ตัวอย่าง 1 ของคำเตือนนี้คือ 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 หรือเครื่องมืออื่นๆ ที่เทียบเท่ากันในเบราว์เซอร์