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

Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด

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

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

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

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

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

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

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

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

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

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

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

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

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

คีย์ API ของคุณมีการจำกัดที่อยู่ IP ไหม

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

NotLoadingAPIFromGoogleMapsError

ต้องดาวน์โหลด Maps JavaScript API จากเซิร์ฟเวอร์ของ Google โดยตรง

องค์ประกอบสคริปต์ที่โหลด Maps JavaScript API ไม่ได้รวมอยู่ในหน้าเว็บอย่างถูกต้อง เพื่อให้ API ทำงานได้อย่างถูกต้อง คุณต้องโหลด API จาก https://maps.googleapis.com โดยตรง

ดู การโหลด Maps JavaScript API

TOSViolationMapError

ดูเหมือนว่าเว็บไซต์นี้จะละเมิดข้อกำหนดในการให้บริการของ Google Maps API Google Maps API ถูกปิดใช้สำหรับเว็บไซต์นี้

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

โปรดใช้คีย์ API หรือข้อมูลเข้าสู่ระบบรหัสไคลเอ็นต์เพื่อแก้ไขข้อผิดพลาดนี้ ดูคำแนะนำเกี่ยวกับคีย์ API และรหัสไคลเอ็นต์

UnauthorizedURLForClientIdMapError

URL นี้ไม่ได้รับอนุญาตให้ใช้รหัสไคลเอ็นต์ Google Maps ที่ระบุ

