ข้อความแสดงข้อผิดพลาด

หากต้องการความช่วยเหลือจากเจ้าหน้าที่
ไปที่หน้าการสนับสนุนของ Google Maps Platform
หน้านี้มีไว้สำหรับอ้างอิงเท่านั้น เราพร้อม ช่วยคุณแก้ปัญหาข้อผิดพลาดของ Maps JavaScript API ด้วยตนเอง หากพยายามขอความช่วยเหลือจากเจ้าหน้าที่โดยการส่งความคิดเห็นผ่านหน้านี้ คุณจะไม่ได้รับการติดต่อจากผู้ที่สามารถช่วยเหลือได้ อย่างไรก็ตาม หากพบปัญหาเกี่ยวกับเนื้อหาในหน้านี้ โปรดแจ้งให้เราทราบโดยใช้ลิงก์ความคิดเห็น ขอขอบคุณ

หน้านี้อธิบายข้อความแสดงข้อผิดพลาดที่ Maps JavaScript API อาจแสดง Maps JavaScript API จะเขียนข้อความแสดงข้อผิดพลาดและคำเตือนไปยังคอนโซล JavaScript นอกจากนี้ ยังอาจเกิด เงื่อนไขข้อผิดพลาดบางอย่าง ซึ่งส่งผลให้มีการแสดงแผนที่ที่มีลายน้ำ แบบมืด

หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะทำอะไรเพื่อแก้ไขข้อผิดพลาดเหล่านี้ไม่ได้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้

ข้อผิดพลาดเกี่ยวกับคีย์ API และการเรียกเก็บเงิน

การแก้ปัญหา

ในบางกรณี ระบบอาจแสดงแผนที่ที่มืดลงหรือรูปภาพ Street View ที่เป็น "เนกาทีฟ" ซึ่งมีลายน้ำเป็นข้อความ "เพื่อวัตถุประสงค์ในการพัฒนาเท่านั้น" โดยปกติแล้วลักษณะการทำงานนี้บ่งบอกถึงปัญหาเกี่ยวกับคีย์ API หรือการเรียกเก็บเงิน หากต้องการใช้ผลิตภัณฑ์ Google Maps Platform คุณต้องเปิดใช้การเรียกเก็บเงินในบัญชี และคำขอทั้งหมดต้องมีคีย์ API ที่ถูกต้อง หากต้องการความช่วยเหลือในการค้นหาข้อความแสดงข้อผิดพลาด โปรดดูส่วนเกี่ยวกับ การตรวจสอบข้อผิดพลาดในเบราว์เซอร์

ขั้นตอนต่อไปนี้จะช่วยคุณแก้ปัญหา

คุณใช้คีย์ API อยู่ใช่ไหม

ชั้นก็ไม่แน่ใจค่ะ ฉันจะตรวจสอบได้อย่างไรว่ากำลังใช้คีย์ API อยู่หรือไม่

ระบบจะส่งคีย์ API เป็นพารามิเตอร์ key ใน URL ที่ใช้โหลด Maps JavaScript API ต่อไปนี้คือตัวเลือกบางส่วนในการตรวจสอบว่าคุณใช้คีย์ API หรือไม่

• ใช้ส่วนขยาย Chrome ตัวตรวจสอบ API ของ Google Maps Platform ซึ่งจะช่วยให้คุณทราบว่าเว็บไซต์ ของคุณใช้ Google Maps API ที่ได้รับอนุญาตอย่างถูกต้องหรือไม่
• หากคุณใช้ไลบรารีหรือปลั๊กอินเพื่อโหลด Maps JavaScript API ให้ตรวจสอบการตั้งค่าของไลบรารีนั้นและมองหาตัวเลือกคีย์ API
• ตรวจสอบข้อผิดพลาดในเบราว์เซอร์ หากคุณเห็นข้อความต่อไปนี้ แสดงว่าคุณใช้คีย์ API ไม่ถูกต้อง
• คำเตือนเกี่ยวกับ Google Maps JavaScript API NoApiKeys
• ข้อผิดพลาดของ Google Maps JavaScript API: MissingKeyMapError

