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

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

คําขอไม่ถูกต้อง

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

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

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

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

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

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

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

คำเตือน

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

  • 1 แผนที่แสดงโดยมีแถบข้อผิดพลาดสีเหลืองวางซ้อนบนแผนที่พร้อมข้อความ "ข้อผิดพลาดของแผนที่: 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). คําขอระบุจํานวน Polylines เกินจํานวนสูงสุดที่อนุญาตซึ่งมีที่อยู่ที่มนุษย์อ่านได้ จํานวนสูงสุดคือ 15 โปรดทราบว่าขีดจํากัดนี้ใช้กับ Polylines ที่มีจุดยอดมุมซึ่งเป็นที่อยู่ที่มนุษย์อ่านได้ ซึ่งต้องมีการเขียนโค้ดภูมิศาสตร์ โดยไม่มีผลกับรูปหลายเหลี่ยมที่ระบุด้วยพิกัดละติจูด/ลองจิจูด

คุณดูคําเตือนส่วนหัว HTTP ได้ในคอนโซล Chrome DevTools, Firefox Web Console หรือเครื่องมือที่เทียบเท่าอื่นๆ ในเบราว์เซอร์