Maps Static API อาจแสดงข้อผิดพลาดหรือคำเตือนเมื่อมีบางอย่างไม่ถูกต้อง คู่มือนี้จะอธิบายข้อความแสดงข้อผิดพลาดแต่ละข้อ และให้คำแนะนำเพิ่มเติมในการแก้ไขข้อผิดพลาด
คำขอที่ไม่ถูกต้อง
ในกรณีที่คำขอไม่ถูกต้อง Maps Static API จะแสดงรหัสสถานะ HTTP 4xx
และข้อความที่อธิบายปัญหา ด้านล่างนี้คือตัวอย่างของเงื่อนไขข้อผิดพลาดดังกล่าว หมายเหตุ: นี่ไม่ใช่รายการข้อผิดพลาดทั้งหมดที่อาจเกิดขึ้น โปรดตรวจสอบรหัสข้อผิดพลาดและข้อความแสดงข้อผิดพลาดจริงที่ API ส่งคืนเพื่อดูรายละเอียดปัญหาที่เฉพาะเจาะจง
ตัวอย่างเงื่อนไขข้อผิดพลาด | รหัสสถานะ |
---|---|
คำขอมีพารามิเตอร์ที่ไม่ถูกต้อง หรือพารามิเตอร์ที่จำเป็น
ไม่มี เช่น พารามิเตอร์ size ไม่ได้อยู่ในช่วงของค่าตัวเลขที่คาดไว้ หรือไม่ได้อยู่ในคำขอ |
400 BAD REQUEST |
คีย์ API ในคำขอไม่ถูกต้อง | 403 FORBIDDEN |
ข้อผิดพลาดที่ทำให้แผนที่ไม่แสดง
หากคำขอถูกต้อง แต่เกิดข้อผิดพลาดอื่นที่ทำให้แสดงแผนที่ไม่ได้ Maps Static API จะแสดงข้อความหรือรูปภาพข้อผิดพลาดแทนแผนที่ ทั้งนี้ขึ้นอยู่กับข้อผิดพลาดนั้น ตัวอย่างของเงื่อนไขข้อผิดพลาดดังกล่าวก็คือเมื่อแอปพลิเคชันใช้เกินขีดจำกัดการใช้งาน
![รูปภาพแสดงข้อผิดพลาดแสดงขึ้นแทนแผนที่](https://developers.google.cn/static/maps/documentation/maps-static/images/error-image-generic.png?authuser=5&hl=th)
ข้อผิดพลาดเกี่ยวกับคีย์ API และการเรียกเก็บเงิน
หากคุณใช้ Maps Static API โดยไม่มีคีย์ API หรือหากไม่ได้เปิดใช้การเรียกเก็บเงินในบัญชี หน้านั้นจะแสดงรูปภาพข้อผิดพลาดแทนแผนที่ พร้อมลิงก์แสดงประเภทของข้อผิดพลาด ตัวอย่างเช่น "g.co/staticmaperror/key"
ข้อผิดพลาดที่ไม่มีคีย์และวิธีแก้ไขปัญหา | |
---|---|
![]() |
คุณกำลังใช้ Maps Static API โดยไม่มีคีย์ API คุณต้องดำเนินการต่อไปนี้เพื่อแก้ปัญหา |
![]() |
คำขอของคุณไม่มีลายเซ็นดิจิทัล (จำเป็น) โปรด ลงนาม 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](https://developers.google.cn/static/maps/documentation/maps-static/images/map-warning.png?authuser=5&hl=th)
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 หรือเครื่องมืออื่นๆ ที่เทียบเท่ากันในเบราว์เซอร์