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-backend.googleapis.com - การตรวจสอบสิทธิ์: คีย์ API
- เริ่มต้นใช้งาน: ตั้งค่า Maps Embed API
- ข้อมูลอ้างอิง: เอกสารอ้างอิง Maps Embed 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
ดูคำแนะนำที่ลิงก์ไว้ด้านล่างสำหรับแต่ละงาน หรือเปรียบเทียบผลิตภัณฑ์ต่างๆ ในเครื่องมือสำรวจความสามารถ