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

หน้านี้ได้รับการแปลโดย Cloud Translation API

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

หากต้องการความช่วยเหลือจากเจ้าหน้าที่
ไปที่หน้าการสนับสนุนของ 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 ต่อไปนี้เป็นตัวเลือก 2-3 ข้อในการตรวจสอบว่าคุณกำลังใช้คีย์ API อยู่หรือไม่

ใช้ส่วนขยาย Google Maps Platform API Checker ใน Chrome วิธีนี้จะช่วยให้คุณทราบว่าเว็บไซต์ใช้งาน 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 ให้ใช้คีย์ API แทน YOUR_API_KEY ในโค้ดด้านล่าง
```
  <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 Console แล้วเลือกโปรเจ็กต์ที่คุณสร้างคีย์ API ไว้ วิธียืนยันว่าคีย์เชื่อมโยงกับโปรเจ็กต์แล้ว

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

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

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

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

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

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

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

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

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

UnauthorizedURLForClientIdMapError

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

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

รหัสข้อผิดพลาดของนักพัฒนาซอฟต์แวร์	Type	คำอธิบาย
`ApiNotActivatedMapError`	ข้อผิดพลาด	ไม่ได้เปิดใช้งาน Maps JavaScript API ในโปรเจ็กต์ API ของคุณ คุณอาจต้องเปิดใช้ Maps JavaScript API ภายใต้ API ใน Google Cloud Console หากต้องการเปิดใช้งาน 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 หากไม่มีใบอนุญาตแพ็กเกจพรีเมียมหรือ Maps API for Work คุณต้องใช้พารามิเตอร์ `key` กับคีย์ API แทนพารามิเตอร์ `client` โปรดดูคู่มือสำหรับ การตรวจสอบสิทธิ์ของแพ็กเกจพรีเมียม
`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 ดู 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`	คำเตือน	คุณอาจระบุคีย์การเข้ารหัสไว้ในพารามิเตอร์ `client` หากคุณมีใบอนุญาตแพ็กเกจพรีเมียมหรือ Maps API for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` คุณไม่จำเป็นต้องใช้คีย์การเข้ารหัสสำหรับ Maps JavaScript API ดูคู่มือเกี่ยวกับ รหัสไคลเอ็นต์สำหรับลูกค้าของแพ็กเกจพรีเมียมและ Maps API for Work
`ClientIdLooksLikeKey`	คำเตือน	คุณอาจระบุคีย์ API ไว้ในพารามิเตอร์ `client` หากคุณมีใบอนุญาตแพ็กเกจพรีเมียมหรือ Maps API for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` หากมีแพ็กเกจพรีเมียมของ Google Maps Platform คุณจะใช้พารามิเตอร์ `client` หรือพารามิเตอร์ `key` ได้ หากไม่มีใบอนุญาต คุณต้องใช้พารามิเตอร์ `key` แทนพารามิเตอร์ `client` โปรดดูคู่มือสำหรับ การตรวจสอบสิทธิ์ของแพ็กเกจพรีเมียม
`InvalidChannel`	คำเตือน	คุณอาจระบุพารามิเตอร์ `channel` ที่ไม่ถูกต้อง แชแนลต้องเป็นสตริงที่เป็นตัวอักษรและตัวเลขคละกัน ASCII ซึ่งอาจรวมถึงจุด (.) ขีดล่าง (_) และขีดกลาง (-) โปรดตรวจสอบว่าคุณระบุพารามิเตอร์ `channel` ที่ถูกต้อง ดู การรายงาน \| แพ็กเกจพรีเมียมของ Google Maps Platform
`InvalidClientId`	คำเตือน	ดูเหมือนว่าพารามิเตอร์ `client` จะไม่มีรหัสไคลเอ็นต์ที่ถูกต้อง รหัสลูกค้าควรเริ่มต้นด้วย "gme-" โปรดดูคู่มือสำหรับ การตรวจสอบสิทธิ์ของแพ็กเกจพรีเมียม
`InvalidKey`	คำเตือน	คีย์ API ที่รวมอยู่ในองค์ประกอบสคริปต์ที่โหลด API ดูไม่ถูกต้อง โปรดตรวจสอบว่าคุณกำลังใช้คีย์ API ที่ถูกต้อง คุณสร้างคีย์ API ใหม่ใน Cloud Console ได้ คลิกปุ่มด้านล่างเพื่อรับคีย์ API เริ่มต้นใช้งาน
`InvalidVersion`	คำเตือน	คุณอาจระบุหมายเลขรุ่นที่ไม่ถูกต้องในองค์ประกอบของสคริปต์ โปรดตรวจสอบว่าคุณใช้หมายเลขเวอร์ชันที่ถูกต้อง ดู การกำหนดเวอร์ชัน \| Google Maps JavaScript API
`KeyLooksLikeClientId`	คำเตือน	คุณระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `key` ได้ หากคุณมีใบอนุญาตแพ็กเกจพรีเมียมหรือ Maps API for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` แทนพารามิเตอร์ `key` หากมีแพ็กเกจพรีเมียมของ Google Maps Platform คุณจะใช้พารามิเตอร์ `client` หรือพารามิเตอร์ `key` ได้ หากไม่มีใบอนุญาต คุณต้องใช้พารามิเตอร์ `key` แทนพารามิเตอร์ `client` โปรดดูคู่มือสำหรับ การตรวจสอบสิทธิ์ของแพ็กเกจพรีเมียม
`KeyLooksLikeCryptoKey`	คำเตือน	คุณอาจระบุคีย์การเข้ารหัสหรือข้อมูลลับที่มีการรับรองเป็นพารามิเตอร์ `key` แล้ว หากคุณมีใบอนุญาตแพ็กเกจพรีเมียมหรือ Maps API for Work โปรดระบุรหัสไคลเอ็นต์เป็นพารามิเตอร์ `client` และนำพารามิเตอร์ `key` ออกจากองค์ประกอบสคริปต์ ไม่จำเป็นต้องใช้คีย์การเข้ารหัสสำหรับ Maps JavaScript API หากมีแพ็กเกจพรีเมียมของ 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 จะอธิบายถึงข้อผิดพลาดที่พบบ่อยและวิธีแก้ไขในวิดีโอนี้เพื่อช่วยให้โค้ดแผนที่ของคุณพร้อมใช้งาน

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