DOM elements

OverlayView class

google.maps.OverlayView class

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

Utwórz klasę dziedziczącą 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() musisz usunąć obiekty z DOM.
Aby wywołać metodę onAdd(), musisz wywołać metodę setMap() z prawidłowym obiektem Map, a aby wywołać metodę onRemove(), musisz wywołać metodę setMap(null). Metodę setMap() można wywołać w momencie tworzenia lub w dowolnym momencie później, gdy nakładka powinna zostać ponownie wyświetlona po usunięciu. Metoda draw() zostanie wywołana, gdy zmieni się właściwość mapy, która może zmienić pozycję elementu, np. powiększenie, położenie środka lub typ mapy.

Te zajęcia trwają MVCObject.

Dostęp przez połączenie telefoniczne const {OverlayView} = await google.maps.importLibrary("maps") lub const {OverlayView} = await google.maps.importLibrary("streetView"). Zobacz Biblioteki w Maps JavaScript API.
OverlayView
OverlayView()
Parametry: brak
Tworzy OverlayView.
preventMapHitsAndGesturesFrom
preventMapHitsAndGesturesFrom(element)
Parametry: 
Zwracana wartość:  brak
Zapobiega przenoszeniu na mapę zdarzeń kliknięcia, dotknięcia, przeciągania i użycia kółka. Użyj tego, aby zapobiec przeciąganiu i powiększaniu mapy, a także zdarzeniom „kliknięcia” mapy.
preventMapHitsFrom
preventMapHitsFrom(element)
Parametry: 
Zwracana wartość:  brak
Zapobiega klikaniu lub dotykaniu elementu, który powoduje przeniesienie na mapę. Użyj tego parametru, aby zapobiec wywoływaniu przez mapę zdarzeń „kliknięcie”.
draw
draw()
Parametry: brak
Zwracana wartość:  brak
Zaimplementuj tę metodę, aby narysować lub zaktualizować nakładkę. Użyj pozycji z projection.fromLatLngToDivPixel() do prawidłowego ustawienia nakładki względem MapPanes. Ta metoda jest wywoływana po onAdd() i po zmianie powiększenia lub środka. Nie zalecamy korzystania z tej metody do wykonywania prac wymagających dużych zasobów obliczeniowych.
getMap
getMap()
Parametry: brak
Wartość zwracana:  Map|StreetViewPanorama
getPanes
getPanes()
Parametry: brak
Wartość zwracana:  MapPanes|null
Zwraca panele, w których można renderować tę widoczną nakładkę. Panele nie są inicjowane, dopóki interfejs API nie wywoła funkcji onAdd.
getProjection
getProjection()
Parametry: brak
Wartość zwracana:  MapCanvasProjection
Zwraca obiekt MapCanvasProjection powiązany z tym obiektem OverlayView. Projekcja nie jest inicjowana, dopóki interfejs API nie wywoła metody onAdd.
onAdd
onAdd()
Parametry: brak
Zwracana wartość:  brak
Zaimplementuj tę metodę, aby zainicjować elementy DOM nakładki. Ta metoda jest wywoływana raz po wywołaniu setMap() z prawidłową mapą. W tym momencie panele i projekcja zostaną zainicjowane.
onRemove
onRemove()
Parametry: brak
Zwracana wartość:  brak
Zaimplementuj tę metodę, aby usunąć elementy z DOM. Ta metoda jest wywoływana raz po wywołaniu setMap(null).
setMap
setMap(map)
Parametry: 
Zwracana wartość:  brak
Dodaje nakładkę do mapy lub panoramy.
Uzyskane: addListener, bindTo, get, notify, set, setValues, unbind, unbindAll

Interfejs MapPanes

google.maps.MapPanesinterfejs

floatPane
Typ:  Element
Ten panel zawiera okno informacyjne. Znajduje się ona nad wszystkimi nakładkami mapy. (panel 4).
mapPane
Typ:  Element
To najniższy panel, który 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
Ta karta zawiera polilinie, wielokąty, nakładki na grunt i nakładki na warstwy kafelków. Nie odbiera zdarzeń DOM. (panel 1).
overlayMouseTarget
Typ:  Element
Ta karta zawiera elementy, które odbierają zdarzenia DOM. (panel 3).

Interfejs MapCanvasProjection

google.maps.MapCanvasProjectioninterfejs

Ten obiekt jest udostępniany obiektowi OverlayView w ramach metody draw. Nie można zagwarantować, że zostanie zainicjowany przed wywołaniem metody 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 elementach div, które zawierają mapę do przeciągania.
fromLatLngToContainerPixel
fromLatLngToContainerPixel(latLng)
Parametry: 
Wartość zwracana:  Point|null
Oblicza współrzędne pikseli danej lokalizacji geograficznej w elementach kontenera mapy.
fromLatLngToDivPixel
fromLatLngToDivPixel(latLng)
Parametry: 
Wartość zwracana:  Point|null
Oblicza współrzędne pikseli danej lokalizacji geograficznej w elemencie DOM, który zawiera mapę do przeciągania.
getVisibleRegion
getVisibleRegion()
Parametry: brak
Wartość zwracana:  VisibleRegion|null
Widoczny obszar mapy. Zwraca null, jeśli mapa nie ma rozmiaru. Zwraca wartość null, jeśli OverlayView znajduje się na StreetViewPanorama.
getWorldWidth
getWorldWidth()
Parametry: brak
Wartość zwracana:  number
Szerokość świata w pikselach przy bieżącym poziomie powiększenia. W przypadku projekcji z kątem kierunku 90 lub 270 stopni odpowiada to zakresowi pikseli na osi Y.