สำหรับนักพัฒนาเว็บ

• หากคุณมีสิทธิ์เข้าถึงซอร์สโค้ดของแอปพลิเคชัน ให้มองหาแท็ก <script> ที่ใช้โหลด Maps JavaScript API เมื่อโหลด Maps JavaScript API ให้แทนที่ YOUR_API_KEY ในโค้ดด้านล่างด้วยคีย์ API ของคุณ

    <script async defer
      src="https://maps.googleapis.com/maps/api/js?key=YOUR_API_KEY&callback=initMap">
    </script>

• ตรวจสอบการจราจรของข้อมูลในเครือข่ายที่เว็บไซต์สร้างขึ้นในเบราว์เซอร์ ใน Chrome คุณสามารถดูได้โดยใช้แท็บDevTools เครือข่าย ในส่วนนี้ คุณจะเห็นคำขอเครือข่ายที่เว็บไซต์ของคุณส่ง คำขอที่สร้างขึ้นโดยใช้ Maps JavaScript API จะอยู่ภายใต้เส้นทาง maps/api/js ที่นี่คุณสามารถยืนยันได้ว่าคำขอใช้พารามิเตอร์ key หรือไม่ คุณอาจ กรองการจราจรของข้อมูลในเครือข่ายตาม maps/api/js เมื่อดูแท็บเครือข่าย

ไม่ ฉันไม่ได้ใช้คีย์ API

หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง หากไม่เห็นการตั้งค่าแบบมีคำแนะนำ ให้ทำตาม วิธีการทั้งหมดที่เริ่มต้นใช้งาน Google Maps Platform
เริ่มต้นใช้งาน

ใช่ ฉันใช้คีย์ API

เยี่ยมเลย มาดูต่อกันว่าโปรเจ็กต์ของคุณเชื่อมต่อกับบัญชีสำหรับการเรียกเก็บเงินหรือไม่

โปรเจ็กต์ของคุณมีบัญชีสำหรับการเรียกเก็บเงินแนบอยู่ไหม

ชั้นก็ไม่แน่ใจค่ะ ฉันจะตรวจสอบได้อย่างไรว่าบัญชีสำหรับการเรียกเก็บเงินเชื่อมต่อกับโปรเจ็กต์ของฉัน

ไปที่ หน้าการเรียกเก็บเงินในคอนโซล Google Cloud แล้วเลือกโปรเจ็กต์ที่สร้างคีย์ API วิธียืนยันว่าคีย์เชื่อมโยงกับโปรเจ็กต์

1. ไปที่ส่วนข้อมูลเข้าสู่ระบบ ซึ่งเข้าถึงได้จากแถบด้านข้างทางซ้ายในส่วน Google Maps Platform > ข้อมูลเข้าสู่ระบบ
2. ตรวจสอบว่าคีย์ API ที่คุณใช้ในเว็บไซต์อยู่ในรายการ หากไม่เป็นเช่นนั้น ให้เปลี่ยนไปใช้โปรเจ็กต์อื่น แล้วตรวจสอบข้อมูลเข้าสู่ระบบในโปรเจ็กต์นั้น
3. หากไม่พบโปรเจ็กต์สำหรับคีย์ API แสดงว่าคุณอาจเสียสิทธิ์เข้าถึงโปรเจ็กต์นี้ ขอความช่วยเหลือจากผู้อื่นในองค์กร หากไม่พบโปรเจ็กต์ต้นฉบับ คุณควรทำดังนี้
   1. สร้างโปรเจ็กต์ใหม่ โดยทำได้โดยเลือกโปรเจ็กต์ใหม่ จากรายการโปรเจ็กต์ หรือเลือกสร้างโปรเจ็กต์ผ่าน หน้า Resource Manager
   2. สร้างคีย์ API ใหม่ ซึ่งทำได้ในหน้าข้อมูลเข้าสู่ระบบ เมื่อไปที่หน้าดังกล่าวแล้ว ให้คลิกสร้างข้อมูลเข้าสู่ระบบ แล้วเลือกคีย์ API