รหัสไคลเอ็นต์ที่รวมอยู่ในการโหลดสคริปต์ไม่ถูกต้อง หมดอายุ หรือที่อยู่ปัจจุบันที่โหลด 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 ดูข้อมูลเพิ่มเติมได้ที่แนวทางปฏิบัติแนะนำด้านความปลอดภัยของ API
`DeletedApiProjectMapError`	ข้อผิดพลาด	ระบบอาจลบโปรเจ็กต์ API ของคุณออกจากคอนโซล Cloud แล้ว โปรดตรวจสอบโปรเจ็กต์ที่คุณสร้างคีย์ 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`	ข้อผิดพลาด	เพื่อเพิ่มความปลอดภัยและความน่าเชื่อถือในการตรวจสอบสิทธิ์ เราจึงเลิกใช้งานรหัสไคลเอ็นต์ Maps Platform ตั้งแต่วันที่ 26 พฤษภาคม 2025 และจะใช้ไม่ได้อีกต่อไปหลังจากวันที่ 31 พฤษภาคม 2026 คุณต้องใช้ข้อมูลเข้าสู่ระบบคีย์ API เพื่อตรวจสอบสิทธิ์การเข้าชมบริการ Google Maps API แทนการใช้รหัสไคลเอ็นต์ ดูข้อมูลเพิ่มเติมได้ที่คำแนะนำในการย้ายข้อมูลรหัสไคลเอ็นต์ ทำตามขั้นตอนในคู่มือเพื่อกู้คืนรหัสไคลเอ็นต์ชั่วคราว
`InvalidKeyMapError`	ข้อผิดพลาด	ไม่พบคีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ได้ในคอนโซล Cloud หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง เริ่มต้นใช้งาน
`MalformedCredentialsMapError`	ข้อผิดพลาด	แอปพลิเคชันของคุณใช้สคีม URI ที่ไม่รองรับ ตรวจสอบว่าแอปพลิเคชันใช้รูปแบบ URI ที่ถูกต้องตามที่ระบุไว้ใน RFC 3986
`MissingKeyMapError`	ข้อผิดพลาด	องค์ประกอบสคริปต์ที่โหลด API ไม่มีพารามิเตอร์การตรวจสอบสิทธิ์ที่จำเป็น หากใช้ Maps JavaScript API คุณต้องใช้พารามิเตอร์ `key` กับคีย์ API ที่ถูกต้อง ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเริ่มต้นใช้งาน Google Maps Platform หากใช้รหัสไคลเอ็นต์ คุณต้องใช้พารามิเตอร์ `client` กับรหัสไคลเอ็นต์ หรือพารามิเตอร์ `key` กับคีย์ API ที่ถูกต้อง ดูข้อมูลเพิ่มเติมได้ที่คู่มือเกี่ยวกับคีย์ API และรหัสไคลเอ็นต์ หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะดำเนินการใดๆ เพื่อแก้ไขข้อผิดพลาดนี้ไม่ได้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้
`ProjectDeniedMapError`	ข้อผิดพลาด	คำขอของคุณยังไม่เสร็จสมบูรณ์ คุณอาจดูรายละเอียดเพิ่มเติมเกี่ยวกับข้อผิดพลาดได้ในคอนโซล Cloud ดูคอนโซล Google Cloud
`RefererDeniedMapError`	ข้อผิดพลาด	แอปพลิเคชันของคุณถูกบล็อกเนื่องจากไม่เป็นไปตามข้อกำหนดในการให้บริการของ Google Maps Platform หลังจากได้รับการแจ้งเตือนทางอีเมลหลายครั้ง หากต้องการอุทธรณ์การบล็อกและขอรับการตรวจสอบการใช้งาน โปรดกรอก แบบฟอร์มคำร้องเกี่ยวกับข้อกำหนดในการให้บริการของ Google Maps Platform คุณจะได้รับการตอบกลับทางอีเมลภายใน 2-3 วันทำการ
`RefererNotAllowedMapError`	ข้อผิดพลาด	URL ปัจจุบันที่โหลด Maps JavaScript API ยังไม่ได้เพิ่มลงในรายการผู้อ้างอิงที่อนุญาต โปรดตรวจสอบการตั้งค่า URL ที่มาของคีย์ API ในคอนโซล Cloud ดู Maps JavaScript API และรับคีย์ API
`OverQuotaMapError`	ข้อผิดพลาด	จำนวนคำขอเกินขีดจำกัดการใช้งานสำหรับ Maps JavaScript API คำขอของแอปจะทำงานอีกครั้งเมื่อมีการรีเซ็ตโควต้ารายวันครั้งถัดไป หากคุณไม่ใช่เจ้าของเว็บไซต์ คุณจะไม่มีขั้นตอนใดๆ ที่สามารถทำได้เพื่อแก้ไขข้อผิดพลาดนี้ อย่างไรก็ตาม คุณอาจต้องแจ้งให้เจ้าของเว็บไซต์ทราบหากเป็นไปได้ ดูรายละเอียดเพิ่มเติมได้ในคู่มือ ขีดจำกัดการใช้งาน หน้านี้ยังอธิบายวิธีเพิ่มขีดจำกัดการใช้งานด้วย
`ApiProjectMapError`	ข้อผิดพลาด	ไม่สามารถแก้ไขคีย์ API ที่ระบุหรือโปรเจ็กต์ API ที่เชื่อมโยงกับคีย์ดังกล่าวได้ ข้อผิดพลาดนี้อาจเกิดขึ้นชั่วคราว หากข้อความแสดงข้อผิดพลาดนี้ยังคงอยู่ คุณอาจต้องรับคีย์ API ใหม่หรือสร้างโปรเจ็กต์ API ใหม่ ดูข้อมูลเพิ่มเติมได้ที่หัวข้อเริ่มต้นใช้งาน Google Maps Platform
`ClientIdLooksLikeCryptoKey`	คำเตือน	คุณอาจระบุคีย์การเข้ารหัสในพารามิเตอร์ `client` โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` คุณไม่จำเป็นต้องใช้คีย์การเข้ารหัสสำหรับ Maps JavaScript API ดูคำแนะนำเกี่ยวกับรหัสไคลเอ็นต์
`ClientIdLooksLikeKey`	คำเตือน	คุณอาจระบุคีย์ API ในพารามิเตอร์ `client` โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` หรือใช้พารามิเตอร์ `key` กับคีย์ API ที่ถูกต้องแทนพารามิเตอร์ `client` ดูคำแนะนำเกี่ยวกับคีย์ API และรหัสไคลเอ็นต์
`InvalidChannel`	คำเตือน	คุณอาจระบุพารามิเตอร์ `channel` ที่ไม่ถูกต้อง แชแนลต้องเป็นสตริงตัวอักษรและตัวเลขคละกันแบบ ASCII ซึ่งอาจรวมถึงจุด (.) ขีดล่าง (_) และขีดกลาง (-) โปรดตรวจสอบว่าคุณระบุพารามิเตอร์ `channel` ที่ถูกต้อง ดู การรายงาน \| Google Maps Platform
`InvalidClientId`	คำเตือน	ดูเหมือนว่าพารามิเตอร์ `client` ไม่มีรหัสไคลเอ็นต์ที่ถูกต้อง รหัสไคลเอ็นต์ควรขึ้นต้นด้วย "gme-" ดูคำแนะนำเกี่ยวกับคีย์ API และรหัสไคลเอ็นต์
`InvalidKey`	คำเตือน	คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API ดูเหมือนจะไม่ถูกต้อง โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ได้ในคอนโซล Cloud หากต้องการรับคีย์ API ให้คลิกปุ่มด้านล่าง เริ่มต้นใช้งาน
`InvalidVersion`	คำเตือน	คุณอาจระบุหมายเลขเวอร์ชันที่ไม่ถูกต้องในองค์ประกอบสคริปต์ โปรดตรวจสอบว่าคุณใช้หมายเลขเวอร์ชันที่ถูกต้อง ดู การกำหนดเวอร์ชัน \| Google Maps JavaScript API
`KeyLooksLikeClientId`	คำเตือน	คุณอาจระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `key` โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` แทนพารามิเตอร์ `key` หรือใช้พารามิเตอร์ `key` กับคีย์ API ที่ถูกต้อง ดูคำแนะนำเกี่ยวกับคีย์ API และรหัสไคลเอ็นต์
`KeyLooksLikeCryptoKey`	คำเตือน	คุณอาจระบุคีย์การเข้ารหัสหรือข้อมูลลับในการรับรองเป็นพารามิเตอร์ `key` โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` และนำพารามิเตอร์ `key` ออกจากองค์ประกอบสคริปต์ Maps JavaScript API ไม่จำเป็นต้องใช้คีย์การเข้ารหัสลับ หรือจะรับคีย์ API ในคอนโซล Cloud และใช้พารามิเตอร์ `key` ก็ได้ ดูคำแนะนำเกี่ยวกับการระบุรหัสไคลเอ็นต์เมื่อโหลด API
`KeyLooksLikeProjectNumber`	คำเตือน	คุณอาจระบุหมายเลขโปรเจ็กต์เป็นพารามิเตอร์ `key` โปรดตรวจสอบว่าคุณใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ได้ในคอนโซล Cloud ดูวิธีรับคีย์ API
`NoApiKeys`	คำเตือน	องค์ประกอบสคริปต์ที่โหลด API ไม่มีคีย์ API โปรดตรวจสอบว่าคุณได้ใส่คีย์ API ที่ถูกต้องเป็นพารามิเตอร์ `key` คุณสร้างคีย์ API ใหม่ได้ในคอนโซล Cloud หากต้องการรับคีย์ 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 จะชี้ให้เห็นข้อผิดพลาดที่พบบ่อยและวิธีแก้ไขในวิดีโอนี้ เพื่อช่วยให้คุณเขียนโค้ดแผนที่และทำให้โค้ดทำงานได้

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