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.
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.
Zespół | |
---|---|
OverlayView |
OverlayView() Parametry: brak
Tworzy OverlayView . |
Metody statyczne | |
---|---|
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”. |
Metody | |
---|---|
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.MapPanes
interfejs
Właściwości | |
---|---|
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.MapCanvasProjection
interfejs
Ten obiekt jest udostępniany obiektowi OverlayView
w ramach metody draw. Nie można zagwarantować, że zostanie zainicjowany przed wywołaniem metody draw.
Metody | |
---|---|
fromContainerPixelToLatLng |
fromContainerPixelToLatLng(pixel[, noClampNoWrap]) Parametry:
Wartość zwracana:
LatLng|null Oblicza współrzędne geograficzne na podstawie współrzędnych pikseli w kontenerze mapy. |
fromDivPixelToLatLng |
fromDivPixelToLatLng(pixel[, noClampNoWrap]) Parametry:
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. |