หน้านี้จะอธิบายถึงข้อความแสดงข้อผิดพลาดที่ 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 โดยตรงเพื่อให้ API ทํางานได้อย่างถูกต้อง |
TOSViolationMapError
|
ดูเหมือนว่าเว็บไซต์นี้ละเมิดข้อกําหนดในการให้บริการของ Google Maps API ปิดใช้ Google Maps API สําหรับเว็บไซต์นี้แล้ว |
แอปพลิเคชันของคุณถูกบล็อกเนื่องจากไม่ปฏิบัติตามข้อกําหนดในการให้บริการของ Google Maps Platform หลังจากการแจ้งเตือนทางอีเมลหลายรายการ หากต้องการยื่นอุทธรณ์การบล็อกและตรวจสอบการใช้งาน โปรดกรอกแบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายในไม่กี่วันทําการ หากคุณมีใบอนุญาตแพ็กเกจพรีเมียมของ Google Maps Platform โปรดใช้ข้อมูลเข้าสู่ระบบของแพ็กเกจ Google Maps Platform Premium เพื่อแก้ไขข้อผิดพลาดนี้ ดูคู่มือเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
UnauthorizedURLForClientIdMapError
|
URL นี้ไม่ได้รับอนุญาตให้ใช้รหัสไคลเอ็นต์ที่ระบุของ Google Maps |
รหัสไคลเอ็นต์ของแผนพรีเมียมหรือ Maps API สําหรับ Work API ที่รวมอยู่ในการโหลดสคริปต์ไม่ถูกต้อง หมดอายุ หรือที่อยู่ปัจจุบันที่โหลด Maps JavaScript API ไม่ได้เพิ่มลงในรายการ URL ที่ได้รับอนุญาต |
รหัสข้อผิดพลาดของ Maps JavaScript API
หากคุณพบข้อผิดพลาดใน Chrome JavaScript Console, Firefox Web Console หรือเครื่องมืออื่นๆ ที่เทียบเท่าในเบราว์เซอร์ของคุณ โปรดดูตารางด้านล่างเพื่อค้นหาคําอธิบายสําหรับรหัสข้อผิดพลาด
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 Console หากต้องการเปิดใช้งาน Maps JavaScript API สําหรับโปรเจ็กต์ของคุณ ให้คลิกปุ่มด้านล่าง
|
ApiTargetBlockedMapError
|
ข้อผิดพลาด |
คีย์ API นี้ไม่ได้รับอนุญาตให้ใช้บริการหรือ API นี้ โปรดตรวจสอบการตั้งค่าข้อจํากัด API ของคีย์ API ใน Google Cloud Console เพื่อให้แน่ใจว่ามีการระบุ API และบริการทั้งหมดที่คุณจําเป็นต้องใช้ในรายการ API ที่เปิดใช้อย่างถูกต้องแล้ว ดูคีย์ API ใน Cloud Console ดูข้อมูลเพิ่มเติมได้ในแนวทางปฏิบัติแนะนําด้านความปลอดภัยของ API |
DeletedApiProjectMapError
|
ข้อผิดพลาด |
โปรเจ็กต์ API ของคุณอาจถูกลบออกจาก Cloud Console แล้ว โปรดตรวจสอบโปรเจ็กต์ที่คุณสร้างคีย์ API ที่รวมอยู่ในตัวโหลด JavaScript API คุณสามารถสร้างโปรเจ็กต์ API ใหม่และรับคีย์ใหม่ใน Cloud Console หากต้องการสร้างโปรเจ็กต์ใหม่และรับคีย์ API สําหรับโปรเจ็กต์ ให้คลิกปุ่มด้านล่าง
|
ClientBillingNotEnabledMapError
|
ข้อผิดพลาด |
คุณยังไม่ได้เปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ คุณต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ Google Cloud ที่เชื่อมโยงกับรหัสไคลเอ็นต์นี้ที่นี่ |
BillingNotEnabledMapError
|
ข้อผิดพลาด |
คุณยังไม่ได้เปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ที่ทําให้เกิดข้อผิดพลาดนี้ คุณต้องเปิดใช้การเรียกเก็บเงินในโปรเจ็กต์ Google Cloudที่นี่ |
ExpiredKeyMapError
|
ข้อผิดพลาด |
คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API หมดอายุแล้ว หรือระบบไม่รู้จัก คุณอาจได้รับข้อผิดพลาดนี้หลังจากสร้างคีย์ API ใหม่ หากคุณพยายามใช้คีย์นั้นเพื่อให้ระบบจดจําได้ โปรดรอสักครู่แล้วลองอีกครั้ง หรือคุณอาจต้องสร้างคีย์ API ใหม่ใน Cloud Console หากต้องการดาวน์โหลดคีย์ API ให้คลิกปุ่มด้านล่าง
|
InvalidClientIdMapError
|
ข้อผิดพลาด |
รหัสไคลเอ็นต์ที่อยู่ในองค์ประกอบสคริปต์ที่โหลด API ไม่ถูกต้องหรือหมดอายุ โปรดตรวจสอบว่าคุณใช้รหัสไคลเอ็นต์อย่างถูกต้อง รหัสไคลเอ็นต์ควรขึ้นต้นด้วย "goog-" หากคุณเห็นข้อผิดพลาดนี้แม้ว่าจะใช้รหัสไคลเอ็นต์อย่างถูกต้อง แสดงว่ารหัสไคลเอ็นต์อาจหมดอายุ โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google
หากไม่มีแพ็กเกจ Premium API หรือ 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 หลังจากการแจ้งเตือนทางอีเมลหลายรายการ หากต้องการยื่นอุทธรณ์การบล็อกและตรวจสอบการใช้งาน โปรดกรอกแบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายในไม่กี่วันทําการ |
RefererNotAllowedMapError
|
ข้อผิดพลาด |
ยังไม่ได้เพิ่ม URL ปัจจุบันที่โหลด Maps JavaScript API ลงในรายการ URL ที่มาที่ได้รับอนุญาต โปรดตรวจสอบการตั้งค่าผู้อ้างอิงของคีย์ API ใน Cloud Console ดู Maps JavaScript API และ รับคีย์ API |
OverQuotaMapError
|
ข้อผิดพลาด |
จํานวนคําขอเกินขีดจํากัดสําหรับ Maps JavaScript API คําขอของแอปจะใช้งานได้อีกครั้งในการรีเซ็ตโควต้ารายวันครั้งถัดไป หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะใช้ขั้นตอนต่อไปนี้เพื่อแก้ไขข้อผิดพลาดนี้ได้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากทําได้ โปรดดูรายละเอียดเพิ่มเติมในคู่มือเกี่ยวกับขีดจํากัดการใช้งาน หน้าดังกล่าวยังอธิบายวิธีใช้ประโยชน์จากขีดจํากัดการใช้งานที่สูงขึ้นด้วย |
ApiProjectMapError
|
ข้อผิดพลาด |
แก้ไขคีย์ API ที่ระบุหรือโปรเจ็กต์ API ที่เชื่อมโยงกับคีย์อยู่ไม่ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นชั่วคราว หากข้อความแสดงข้อผิดพลาดนี้ยังคงอยู่ คุณอาจต้องซื้อคีย์ API ใหม่หรือสร้างโปรเจ็กต์ API ใหม่ ดูข้อมูลเพิ่มเติมได้ที่เริ่มต้นใช้งาน Google Maps Platform |
ClientIdLooksLikeCryptoKey
|
คำเตือน |
คุณอาจให้คีย์การเข้ารหัสในพารามิเตอร์ ดูคําแนะนําเกี่ยวกับรหัสไคลเอ็นต์สําหรับลูกค้า Premium Premium และ Maps API for Work |
ClientIdLooksLikeKey
|
คำเตือน |
คุณอาจระบุคีย์ API ในพารามิเตอร์ ดูคู่มือเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
InvalidChannel
|
คำเตือน |
คุณอาจระบุพารามิเตอร์ |
InvalidClientId
|
คำเตือน |
ดูเหมือนว่าพารามิเตอร์ ดูคู่มือเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
InvalidKey
|
คำเตือน |
คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API ดูไม่ถูกต้อง โปรดตรวจสอบว่าใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ใน Cloud Console ได้ หากต้องการดาวน์โหลดคีย์ API ให้คลิกปุ่มด้านล่าง
|
InvalidVersion
|
คำเตือน |
คุณอาจระบุหมายเลขเวอร์ชันไม่ถูกต้องในองค์ประกอบสคริปต์ โปรดตรวจสอบว่าคุณใช้หมายเลขเวอร์ชันที่ถูกต้อง |
KeyLooksLikeClientId
|
คำเตือน |
คุณอาจระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ key หากคุณมีแพ็กเกจ Premium API หรือ Maps API for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ client แทนพารามิเตอร์ key หากมีแพ็กเกจ Google Maps Platform Premium คุณสามารถใช้พารามิเตอร์ client หรือพารามิเตอร์ key ได้ หากไม่มีใบอนุญาต คุณจะต้องใช้พารามิเตอร์ key แทนพารามิเตอร์ client
ดูคู่มือเกี่ยวกับการตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
KeyLooksLikeCryptoKey
|
คำเตือน |
คุณอาจระบุคีย์การเข้ารหัสหรือข้อมูลลับในการลงนามเป็นพารามิเตอร์ ดูคําแนะนําเกี่ยวกับการระบุรหัสไคลเอ็นต์เมื่อโหลด API |
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
ในเบราว์เซอร์อื่นๆ เพื่อเป็นข้อมูลอ้างอิง
- เว็บคอนโซลสําหรับ Firefox
- การแก้ไขข้อบกพร่องระยะไกลสําหรับ Android
- เครื่องมือตรวจสอบเว็บสําหรับ 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 ดูหลักเกณฑ์เกี่ยวกับวิธีโพสต์คําถามดีๆ ได้ในหน้าการสนับสนุน