Marker class
google.maps.Marker
zajęcia
Ta klasa rozszerza klasę MVCObject.
Dostęp przez połączenie pod numer const {Marker} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.
Zespół | |
|---|---|
Marker |
Marker([opts])Parametry:
Tworzy znacznik z określonymi opcjami. Jeśli mapa jest określona, znacznik jest dodawany do mapy podczas tworzenia. Pamiętaj, że aby znacznik się wyświetlał, musisz ustawić jego pozycję. |
Stałe | |
|---|---|
MAX_ZINDEX |
Maksymalna domyślna wartość wskaźnika z-index, jaką interfejs API przypisze do markera. Możesz ustawić wyższą wartość wskaźnika z-index, aby przenieść znacznik na wierzch. |
Metody | |
|---|---|
getAnimation |
getAnimation()Parametry: brak
Zwracana wartość:
Animation|null|undefinedPobiera aktualnie odtwarzaną animację. |
getClickable |
getClickable()Parametry: brak
Wartość zwracana:
boolean wartość Prawda, jeśli w marker można kliknąć.Sprawdź, czy element Marker można kliknąć. |
getCursor |
getCursor()Parametry: brak
Zwracana wartość:
string|null|undefinedPobiera typ kursora myszy wyświetlany po najechaniu. |
getDraggable |
getDraggable()Parametry: brak
Wartość zwracana:
boolean Prawda, jeśli znacznik można przeciągać.Pobierz stan elementu Marker, który można przeciągać. |
getIcon |
getIcon()Parametry: brak
Pobierz ikonę Marker. Zobacz MarkerOptions.icon. |
getLabel |
getLabel()Parametry: brak
Zwracana wartość:
MarkerLabel|string|null|undefinedPobierz etykietę Marker. Zobacz MarkerOptions.label. |
getMap |
getMap()Parametry: brak
Zwracana wartość:
Map|StreetViewPanoramaPobierz mapę lub panoramę, na której renderowane jest urządzenie Marker. |
getOpacity |
getOpacity()Parametry: brak
Zwracana wartość:
number|null|undefined liczba z zakresu od 0,0 do 1,0.Pobierz wartość przezroczystości elementu Marker. |
getPosition |
getPosition()Parametry: brak
Zwracana wartość:
LatLng|null|undefinedPobierz pozycję Marker. |
getShape |
getShape()Parametry: brak
Zwracana wartość:
MarkerShape|null|undefined |
getTitle |
getTitle()Parametry: brak
Zwracana wartość:
string|null|undefinedPobierz tytuł Marker etykietki. Zobacz MarkerOptions.title. |
getVisible |
getVisible()Parametry: brak
Wartość zwracana:
boolean wartość „true”, jeśli znacznik jest widoczny.Uzyskaj widoczność Marker. |
getZIndex |
getZIndex()Parametry: brak
Zwracana wartość:
number|null|undefined indeks Z znacznika.Pobierz zIndex elementu Marker. Zobacz MarkerOptions.zIndex. |
setAnimation |
setAnimation([animation])Parametry:
Zwracana wartość: brak
Uruchom animację. Wszelkie trwające animacje zostaną anulowane. Obecnie obsługiwane animacje to: Animation.BOUNCE, Animation.DROP. Przekazanie wartości null spowoduje zatrzymanie animacji. |
setClickable |
setClickable(flag)Parametry:
Zwracana wartość: brak
Określ, czy element Marker można kliknąć. |
setCursor |
setCursor([cursor])Parametry:
Zwracana wartość: brak
Ustaw typ kursora myszy wyświetlany po najechaniu. |
setDraggable |
setDraggable(flag)Parametry:
Zwracana wartość: brak
Określ, czy element Marker można przeciągać. |
setIcon |
setIcon([icon])Zwracana wartość: brak
Ustaw ikonę dla Marker. Zobacz MarkerOptions.icon. |
setLabel |
setLabel([label])Parametry:
Zwracana wartość: brak
Ustaw etykietę dla elementu Marker. Zobacz MarkerOptions.label. |
setMap |
setMap(map)Parametry:
Zwracana wartość: brak
Renderuje ikonę Marker na określonej mapie lub panoramie. Jeśli mapa jest ustawiona na null, znacznik zostanie usunięty. |
setOpacity |
setOpacity([opacity])Parametry:
Zwracana wartość: brak
Ustaw nieprzezroczystość elementu Marker. |
setOptions |
setOptions(options)Parametry:
Zwracana wartość: brak
Ustaw opcje dla Marker. |
setPosition |
setPosition([latlng])Parametry:
Zwracana wartość: brak
Ustaw pozycję dla elementu Marker. |
setShape |
setShape([shape])Parametry:
Zwracana wartość: brak
|
setTitle |
setTitle([title])Parametry:
Zwracana wartość: brak
Ustaw tytuł etykietki Marker. Zobacz MarkerOptions.title. |
setVisible |
setVisible(visible)Parametry:
Zwracana wartość: brak
Ustaw, czy Marker ma być widoczny. |
setZIndex |
setZIndex([zIndex])Parametry:
Zwracana wartość: brak
Ustaw zIndex elementu Marker. Zobacz MarkerOptions.zIndex. |
Odziedziczone:
addListener,
bindTo,
get,
notify,
set,
setValues,
unbind,
unbindAll
| |
Wydarzenia | |
|---|---|
animation_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość animacji Marker. |
click |
function(event)Argumenty:
To zdarzenie jest wywoływane po kliknięciu ikony Marker. |
clickable_changed |
function()Argumenty: brak
|
contextmenu |
function(event)Argumenty:
To zdarzenie jest wywoływane, gdy zdarzenie DOM contextmenu jest wywoływane w elemencie Marker. |
cursor_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość Markerkursora. |
dblclick |
function(event)Argumenty:
To zdarzenie jest wywoływane po dwukrotnym kliknięciu ikony Marker. |
drag |
function(event)Argumenty:
To zdarzenie jest wywoływane wielokrotnie, gdy użytkownik przeciąga element Marker. |
dragend |
function(event)Argumenty:
To zdarzenie jest uruchamiane, gdy użytkownik przestanie przeciągać element Marker. |
draggable_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość Marker draggable. |
dragstart |
function(event)Argumenty:
To zdarzenie jest wywoływane, gdy użytkownik zaczyna przeciągać element Marker. |
flat_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość płaska Marker. |
icon_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość ikony Marker. |
mousedown |
function(event)Argumenty:
To zdarzenie jest wywoływane po naciśnięciu przycisku myszy na elemencie Marker. |
mouseout |
function(event)Argumenty:
To zdarzenie jest uruchamiane, gdy wskaźnik myszy opuści obszar ikony Marker. |
mouseover |
function(event)Argumenty:
To zdarzenie jest wywoływane, gdy kursor myszy znajdzie się w obszarze ikony Marker. |
mouseup |
function(event)Argumenty:
To zdarzenie jest wywoływane po zwolnieniu przycisku myszy na elemencie Marker. |
position_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość Marker position. |
shape_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość kształtu Marker. |
title_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się Markerwłaściwość tytułu. |
visible_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość Markervisible. |
zindex_changed |
function()Argumenty: brak
To zdarzenie jest wywoływane, gdy zmienia się właściwość MarkerzIndex. |
|
function(event)Argumenty:
To zdarzenie jest wywoływane po kliknięciu prawym przyciskiem myszy elementu Marker. |
MarkerOptions interfejs
google.maps.MarkerOptionsinterfejs
Obiekt MarkerOptions używany do określania właściwości, które można ustawić w przypadku znacznika.
Właściwości | |
|---|---|
anchorPoint optional |
Typ:
Point optionalPrzesunięcie od pozycji znacznika do wierzchołka okna informacyjnego, które zostało otwarte ze znacznikiem jako punktem zakotwiczenia. |
animation optional |
Typ:
Animation optionalDomyślnie:
nullAnimacja, która ma być odtwarzana po dodaniu znacznika do mapy. |
clickable optional |
Typ:
boolean optionalDomyślnie:
trueJeśli true, znacznik odbiera zdarzenia myszy i dotyku. |
|
Typ:
string|CollisionBehavior optionalDomyślnie:
nullUstawianie zachowania znaczników na mapach wektorowych w przypadku kolizji. |
crossOnDrag optional |
Typ:
boolean optionalDomyślnie:
trueJeśli false, wyłącza krzyżyk, który pojawia się pod markerem podczas przeciągania. |
cursor optional |
Typ:
string optionalDomyślnie:
pointerTyp kursora myszy, który ma się wyświetlać po najechaniu na element. |
draggable optional |
Typ:
boolean optionalDomyślnie:
falseJeśli true, znacznik można przeciągnąć. Uwaga: ustawienie wartości true spowoduje, że znacznik będzie klikalny nawet wtedy, gdy wartość clickable będzie ustawiona na false. |
icon optional |
Ikona pierwszego planu. Jeśli podany jest ciąg znaków, jest on traktowany tak, jakby był obiektem Icon, w którym ciąg znaków jest wartością pola url. |
label optional |
Typ:
string|MarkerLabel optionalDomyślnie:
nullDodaje etykietę do znacznika. Etykieta znacznika to litera lub cyfra, która pojawia się wewnątrz znacznika. Etykieta może być ciągiem znaków lub obiektem MarkerLabel. Jeśli podano wartość parametru MarkerOptions.title, a nie podano wartości parametru MarkerOptions.title, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użycia z czytnikami ekranu) z tekstem podanej etykiety. Pamiętaj, że symbol label jest obecnie używany tylko w tekście ułatwień dostępu w przypadku nieoptymalizowanych znaczników. |
map optional |
Typ:
Map|StreetViewPanorama optionalMapa, na której ma być wyświetlany znacznik. Mapa jest wymagana do wyświetlenia znacznika i może być podana za pomocą Marker.setMap, jeśli nie została podana podczas tworzenia znacznika. |
opacity optional |
Typ:
number optionalWartość domyślna: 1.0
Liczba z zakresu od 0,0 (przezroczystość) do 1,0 (nieprzezroczystość). |
optimized optional |
Typ:
boolean optionalOptymalizacja zwiększa wydajność, renderując wiele znaczników jako jeden element statyczny. Jest to przydatne w przypadku, gdy wymagana jest duża liczba znaczników. Dowiedz się więcej o optymalizacji markerów. Uwaga: ta optymalizacja nie ma wpływu na znaczniki na mapach wektorowych. |
position optional |
Typ:
LatLng|LatLngLiteral optionalUstawia pozycję znacznika. Może zostać utworzony znacznik, ale nie będzie on wyświetlany, dopóki nie zostanie podana jego pozycja – na przykład w wyniku działań lub wyborów użytkownika. Pozycję znacznika można podać za pomocą parametru Marker.setPosition, jeśli nie została podana podczas tworzenia znacznika. |
shape optional |
Typ:
MarkerShape optionalDefinicja regionu mapy obrazu używana do przeciągania lub klikania. |
title optional |
Typ:
string optionalDomyślnie:
undefinedTekst po najechaniu kursorem. Jeśli zostanie podany, do znacznika zostanie dodany tekst ułatwień dostępu (np. do użycia z czytnikami ekranu) o podanej wartości. Pamiętaj, że symbol title jest obecnie używany tylko w tekście ułatwień dostępu w przypadku nieoptymalizowanych znaczników. |
visible optional |
Typ:
boolean optionalDomyślnie:
trueJeśli true, znacznik jest widoczny. |
zIndex optional |
Typ:
number optionalWszystkie znaczniki są wyświetlane na mapie w kolejności ich indeksu z, przy czym znaczniki o wyższych wartościach są wyświetlane przed znacznikami o niższych wartościach. Domyślnie markery są wyświetlane zgodnie z ich pionową pozycją na ekranie. Markery znajdujące się niżej pojawiają się przed markerami znajdującymi się wyżej. |
Stałe CollisionBehavior
google.maps.CollisionBehavior
stałe
Dostęp przez połączenie pod numer const {CollisionBehavior} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
|---|---|
OPTIONAL_AND_HIDES_LOWER_PRIORITY |
Wyświetlaj znacznik tylko wtedy, gdy nie nakłada się na inne znaczniki. Jeśli 2 markery tego typu nakładają się na siebie, wyświetlany jest ten o wyższej wartości zIndex. Jeśli mają tę samą wartość zIndex, wyświetlana jest ta, która znajduje się niżej na ekranie. |
REQUIRED |
Zawsze wyświetlaj znacznik, niezależnie od kolizji. Jest to zachowanie domyślne. |
REQUIRED_AND_HIDES_OPTIONAL |
Zawsze wyświetlaj znacznik niezależnie od kolizji i ukrywaj wszystkie znaczniki lub etykiety OPTIONAL_AND_HIDES_LOWER_PRIORITY, które mogłyby się z nim pokrywać. |
Interfejs ikony
google.maps.Iconinterfejs
Struktura reprezentująca obraz ikony markera.
Właściwości | |
|---|---|
url |
Typ:
stringAdres URL obrazu lub arkusza sprite. |
anchor optional |
Typ:
Point optionalPozycja, w której obraz ma być zakotwiczony w odniesieniu do lokalizacji znacznika na mapie. Domyślnie punkt zakotwiczenia znajduje się w środku dolnej części obrazu. |
labelOrigin optional |
Typ:
Point optionalPunkt początkowy etykiety względem lewego górnego rogu obrazu ikony, jeśli etykieta jest dostarczana przez znacznik. Domyślnie punkt początkowy znajduje się w środku obrazu. |
origin optional |
Typ:
Point optionalPołożenie obrazu w spricie (jeśli występuje). Domyślnie punkt początkowy znajduje się w lewym górnym rogu obrazu (0, 0). |
scaledSize optional |
Typ:
Size optionalRozmiar całego obrazu po ewentualnym skalowaniu. Użyj tej właściwości, aby rozciągnąć lub zmniejszyć obraz lub sprite’a. |
size optional |
Typ:
Size optionalRozmiar wyświetlania sprite’a lub obrazu. Jeśli używasz sprite’ów, musisz określić ich rozmiar. Jeśli rozmiar nie zostanie podany, zostanie ustawiony po wczytaniu obrazu. |
MarkerLabel interfejs
google.maps.MarkerLabelinterfejs
Te opcje określają wygląd etykiety markera. Etykieta znacznika to ciąg znaków (często pojedynczy znak), który będzie wyświetlany w znaczniku. Jeśli używasz go z niestandardowym znacznikiem, możesz zmienić jego położenie za pomocą właściwości labelOrigin w klasie Icon.
Właściwości | |
|---|---|
text |
Typ:
stringTekst, który ma być wyświetlany na etykiecie. |
className optional |
Typ:
string optionalWartość domyślna:
'' (pusty ciąg tekstowy)Właściwość className elementu etykiety (odpowiednik atrybutu class elementu). Możesz dodać wiele klas CSS rozdzielonych spacjami. Kolor, rozmiar, grubość i rodzinę czcionki można ustawić tylko za pomocą innych właściwości MarkerLabel. Klas CSS nie należy używać do zmiany pozycji ani orientacji etykiety (np. za pomocą translacji i obrotów), jeśli używasz też zarządzania kolizjami znaczników. |
color optional |
Typ:
string optionalDomyślnie:
'black'Kolor tekstu etykiety. |
fontFamily optional |
Typ:
string optionalRodzina czcionek tekstu etykiety (odpowiednik właściwości CSS font-family). |
fontSize optional |
Typ:
string optionalDomyślnie:
'14px'Rozmiar czcionki tekstu etykiety (odpowiednik właściwości CSS font-size). |
fontWeight optional |
Typ:
string optionalGrubość czcionki tekstu etykiety (odpowiednik właściwości CSS font-weight). |
MarkerShape interfejs
google.maps.MarkerShapeinterfejs
Ten obiekt definiuje obszar klikalny obrazu znacznika. Kształt składa się z 2 właściwości – type i coord – które określają nieprzezroczysty obszar obrazu.
Właściwości | |
|---|---|
type |
Typ:
stringOkreśla typ kształtu i może mieć wartość circle, poly lub rect. |
coords optional |
Typ:
Array<number> optionalFormat tego atrybutu zależy od wartości type i jest zgodny ze specyfikacją w3 AREA coords, którą znajdziesz na stronie http://www.w3.org/TR/REC-html40/struct/objects.html#adef-coords. Atrybut coords to tablica liczb całkowitych określających położenie kształtu w pikselach względem lewego górnego rogu obrazu docelowego. Współrzędne zależą od wartości type w ten sposób: - circle: coords to [x1,y1,r], gdzie x1,y2 to współrzędne środka okręgu, a r to promień okręgu. - poly: coords to [x1,y1,x2,y2...xn,yn], gdzie każda para x,y zawiera współrzędne jednego wierzchołka wielokąta. - rect: coords to [x1,y1,x2,y2], gdzie x1,y1 to współrzędne lewego górnego rogu prostokąta, a x2,y2 to współrzędne prawego dolnego rogu prostokąta. |
Symbol interfejs
google.maps.Symbolinterfejs
Opisuje symbol, który składa się ze ścieżki wektorowej ze stylem. Symbol może być używany jako ikona znacznika lub umieszczany na polilinii.
Właściwości | |
|---|---|
path |
Typ:
SymbolPath|stringŚcieżka symbolu, która jest wbudowaną ścieżką symbolu lub ścieżką niestandardową wyrażoną za pomocą notacji ścieżki SVG. Wymagane. |
anchor optional |
Typ:
Point optionalDomyślnie:
google.maps.Point(0,0)Położenie symbolu względem znacznika lub linii łamanej. Współrzędne ścieżki symbolu są przesuwane w lewo i w górę odpowiednio o współrzędne x i y punktu zakotwiczenia. Pozycja jest wyrażona w tym samym układzie współrzędnych co ścieżka symbolu. |
fillColor optional |
Typ:
string optionalKolor wypełnienia symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślnie jest to „black”. W przypadku symboli na liniach łamanych jest to domyślnie kolor linii łamanej. |
fillOpacity optional |
Typ:
number optionalDomyślnie:
0Przezroczystość wypełnienia symbolu. |
labelOrigin optional |
Typ:
Point optionalDomyślnie:
google.maps.Point(0,0)Pochodzenie etykiety względem pochodzenia ścieżki, jeśli etykieta jest dostarczana przez znacznik. Początek jest wyrażony w tym samym układzie współrzędnych co ścieżka symbolu. Ta właściwość nie jest używana w przypadku symboli na poliliniach. |
rotation optional |
Typ:
number optionalDomyślnie:
0Kąt, o który należy obrócić symbol, wyrażony w stopniach zgodnie z ruchem wskazówek zegara. Symbol w IconSequence, gdzie fixedRotation to false, jest obrócony względem kąta krawędzi, na której się znajduje. |
scale optional |
Typ:
number optionalWartość, o którą symbol jest skalowany. W przypadku znaczników symboli domyślna wartość to 1. Po skalowaniu symbol może mieć dowolny rozmiar. W przypadku symboli na polilinii domyślnie jest to grubość linii polilinii. Po przeskalowaniu symbol musi znajdować się w kwadracie o rozmiarze 22 pikseli wyśrodkowanym na punkcie zakotwiczenia symbolu. |
strokeColor optional |
Typ:
string optionalKolor obrysu symbolu. Obsługiwane są wszystkie kolory CSS3 z wyjątkiem rozszerzonych nazw kolorów. W przypadku znaczników symboli domyślnie jest to „black”. W przypadku symboli na linii łamanej jest to domyślnie kolor linii łamanej. |
strokeOpacity optional |
Typ:
number optionalPrzezroczystość konturu symbolu. W przypadku znaczników symboli domyślna wartość to 1. W przypadku symboli na linii łamanej domyślnie jest to krycie linii łamanej. |
strokeWeight optional |
Typ:
number optionalDomyślna:
Symbol.scale symbolu.Grubość konturu symbolu. |
SymbolPath constants
google.maps.SymbolPath
stałe
Wbudowane ścieżki symboli.
Dostęp przez połączenie pod numer const {SymbolPath} = await google.maps.importLibrary("core").
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
|---|---|
BACKWARD_CLOSED_ARROW |
Zamknięta strzałka skierowana w lewo. |
BACKWARD_OPEN_ARROW |
Otwarta strzałka skierowana w lewo. |
CIRCLE |
okrąg, |
FORWARD_CLOSED_ARROW |
Zamknięta strzałka skierowana do przodu. |
FORWARD_OPEN_ARROW |
Otwarta strzałka skierowana do przodu. |
Stałe animacji
google.maps.Animation
stałe
Animacje, które można odtworzyć na znaczniku. Użyj metody Marker.setAnimation na znaczniku lub opcji MarkerOptions.animation, aby odtworzyć animację.
Dostęp przez połączenie pod numer const {Animation} = await google.maps.importLibrary("marker").
Zobacz Biblioteki w Maps JavaScript API.
Stałe | |
|---|---|
BOUNCE |
Znacznik podskakuje, dopóki animacja nie zostanie zatrzymana przez wywołanie funkcji Marker.setAnimation z parametrem null. |
DROP |
Znacznik spada z góry mapy do miejsca docelowego. Animacja zakończy się, gdy znacznik się zatrzyma, a Marker.getAnimation wróci do pozycji null. Ten typ animacji jest zwykle określany podczas tworzenia markera. |