หน้านี้อธิบายข้อความแสดงข้อผิดพลาดที่ Maps JavaScript API แสดงได้ Maps JavaScript API จะเขียนข้อความแสดงข้อผิดพลาดและคำเตือนลงในคอนโซล JavaScript นอกจากนี้ ยังอาจเกิดข้อผิดพลาดบางอย่างขึ้น ซึ่งส่งผลให้แผนที่แสดงเป็นสีเข้มและมีลายน้ำ
ข้อผิดพลาดเกี่ยวกับคีย์ API และการเรียกเก็บเงิน
การแก้ปัญหา
ในบางกรณี ระบบอาจแสดงแผนที่ที่มืดลงหรือรูปภาพ Street View "เชิงลบ" ที่มีลายน้ำเป็นข้อความ "สำหรับวัตถุประสงค์ในการพัฒนาเท่านั้น" ลักษณะการทำงานนี้มักบ่งบอกถึงปัญหาเกี่ยวกับคีย์ API หรือการเรียกเก็บเงิน หากต้องการใช้ผลิตภัณฑ์ Google Maps Platform คุณต้องเปิดใช้การเรียกเก็บเงินในบัญชี และคำขอทั้งหมดต้องมีคีย์ API ที่ถูกต้อง หากต้องการความช่วยเหลือเกี่ยวกับการค้นหาข้อความแสดงข้อผิดพลาด โปรดดูส่วนการตรวจสอบข้อผิดพลาดในเบราว์เซอร์
ขั้นตอนต่อไปนี้จะช่วยคุณแก้ปัญหา
รหัสข้อผิดพลาดของ Maps JavaScript API สำหรับนักพัฒนาซอฟต์แวร์และเจ้าของเว็บไซต์
ตารางต่อไปนี้แสดงรหัสข้อผิดพลาดที่ Maps JavaScript API อาจแสดงพร้อมกับคำอธิบายสาเหตุและวิธีแก้ไขปัญหา หากต้องการความช่วยเหลือในการค้นหาข้อความแสดงข้อผิดพลาด โปรดดูส่วนการตรวจสอบข้อผิดพลาดในเบราว์เซอร์
ข้อผิดพลาดในการโหลดแผนที่
หากพบข้อผิดพลาดขณะโหลด Maps JavaScript API โปรดดูคำอธิบายรหัสข้อผิดพลาดในตารางด้านล่าง
รหัสข้อผิดพลาด | ข้อความ | คำอธิบาย |
---|---|---|
NotLoadingAPIFromGoogleMapsError
|
คุณต้องดาวน์โหลด Maps JavaScript API จากเซิร์ฟเวอร์ของ Google โดยตรง |
องค์ประกอบสคริปต์ที่โหลด Maps JavaScript API ไม่ได้รวมอยู่ในหน้าเว็บอย่างถูกต้อง API ต้องโหลดจาก https://maps.googleapis.com โดยตรงเพื่อให้ทำงานได้อย่างถูกต้อง โปรดดู การโหลด Maps JavaScript API |
TOSViolationMapError
|
ดูเหมือนว่าเว็บไซต์นี้จะละเมิดข้อกำหนดในการให้บริการของ Google Maps API ระบบได้ปิดใช้ Google Maps API สำหรับเว็บไซต์นี้ |
แอปพลิเคชันของคุณถูกบล็อกเนื่องจากไม่ปฏิบัติตามข้อกำหนดในการให้บริการของ Google Maps Platform ตามการแจ้งเตือนทางอีเมลหลายฉบับ หากต้องการอุทธรณ์การบล็อกและรับการตรวจสอบการติดตั้งใช้งาน โปรดกรอก แบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายใน 2-3 วันทำการ หากคุณมีใบอนุญาตแพ็กเกจพรีเมียมของ Google Maps Platform โปรดใช้ข้อมูลเข้าสู่ระบบแพ็กเกจพรีเมียมของ Google Maps Platform เพื่อแก้ไขข้อผิดพลาดนี้ โปรดดูคำแนะนำเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
UnauthorizedURLForClientIdMapError
|
URL นี้ไม่ได้รับอนุญาตให้ใช้รหัสไคลเอ็นต์ Google Maps ที่ระบุ |
รหัสไคลเอ็นต์ของแพ็กเกจพรีเมียมหรือ Maps API for Work ที่รวมอยู่ในการโหลดสคริปต์ไม่ถูกต้อง หมดอายุ หรือยังไม่ได้เพิ่มที่อยู่ปัจจุบันที่โหลด Maps JavaScript API ลงในรายการ URL ที่อนุญาต |
รหัสข้อผิดพลาดของ Maps JavaScript API
หากพบข้อผิดพลาดในคอนโซล JavaScript ของ Chrome, Web Console ของ Firefox หรือเครื่องมืออื่นๆ ที่เทียบเท่าในเบราว์เซอร์ของคุณ โปรดดูคำอธิบายรหัสข้อผิดพลาดในตารางด้านล่าง
Maps JavaScript API จะแสดงทั้งข้อผิดพลาดและคําเตือน ข้อผิดพลาดบ่งบอกถึงปัญหาร้ายแรงที่เกิดขึ้นขณะโหลด Maps JavaScript API หน้าเว็บโหลด API อย่างไม่ถูกต้อง และ API จะไม่ทํางานในหน้านั้น คําเตือนคือข้อความเสริมเกี่ยวกับการโหลด Maps JavaScript API คำเตือนจะอธิบายสาเหตุที่เป็นไปได้ของข้อผิดพลาด หรือแนะนำปัญหาที่อาจเกิดขึ้นในโค้ดที่โหลด Maps JavaScript API หากได้รับเฉพาะคำเตือนโดยไม่มีข้อผิดพลาดใดๆ แสดงว่า API จะทำงานอย่างถูกต้องในหน้านั้น อย่างไรก็ตาม เราขอแนะนำให้คุณแก้ไขปัญหาที่อาจเกิดขึ้นเหล่านี้ด้วย
รหัสข้อผิดพลาดของนักพัฒนาแอป | ประเภท | คำอธิบาย |
---|---|---|
ApiNotActivatedMapError
|
ข้อผิดพลาด |
Maps JavaScript API ไม่ได้เปิดใช้งานในโปรเจ็กต์ API คุณอาจต้องเปิดใช้ Maps JavaScript API ในส่วน API ในคอนโซล Google Cloud หากต้องการเปิดใช้งาน Maps JavaScript API สําหรับโปรเจ็กต์ ให้คลิกปุ่มด้านล่าง
|
ApiTargetBlockedMapError
|
ข้อผิดพลาด |
คีย์ API นี้ไม่ได้รับอนุญาตให้ใช้บริการหรือ API นี้ โปรดตรวจสอบการตั้งค่าข้อจํากัดของ API ของคีย์ API ในคอนโซล Google Cloud เพื่อให้แน่ใจว่าระบุ API และบริการทั้งหมดที่จําเป็นต้องใช้ไว้ในรายการ API ที่เปิดใช้อย่างถูกต้อง ดู คีย์ API ใน Cloud Console ดูข้อมูลเพิ่มเติมได้ที่แนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API |
DeletedApiProjectMapError
|
ข้อผิดพลาด |
โปรเจ็กต์ API อาจถูกลบออกจาก Cloud Console แล้ว โปรดตรวจสอบโปรเจ็กต์ที่คุณสร้างคีย์ API ที่รวมอยู่ในโปรแกรมโหลด JavaScript API คุณสามารถสร้างโปรเจ็กต์ API ใหม่และรับคีย์ใหม่ในคอนโซล Cloud ได้ หากต้องการสร้างโปรเจ็กต์ใหม่และรับคีย์ API สำหรับโปรเจ็กต์ ให้คลิกปุ่มด้านล่าง
|
ClientBillingNotEnabledMapError
|
ข้อผิดพลาด |
คุณยังไม่ได้เปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ คุณต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ Google Cloud ที่เชื่อมโยงกับรหัสไคลเอ็นต์นี้ที่นี่ |
BillingNotEnabledMapError
|
ข้อผิดพลาด |
คุณยังไม่ได้เปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ ซึ่งทำให้เกิดข้อผิดพลาดนี้ คุณต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ Google Cloudที่นี่ |
ExpiredKeyMapError
|
ข้อผิดพลาด |
คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API หมดอายุแล้วหรือระบบไม่รู้จัก คุณอาจได้รับข้อผิดพลาดนี้หลังจากสร้างคีย์ API ใหม่หากพยายามใช้คีย์ก่อนที่ระบบจะจดจำคีย์ โปรดรอสักครู่แล้วลองอีกครั้ง หรือคุณอาจต้องสร้างคีย์ API ใหม่ในคอนโซล Cloud หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง
|
InvalidAppCheckTokenMapError
|
ข้อผิดพลาด |
โทเค็น App Check ที่ระบุไม่ถูกต้องหรือหมดอายุ ข้อผิดพลาดนี้จะเกิดขึ้นก็ต่อเมื่อมีการใช้การยืนยัน App Check เท่านั้น ดูคำแนะนำเกี่ยวกับการตรวจสอบ App Check |
InvalidClientIdMapError
|
ข้อผิดพลาด |
รหัสไคลเอ็นต์ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API ไม่ถูกต้องหรือหมดอายุแล้ว โปรดตรวจสอบว่าคุณใช้รหัสไคลเอ็นต์อย่างถูกต้อง รหัสไคลเอ็นต์ควรขึ้นต้นด้วย "gme-" หากคุณเห็นข้อผิดพลาดนี้แม้ว่าจะใช้รหัสไคลเอ็นต์อย่างถูกต้องแล้ว แสดงว่ารหัสไคลเอ็นต์อาจหมดอายุ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google
หากไม่มีแพ็กเกจพรีเมียมหรือใบอนุญาต Maps API for Work คุณต้องใช้พารามิเตอร์ โปรดดูคำแนะนำเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
InvalidKeyMapError
|
ข้อผิดพลาด |
ไม่พบคีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสามารถสร้างคีย์ API ใหม่ใน Cloud Console ได้ หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง
|
MalformedCredentialsMapError
|
ข้อผิดพลาด |
แอปพลิเคชันของคุณใช้รูปแบบ URI ที่ไม่รองรับ ยืนยันว่าแอปพลิเคชันใช้รูปแบบ URI ที่ถูกต้องตามที่ระบุไว้ใน RFC 3986 |
MissingKeyMapError
|
ข้อผิดพลาด |
องค์ประกอบสคริปต์ที่โหลด API ไม่มีพารามิเตอร์การตรวจสอบสิทธิ์ที่จำเป็น หากใช้ Maps JavaScript API มาตรฐาน คุณต้องพารามิเตอร์ หากคุณเป็นลูกค้าแพ็กเกจพรีเมียม คุณต้องพารามิเตอร์ หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะไม่สามารถดำเนินการใดๆ เพื่อแก้ไขข้อผิดพลาดนี้ได้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้ |
ProjectDeniedMapError
|
ข้อผิดพลาด |
คำขอของคุณยังไม่เสร็จสมบูรณ์ คุณอาจดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อผิดพลาดได้ใน Cloud Console |
RefererDeniedMapError
|
ข้อผิดพลาด |
แอปพลิเคชันของคุณถูกบล็อกเนื่องจากไม่ปฏิบัติตามข้อกำหนดในการให้บริการของ Google Maps Platform ตามการแจ้งเตือนทางอีเมลหลายฉบับ หากต้องการอุทธรณ์การบล็อกและรับการตรวจสอบการติดตั้งใช้งาน โปรดกรอก แบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายใน 2-3 วันทำการ |
RefererNotAllowedMapError
|
ข้อผิดพลาด |
ยังไม่ได้เพิ่ม URL ปัจจุบันที่โหลด Maps JavaScript API ลงในรายการ URL ที่มาที่อนุญาต โปรดตรวจสอบการตั้งค่า URL ที่มาของคีย์ API ใน Cloud Console โปรดดู Maps JavaScript API และรับคีย์ API |
OverQuotaMapError
|
ข้อผิดพลาด |
จำนวนคำขอเกินขีดจำกัดการใช้งาน Maps JavaScript API คำขอของแอปจะทำงานอีกครั้งเมื่อรีเซ็ตโควต้ารายวันครั้งถัดไป หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะไม่สามารถดำเนินการใดๆ เพื่อแก้ไขข้อผิดพลาดนี้ได้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้ ดูรายละเอียดเพิ่มเติมได้ที่คำแนะนำเกี่ยวกับ การจำกัดการใช้งาน หน้านี้ยังอธิบายวิธีเพิ่มขีดจำกัดการใช้งานด้วย |
ApiProjectMapError
|
ข้อผิดพลาด |
คีย์ API ที่ระบุหรือโปรเจ็กต์ API ที่เชื่อมโยงกับคีย์นั้นไม่สามารถแก้ไขได้ ข้อผิดพลาดนี้อาจเกิดขึ้นชั่วคราว หากยังเห็นข้อความแสดงข้อผิดพลาดนี้อยู่ คุณอาจต้องขอคีย์ API ใหม่หรือสร้างโปรเจ็กต์ API ใหม่ โปรดดูข้อมูลเพิ่มเติมที่หัวข้อเริ่มต้นใช้งาน Google Maps Platform |
ClientIdLooksLikeCryptoKey
|
คำเตือน |
คุณอาจระบุคีย์การเข้ารหัสในพารามิเตอร์ ดูคำแนะนำเกี่ยวกับรหัสไคลเอ็นต์สำหรับลูกค้าแพ็กเกจพรีเมียมและ Maps API for Work |
ClientIdLooksLikeKey
|
คำเตือน |
คุณอาจระบุคีย์ API ในพารามิเตอร์ โปรดดูคำแนะนำเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
InvalidChannel
|
คำเตือน |
คุณอาจระบุพารามิเตอร์ |
InvalidClientId
|
คำเตือน |
ดูเหมือนว่าพารามิเตอร์ โปรดดูคำแนะนำเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
InvalidKey
|
คำเตือน |
คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API ไม่ถูกต้อง โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ได้ใน Cloud Console หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง
|
InvalidVersion
|
คำเตือน |
คุณอาจระบุหมายเลขเวอร์ชันไม่ถูกต้องในองค์ประกอบสคริปต์ โปรดตรวจสอบว่าคุณใช้หมายเลขเวอร์ชันที่ถูกต้อง |
KeyLooksLikeClientId
|
คำเตือน |
คุณอาจระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ key หากคุณมีแพ็กเกจ Premium หรือใบอนุญาต Maps API for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ client แทนพารามิเตอร์ key หากใช้แพ็กเกจพรีเมียมของ Google Maps Platform คุณจะใช้พารามิเตอร์ client หรือพารามิเตอร์ key ได้ หากไม่มีใบอนุญาต คุณต้องใช้พารามิเตอร์ key แทนพารามิเตอร์ client
โปรดดูคำแนะนำเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
KeyLooksLikeCryptoKey
|
คำเตือน |
คุณอาจระบุคีย์การเข้ารหัสหรือข้อมูลลับสำหรับการลงนามเป็น |
KeyLooksLikeProjectNumber
|
คำเตือน |
คุณอาจระบุหมายเลขโปรเจ็กต์เป็นพารามิเตอร์ ดูวิธีรับคีย์ API |
NoApiKeys
|
คำเตือน |
องค์ประกอบสคริปต์ที่โหลด API ไม่มีคีย์ API โปรดตรวจสอบว่าคุณระบุคีย์ API ที่ถูกต้องเป็นพารามิเตอร์
หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่างเพื่อเริ่มต้นใช้งาน
หากคุณโหลด Maps JavaScript API จากเส้นทาง v2 ที่เลิกใช้งานแล้ว คุณจะได้รับคำเตือน |
RetiredVersion
|
คำเตือน |
คุณอาจระบุเวอร์ชันที่เลิกใช้งานแล้วในองค์ประกอบสคริปต์ โปรดอัปเดตแอปพลิเคชันเพื่อใช้เวอร์ชันใดเวอร์ชันหนึ่งที่มีอยู่ |
SensorNotRequired
|
คำเตือน |
ไม่จำเป็นต้องใช้พารามิเตอร์ |
SignatureNotRequired
|
คำเตือน |
คุณไม่จำเป็นต้องใช้พารามิเตอร์ |
SignedInNotSupported
|
คำเตือน |
ระบบเลิกใช้งานพารามิเตอร์ |
UrlAuthenticationCommonError
|
ข้อผิดพลาด |
เกิดข้อผิดพลาดที่ไม่อยู่ในหมวดหมู่อื่นๆ ในหน้านี้ ปัญหานี้อาจเกิดจากปัญหาชั่วคราว โปรดลองส่งคำขออีกครั้งหลังจากรอสักครู่ หากยังแก้ไขปัญหาไม่ได้ โปรดอ่านคู่มือนักพัฒนาแอปเพื่อให้แน่ใจว่าคำขออยู่ในรูปแบบที่เหมาะสม |
การตรวจสอบข้อผิดพลาดในเบราว์เซอร์
Maps JavaScript API จะเขียนข้อความแสดงข้อผิดพลาดไปยัง
window.console
ส่วนนี้จะอธิบายวิธีตรวจสอบเอาต์พุต window.console
ใน Google Chrome หากคุณใช้เบราว์เซอร์อื่น โปรดดูเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์นั้นๆ ต่อไปนี้เป็นรายการเครื่องมือสำหรับตรวจสอบเอาต์พุต window.console
ในเบราว์เซอร์อื่นๆ บางรุ่นเพื่อเป็นข้อมูลอ้างอิง
- Web Console สําหรับ Firefox
- การแก้ไขข้อบกพร่องจากระยะไกลสำหรับ Android
- Web Inspector สำหรับ iOS
ใน Chrome คุณสามารถใช้คอนโซล JavaScript เพื่อตรวจสอบเอาต์พุต window.console
ได้โดยทำดังนี้
- หากต้องการเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ ให้เลือกไอคอนเมนู > เครื่องมือเพิ่มเติม > เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์
- หากต้องการเปิดคอนโซล JavaScript ให้กดแป้น ESC บนแป้นพิมพ์ ปุ่ม ESC จะเปิด/ปิดคอนโซล JavaScript หากปิดคอนโซล ให้กดแป้น ESC อีกครั้งเพื่อเปิด
หากเกิดข้อผิดพลาดหรือคำเตือนเมื่อโหลด Maps JavaScript API ข้อผิดพลาดหรือคำเตือนดังกล่าวจะปรากฏเป็นบรรทัดอย่างน้อย 1 บรรทัดในคอนโซล ข้อความแสดงข้อผิดพลาดหรือคำเตือนมีรูปแบบดังนี้
Google Maps API error: [ERROR CODE] [Link to API document]
หรือ
Google Maps API warning: [ERROR CODE] [Link to API document]
คุณสามารถตรวจสอบตารางรหัสข้อผิดพลาดด้านบนเพื่อค้นหารหัสข้อผิดพลาดในข้อความแสดงข้อผิดพลาด นอกจากนี้ คุณยังดูรายละเอียดเกี่ยวกับข้อความแสดงข้อผิดพลาดในเอกสาร API ที่ลิงก์จากข้อความได้ด้วย
หมายเหตุ: คุณสามารถ ฟังข้อผิดพลาดในการตรวจสอบสิทธิ์แบบเป็นโปรแกรมได้
การจัดการเบราว์เซอร์ที่ไม่รองรับ
ตรวจสอบว่าเบราว์เซอร์ที่คุณใช้อยู่ได้รับการรองรับจาก Maps JavaScript API ในปัจจุบัน
หากคุณกำลังพัฒนาแอปพลิเคชัน Windows เวอร์ชันที่มาพร้อมเครื่องซึ่งทำงานใน WebView โปรดตรวจสอบว่าคุณใช้ WebView2 บน Edge ระบบไม่รองรับ WebView เวอร์ชันก่อนหน้าซึ่งอิงตาม Internet Explorer อีกต่อไป
หากรหัสยังคงใช้งานไม่ได้
Brendan Kenny และ Mano Marks ชี้ให้เห็นข้อผิดพลาดที่พบบ่อยและวิธีแก้ไขในวิดีโอนี้เพื่อช่วยให้คุณใช้งานโค้ดแผนที่ได้
- ตรวจหาคำที่พิมพ์ผิด โปรดทราบว่า JavaScript เป็นภาษาที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
- ตรวจสอบข้อมูลเบื้องต้น - ปัญหาที่พบบ่อยที่สุดบางอย่างเกิดขึ้นกับการสร้างแผนที่ครั้งแรก เช่น
- ยืนยันว่าคุณได้ระบุพร็อพเพอร์ตี้
zoom
และcenter
ในตัวเลือกแผนที่ - ตรวจสอบว่าคุณได้ประกาศองค์ประกอบ div ที่แผนที่จะปรากฏบนหน้าจอ
- ตรวจสอบว่าองค์ประกอบ div สำหรับแผนที่มีความสูง โดยค่าเริ่มต้น ระบบจะสร้างองค์ประกอบ div ที่มีความสูง 0 จึงมองไม่เห็น
- ยืนยันว่าคุณได้ระบุพร็อพเพอร์ตี้
- ใช้โปรแกรมแก้ไขข้อบกพร่อง JavaScript เพื่อช่วยระบุปัญหา เช่น โปรแกรมที่มีให้ใช้งานในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Chrome เริ่มต้นด้วยการมองหาข้อผิดพลาดในคอนโซล JavaScript
- โพสต์คำถามใน Stack Overflow ดูหลักเกณฑ์เกี่ยวกับวิธีโพสต์คำถามที่ยอดเยี่ยมได้ในหน้าการสนับสนุน