เมื่อพบโปรเจ็กต์ใน Cloud Console แล้ว ให้ตรวจสอบว่าได้แนบบัญชีสำหรับการเรียกเก็บเงินไว้หรือไม่โดยไปที่ส่วนการเรียกเก็บเงินในเมนูด้านซ้าย

ไม่ โปรเจ็กต์ของฉันไม่ได้แนบอยู่กับบัญชีสำหรับการเรียกเก็บเงิน

ไปที่หน้าเปิดใช้การเรียกเก็บเงินใน Cloud Console แล้วเพิ่มบัญชีสำหรับการเรียกเก็บเงินลงในโปรเจ็กต์ ดูข้อมูลเพิ่มเติมได้ที่ เริ่มต้นใช้งาน Google Maps Platform

ใช่ บัญชีสำหรับการเรียกเก็บเงินแนบอยู่กับโปรเจ็กต์ของฉัน

เยี่ยมเลย โปรดตรวจสอบว่าวิธีการเรียกเก็บเงินที่ระบุถูกต้อง

วิธีการเรียกเก็บเงินที่ระบุใช้ไม่ได้อีกต่อไป (เช่น บัตรเครดิตหมดอายุ) หรือไม่

คุณ เพิ่ม นำออก หรืออัปเดตวิธีการชำระเงินได้ในคอนโซล Cloud

API มีขีดจำกัดการใช้งานต่อวันที่กำหนดเองไหม

หากคุณได้ตั้งค่าขีดจำกัดรายวันใน API ใดก็ตาม ซึ่งเป็นเรื่องปกติเพื่อป้องกันการเพิ่มขึ้นที่ไม่คาดคิด คุณสามารถแก้ไขปัญหานี้ได้โดยเพิ่มขีดจำกัดรายวัน

คุณสามารถตรวจสอบขีดจำกัดรายวันได้โดยไปที่แดชบอร์ด API และบริการใน Cloud Console โดยทำดังนี้

1. เลือกโปรเจ็กต์หากได้รับข้อความแจ้ง
2. เลือก API จากรายการ แล้วคลิกแท็บโควต้า

คีย์ API มีข้อจำกัดที่อยู่ IP ไหม

