DOM elements

Klasa OverlayView

google.maps.OverlayView class
extends MVCObject
library "maps", "streetView"

Możesz zaimplementować tę klasę, jeśli chcesz wyświetlać na mapie niestandardowe typy obiektów nakładki.

Dziedzicz z tej klasy, ustawiając prototyp nakładki: MyOverlay.prototype = new google.maps.OverlayView();. Konstruktor OverlayView jest zawsze pustą funkcją.

Musisz zaimplementować 3 metody: onAdd(), draw() i onRemove().

  • W metodzie onAdd() należy utworzyć obiekty DOM i dołączyć je jako elementy podrzędne paneli.
  • W metodzie draw() należy umieścić te elementy.
  • W metodzie onRemove() należy usunąć obiekty z DOM.
Musisz wywołać metodę setMap() z prawidłowym obiektem Map, aby wywołać metodę onAdd(), oraz metodę setMap(null), aby wywołać metodę onRemove(). Metodę setMap() można wywołać w momencie tworzenia lub w dowolnym momencie, gdy nakładka ma zostać ponownie wyświetlona po usunięciu. Metoda draw() będzie wywoływana za każdym razem, gdy zmieni się właściwość mapy, która może zmienić pozycję elementu, np. powiększenie, środek lub typ mapy.

const {OverlayView} = await google.maps.importLibrary("maps");
lub
const {OverlayView} = await google.maps.importLibrary("streetView");
OverlayView
OverlayView()
Parametry: brak
Tworzy OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Parametry:
Zwracana wartość: brak
Zatrzymuje zdarzenia kliknięcia, dotknięcia, przeciągnięcia i użycia kółka myszy na elemencie, aby nie były przekazywane do mapy. Użyj tej opcji, aby uniemożliwić przeciąganie i powiększanie mapy, a także zdarzenia „kliknięcia” mapy.
preventMapHitsFrom
preventMapHitsFrom(element)
Parametry:
Zwracana wartość: brak
Zatrzymuje kliknięcie elementu, aby nie zostało przekazane do mapy. Użyj tej opcji, aby zapobiec wywoływaniu przez mapę zdarzeń „kliknięcia”.
draw
draw()
Parametry: brak
Wartość zwracana: void
Zaimplementuj tę metodę, aby narysować lub zaktualizować nakładkę. Użyj pozycji z funkcji projection.fromLatLngToDivPixel(), aby prawidłowo ustawić nakładkę względem MapPanes. Ta metoda jest wywoływana po onAdd() i jest wywoływana po zmianie powiększenia lub środka. Nie zalecamy wykonywania w tej metodzie zadań wymagających dużej mocy obliczeniowej.
getMap
getMap()
Parametry: brak
Wartość zwracana: Map|StreetViewPanorama
getPanes
getPanes()
Parametry: brak
Wartość zwracana: MapPanes|null
Zwraca panele, w których można renderować ten widok OverlayView. Panele nie są inicjowane, dopóki interfejs API nie wywoła metody onAdd.
getProjection
getProjection()
Parametry: brak
Wartość zwracana: MapCanvasProjection
Zwraca obiekt MapCanvasProjection powiązany z tym OverlayView. Projekcja nie jest inicjowana, dopóki interfejs API nie wywoła metody onAdd.
onAdd
onAdd()
Parametry: brak
Wartość zwracana: void
Zaimplementuj tę metodę, aby zainicjować elementy DOM nakładki. Ta metoda jest wywoływana raz po wywołaniu metody setMap() z prawidłową mapą. W tym momencie panele i projekcja zostaną zainicjowane.
onRemove
onRemove()
Parametry: brak
Wartość zwracana: void
Zaimplementuj tę metodę, aby usunąć elementy z DOM. Ta metoda jest wywoływana raz po wywołaniu metody setMap(null).
setMap
setMap(map)
Parametry:
Zwracana wartość: brak
Dodaje nakładkę do mapy lub panoramy.
Dziedziczone: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfejs MapPanes

Interfejs google.maps.MapPanes

floatPane
Typ: Element
Ten panel zawiera okno informacyjne. Znajduje się nad wszystkimi nakładkami mapy. (panel 4).
mapPane
Typ: Element
Ten panel jest najniższym panelem i znajduje się nad kafelkami. Nie odbiera zdarzeń DOM. (Panel 0).
markerLayer
Typ: Element
Ten panel zawiera znaczniki. Nie odbiera zdarzeń DOM. (panel 2).
overlayLayer
Typ: Element
Ten panel zawiera linie łamane, wielokąty, nakładki naziemne i nakładki warstw kafelków. Nie odbiera zdarzeń DOM. (panel 1).
overlayMouseTarget
Typ: Element
Ten panel zawiera elementy, które odbierają zdarzenia DOM. (panel 3).

MapCanvasProjection interface

Interfejs google.maps.MapCanvasProjection

Ten obiekt jest udostępniany OverlayView w ramach metody draw. Nie ma gwarancji, że zostanie zainicjowany, dopóki nie zostanie wywołana funkcja draw.

fromContainerPixelToLatLng
fromContainerPixelToLatLng(pixel[, noClampNoWrap])
Parametry:
  • pixel: Point optional
  • noClampNoWrap: boolean optional
Wartość zwracana: LatLng|null
Oblicza współrzędne geograficzne na podstawie współrzędnych pikseli w kontenerze mapy.
fromDivPixelToLatLng
fromDivPixelToLatLng(pixel[, noClampNoWrap])
Parametry:
  • pixel: Point optional
  • noClampNoWrap: boolean optional
Wartość zwracana: LatLng|null
Oblicza współrzędne geograficzne na podstawie współrzędnych pikseli w elemencie div, który zawiera mapę z możliwością przeciągania.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
Parametry:
Wartość zwracana: Point|null
Oblicza współrzędne pikseli danego położenia geograficznego w elemencie kontenera mapy.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
Parametry:
Wartość zwracana: Point|null
Oblicza współrzędne pikseli danego położenia geograficznego w elemencie DOM, który zawiera mapę z możliwością przeciągania.
getVisibleRegion
getVisibleRegion()
Parametry: brak
Wartość zwracana: VisibleRegion|null
Widoczny region mapy. Jeśli mapa nie ma rozmiaru, zwraca wartość null. Zwraca null, jeśli OverlayView znajduje się w StreetViewPanorama.
getWorldWidth
getWorldWidth()
Parametry: brak
Wartość zwracana: number
Szerokość świata w pikselach na bieżącym poziomie powiększenia. W przypadku rzutów z kątem nagłówka wynoszącym 90 lub 270 stopni odpowiada to rozpiętości pikseli na osi Y.