Places UI Kit: ไลบรารีที่พร้อมใช้งานซึ่งช่วยให้นักพัฒนาซอฟต์แวร์ปรับแต่งและควบคุมได้ ลองใช้ดู แล้วแชร์ความคิดเห็นเกี่ยวกับประสบการณ์การใช้ UI Kit

Google uses AI technology to translate content into your preferred language. AI translations can contain errors.

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

หากต้องการความช่วยเหลือจากเจ้าหน้าที่
ไปที่หน้าการสนับสนุนของ 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 วิธียืนยันว่าคีย์เชื่อมโยงกับโปรเจ็กต์

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

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

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

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

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

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

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

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

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

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

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

เลือกโปรเจ็กต์หากได้รับข้อความแจ้ง
เลือก 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 ที่ได้รับอนุญาต

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 ได้โดยทำดังนี้

หากต้องการเปิดเครื่องมือสำหรับนักพัฒนาซอฟต์แวร์ ให้เลือกไอคอนเมนู > เครื่องมือเพิ่มเติม > เครื่องมือสำหรับนักพัฒนาซอฟต์แวร์
หากต้องการเปิดคอนโซล 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 ดูหลักเกณฑ์เกี่ยวกับวิธีโพสต์คำถามที่ยอดเยี่ยมได้ที่หน้าการสนับสนุน