Giriş
Bindirmeler, harita üzerinde enlem/boylam koordinatlarına bağlı nesnelerdir. Böylece, haritayı sürüklediğinizde veya yakınlaştırdığınızda hareket ederler. Önceden tanımlanmış yer paylaşımı türleri hakkında bilgi için Haritada çizim bölümüne bakın.
Maps JavaScript API, kendi özel yer paylaşımlarınızı oluşturmanız için bir OverlayView
sınıfı sağlar. OverlayView
, yer paylaşımlarınızı oluştururken uygulamanız gereken çeşitli yöntemler sunan bir temel sınıftır. Sınıfta, ekran koordinatları ile harita üzerindeki konumlar arasında çeviri yapmayı sağlayan birkaç yöntem de sunulmaktadır.
Özel yer paylaşımı ekle
Özel bindirme oluşturmak için gereken adımların özetini burada bulabilirsiniz:
- Özel yer paylaşımlı nesnenizin
prototype
öğesini yeni birgoogle.maps.OverlayView()
örneğine ayarlayın. Bu, aslında yer paylaşımı sınıfının alt sınıflandırılmasına neden olur. - Özel yer paylaşımınız için bir oluşturucu oluşturun ve tüm başlatma parametrelerini ayarlayın.
- Prototipinize bir
onAdd()
yöntemi uygulayın ve yer paylaşımını haritaya ekleyin. Harita, yer paylaşımının eklenmesi için hazır olduğundaOverlayView.onAdd()
çağrılır. - Prototipinizde bir
draw()
yöntemi uygulayın ve nesnenizin görsel görüntüsünü işleyin.OverlayView.draw()
, nesne ilk kez görüntülendiğinde çağrılır. - Ayrıca, yer paylaşımına eklediğiniz tüm öğeleri temizlemek için bir
onRemove()
yöntemi de uygulamanız gerekir.
Her bir adımla ilgili daha fazla bilgiyi aşağıda bulabilirsiniz. Çalışan örnek kodun tamamını görebilirsiniz: örnek kodu görüntüleyin.
Yer paylaşımını alt sınıflandırma
Aşağıdaki örnekte, basit bir resim yer paylaşımı oluşturmak için OverlayView
kullanılmaktadır.
Şimdi USGSOverlay
sınıfı için bir kurucu oluşturuyor ve iletilen parametreleri yeni nesnenin özellikleri olarak ilk kullanıma hazırlıyoruz.
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; }
Bu yer paylaşımını henüz yer paylaşımının oluşturucusunda haritaya ekleyemiyoruz. Öncelikle, tüm harita bölmelerinin kullanılabilir olduğundan emin olmamız gerekir. Çünkü bunlar, nesnelerin haritada görüntülenme sırasını belirtir. API, bunun oluştuğunu belirten bir yardımcı yöntem sağlar. Bu yöntemi bir sonraki bölümde ele alacağız.
Yer paylaşımını başlatma
Bindirme ilk kez örneklendirildiğinde ve görüntülenmeye hazır olduğunda bunu tarayıcının DOM'si aracılığıyla haritaya eklememiz gerekir. API, yer paylaşımının onAdd()
yöntemini çağırarak yer paylaşımının haritaya eklendiğini belirtir. Bu yöntemi kullanmak için resmimizi barındıracak bir <div>
oluştururuz, bir <img>
öğesi ekleriz, bu öğeyi <div>
'e ekleriz ve ardından yer paylaşımını haritanın bölmelerinden birine ekleriz. Panel, DOM ağacındaki bir düğümdür.
MapPanes
türündeki bölmeler, haritada farklı katmanların yığın sıralamasını belirtir. Aşağıdaki bölmeler kullanılabilir ve aşağıdan yukarıya doğru yığılmış oldukları sırayla listelenir:
mapPane
, en alt paneldir ve kartların üzerindedir. DOM etkinlikleri alamayabilir. (Pane 0).overlayLayer
çoklu çizgiler, poligonlar, zemin bindirmeleri ve karo katmanı katmanları içerir. DOM etkinlikleri alamayabilir. (1. panel).markerLayer
işaretçiler içeriyor. DOM etkinlikleri alamayabilir. (2. bölme).overlayMouseTarget
, DOM etkinliklerini alan öğeler içeriyor. (3. bölme).floatPane
bilgi penceresini içerir. Tüm harita yer paylaşımlarının üstündedir. (Pane 4).
Görüntümüz "zemin bindirme" olduğundan overlayLayer
bölmesini kullanacağız. Bu bölmeyi oluşturduğumuzda nesnemizi ona bir alt öğe olarak ekleriz.
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); }
Yer paylaşımını çizme
Yukarıdaki kodda herhangi bir özel görsel görüntüleme çağırmadığımızı unutmayın. İlk eklendiği zaman da dahil olmak üzere, yer paylaşımını haritada çizmesi gerektiğinde API, yer paylaşımında ayrı bir draw()
yöntemi çağırır.
Bu nedenle, bu draw()
yöntemini uygular, getProjection()
kullanarak yer paylaşımının MapCanvasProjection
değerini alır ve nesnenin sağ üst ve sol alt noktalarının sabitleneceği tam koordinatları hesaplarız.
Daha sonra, <div>
öğesini yeniden boyutlandırabiliriz. Bu da resmi, yer paylaşımının kurucusunda belirttiğimiz sınırlarla eşleşecek şekilde yeniden boyutlandırır.
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"; } }
Özel yer paylaşımını kaldırma
Ayrıca, bindirmeyi haritadan temiz bir şekilde kaldırmak için bir onRemove()
yöntemi de ekledik.
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; } }
Özel yer paylaşımını gizleme ve gösterme
Bir yer paylaşımını oluşturmak veya kaldırmak yerine gizlemek ya da göstermek isterseniz yer paylaşımının görünürlüğünü ayarlamak için kendi hide()
ve show()
yöntemlerinizi uygulayabilirsiniz. Alternatif olarak, bindirmeyi haritanın DOM'sinden çıkarabilirsiniz, ancak bu işlem biraz daha pahalıdır. Daha sonra yer paylaşımını haritanın DOM'una yeniden eklerseniz yer paylaşımının onAdd()
yönteminin yeniden çağrılacağını unutmayın.
Aşağıdaki örnekte, yer paylaşımının prototipine <div>
kapsayıcısının görünürlüğünü açıp kapatan hide()
ve show()
yöntemleri eklenmiştir. Ayrıca, yer paylaşımını haritaya ekleyen veya haritadan kaldıran bir toggleDOM()
yöntemi de ekleriz.
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); } }
Düğme kontrolleri ekle
toggle
ve toggleDom
yöntemlerini tetiklemek için düğme kontrolleri haritaya eklenir.
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);
Örnek kodu tamamlayın
Örnek kodun tamamı aşağıda verilmiştir:
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>