หน้านี้จะอธิบายถึงข้อความแสดงข้อผิดพลาดที่ระบบอาจแสดงผลโดย 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
|
ต้องดาวน์โหลด JavaScript API ของ Maps โดยตรงจาก เซิร์ฟเวอร์ |
องค์ประกอบของสคริปต์ที่โหลด Maps JavaScript API คือ มีการใส่อย่างไม่ถูกต้องในหน้าเว็บของคุณ เพื่อให้ API ทำงานได้ อย่างถูกต้อง จะต้องโหลดจาก https://maps.googleapis.com โดยตรง |
TOSViolationMapError
|
ดูเหมือนว่าเว็บไซต์นี้ละเมิดข้อกำหนดในการให้บริการของ Google Maps API Google Maps API ถูกปิดใช้สำหรับเว็บไซต์นี้ |
แอปพลิเคชันของคุณถูกบล็อกเนื่องจากไม่ปฏิบัติตาม ข้อกำหนดในการให้บริการของ Google Maps Platform ตามการแจ้งเตือนทางอีเมลหลายครั้ง วิธีอุทธรณ์ บล็อกและตรวจสอบการติดตั้งใช้งานของคุณ โปรดดำเนินการให้เสร็จสมบูรณ์ แบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายใน 2-3 วันทำการ หากคุณมีใบอนุญาตแผนพรีเมียมของแพลตฟอร์ม Google Maps โปรดใช้ ข้อมูลเข้าสู่ระบบแพ็กเกจพรีเมียมของ Google Maps Platform เพื่อแก้ไขข้อผิดพลาดนี้ ดูคู่มือสำหรับ การตรวจสอบสิทธิ์แพ็กเกจพรีเมียม |
UnauthorizedURLForClientIdMapError
|
URL นี้ไม่ได้รับอนุญาตให้ใช้รหัสไคลเอ็นต์ของ Google Maps ที่ระบุ |
แผนพรีเมียมหรือ Maps API for Work รหัสลูกค้าที่รวมอยู่ในการโหลดสคริปต์ไม่ถูกต้อง หมดอายุ หรือที่อยู่ปัจจุบันที่โหลด ไม่ได้เพิ่ม 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 จะทำงาน อย่างถูกต้องในหน้านั้น อย่างไรก็ตาม เราขอแนะนำให้คุณแก้ไข ของ Google ด้วยเช่นกัน
รหัสข้อผิดพลาดของนักพัฒนาซอฟต์แวร์ | ประเภท | คำอธิบาย |
---|---|---|
ApiNotActivatedMapError
|
ข้อผิดพลาด |
ไม่ได้เปิดใช้งาน Maps JavaScript API ในโปรเจ็กต์ API คุณอาจต้องเปิดใช้ Maps JavaScript API ภายใต้ API ใน คอนโซล Google Cloud คลิกปุ่มด้านล่างเพื่อเปิดใช้งาน 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 คือ ไม่ถูกต้องหรือหมดอายุแล้ว โปรดตรวจสอบว่าคุณใช้รหัสไคลเอ็นต์ อย่างถูกต้อง รหัสลูกค้าควรขึ้นต้นด้วย "gme-" คำนำหน้า หากคุณเห็น ข้อผิดพลาดนี้แม้ว่าจะใช้รหัสไคลเอ็นต์อย่างถูกต้อง รหัสไคลเอ็นต์อาจ หมดอายุแล้ว โปรดติดต่อผู้จัดการฝ่ายดูแลลูกค้าของ Google
หากคุณไม่มีแพ็กเกจ Premium หรือ
คุณต้องใช้ใบอนุญาต 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 โปรดดู Cloud Console |
RefererDeniedMapError
|
ข้อผิดพลาด |
แอปพลิเคชันของคุณถูกบล็อกเนื่องจากไม่ปฏิบัติตาม ข้อกำหนดในการให้บริการของ Google Maps Platform ตามการแจ้งเตือนทางอีเมลหลายครั้ง วิธีอุทธรณ์ บล็อกและตรวจสอบการติดตั้งใช้งานของคุณ โปรดดำเนินการให้เสร็จสมบูรณ์ แบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายใน 2-3 วันทำการ |
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 และ ลูกค้า 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
|
คำเตือน |
คุณอาจระบุคีย์การเข้ารหัสหรือข้อมูลลับในการลงชื่อเป็น ดูคู่มือสำหรับ การระบุ รหัสไคลเอ็นต์ขณะโหลด 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 จะปรากฏเป็นหนึ่งบรรทัดหรือมากกว่าใน คอนโซลผู้ดูแลระบบ ข้อความแสดงข้อผิดพลาดหรือคําเตือนจะมีรูปแบบต่อไปนี้
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 รายการเพิ่มเติม โปรดดูหลักเกณฑ์เกี่ยวกับวิธีโพสต์คำถามที่ยอดเยี่ยมใน หน้าการสนับสนุน