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. |