ข้อความแสดงข้อผิดพลาดใน 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 จะแสดงแผนที่ แต่ข้อมูลบางอย่างอาจ ขาดหายไปจากแผนที่ เมื่อเกิดกรณีนี้ คุณจะระบุคำเตือนได้โดยใช้เงื่อนไขต่อไปนี้

  • แผนที่จะปรากฏพร้อมแถบข้อผิดพลาดสีเหลืองที่ซ้อนทับบน แผนที่พร้อมข้อความ "ข้อผิดพลาดของแผนที่: g.co/staticmaperror"
  • 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, ]* เกิดข้อผิดพลาดขณะพยายามเข้ารหัสภูมิศาสตร์คำขอ ข้อความนี้มีหลายรูปแบบ ขึ้นอยู่กับองค์ประกอบที่การแปลงรหัสพิกัดภูมิศาสตร์ไม่สำเร็จ เช่น center, marker, visible หรือ path และจำนวนองค์ประกอบที่ไม่สำเร็จ ตัวอย่างประกาศเตือนนี้คือ 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 หรือเครื่องมืออื่นๆ ที่เทียบเท่าในเบราว์เซอร์