ข้อมูลอ้างอิงฉบับย่อของ Maps Embed API

Maps Embed API จะวางแผนที่แบบอินเทอร์แอกทีฟหรือภาพพาโนรามาใน Street View บนหน้าเว็บผ่านคำขอ HTTP ที่ตั้งค่าเป็น URL ของ iframe src โดยไม่ต้องใช้ JavaScript โดยรองรับโหมดแผนที่place, view, directions, streetview และsearch

Maps Embed API: ข้อมูลสำคัญ

  • ผลิตภัณฑ์: Maps Embed API
  • หรือที่เรียกว่า Google Maps Embed API, Maps Embed
  • หมวดหมู่: Maps
  • แพลตฟอร์ม: JavaScript (เบราว์เซอร์)
  • ทำงานใน: ไคลเอ็นต์ (โค้ดแอปหรือเบราว์เซอร์)
  • ระยะการเปิดตัว: GA
  • วงจร: ใช้งานอยู่
  • ภาพรวม: ภาพรวมของ Maps Embed API
  • ภูมิภาคที่พร้อมให้บริการ: ทั่วโลก โหมด Street View ขึ้นอยู่กับความครอบคลุมของ Street View โดยพารามิเตอร์ region จะยอมรับภูมิภาคที่แสดงในหน้ารายละเอียดความครอบคลุมของ Maps Platform (รายละเอียดความครอบคลุม)

Maps Embed API: กรณีที่ควรใช้

ใช้ Maps Embed API เมื่อ

  • คุณต้องการแผนที่แบบอินเทอร์แอกทีฟหรือพาโนรามาใน Street View บนหน้าเว็บโดยใช้ iframe ของ HTML เท่านั้น โดยไม่มี JavaScript
  • คุณต้องแสดงหมุดสถานที่ มุมมองแผนที่ เส้นทางระหว่างจุดต่างๆ หรือผลการค้นหาสำหรับพื้นที่ในแผนที่ที่ฝังไว้
  • คุณต้องมีแผนที่แบบฝังที่ไม่มีการเรียกเก็บเงินต่อคำขอ และไม่มีขีดจำกัด QPS หรือคำขอรายวัน (ยังคงต้องใช้คีย์ API)

อย่าใช้ Maps Embed API ในกรณีต่อไปนี้

  • คุณต้องปรับแต่งแผนที่เว็บด้วยเนื้อหาและรูปภาพของคุณเอง โปรดใช้ Maps JavaScript API แทน
  • คุณต้องขยายแผนที่ที่ฝังด้วยฟีเจอร์แบบเป็นโปรแกรมที่นอกเหนือจากพารามิเตอร์ของ URL ของ iframe โปรดใช้ Maps JavaScript API แทน

Maps Embed API: การตั้งค่า

Maps Embed API: ข้อผิดพลาดที่พบบ่อย

  • ปัญหา: หากหน้าโฮสต์ตั้งค่าเมตาแท็ก referrer เป็น no-referrer หรือ same-origin เบราว์เซอร์จะไม่ส่งส่วนหัว Referer และคีย์ API ที่จำกัด HTTP Referrer อาจปฏิเสธคำขอฝัง วิธีแก้ไข: เพิ่ม referrerpolicy="strict-origin-when-cross-origin" ลงใน iframe เพื่อให้ระบบส่งโดเมนของเว็บไซต์ไปยัง Google ดู /maps/documentation/embed/embedding-map
  • ปัญหา: ระบบไม่รองรับแผนที่ที่ฝังซึ่งมีขนาดต่ำกว่า 200 พิกเซลในมิติข้อมูลใดก็ตาม วิธีแก้ไข: ตั้งค่า width และ height ของ iframe เป็นอย่างน้อย 200 พิกเซล ดู /maps/documentation/embed/embedding-map
  • ปัญหา: แม้ว่าการใช้งานจะไม่มีค่าใช้จ่าย แต่แผนที่สีเข้มที่มีลายน้ำ "เพื่อวัตถุประสงค์ในการพัฒนาเท่านั้น" จะปรากฏขึ้นหากไม่ได้เปิดใช้การเรียกเก็บเงิน วิธีการเรียกเก็บเงินไม่ถูกต้อง เกินขีดจำกัดการใช้งานต่อวันที่กำหนดเอง หรือคำขอไม่มีที่มา HTTP ขณะใช้คีย์ที่จำกัดที่มา วิธีแก้ไข: เปิดใช้การเรียกเก็บเงินด้วยวิธีการชำระเงินที่ถูกต้องในโปรเจ็กต์ เพิ่มหรือนำขีดจำกัดโควต้ารายวันที่กำหนดเองออก และตรวจสอบว่ามีการส่ง URL ที่มาสำหรับคีย์ที่จำกัด URL ที่มา (เช่น มี referrerpolicy="strict-origin-when-cross-origin" ใน iframe) ดู /maps/documentation/embed/error-messages
  • ปัญหา: สำหรับคำขอที่ไม่ถูกต้อง (พารามิเตอร์ไม่ถูกต้องหรือขาดหายไป และข้อผิดพลาดเกี่ยวกับคีย์ API และโควต้า เช่น คีย์ขาดหายไปหรือไม่ถูกต้อง, Maps Embed API ไม่ได้เปิดใช้ หรือการละเมิดข้อจำกัดของคีย์) ระบบจะรายงานเฉพาะรหัสสถานะ HTTP 4xx ในคอนโซลเบราว์เซอร์ ไม่ใช่ข้อความอธิบาย โดยข้อความแสดงข้อผิดพลาดจะปรากฏภายใน iframe แทนแผนที่ วิธีแก้ไข: อ่านข้อความแสดงข้อผิดพลาดใน iframe และรหัสสถานะคอนโซล (400 สำหรับข้อผิดพลาดของพารามิเตอร์, 401 สำหรับคีย์ที่ขาดหายไป, 403 สำหรับคีย์ที่ไม่ถูกต้อง) จากนั้นยืนยันว่าพารามิเตอร์ถูกต้อง คีย์ถูกต้อง เปิดใช้ Maps Embed API แล้ว และข้อจำกัดของคีย์อนุญาตคำขอ ดู /maps/documentation/embed/error-messages

สิ่งที่คุณทำได้ด้วย Maps Embed API

ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ

Maps Embed API: เส้นทางและการกำหนดเส้นทาง

Maps Embed API: Maps

Maps Embed API: Places

Maps Embed API: Street View