คีย์ API ที่มีข้อจำกัดที่อยู่ IP จะใช้ได้กับบริการบนเว็บที่ มีไว้สำหรับการใช้งานจากฝั่งเซิร์ฟเวอร์เท่านั้น (เช่น Geocoding API และ Web Service API อื่นๆ) บริการเว็บส่วนใหญ่เหล่านี้มีบริการที่เทียบเท่ากันภายใน Maps JavaScript API (เช่น ดู บริการการเข้ารหัสพิกัดภูมิศาสตร์) หากต้องการใช้บริการฝั่งไคลเอ็นต์ของ Maps JavaScript API คุณจะต้องสร้างคีย์ API แยกต่างหากซึ่งสามารถรักษาความปลอดภัยได้ด้วยการจำกัดผู้อ้างอิง HTTP (ดูรับ เพิ่ม และจำกัดคีย์ 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 เพื่อแก้ไขข้อผิดพลาดนี้ ดูคำแนะนำเกี่ยวกับ การตรวจสอบสิทธิ์แพ็กเกจ Premium
UnauthorizedURLForClientIdMapError	URL นี้ไม่ได้รับอนุญาตให้ใช้รหัสไคลเอ็นต์ Google Maps ที่ระบุ	แผน Premium หรือรหัสไคลเอ็นต์ของ Maps APIs for Work ที่รวมอยู่ในการโหลดสคริปต์ไม่ถูกต้อง หมดอายุ หรือยังไม่ได้เพิ่มที่อยู่ปัจจุบันที่โหลด Maps JavaScript API ลงในรายการ URL ที่ได้รับอนุญาต ดู การลงทะเบียน URL ที่ได้รับอนุญาต

รหัสข้อผิดพลาดของ Maps JavaScript API

หากพบข้อผิดพลาดในคอนโซล JavaScript ของ Chrome, คอนโซลเว็บของ 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 ใหม่ใน คอนโซลระบบคลาวด์ หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง เริ่มต้นใช้งาน
InvalidAppCheckTokenMapError	ข้อผิดพลาด	โทเค็น App Check ที่ระบุไม่ถูกต้องหรือหมดอายุ ข้อผิดพลาดนี้จะเกิดขึ้นได้ก็ต่อเมื่อ มีการใช้การยืนยัน App Check ดูคำแนะนำเกี่ยวกับการยืนยัน App Check
InvalidClientIdMapError	ข้อผิดพลาด	เพื่อเพิ่มความปลอดภัยและความน่าเชื่อถือในการตรวจสอบสิทธิ์ เราจะ เลิกใช้งานรหัสไคลเอ็นต์ของ Maps Platform ตั้งแต่วันที่ 26 พฤษภาคม 2025 และจะใช้ ไม่ได้อีกต่อไปหลังจากวันที่ 31 พฤษภาคม 2026 คุณต้องใช้ข้อมูลเข้าสู่ระบบคีย์ API แทนการใช้รหัสไคลเอ็นต์เพื่อตรวจสอบสิทธิ์การเข้าชมบริการ Google Maps API ดูข้อมูลเพิ่มเติมได้ที่ คำแนะนำในการย้ายข้อมูล Client ID ทำตามขั้นตอนในคู่มือเพื่อ กู้คืนรหัสไคลเอ็นต์ชั่วคราว
InvalidKeyMapError	ข้อผิดพลาด	ไม่พบคีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ซึ่งโหลด API โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสามารถ สร้างคีย์ API ใหม่ใน Cloud Console หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง เริ่มต้นใช้งาน
MalformedCredentialsMapError	ข้อผิดพลาด	แอปพลิเคชันของคุณใช้สคีม URI ที่ไม่รองรับ ตรวจสอบว่าแอปพลิเคชันใช้รูปแบบ URI ที่ถูกต้องตามที่กําหนดไว้ใน RFC 3986
MissingKeyMapError	ข้อผิดพลาด	องค์ประกอบสคริปต์ที่โหลด API ไม่มีพารามิเตอร์การตรวจสอบสิทธิ์ที่จำเป็น หากคุณใช้ Maps JavaScript API มาตรฐาน คุณต้องใช้พารามิเตอร์ key ที่มีคีย์ API ที่ถูกต้อง ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ เริ่มต้นใช้งาน Google Maps Platform หากเป็นลูกค้าแพ็กเกจพรีเมียม คุณต้อง ใช้พารามิเตอร์ client กับรหัสไคลเอ็นต์ หรือพารามิเตอร์ key กับคีย์ API ที่ถูกต้อง ดูข้อมูลเพิ่มเติมได้ในคำแนะนำเกี่ยวกับ คีย์ API และรหัสไคลเอ็นต์ หากคุณไม่ใช่เจ้าของเว็บไซต์ ก็จะไม่มีขั้นตอนใดที่คุณสามารถทำเพื่อแก้ไขข้อผิดพลาดนี้ได้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้
ProjectDeniedMapError	ข้อผิดพลาด	คำขอของคุณยังไม่เสร็จสมบูรณ์ คุณอาจดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อผิดพลาดได้ในคอนโซลระบบคลาวด์ ดู Cloud Console
RefererDeniedMapError	ข้อผิดพลาด	ระบบบล็อกแอปพลิเคชันของคุณเนื่องจากไม่ปฏิบัติตาม ข้อกำหนดในการให้บริการของ Google Maps Platform หลังจากส่งการแจ้งเตือนทางอีเมลหลายครั้ง หากต้องการอุทธรณ์การบล็อกและรับการตรวจสอบการติดตั้งใช้งาน โปรดกรอก แบบฟอร์มนี้ คุณจะได้รับการตอบกลับทางอีเมลภายใน 2-3 วันทำการ
RefererNotAllowedMapError	ข้อผิดพลาด	URL ปัจจุบันที่โหลด Maps JavaScript API ยังไม่ได้ เพิ่มลงในรายการผู้แนะนำที่อนุญาต โปรดตรวจสอบการตั้งค่าผู้แนะนำ ของคีย์ API ใน Cloud Console ดู Maps JavaScript API และ รับคีย์ API
OverQuotaMapError	ข้อผิดพลาด	จำนวนคำขอเกินขีดจำกัดการใช้งานสำหรับ Maps JavaScript API คำขอของแอปจะทำงานอีกครั้ง เมื่อโควต้าประจำวันรีเซ็ตครั้งถัดไป หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะทำอะไรไม่ได้เพื่อ แก้ไขข้อผิดพลาดนี้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้ ดูรายละเอียดเพิ่มเติมได้ในคำแนะนำเกี่ยวกับ โควต้าการใช้งาน หน้านี้ยังอธิบายวิธีเพิ่มโควต้าการใช้งานด้วย
ApiProjectMapError	ข้อผิดพลาด	ไม่สามารถแก้ไขคีย์ API ที่ระบุหรือโปรเจ็กต์ API ที่เชื่อมโยงกับคีย์ ได้ ข้อผิดพลาดนี้อาจเกิดขึ้นชั่วคราว หากยังเห็นข้อความแสดงข้อผิดพลาดนี้อยู่ คุณอาจต้องรับคีย์ API ใหม่หรือสร้างโปรเจ็กต์ API ใหม่ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อ เริ่มต้นใช้งาน Google Maps Platform
ClientIdLooksLikeCryptoKey	คำเตือน	คุณอาจระบุคีย์การเข้ารหัสในพารามิเตอร์ client หากคุณมีแพ็กเกจพรีเมียมหรือ ใบอนุญาต Maps APIs for Work โปรดระบุ รหัสไคลเอ็นต์เป็นพารามิเตอร์ client คุณไม่จำเป็นต้องใช้คีย์การเข้ารหัสสำหรับ Maps JavaScript API ดูคำแนะนำเกี่ยวกับ รหัส ไคลเอ็นต์สำหรับแพ็กเกจพรีเมียมและ Maps API สำหรับลูกค้า Maps API for Work
ClientIdLooksLikeKey	คำเตือน	คุณอาจระบุคีย์ API ในพารามิเตอร์ client หากคุณมีแพ็กเกจพรีเมียมหรือ ใบอนุญาต Maps APIs for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ client หากมี Google Maps Platform Premium Plan คุณจะใช้พารามิเตอร์ client หรือพารามิเตอร์ key ได้ หากไม่มีใบอนุญาต คุณต้องใช้พารามิเตอร์ key แทนพารามิเตอร์ client ดูคำแนะนำเกี่ยวกับ การตรวจสอบสิทธิ์แพ็กเกจ Premium
InvalidChannel	คำเตือน	คุณอาจระบุพารามิเตอร์ channel ที่ไม่ถูกต้อง แชแนลต้องเป็นสตริงตัวอักษรและตัวเลข ASCII ซึ่งอาจมีมหัพภาค (.) ขีดล่าง (_) และยัติภังค์ (-) โปรดตรวจสอบว่าคุณระบุพารามิเตอร์ channel ที่ถูกต้อง ดู การรายงาน | Google Maps Platform Premium Plan
InvalidClientId	คำเตือน	ดูเหมือนว่าพารามิเตอร์ client จะไม่มีรหัสไคลเอ็นต์ที่ถูกต้อง รหัสไคลเอ็นต์ควรขึ้นต้นด้วย "gme-" ดูคำแนะนำเกี่ยวกับ การตรวจสอบสิทธิ์แพ็กเกจ Premium
InvalidKey	คำเตือน	คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API ดูไม่ถูกต้อง โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ได้ใน Cloud Console หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง เริ่มต้นใช้งาน
InvalidVersion	คำเตือน	คุณอาจระบุหมายเลขเวอร์ชันที่ไม่ถูกต้องในองค์ประกอบสคริปต์ โปรดตรวจสอบว่าคุณกำลังใช้หมายเลขเวอร์ชันที่ถูกต้อง ดู การกำหนดเวอร์ชัน | Google Maps JavaScript API
KeyLooksLikeClientId	คำเตือน	คุณอาจระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ key หากคุณ มีแพ็กเกจพรีเมียมหรือ ใบอนุญาต Maps APIs for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ client แทนพารามิเตอร์ key หากมีclientแพ็กเกจพรีเมียมของ Google Maps Platform คุณจะใช้พารามิเตอร์ client หรือพารามิเตอร์ key ได้ หากไม่มีใบอนุญาต คุณต้องใช้พารามิเตอร์ key แทนพารามิเตอร์ client ดูคำแนะนำเกี่ยวกับ การตรวจสอบสิทธิ์แพ็กเกจ Premium
KeyLooksLikeCryptoKey	คำเตือน	คุณอาจระบุคีย์การเข้ารหัสหรือข้อมูลลับในการลงนามเป็นkey พารามิเตอร์ หากคุณมีแพ็กเกจ Premium หรือ ใบอนุญาต Maps APIs for Work โปรดระบุ รหัสไคลเอ็นต์เป็นพารามิเตอร์ client และนำพารามิเตอร์ key ออกจากองค์ประกอบสคริปต์ ไม่จำเป็นต้องใช้คีย์การเข้ารหัสสำหรับ Maps JavaScript API หากมีclientแพ็กเกจพรีเมียมของ Google Maps Platform คุณจะใช้พารามิเตอร์ client หรือพารามิเตอร์ key ได้ หากไม่มีใบอนุญาต คุณสามารถ รับคีย์ API ใน Cloud Console ดูคำแนะนำเกี่ยวกับ การระบุ รหัสไคลเอ็นต์เมื่อโหลด API
KeyLooksLikeProjectNumber	คำเตือน	คุณอาจระบุหมายเลขโปรเจ็กต์เป็นพารามิเตอร์ key โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ได้ใน Cloud Console ดูวิธีรับคีย์ API
NoApiKeys	คำเตือน	องค์ประกอบสคริปต์ที่โหลด API ไม่มีคีย์ API โปรดตรวจสอบว่า คุณใส่คีย์ API ที่ถูกต้องเป็นพารามิเตอร์ key คุณสร้างคีย์ API ใหม่ได้ใน Cloud Console หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่างเพื่อเริ่มต้นใช้งาน เริ่มต้นใช้งาน หากโหลด Maps JavaScript API จากเส้นทาง v2 ที่เลิกใช้งานแล้ว คุณจะได้รับNoApiKeysคำเตือน แม้ว่าจะระบุพารามิเตอร์ key ก็ตาม โปรดดู คู่มือการอัปเกรดจาก v2 เป็น v3 และย้ายข้อมูลแอปพลิเคชันไปยัง Maps JavaScript API v3
RetiredVersion	คำเตือน	คุณอาจระบุเวอร์ชันที่เลิกใช้งานแล้วในองค์ประกอบสคริปต์ โปรดอัปเดตแอปพลิเคชันเพื่อใช้เวอร์ชันใดเวอร์ชันหนึ่งที่พร้อมใช้งาน ดู การกำหนดเวอร์ชัน | Google Maps JavaScript API
SensorNotRequired	คำเตือน	ไม่จำเป็นต้องใช้พารามิเตอร์ sensor สำหรับ Maps JavaScript API อีกต่อไป ซึ่งจะไม่ส่งผลให้ Maps JavaScript API ทำงานไม่ถูกต้อง แต่เราขอแนะนำให้คุณนำพารามิเตอร์ sensor ออกจากองค์ประกอบสคริปต์
SignatureNotRequired	คำเตือน	ไม่จำเป็นต้องใช้พารามิเตอร์ signature สำหรับ Maps JavaScript API ซึ่งจะไม่ส่งผลให้ Maps JavaScript API ทำงานไม่ถูกต้อง แต่ก็อาจ ทำให้เกิดความเสี่ยงด้านความปลอดภัย โปรดนำออกจากองค์ประกอบสคริปต์
SignedInNotSupported	คำเตือน	พารามิเตอร์ signed_in ถูกเลิกใช้งานแล้วและไม่รองรับใน Maps JavaScript API เวอร์ชัน ที่คุณกำลังใช้ การดำเนินการนี้จะไม่ทำให้ Maps JavaScript API ใช้งานไม่ได้ แต่ลักษณะการทำงานของแอปพลิเคชันอาจเปลี่ยนแปลง หากคุณใช้ฟีเจอร์ที่ต้องลงชื่อเข้าใช้
UrlAuthenticationCommonError	ข้อผิดพลาด	เกิดข้อผิดพลาดที่ไม่อยู่ในหมวดหมู่อื่นๆ ในหน้านี้ ปัญหานี้อาจเกิดจากปัญหาชั่วคราว โปรดลองส่งคำขออีกครั้งหลังจากรอสักครู่ หากยังแก้ปัญหาไม่ได้ โปรด อ่าน คู่มือนักพัฒนาแอป เพื่อให้แน่ใจว่าคำขอมีรูปแบบที่ถูกต้อง

การตรวจสอบข้อผิดพลาดในเบราว์เซอร์

Maps JavaScript API จะเขียนข้อความแสดงข้อผิดพลาดไปยัง window.console ส่วนนี้จะอธิบายวิธีตรวจสอบwindow.consoleเอาต์พุตใน Google Chrome หากคุณใช้เบราว์เซอร์อื่น โปรดดูเอกสารประกอบสำหรับนักพัฒนาซอฟต์แวร์ของเบราว์เซอร์นั้น เพื่อเป็นข้อมูลอ้างอิง นี่คือรายการเครื่องมือสำหรับตรวจสอบwindow.consoleเอาต์พุต ในเบราว์เซอร์อื่นๆ

• Web Console สำหรับ Firefox
• การแก้ไขข้อบกพร่องจากระยะไกลสำหรับ Android
• Web Inspector สำหรับ iOS

ใน Chrome คุณสามารถใช้คอนโซล JavaScript เพื่อตรวจสอบเอาต์พุต window.console ได้โดยทำดังนี้

1. หากต้องการเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ ให้เลือกไอคอนเมนู > เครื่องมือเพิ่มเติม > เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์
2. หากต้องการเปิดคอนโซล 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 จะชี้ให้เห็นข้อผิดพลาดที่พบบ่อยและวิธีแก้ไขในวิดีโอนี้ เพื่อช่วยให้คุณใช้โค้ด Maps ได้

• มองหาการพิมพ์ผิด โปรดทราบว่า JavaScript เป็นภาษาที่คำนึงถึงตัวพิมพ์เล็กและตัวพิมพ์ใหญ่
• ตรวจสอบพื้นฐาน - ปัญหาที่พบบ่อยที่สุดบางอย่างเกิดขึ้นเมื่อ สร้างแผนที่ครั้งแรก เช่น
  • ตรวจสอบว่าคุณได้ระบุพร็อพเพอร์ตี้ zoom และ center ในตัวเลือกแผนที่ แล้ว
  • ตรวจสอบว่าคุณได้ประกาศองค์ประกอบ div ที่แผนที่จะ ปรากฏบนหน้าจอแล้ว
  • ตรวจสอบว่าองค์ประกอบ div สำหรับแผนที่มีความสูง โดยค่าเริ่มต้น ระบบจะสร้างองค์ประกอบ div ที่มีความสูงเป็น 0 และจึง มองไม่เห็น
  ดูตัวอย่างของเราเพื่อเป็นข้อมูลอ้างอิง ในการติดตั้งใช้งาน
• ใช้โปรแกรมแก้ไขข้อบกพร่อง JavaScript เพื่อช่วยระบุปัญหา เช่น ปัญหาที่พบได้ในเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ Chrome เริ่มต้นด้วยการดูข้อผิดพลาดในคอนโซล JavaScript
• โพสต์คำถามใน Stack Overflow ดูหลักเกณฑ์เกี่ยวกับวิธีโพสต์คำถามที่ยอดเยี่ยมได้ที่หน้าการสนับสนุน