OverlayView-Klasse
google.maps.OverlayView
Klasse
Diese Klasse können Sie implementieren, wenn Sie benutzerdefinierte Typen von Overlay-Objekten auf der Karte anzeigen möchten.
Von dieser Klasse übernehmen, indem Sie den Prototyp Ihres Overlays festlegen: MyOverlay.prototype = new google.maps.OverlayView();
. Der OverlayView
-Konstruktor ist garantiert eine leere Funktion.
Sie müssen drei Methoden implementieren: onAdd()
, draw()
und onRemove()
.
- In der
onAdd()
-Methode sollten Sie DOM-Objekte erstellen und als untergeordnete Elemente der Bereiche anhängen. - In der Methode
draw()
sollten Sie diese Elemente positionieren. - In der
onRemove()
-Methode sollten Sie die Objekte aus dem DOM entfernen.
setMap()
mit einem gültigen Map
-Objekt aufrufen, um den Aufruf der Methode onAdd()
und setMap(null)
auszulösen, damit die Methode onRemove()
ausgelöst wird. Die Methode setMap()
kann bei der Erstellung oder jederzeit danach aufgerufen werden, wenn das Overlay nach dem Entfernen wieder angezeigt werden soll. Die Methode draw()
wird dann immer dann aufgerufen, wenn sich eine Karteneigenschaft ändert, die die Position des Elements ändern könnte, z. B. Zoom, Mittelpunkt oder Kartentyp.
Diese Klasse erweitert MVCObject
.
Rufen Sie dazu const {OverlayView} = await google.maps.importLibrary("maps")
oder const {OverlayView} = await google.maps.importLibrary("streetView")
auf. Weitere Informationen finden Sie unter Bibliotheken in der Maps JavaScript API.
Konstruktor | |
---|---|
OverlayView |
OverlayView() Parameter:Keine
Erstellt ein OverlayView . |
Statische Methoden | |
---|---|
preventMapHitsAndGesturesFrom |
preventMapHitsAndGesturesFrom(element) Parameter:
Rückgabewert:Keine
Verhindert, dass Klick-, Tippen-, Ziehen- und Rad-Ereignisse für das Element auf der Karte angezeigt werden. Hiermit können Sie das Ziehen und Zoomen der Karte sowie Klickereignisse für die Karte verhindern. |
preventMapHitsFrom |
preventMapHitsFrom(element) Parameter:
Rückgabewert:Keine
verhindert, dass das Klicken oder Tippen auf das Element auf der Karte angezeigt wird. Damit verhindern Sie, dass die Karte Klickereignisse auslöst. |
Methoden | |
---|---|
draw |
draw() Parameter:Keine
Rückgabewert:Keine
Implementieren Sie diese Methode, um den Overlay zu zeichnen oder zu aktualisieren. Verwenden Sie die Position von production.fromLatLngToDivPixel(), um das Overlay relativ zum MapPanes korrekt zu positionieren. Diese Methode wird nach onAdd() und bei einer Änderung des Zoom- oder Mittelpunkts aufgerufen. Es wird nicht empfohlen, bei dieser Methode rechenintensive Arbeit zu leisten. |
getMap |
getMap() Parameter:Keine
Rückgabewert:
Map|StreetViewPanorama |
getPanes |
getPanes() Parameter:Keine
Rückgabewert:
MapPanes|null Gibt die Fenster zurück, in denen dieser Overlay wiedergegeben werden kann. Die Bereiche werden erst initialisiert, wenn onAdd von der API aufgerufen wird. |
getProjection |
getProjection() Parameter:Keine
Rückgabewert:
MapCanvasProjection Gibt das MapCanvasProjection -Objekt zurück, das mit OverlayView verknüpft ist. Die Projektion wird erst initialisiert, wenn onAdd von der API aufgerufen wird. |
onAdd |
onAdd() Parameter:Keine
Rückgabewert:Keine
Implementieren Sie diese Methode, um die Overlay-DOM-Elemente zu initialisieren. Diese Methode wird einmal aufgerufen, nachdem setMap() mit einer gültigen Karte aufgerufen wurde. Zu diesem Zeitpunkt sind Fenster und Projektionen bereits initialisiert. |
onRemove |
onRemove() Parameter:Keine
Rückgabewert:Keine
Implementieren Sie diese Methode, um Elemente aus dem DOM zu entfernen. Diese Methode wird einmal nach dem Aufrufen von setMap(null) aufgerufen. |
setMap |
setMap(map) Parameter:
Rückgabewert:Keine
Fügt das Overlay zur Karte oder zum Panorama hinzu. |
Übernommen:
addListener ,
bindTo ,
get ,
notify ,
set ,
setValues ,
unbind ,
unbindAll
|
MapPanes-Schnittstelle
google.maps.MapPanes
-Schnittstelle
Attribute | |
---|---|
floatPane |
Typ:
Element Dieses Fenster enthält das Infofenster. Diese Überlagerung liegt über allen Kartenüberlagerungen. (Bereich 4). |
mapPane |
Typ:
Element Dies ist das unterste Fenster; es befindet sich direkt über den Kacheln. Er empfängt keine DOM-Ereignisse. (Bereich 0). |
markerLayer |
Typ:
Element Dieses Fenster enthält Markierungen. Er empfängt keine DOM-Ereignisse. (Bereich 2). |
overlayLayer |
Typ:
Element Dieses Fenster enthält Polylinien, Polygone, Boden-Overlays und Kachelebenen-Overlays. Er empfängt keine DOM-Ereignisse. (Bereich 1). |
overlayMouseTarget |
Typ:
Element Dieser Bereich enthält Elemente, die DOM-Ereignisse empfangen. (Bereich 3). |
MapCanvasProjection-Schnittstelle
google.maps.MapCanvasProjection
-Schnittstelle
Dieses Objekt wird dem OverlayView
innerhalb der „draw“-Methode zur Verfügung gestellt. Es besteht keine Garantie, dass es initialisiert wird bis "draw" aufgerufen wird.
Methoden | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parameter:
Rückgabewert:
LatLng|null Berechnet die geografischen Koordinaten aus den Pixelkoordinaten im Container der Karte. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) Parameter:
Rückgabewert:
LatLng|null Berechnet die geografischen Koordinaten aus den Pixelkoordinaten im div-Element, das die verschiebbare Karte enthält. |
fromLatLngToContainerPixel |
fromLatLngToContainerPixel(latLng) Parameter:
Rückgabewert:
Point|null Berechnet die Pixelkoordinaten des angegebenen geografischen Standorts im Containerelement der Karte. |
fromLatLngToDivPixel |
fromLatLngToDivPixel(latLng) Parameter:
Rückgabewert:
Point|null Berechnet die Pixelkoordinaten des angegebenen geografischen Standorts im DOM-Element, das die verschiebbare Karte enthält. |
getVisibleRegion |
getVisibleRegion() Parameter:Keine
Rückgabewert:
VisibleRegion|null Der sichtbare Bereich der Karte. Gibt null zurück, wenn die Karte keine Größe hat. Gibt null zurück, wenn sich OverlayView auf einem StreetViewPanorama befindet. |
getWorldWidth |
getWorldWidth() Parameter:Keine
Rückgabewert:
number Die Breite der Welt in Pixeln bei der aktuellen Zoom-Einstellung. Bei Projektionen mit einem Ausrichtungswinkel von entweder 90 oder 270 Grad entspricht dies der Pixelspanne auf der Y-Achse. |