บทนำ
การวางซ้อนคือวัตถุบนแผนที่ที่เชื่อมโยงกับพิกัดละติจูด/ลองจิจูด ดังนั้นวัตถุจะเคลื่อนไหวเมื่อคุณลากหรือซูมแผนที่ ดูข้อมูลเกี่ยวกับประเภทการวางซ้อนที่กําหนดไว้ล่วงหน้าได้ที่การวาดบนแผนที่
Maps JavaScript API มีคลาส OverlayView
สำหรับการสร้างการวางซ้อนที่กําหนดเอง OverlayView
เป็นคลาสพื้นฐานที่มีเมธอดหลายรายการซึ่งคุณต้องนำมาใช้เมื่อสร้างการวางซ้อน นอกจากนี้ คลาสยังมีวิธีการบางอย่างที่ช่วยให้แปลระหว่างพิกัดหน้าจอและสถานที่บนแผนที่ได้
เพิ่มการวางซ้อนที่กําหนดเอง
สรุปขั้นตอนที่จำเป็นในการสร้างการวางซ้อนที่กำหนดเองมีดังนี้
- ตั้งค่า
prototype
ของออบเจ็กต์การวางซ้อนที่กําหนดเองเป็นอินสแตนซ์ใหม่ของgoogle.maps.OverlayView()
ซึ่งจะทำให้เกิดคลาสย่อยของคลาสการวางซ้อน - สร้างคอนสตรัคเตอร์สําหรับการวางซ้อนที่กําหนดเอง และตั้งค่าพารามิเตอร์การเริ่มต้น
- ใช้เมธอด
onAdd()
ภายในโปรโตไทป์ และแนบการวางซ้อนกับแผนที่ ระบบจะเรียกใช้OverlayView.onAdd()
เมื่อแผนที่พร้อมสำหรับการแนบการวางซ้อน - ใช้เมธอด
draw()
ภายในโปรโตไทป์ และจัดการการแสดงภาพวัตถุOverlayView.draw()
จะเรียกใช้เมื่อออบเจ็กต์แสดงเป็นครั้งแรก - นอกจากนี้ คุณควรใช้เมธอด
onRemove()
เพื่อล้างองค์ประกอบทั้งหมดที่เพิ่มภายในการวางซ้อน
รายละเอียดเพิ่มเติมของแต่ละขั้นตอนมีดังนี้ คุณดูโค้ดตัวอย่างที่ใช้งานได้แบบเต็มได้ที่ดูโค้ดตัวอย่าง
วางซ้อนคลาสย่อย
ตัวอย่างด้านล่างใช้ OverlayView
เพื่อสร้างการวางซ้อนรูปภาพอย่างง่าย
ตอนนี้เราสร้างคอนสตรัคเตอร์สำหรับคลาส USGSOverlay
และเริ่มต้นพารามิเตอร์ที่ส่งเป็นพร็อพเพอร์ตี้ของออบเจ็กต์ใหม่
TypeScript
/** * The custom USGSOverlay object contains the USGS image, * the bounds of the image, and a reference to the map. */ class USGSOverlay extends google.maps.OverlayView { private bounds: google.maps.LatLngBounds; private image: string; private div?: HTMLElement; constructor(bounds: google.maps.LatLngBounds, image: string) { super(); this.bounds = bounds; this.image = image; }
JavaScript
/** * The custom USGSOverlay object contains the USGS image, * the bounds of the image, and a reference to the map. */ class USGSOverlay extends google.maps.OverlayView { bounds; image; div; constructor(bounds, image) { super(); this.bounds = bounds; this.image = image; }
เรายังแนบการวางซ้อนนี้กับแผนที่ในเครื่องมือสร้างของการวางซ้อนไม่ได้ ก่อนอื่นเราต้องตรวจสอบว่าแผงทั้งหมดของแผนที่พร้อมใช้งาน เนื่องจากแผงเหล่านี้จะระบุลำดับที่วัตถุจะแสดงบนแผนที่ API มีเมธอดตัวช่วยที่ระบุว่าเกิดเหตุการณ์นี้ขึ้น เราจะจัดการวิธีการนั้นในส่วนถัดไป
เริ่มต้นการวางซ้อน
เมื่ออินสแตนซ์การวางซ้อนเป็นครั้งแรกและพร้อมแสดงแล้ว เราจะต้องแนบการวางซ้อนนั้นกับแผนที่ผ่าน DOM ของเบราว์เซอร์ API ระบุว่าได้เพิ่มการวางซ้อนลงในแผนที่แล้วโดยการเรียกใช้เมธอด onAdd()
ของการวางซ้อน ในการจัดการกับวิธีการนี้ เราสร้าง <div>
เพื่อเก็บรูปภาพ เพิ่มองค์ประกอบ <img>
แนบกับ <div>
แล้วแนบการวางซ้อนกับแผงของแผนที่ แผงคือโหนดภายในแผนผัง DOM
แผงประเภท MapPanes
จะระบุลําดับการซ้อนสําหรับเลเยอร์ต่างๆ ในแผนที่ แผงต่อไปนี้พร้อมใช้งานและจะแสดงตามลําดับที่ซ้อนกันจากล่างขึ้นบน
mapPane
คือแผงที่อยู่ต่ำสุดและอยู่เหนือการ์ด รายการนี้อาจไม่รับเหตุการณ์ DOM (แผง 0)overlayLayer
มีเส้นประกอบ รูปหลายเหลี่ยม การวางซ้อนพื้น และการวางซ้อนเลเยอร์ไทล์ อาจมีไม่รับเหตุการณ์ DOM (แผง 1)markerLayer
มีเครื่องหมาย อาจมีไม่รับเหตุการณ์ DOM (แผง 2)overlayMouseTarget
มีองค์ประกอบที่รับเหตุการณ์ DOM (แผง 3)floatPane
มีหน้าต่างข้อมูล โดยจะอยู่เหนือการวางซ้อนแผนที่ทั้งหมด (Pane 4).
เนื่องจากรูปภาพของเราเป็น "การวางซ้อนพื้นดิน" เราจึงจะใช้แผง overlayLayer
เมื่อได้แผงนั้นแล้ว เราจะแนบออบเจ็กต์ของเราเป็นรายการย่อย
TypeScript
/** * onAdd is called when the map's panes are ready and the overlay has been * added to the map. */ onAdd() { this.div = document.createElement("div"); this.div.style.borderStyle = "none"; this.div.style.borderWidth = "0px"; this.div.style.position = "absolute"; // Create the img element and attach it to the div. const img = document.createElement("img"); img.src = this.image; img.style.width = "100%"; img.style.height = "100%"; img.style.position = "absolute"; this.div.appendChild(img); // Add the element to the "overlayLayer" pane. const panes = this.getPanes()!; panes.overlayLayer.appendChild(this.div); }
JavaScript
/** * onAdd is called when the map's panes are ready and the overlay has been * added to the map. */ onAdd() { this.div = document.createElement("div"); this.div.style.borderStyle = "none"; this.div.style.borderWidth = "0px"; this.div.style.position = "absolute"; // Create the img element and attach it to the div. const img = document.createElement("img"); img.src = this.image; img.style.width = "100%"; img.style.height = "100%"; img.style.position = "absolute"; this.div.appendChild(img); // Add the element to the "overlayLayer" pane. const panes = this.getPanes(); panes.overlayLayer.appendChild(this.div); }
วาดการวางซ้อน
โปรดทราบว่าเราไม่ได้เรียกใช้การแสดงภาพพิเศษใดๆ ในโค้ดด้านบน API จะเรียกใช้เมธอด draw()
แยกต่างหากบนการวางซ้อนทุกครั้งที่ต้องวาดการวางซ้อนบนแผนที่ รวมถึงเมื่อเพิ่มครั้งแรก
ดังนั้น เราจะใช้เมธอด draw()
นี้ ดึงข้อมูล MapCanvasProjection
ของการวางซ้อนโดยใช้ getProjection()
และคำนวณพิกัดที่แน่นอนเพื่อยึดจุดบนขวาและล่างซ้ายของวัตถุ
จากนั้นเราจะปรับขนาด <div>
ได้ ซึ่งจะปรับขนาดรูปภาพให้ตรงกับขอบเขตที่เราระบุไว้ในคอนสตรัคเตอร์ของการวางซ้อน
TypeScript
draw() { // We use the south-west and north-east // coordinates of the overlay to peg it to the correct position and size. // To do this, we need to retrieve the projection from the overlay. const overlayProjection = this.getProjection(); // Retrieve the south-west and north-east coordinates of this overlay // in LatLngs and convert them to pixel coordinates. // We'll use these coordinates to resize the div. const sw = overlayProjection.fromLatLngToDivPixel( this.bounds.getSouthWest() )!; const ne = overlayProjection.fromLatLngToDivPixel( this.bounds.getNorthEast() )!; // Resize the image's div to fit the indicated dimensions. if (this.div) { this.div.style.left = sw.x + "px"; this.div.style.top = ne.y + "px"; this.div.style.width = ne.x - sw.x + "px"; this.div.style.height = sw.y - ne.y + "px"; } }
JavaScript
draw() { // We use the south-west and north-east // coordinates of the overlay to peg it to the correct position and size. // To do this, we need to retrieve the projection from the overlay. const overlayProjection = this.getProjection(); // Retrieve the south-west and north-east coordinates of this overlay // in LatLngs and convert them to pixel coordinates. // We'll use these coordinates to resize the div. const sw = overlayProjection.fromLatLngToDivPixel( this.bounds.getSouthWest(), ); const ne = overlayProjection.fromLatLngToDivPixel( this.bounds.getNorthEast(), ); // Resize the image's div to fit the indicated dimensions. if (this.div) { this.div.style.left = sw.x + "px"; this.div.style.top = ne.y + "px"; this.div.style.width = ne.x - sw.x + "px"; this.div.style.height = sw.y - ne.y + "px"; } }
นำการวางซ้อนที่กําหนดเองออก
นอกจากนี้ เรายังได้เพิ่มเมธอด onRemove()
เพื่อนําการวางซ้อนออกจากแผนที่อย่างเรียบร้อย
TypeScript
/** * The onRemove() method will be called automatically from the API if * we ever set the overlay's map property to 'null'. */ onRemove() { if (this.div) { (this.div.parentNode as HTMLElement).removeChild(this.div); delete this.div; } }
JavaScript
/** * The onRemove() method will be called automatically from the API if * we ever set the overlay's map property to 'null'. */ onRemove() { if (this.div) { this.div.parentNode.removeChild(this.div); delete this.div; } }
ซ่อนและแสดงการวางซ้อนที่กําหนดเอง
หากต้องการซ่อนหรือแสดงการวางซ้อนแทนที่จะสร้างหรือนําออก คุณสามารถใช้เมธอด hide()
และ show()
ของคุณเองเพื่อปรับระดับการมองเห็นของการวางซ้อน หรือจะแยกการวางซ้อนออกจาก DOM ของแผนที่ก็ได้ แต่การดำเนินการนี้จะเสียค่าใช้จ่ายมากกว่าเล็กน้อย โปรดทราบว่าหากคุณแนบการวางซ้อนกับ DOM ของแผนที่อีกครั้ง ระบบจะเรียกใช้เมธอด onAdd()
ของการวางซ้อนอีกครั้ง
ตัวอย่างต่อไปนี้จะเพิ่มเมธอด hide()
และ show()
ลงในโปรโตไทป์ของการวางซ้อน ซึ่งจะสลับการแสดงผลของคอนเทนเนอร์ <div>
นอกจากนี้ เรายังเพิ่มเมธอด toggleDOM()
ซึ่งจะแนบหรือเลิกแนบการวางซ้อนกับแผนที่
TypeScript
/** * Set the visibility to 'hidden' or 'visible'. */ hide() { if (this.div) { this.div.style.visibility = "hidden"; } } show() { if (this.div) { this.div.style.visibility = "visible"; } } toggle() { if (this.div) { if (this.div.style.visibility === "hidden") { this.show(); } else { this.hide(); } } } toggleDOM(map: google.maps.Map) { if (this.getMap()) { this.setMap(null); } else { this.setMap(map); } }
JavaScript
/** * Set the visibility to 'hidden' or 'visible'. */ hide() { if (this.div) { this.div.style.visibility = "hidden"; } } show() { if (this.div) { this.div.style.visibility = "visible"; } } toggle() { if (this.div) { if (this.div.style.visibility === "hidden") { this.show(); } else { this.hide(); } } } toggleDOM(map) { if (this.getMap()) { this.setMap(null); } else { this.setMap(map); } }
เพิ่มการควบคุมด้วยปุ่ม
หากต้องการเรียกใช้เมธอด toggle
และ toggleDom
ระบบจะเพิ่มตัวควบคุมปุ่มลงในแผนที่
TypeScript
const toggleButton = document.createElement("button"); toggleButton.textContent = "Toggle"; toggleButton.classList.add("custom-map-control-button"); const toggleDOMButton = document.createElement("button"); toggleDOMButton.textContent = "Toggle DOM Attachment"; toggleDOMButton.classList.add("custom-map-control-button"); toggleButton.addEventListener("click", () => { overlay.toggle(); }); toggleDOMButton.addEventListener("click", () => { overlay.toggleDOM(map); }); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleDOMButton); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleButton);
JavaScript
const toggleButton = document.createElement("button"); toggleButton.textContent = "Toggle"; toggleButton.classList.add("custom-map-control-button"); const toggleDOMButton = document.createElement("button"); toggleDOMButton.textContent = "Toggle DOM Attachment"; toggleDOMButton.classList.add("custom-map-control-button"); toggleButton.addEventListener("click", () => { overlay.toggle(); }); toggleDOMButton.addEventListener("click", () => { overlay.toggleDOM(map); }); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleDOMButton); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleButton);
โค้ดตัวอย่างที่สมบูรณ์
โค้ดตัวอย่างที่สมบูรณ์มีดังนี้
TypeScript
// This example adds hide() and show() methods to a custom overlay's prototype. // These methods toggle the visibility of the container <div>. // overlay to or from the map. function initMap(): void { const map = new google.maps.Map( document.getElementById("map") as HTMLElement, { zoom: 11, center: { lat: 62.323907, lng: -150.109291 }, mapTypeId: "satellite", } ); const bounds = new google.maps.LatLngBounds( new google.maps.LatLng(62.281819, -150.287132), new google.maps.LatLng(62.400471, -150.005608) ); // The photograph is courtesy of the U.S. Geological Survey. let image = "https://developers.google.com/maps/documentation/javascript/"; image += "examples/full/images/talkeetna.png"; /** * The custom USGSOverlay object contains the USGS image, * the bounds of the image, and a reference to the map. */ class USGSOverlay extends google.maps.OverlayView { private bounds: google.maps.LatLngBounds; private image: string; private div?: HTMLElement; constructor(bounds: google.maps.LatLngBounds, image: string) { super(); this.bounds = bounds; this.image = image; } /** * onAdd is called when the map's panes are ready and the overlay has been * added to the map. */ onAdd() { this.div = document.createElement("div"); this.div.style.borderStyle = "none"; this.div.style.borderWidth = "0px"; this.div.style.position = "absolute"; // Create the img element and attach it to the div. const img = document.createElement("img"); img.src = this.image; img.style.width = "100%"; img.style.height = "100%"; img.style.position = "absolute"; this.div.appendChild(img); // Add the element to the "overlayLayer" pane. const panes = this.getPanes()!; panes.overlayLayer.appendChild(this.div); } draw() { // We use the south-west and north-east // coordinates of the overlay to peg it to the correct position and size. // To do this, we need to retrieve the projection from the overlay. const overlayProjection = this.getProjection(); // Retrieve the south-west and north-east coordinates of this overlay // in LatLngs and convert them to pixel coordinates. // We'll use these coordinates to resize the div. const sw = overlayProjection.fromLatLngToDivPixel( this.bounds.getSouthWest() )!; const ne = overlayProjection.fromLatLngToDivPixel( this.bounds.getNorthEast() )!; // Resize the image's div to fit the indicated dimensions. if (this.div) { this.div.style.left = sw.x + "px"; this.div.style.top = ne.y + "px"; this.div.style.width = ne.x - sw.x + "px"; this.div.style.height = sw.y - ne.y + "px"; } } /** * The onRemove() method will be called automatically from the API if * we ever set the overlay's map property to 'null'. */ onRemove() { if (this.div) { (this.div.parentNode as HTMLElement).removeChild(this.div); delete this.div; } } /** * Set the visibility to 'hidden' or 'visible'. */ hide() { if (this.div) { this.div.style.visibility = "hidden"; } } show() { if (this.div) { this.div.style.visibility = "visible"; } } toggle() { if (this.div) { if (this.div.style.visibility === "hidden") { this.show(); } else { this.hide(); } } } toggleDOM(map: google.maps.Map) { if (this.getMap()) { this.setMap(null); } else { this.setMap(map); } } } const overlay: USGSOverlay = new USGSOverlay(bounds, image); overlay.setMap(map); const toggleButton = document.createElement("button"); toggleButton.textContent = "Toggle"; toggleButton.classList.add("custom-map-control-button"); const toggleDOMButton = document.createElement("button"); toggleDOMButton.textContent = "Toggle DOM Attachment"; toggleDOMButton.classList.add("custom-map-control-button"); toggleButton.addEventListener("click", () => { overlay.toggle(); }); toggleDOMButton.addEventListener("click", () => { overlay.toggleDOM(map); }); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleDOMButton); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleButton); } declare global { interface Window { initMap: () => void; } } window.initMap = initMap;
JavaScript
// This example adds hide() and show() methods to a custom overlay's prototype. // These methods toggle the visibility of the container <div>. // overlay to or from the map. function initMap() { const map = new google.maps.Map(document.getElementById("map"), { zoom: 11, center: { lat: 62.323907, lng: -150.109291 }, mapTypeId: "satellite", }); const bounds = new google.maps.LatLngBounds( new google.maps.LatLng(62.281819, -150.287132), new google.maps.LatLng(62.400471, -150.005608), ); // The photograph is courtesy of the U.S. Geological Survey. let image = "https://developers.google.com/maps/documentation/javascript/"; image += "examples/full/images/talkeetna.png"; /** * The custom USGSOverlay object contains the USGS image, * the bounds of the image, and a reference to the map. */ class USGSOverlay extends google.maps.OverlayView { bounds; image; div; constructor(bounds, image) { super(); this.bounds = bounds; this.image = image; } /** * onAdd is called when the map's panes are ready and the overlay has been * added to the map. */ onAdd() { this.div = document.createElement("div"); this.div.style.borderStyle = "none"; this.div.style.borderWidth = "0px"; this.div.style.position = "absolute"; // Create the img element and attach it to the div. const img = document.createElement("img"); img.src = this.image; img.style.width = "100%"; img.style.height = "100%"; img.style.position = "absolute"; this.div.appendChild(img); // Add the element to the "overlayLayer" pane. const panes = this.getPanes(); panes.overlayLayer.appendChild(this.div); } draw() { // We use the south-west and north-east // coordinates of the overlay to peg it to the correct position and size. // To do this, we need to retrieve the projection from the overlay. const overlayProjection = this.getProjection(); // Retrieve the south-west and north-east coordinates of this overlay // in LatLngs and convert them to pixel coordinates. // We'll use these coordinates to resize the div. const sw = overlayProjection.fromLatLngToDivPixel( this.bounds.getSouthWest(), ); const ne = overlayProjection.fromLatLngToDivPixel( this.bounds.getNorthEast(), ); // Resize the image's div to fit the indicated dimensions. if (this.div) { this.div.style.left = sw.x + "px"; this.div.style.top = ne.y + "px"; this.div.style.width = ne.x - sw.x + "px"; this.div.style.height = sw.y - ne.y + "px"; } } /** * The onRemove() method will be called automatically from the API if * we ever set the overlay's map property to 'null'. */ onRemove() { if (this.div) { this.div.parentNode.removeChild(this.div); delete this.div; } } /** * Set the visibility to 'hidden' or 'visible'. */ hide() { if (this.div) { this.div.style.visibility = "hidden"; } } show() { if (this.div) { this.div.style.visibility = "visible"; } } toggle() { if (this.div) { if (this.div.style.visibility === "hidden") { this.show(); } else { this.hide(); } } } toggleDOM(map) { if (this.getMap()) { this.setMap(null); } else { this.setMap(map); } } } const overlay = new USGSOverlay(bounds, image); overlay.setMap(map); const toggleButton = document.createElement("button"); toggleButton.textContent = "Toggle"; toggleButton.classList.add("custom-map-control-button"); const toggleDOMButton = document.createElement("button"); toggleDOMButton.textContent = "Toggle DOM Attachment"; toggleDOMButton.classList.add("custom-map-control-button"); toggleButton.addEventListener("click", () => { overlay.toggle(); }); toggleDOMButton.addEventListener("click", () => { overlay.toggleDOM(map); }); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleDOMButton); map.controls[google.maps.ControlPosition.TOP_RIGHT].push(toggleButton); } window.initMap = initMap;
CSS
/* * Always set the map height explicitly to define the size of the div element * that contains the map. */ #map { height: 100%; } /* * Optional: Makes the sample page fill the window. */ html, body { height: 100%; margin: 0; padding: 0; } .custom-map-control-button { background-color: #fff; border: 0; border-radius: 2px; box-shadow: 0 1px 4px -1px rgba(0, 0, 0, 0.3); margin: 10px; padding: 0 0.5em; font: 400 18px Roboto, Arial, sans-serif; overflow: hidden; height: 40px; cursor: pointer; } .custom-map-control-button:hover { background: rgb(235, 235, 235); }
HTML
<html> <head> <title>Showing/Hiding Overlays</title> <link rel="stylesheet" type="text/css" href="./style.css" /> <script type="module" src="./index.js"></script> </head> <body> <div id="map"></div> <!-- The `defer` attribute causes the script to execute after the full HTML document has been parsed. For non-blocking uses, avoiding race conditions, and consistent behavior across browsers, consider loading using Promises. See https://developers.google.com/maps/documentation/javascript/load-maps-js-api for more information. --> <script src="https://maps.googleapis.com/maps/api/js?key=AIzaSyB41DRUbKWJHPxaFjMAwdrzWzbVKartNGg&callback=initMap&v=weekly" defer ></script> </body> </html>