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

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

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

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

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