หน้านี้อธิบายข้อความแสดงข้อผิดพลาดที่ 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 โดยตรงเพื่อให้ทำงานได้อย่างถูกต้อง |
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
หากพบข้อผิดพลาดในคอนโซล JavaScript ของ Chrome, Web Console ของ Firefox หรือเครื่องมืออื่นๆ ที่เทียบเท่าในเบราว์เซอร์ของคุณ โปรดดูคำอธิบายรหัสข้อผิดพลาดในตารางด้านล่าง
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 ได้ หากต้องการสร้างโปรเจ็กต์ใหม่และรับคีย์ 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 โปรดดู 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
|
คำเตือน |
คุณอาจระบุคีย์การเข้ารหัสในพารามิเตอร์ ดูคู่มือสำหรับ ลูกค้า รหัสสำหรับแพ็กเกจ 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 ข้อผิดพลาดหรือคำเตือนดังกล่าวจะปรากฏเป็นบรรทัดอย่างน้อย 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 รายการเพิ่มเติม ดูหลักเกณฑ์เกี่ยวกับวิธีโพสต์คำถามที่ยอดเยี่ยมได้ในหน้าการสนับสนุน